Возвращает новую структуру для параметра ПараметрыВыполнения функции ВыполнитьВФоне. Если ЗапуститьВФоне = Ложь и ЗапуститьНеВФоне = Ложь, то задание будет выполнено в фоне по возможности. Запуск выполняется сразу в основном потоке при выполнении любого из следующих условий:

• если вызов выполняется в файловой базе во внешнем соединении (в этом режиме фоновые задания не поддерживаются);
• если приложение запущено в режиме отладки (параметр /C РежимОтладки) - для упрощения отладки конфигурации;
• если в файловой ИБ имеются активные фоновые задания - для снижения времени ожидания пользователя;
• если выполняется функция модуля внешней обработки или внешнего отчета.

Синтаксис

Функция ПараметрыВыполненияВФоне(Знач ИдентификаторФормы = Неопределено) Экспорт

Параметры

• ИдентификаторФормы — УникальныйИдентификатор - уникальный идентификатор формы, во временное хранилище которой необходимо поместить результат выполнения процедуры.
  • Неопределено - если временное хранилище не нужно создавать автоматически на время жизни формы, а его адрес предполагается задавать явно в свойстве АдресРезультата. В таком случае, временное хранилище нужно очищать явно при обработке результата длительной операции с помощью метода УдалитьИзВременногоХранилища.

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

Структура:

• ИдентификаторФормы - УникальныйИдентификатор - уникальный идентификатор формы, во временное хранилище которой надо поместить результат выполнения процедуры.
• ДополнительныйРезультат - Булево - признак использования дополнительного временного хранилища для передачи результата из фонового задания в родительский сеанс. По умолчанию - Ложь.
• ОжидатьЗавершение - Неопределено - ждать до момента завершения фонового задания.
  • Число - таймаут в секундах ожидания завершения фонового задания. Если задано 0, то ждать завершения задания не требуется. По умолчанию - 0.8 секунды, а для низкой скорости соединения - 4.
• НаименованиеФоновогоЗадания - Строка - описание фонового задания. По умолчанию - имя процедуры.
• КлючФоновогоЗадания - Строка - уникальный ключ для активных фоновых заданий, имеющих такое же имя процедуры. По умолчанию не задан.
• АдресРезультата - Строка - адрес временного хранилища, в которое должен быть помещен результат работы процедуры. Если не задан, адрес формируется автоматически на время жизни формы с помощью идентификатора ИдентификаторФормы.
• ЗапуститьВФоне - Булево - если Истина, то задание будет всегда выполняться в фоне, кроме ситуаций: а) если вызов выполняется в файловой базе во внешнем соединении (в этом режиме фоновые задания не поддерживаются); б) если выполняется функция модуля внешней обработки или внешнего отчета. Кроме того, в файловом варианте при наличии ранее запущенных фоновых заданий, новое задание становится в очередь и начинает выполняться после завершения предыдущих. Если Ложь, то задание будет выполнено в фоне по возможности.
• ЗапуститьНеВФоне - Булево - если Истина, задание всегда будет запускаться непосредственно, без использования фонового задания.
• БезРасширений - Булево - если Истина, то фоновое задание будет запущено без подключения расширений конфигурации. Имеет приоритет над параметром ЗапуститьНеВФоне.
• СРасширениямиБазыДанных - Булево - если Истина, то фоновое задание будет запущено с последней версией расширений конфигурации. Имеет приоритет над параметром ЗапуститьНеВФоне.
• ВнешнийОтчетОбработка - Неопределено - по умолчанию.
  • ДвоичныеДанные - когда указано имя метода, которое начинается с "ВнешнийОтчет." или "ВнешняяОбработка.". Для вызова такого метода требуется право интерактивного открытия внешнего отчета или обработки соответственно. Внешний отчет или обработка подключаются с защитой от опасных действий.
• УточнениеОшибки - Строка - если не пустая строка, тогда для пользователя текст ошибки будет уточнен указанным начальным текстом. Пример уточнения: НСтр("ru = 'Не удалось очистить адресный классификатор по причине:'")

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

Результат = ДлительныеОперации.ПараметрыВыполненияВФоне(ИдентификаторФормы)

Доступность

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