2 378 документов
← К списку

ПараметрыВыполненияФункции

страница

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

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

Синтаксис

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

Параметры

  • ИдентификаторФормы — УникальныйИдентификатор - уникальный идентификатор формы, во временное хранилище которой надо поместить результат выполнения процедуры.

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

Структура - параметры выполнения длительной операции:

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

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

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

Доступность

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