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

ВыполнитьФункциюВНесколькоПотоков

страница

Запустить выполнение функции в многопоточном фоновом задании, если это возможно. Вызываемая процедура может быть с произвольным числом параметров, но не более 7. Значения передаваемых параметров процедуры, а также возвращаемое значение должны быть сериализуемыми. Параметры процедуры не должны быть возвращаемыми. Многопоточные длительные операции в неразделенном сеансе не поддерживаются. Не следует использовать эту функцию, если необходимо безусловно запускать фоновое задание. Рекомендуется применять совместно с функцией ДлительныеОперацииКлиент.ОжидатьЗавершение, если невозможно, тогда для проверки завершения операции использовать функцию ЗаданиеВыполнено.

Синтаксис

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

Параметры

  • ИмяФункции — Строка - имя экспортной функции общего модуля, модуля менеджера объекта или модуля обработки, которую необходимо выполнить в фоне. Например, "МойОбщийМодуль.МояПроцедура", "Отчеты.ЗагруженныеДанные.Сформировать" или "Обработки.ЗагрузкаДанных.МодульОбъекта.Загрузить".
  • ПараметрыВыполнения — см. ПараметрыВыполненияФункции
  • НаборПараметровФункции — Соответствие из КлючИЗначение - произвольный набор параметров вызова функции:
    • Ключ - Произвольный - ключ набора
    • Значение - Массив - параметры вызова функции. Количество параметров может быть от 0 до 7.

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

Структура:

  • Статус - Строка - "Выполняется", если задание еще не завершилось; "Выполнено", если задание было успешно выполнено; "Ошибка", если задание завершено с ошибкой; "Отменено", если задание отменено пользователем или администратором.
  • ИдентификаторЗадания - УникальныйИдентификатор - если Статус = "Выполняется", то содержит идентификатор запущенного фонового задания.
    • Неопределено - если Статус <> "Выполняется" и фоновое задание не запускалось.
  • АдресРезультата - Строка - адрес временного хранилища, в которое будет помещено Соответствие: ** Ключ - Произвольный ** Значение - см. ВыполнитьФункцию
  • ИнформацияОбОшибке - ИнформацияОбОшибке - если Статус = "Ошибка".
    • Неопределено - если Статус <> "Ошибка".
  • Сообщения - ФиксированныйМассив - если Статус <> "Выполняется", то массив объектов СообщениеПользователю, которые были сформированы в фоновом задании.
  • КраткоеПредставлениеОшибки - Строка - устарел.
  • ПодробноеПредставлениеОшибки - Строка - устарел.

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

Результат = ДлительныеОперации.ВыполнитьФункциюВНесколькоПотоков(ИмяФункции, ПараметрыВыполнения, НаборПараметровФункции)

Доступность

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