QueryScheduledBackupFailure

From SunFlurry wiki
Revision as of 08:52, 7 February 2021 by Admin (talk | contribs) (1 revision imported)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
  QueryScheduledBackupFailure (Работа с резервным копированием)
Объект:Функции общего назначения
Статус разработки: Реализована
Тип:Функция
Обращение к БД:Сервер
Визуальность:Нет

Функция возвращает информацию по последней ошибке при резервном копировании, выполнявшемся по расписанию. Если ошибка произошла при инициации копирования функцией InitiateBackupCreation, она не будет возвращена этой функцией. Функция может выполняться при запуске клиента с административными правами, чтобы предупредить администратора о том, что какой-либо из процессов резервного копирования закончился с ошибкой. Чтобы очистить информацию об ошибке, необходимо удалить сохраненный файл ошибки LocalConfig\BackupScheduleLastFailure.bin в каталоге проекта на сервере и перезагрузить сервер, сам сервер не будет удалять этот файл, а только заменит его содержимое в случае возникновения новой ошибки.

Синтаксис

QueryScheduledBackupFailure(<Идентификатор протокола последней ошибки резервного копирования (STRING)>,<Сообщение об ошибке, произошедшей во время резервного копирования (STRING)>,<Дата и время начала последнего процесса (DATE)>):<Ошибка происходила (1), ошибки не было (0) (INT)>

Аргументы

  • <Идентификатор протокола последней ошибки резервного копирования (STRING)> - (необязательный аргумент) (возможен аргумент-переменная (ByRef)) При наличии последней ошибки, функция возвращает идентификатор протокола, закончившегося с ошибкой в переменной, переданной в этом аргументе.
  • <Сообщение об ошибке, произошедшей во время резервного копирования (STRING)> - (необязательный аргумент) (возможен аргумент-переменная (ByRef)) При наличии последней ошибки, функция возвращает сообщение об ошибке, с которой закончился процесс резервного копирования, в переменной, переданной в этом аргументе.
  • <Идентификатор протокола последней ошибки резервного копирования (STRING)> - (необязательный аргумент) (возможен аргумент-переменная (ByRef)) При наличии последней ошибки, функция возвращает дату и время начала процесса резервного копирования, закончившегося с ошибкой, в переменной, переданной в этом аргументе.

Возвращаемое значение

Функция возвращает 1 и заполняет переменные соответствующей информацией об ошибке, если информация о ней хранится на сервере, иначе функция возвращает 0 и значения переменных не изменяются.

Примеры

//Фрагмент можно выполнять при запуске клиента, чтобы информировать администратора о том, что в процессе резервного копирования произошла ошибка.
If IsDBAdministrator()=2 Then
  СтрИмя:="";
  СтрОшибка:="";
  аДата:=0;
  If QueryScheduledBackupFailure(СтрИмя,СтрОшибка,аДата) Then
    Message("Внимание! При выполнении резервного копирования на сервере была найдена ошибка!","!");
    Message("Последний раз это произошло "+FormatDate(аДата,"dd.mm.YYYY hh:tt:ss")+" с протоколом "+СтрИмя+", ошибка: "+СтрОшибка+"!","!");
  EndIf;
EndIf;