МенеджерФоновыхЗаданий.Выполнить (BackgroundJobsManager.Execute)
МенеджерФоновыхЗаданий (BackgroundJobsManager)
Выполнить (Execute)
Доступен, начиная с версии 8.1.
Синтаксис:
Выполнить(<ИмяМетода>, <Параметры>, <Ключ>, <Наименование>)Параметры:
<ИмяМетода> (обязательный)
Имя экспортируемой процедуры или функции неглобального общего модуля, который может быть выполнен на сервере, в форме ИмяМодуля.ИмяМетода.
<Параметры> (необязательный)
Массив параметров, передаваемых в метод. Количество и типы параметров должны соответствовать параметрам метода.
Все передаваемые параметры должны поддерживать сериализацию. В противном случае будет выдано исключение и фоновое задание не будет запущено.
Если последние параметры метода имеют значения по-умолчанию, то их можно не задавать в массиве.
Если все параметры метода имеют значение по-умолчанию, то массив можно не передавать вообще.
Размер передаваемых данных ограничен 1 ГБ. Если внутреннее представление превышает указанное значение, будет вызвано исключение. Параметры большого размера рекомендуется передавать через базу данных.
<Ключ> (необязательный)
Ключ задания. Если ключ задан, то он должен быть уникальным среди ключей активных фоновых заданий, имеющих такое же имя метода, что и у данного фонового задания.
<Наименование> (необязательный)
Описание задания.
Возвращаемое значение:
Тип: ФоновоеЗадание.Описание:
Инициирует выполнение фонового задания. Задание выполняется от лица текущего пользователя. Выполнение происходит без ожидания завершения задания: задание ставится в очередь на выполнение, возврат из метода происходт до реального завершения задания. Если установлен ключ задания, он должен быть уникальным среди ключей активных заданий.
При передаче в качестве параметров метода несериализуемых значений будет выдано исключение и фоновое задание запущено не будет.
В файловом варианте возможно одновременное выполнение только одного фонового задания. При наличии уже выполняющегося задания новые будут ставиться в очередь на выполнение, но начнут выполняться только после завершения предыдущего.
При работе через COM-соединение или внешнее соединение с файловой базой фоновые задания не будут выполняться. Задание добавляется в очередь, но реального запуска происходить не будет.
Попытка вызова метода ОжидатьЗавершения из внешнего соединения или фонового задания файлового варианта приведет к ожиданию в течение всего таймаута или к бесконечному ожиданию, если таймаут не задан.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.