Admin: 1 revision imported

2021-02-07T06:52:34Z

1 revision imported

Admin: Created page with "{{infobox function |name=QueryBackupProgress |object=Функции общего назначения |caption=Работа с резервным копированием..."

2020-11-22T06:19:10Z

Created page with "{{infobox function |name=QueryBackupProgress |object=Функции общего назначения |caption=Работа с резервным копированием..."

New page

{{infobox function
|name=QueryBackupProgress
|object=[[Функции общего назначения]]
|caption=Работа с резервным копированием
|type=1
|status=2
|db=1
|exception=Невозможно превратить в число, ошибка сервера.
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция используется для получения информации об окончании или состоянии процесса резервного копирования, инициированого функцией [[InitiateBackupCreation]]. Для получения информации по процессу, запущенному именно функцией ''InitiateBackupCreation'' используется код (индекс) процесса копирования на сервере. Однако, сервер хранит только один старый результат процесса, поэтому, может получиться ситуация, когда код, передаваемый функции, не соответствует ни уже завершенному процессу копирования, ни активному в данный момент процессу (если таковой имеется). В этом случае, функция не сможет возвратить никакой информации, такое состояние может произойти, если функция вызвана после окончания процесса копирования, который был запущен после окончания процесса, информацию о котором пытается получить данная функция. Это состояние, даже если оно маловероятно, также необходимо предусмотреть.

== Синтаксис ==
<code>
'''QueryBackupProgress'''(''<Код процесса резервного копирования (INT)>''{{OptionalByRef|,<Текущее сообщение процесса копирования или сообщение об ошибке (STRING)>,<Дата и время начала последнего процесса (DATE)>}}):''<Код состояния процесса резервного копирования (INT)>''
</code>
==== Аргументы ====
* <code>''<Код процесса резервного копирования (INT)>''</code> - Аргумент задает индекс процесса копирования, инициированого функцией [[InitiateBackupCreation]]. Последняя функция возвращает значение этого аргумента (см. пример ниже).
* <code>''<Текущее сообщение процесса копирования или сообщение об ошибке (STRING)>''</code> - {{Optional}} {{ByRef}} Аргумент задает переменную, в которую будет помещена информация о процессе копирования. Если процесс уже завершен, информация будет представлять собой сообщение об ошибке или сообщение об успешном завершении, иначе информация будет характеризовать текущую стадию процесса.
* <code>''<Дата и время начала последнего процесса (DATE)>''</code> - {{Optional}} {{ByRef}} Аргумент задает переменную, в которую будет помещена дата начала процесса копирования.

==== Возвращаемое значение ====
Функция возвращает числовой код состояния процесса копирования. Возможны следующие значения кода:
* '''0''' -- процесс копирования не найден (внутренняя ошибка или код процесса копирования неверен).
* '''1''' -- процесс копирования активен в данный момент, переменная второго аргумента заполняется информацией по его состоянию.
* '''2''' -- процесс копирования успешно завершен, переменная второго аргумента заполняется сообщением об успешном завершении процесса.
* '''3''' -- процесс копирования завершен с ошибкой, переменная второго аргумента заполняется сообщением об ошибке.

== Примеры ==
<pre>
//Фрагмент выводит в лог различные состояния процесса резервного копирования "Создание копии по запросу"
//Цикл завершается в момент получения информации об ошибке или удачном окончании процесса.
iNum:=InitiateBackupCreation("Создание копии по запросу");
аСтр0:="";
аРез:=1;
While аРез=1 Do
аСтр:="";
аДата:=0;
аРез:=QueryBackupProgress(iNum,аСтр,аДата);

аТип:="";
If аРез=0 Then
аСтр:="Внутренняя ошибка!";
аТип:="!";
ElseIf аРез=2 Then
аТип:="I";
ElseIf аРез=3 Then
аТип:="!";
EndIf;

If аСтр0<>аСтр Then
Message(аСтр,аТип);
аСтр0:=аСтр;
EndIf;
Sleep(50);
EndDo;
</pre>

← Older revision	Revision as of 06:52, 7 February 2021
(No difference)

QueryBackupProgress - Revision history

Admin: 1 revision imported

Admin: Created page with "{{infobox function |name=QueryBackupProgress |object=Функции общего назначения |caption=Работа с резервным копированием..."