Событие сервера Mobile SMARTS «ПолучитьСписокДокументов»

Последние изменения: 11.02.2022

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

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

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

Параметры

Имя параметра Тип данных Описание
ИдПользователя string (строка) Идентификатор пользователя Mobile SMARTS, при работе которого на ТСД, произошел вызов обработчика. 
ТипДокумента string (строка) Тип документов, которые запрашиваются с терминала. Если тип документа null (неопределено) или пустая строка – запрашиваются все документы, вне зависимости от их типа.
XmlСессии string (строка) Объект сессии сервера Mobile SMARTS, сериализованный в xml. Параметр передается, только если включена настройка «Добавлять объект сессии в вызов событий»

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

В качестве возвращаемого значения ожидается коллекция описаний документов Cleverence.Warehouse.DocumentDescriptionCollection, сохраненная в виде XML.

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

Описание в панели управления:

C#
<ид. коннектора>:ПолучитьСписокДокументов

Ид. коннектора - задается в панели управления.

Например: OneC_Connector:ПолучитьСписокДокументов

Пример функции для «1С:Предприятия 8» 

Ниже приведен пример метода «ПолучитьСписокДокументов» для использования в «1С:Предприятии» с целью получения списка документов в нужном формате. Процесс формирования списка документов на стороне 1С подробно не рассматривается (в данном примере он происходит в рамках функции «ОтобратьДокументы(...)»).   

C#
Функция ПолучитьСписокДокументов(UserId, ТипДокумента, mXmlDoc = Неопределено) Экспорт StorageConnector = Новый COMObject("Cleverence.Warehouse.StorageConnector"); ДокументыТСД = Новый COMObject("Cleverence.Warehouse.DocumentDescriptionCollection"); ОтобранныеДокументы = ОтобратьДокументы(UserId, ТипДокумента); Для Каждого СтрокаДок из ОтобранныеДокументы Цикл DocDescr = Новый COMОбъект("Cleverence.Warehouse.DocumentDescription"); DocDescr.Id = XMLСтрока(СтрокаДок.Ссылка); cDescr.Name = Строка(СтрокаДок.Ссылка); DocDescr.DocumentTypeName = ТипДокумента; DocDescrs.Add(DocDescr); КонецЦикла; Результат = StorageConnector.ToXml(DocDescrs); Возврат Результат; КонецФункции

В готовой интеграции «1С:Предприятия» и Mobile SMARTS рассматриваемая функция уже добавлена в модуль основной обработки «КлеверенсТСД_ОсновнаяОбработка.epf». Если вы делаете самостоятельную интеграцию Mobile SMARTS с «1С:Предприятием» с помощью основной обработки, то вы можете использовать готовые методы.


Итогом выполнения функции «ПолучитьСписокДокументов» будет отображение документов из обработки 1С на экране мобильного устройства, подключенного к учетной системе (при работе в онлайн-режиме).

Была ли статья полезна?
Спасибо за ваш отзыв!
Отзыв
Заполните, пожалуйста, данную форму, что конкретно вы не нашли, оставьте свои комментарии о работе сайта / полезности / сложности с навигацией
0/500