Операции, выполняемые на сервере Mobile SMARTS

В платформе Mobile SMARTS есть возможность вызова серверных операций из конфигурации Mobile SMARTS. Серверная операция — это операция, выполняемая на сервере Mobile SMARTS, в отличие от обычной операции, которая выполняется на самом ТСД.

Серверные операции могут использоваться в следующих случаях:

• в случае работы с коллективным документом — позволяет ускорить работу за счет замены множества одиночных вызовов на сервер одним, при котором целый кусок алгоритма отрабатывает на сервере. Дополнительно, используя блокировки, это позволяет решить проблемы несогласованного изменения данных в сложных случаях;

• для явного вызова операции на сервере, даже если документ не коллективный, что дает возможность строить более гибкую логику работы;

• в качестве обработчиков серверных событий (производить какие-то операции с данными при выгрузке или завершении документа).

Необходимо учитывать, что такие операции имеют ограничения на используемые действия. Никакие визуальные действия использоваться в серверных операциях не могут.

Коллективная работа

Для того, чтобы операция выполнялась на сервере, в панели управления в свойствах операции нужно установить настройку «Выполняется на сервере — Да».

При вызове такой операции её исполнение будет полностью происходить на сервере. Если же она будет вызвана в обычном, не коллективном документе, то она всё также будет исполняться на мобильном устройстве.

При разработке таких операций важно учитывать, что все данные, которыми она оперирует, должны быть переданы в качестве её параметров. Данные, не переданные явно, будут в операции недоступны.

Явный вызов операции на сервере

Но серверную операцию можно вызвать явно и для обычного, неколлективного, документа. Для этого можно воспользоваться расширением «Вызов серверных операций».

«Вызов серверных операций» всегда присутствует в конфигурации Mobile SMARTS в случае использования серверной базы в папке «Расширения».

Явный вызов необходимо выполнять с помощью действия «Вызов метода внешней системы».

Обработка событий сервера

Расширение «Вызов серверных операций» поддерживает обработку событий документов с помощью операции, выполняемой на сервере.

Это означает, что можно, например, написать операцию какой-то обработки документа, которая будет исполняться, когда завершенный документ будет приходить с мобильного устройства.

Прочие события (получение номенклатуры, запрос данных из таблиц онлайн) пока не поддерживаются.

Документ добавляется

Событие, возникающее в процессе добавления документа на сервере. Вызывается при выгрузке документа в базу Mobile SMARTS из внешней системы.

В серверную операцию передается добавляемый документ (переменная сессии Document). Если выполнение операции прерывается (переход [прервать операцию]), добавление документа на сервер отменяется, в лог сервера добавляется запись: «Документ отклонен обработчиком события». Если отмена добавления не требуется, операция должна завершиться по переходу [завершить операцию].

Параметры:

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

Документ добавлен

Событие, возникающее после добавления документа на сервере. Вызывается при выгрузке документа в базу Mobile SMARTS из внешней системы.

В серверную операцию передается добавленный документ (переменная сессии Document). Обработчик может внести изменения в документ. После вызова обработчика документ сохраняется на сервере.

Параметры:

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

Документ назначается пользователю

Событие о том, что документ готов передаваться на мобильное устройство. Вызывается при запросе с ТСД получения документа для работы.

В серверную операцию передается назначаемый пользователю документ (переменная сессии Document). Если выполнение серверной операции прерывается (переход [прервать операцию]), назначение документа пользователю ТСД отменяется. Если отмена назначения не требуется, операция должна завершиться по переходу [завершить операцию].

Операция может внести изменения в документ.

Параметры:

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

Документ назначен пользователю

Событие о том, что документ захвачен на обработку. Вызывается в момент, когда документ был передан на ТСД для работы с ним.

В серверную операцию передается добавленный документ (переменная сессии Document). Обработчик может внести изменения в документ. После вызова обработчика документ сохраняется на сервере и отдается на обработку.

Параметры:

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

Документ изменен

Событие об изменении документа. Вызывается при сохранении документа на сервер в процессе работы на ТСД при использовании в конфигурации Mobile SMARTS действия «Сохранение документа на сервер».

В серверную операцию передается измененный документ (переменная сессии Document).

Операция может внести изменения в документ.

Параметры:

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

Документ завершен

Событие о завершении обработки документа. Вызывается при получении сервером завершенного документа с ТСД.

В серверную операцию передается завершенный документ (переменная сессии Document).

Операция может внести изменения в документ.

Параметры:

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

Документ возвращен с ТСД без обработки

Вызывается когда документ с терминала был возвращен пользователем вызовом release (вернуть документ без изменений).

В серверную операцию передается возвращенный документ (переменная сессии Document).

Параметры:

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

Документ удален

Событие об удалении документа с сервера. Удаление выполняется внешней системой.

В серверную операцию передается удаленный документ (переменная сессии Document). Отменить удаление нельзя.

Параметры:

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

Получить список документов

Событие о запросе получения списка документов с сервера. Вызывается при заходе в список документов на терминале и периодически при нахождении внутри списка.

Для того, чтобы выполнялся вызов события, в настройках типа документа в панели управления должна быть включена настройка «Показывать в списке документы на сервере — Да».

Параметры:

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

Получить документ

Событие о запросе получения документа по идентификатору или штрихкоду с сервера. Событие может использоваться совместно с событием «Получить список документов».

Также получение документа может выполняться по штрихкоду, отсканированному в окне выбора документов. В этом случае в параметрах типа документа должна быть включена настройка «Выбирать по штрихкоду с сервера — Да».

Параметры:

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