Регистрирует информацию о ходе выполнения длительной операции. Не следует использовать для передачи результата работы длительной операции по частям. Во избежание избыточного потребления памяти и ее утечек при выполнении одной длительной операции не следует сообщать прогресс более 100 раз. Если прогресс сообщается менее чем через 3 сек после предыдущего вызова, то последнее сообщение удаляется и заменяется на новое (если используется система взаимодействия, то отправка нового сообщения не выполняется, а будет выполнена спустя некоторое время - не быстрее 3 сек). После отправки прогресса отправляются все сообщения, накопленные в очереди сообщений фонового задания. Для того чтобы выводить ход выполнения длительной операции для пользователя, следует установить свойство ВыводитьПрогрессВыполнения в Истина (см. ДлительныеОперацииКлиент.ПараметрыОжидания).

Синтаксис

Процедура СообщитьПрогресс(Знач Процент = Неопределено, Знач Текст = Неопределено, Знач ДополнительныеПараметры = Неопределено) Экспорт

Параметры

• Процент — Число - процент выполнения.
• Текст — Строка - информация о текущей операции.
• ДополнительныеПараметры — Произвольный - любая дополнительная информация, которую необходимо передать на клиент. Значение должно быть простым (сериализуемым в XML-строку).

Пример вызова

ДлительныеОперации.СообщитьПрогресс(Процент, Текст, ДополнительныеПараметры)

Доступность

Сервер, Толстый клиент, Внешнее соединение