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

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

страница

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

Синтаксис

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

Параметры

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

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

Структура:

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

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

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

Доступность

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