Событие о запросе получения документа по идентификатору или штрихкоду с сервера. Событие может использоваться совместно с событием «Получить список документов». Обработчик события «Получить список документов» возвращает список описаний документов (Cleverence.Warehouse.DocumentDescriptionCollection). Cписок отображается в окне выбора документа на ТСД, пользователь ТСД выбирает позицию из списка, идентификатор выбранного документа передается сервером в обработчик события «Получить документ». Обработчик «Получить документ» возвращает документ Mobile SMARTS (объект Cleverence.Warehouse.Document, сериализованный в xml).Также получение документа может выполняться по штрихкоду, отсканированному в окне выбора документов. В этом случае в параметрах типа документа должна быть включена настройка «Выбирать по штрихкоду с сервера — Да».
Параметры
| Имя параметра | Тип данных | Описание |
| ИдПользователя | string (строка) | Идентификатор пользователя Mobile SMARTS, при работе которого на ТСД, произошел вызов обработчика. |
| КодДокумента | string (строка) | Идентификатор или штрихкод запрашиваемого документа. |
| ТипДокумента | string (строка) | Тип документов, которые запрашиваются с терминала. |
| Режим | int (целое число) |
=0 — получить документ по коду; =1 — получить документ по штрихкоду. |
| XmlСессии | string (строка) | Объект сессии сервера Mobile SMARTS, сериализованный в xml. Параметр передается, только если включена настройка «Добавлять объект сессии в вызов событий». |
Возвращаемое значение
Функция должна вернуть объект типа Cleverence.Warehouse.Document в виде XML или пустую строку, если документ не найден.
Событие может быть обработано модулем «Вызов серверных операций». В этом случае в серверную операцию в переменную сессии Document передается результат вызова предыдущего обработчика в цепочке обработчиков данного события (если задано несколько обработчиков). Если предыдущих обработчиков в цепочке нет или результат вызова предыдущего обработчика = null, то создается новый документ с указанным типом. Также в сессию заносятся следующие значения: DocumentTypeName (тип запрошенного документа), DocumentId (ид. или штрихкод запрошенного документа), GetDocumentMode (режим получения документа: 0 — по ид., 1 — по штрихкоду). Возвращаемое значение (документ) операция должна занести в переменную Result.
Описание в панели управления:
C#
<ид. коннектора>:ПолучитьДокумент
Ид. коннектора — задается в панели управления.
Например: OneC_Connector:ПолучитьДокумент
Пример функции
Для «1С:Предприятия 8»:
1C
Функция ПолучитьДокумент(UserId, КодДокумента, ОперацияТСД, Режим, mXmlDoc = Неопределено) Экспорт //код обработки поиска документа ... ДокументТСД = Новый COMОбъект ("Cleverence.Warehouse.Document"); //заполнение документа ТСД данными из документа 1С ... Результат = StorageConnector.ToXml (ДокументТСД); Возврат Результат; КонецФункции
