Технология вызова произвольных (своих) функций в интеграционной обработке вызовом из Mobile SMARTS

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

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

Реализован он за счет добавления общей функции ВызовПроизвольнойФункции в основную обработку, которая является проксирующей и вызывает написанную функцию из интеграционной обработки.

Благодаря этому не нужно изучать, как работает основная обработка и искать, где выполняются функции, в которые нужно вставить свой код. Теперь можно ограничится внесением изменений только в интеграционную обработку.

Данный функционал будет полезен партнерам «Клеверенса», внедренцам, делающим доработки, а также программистам, которые хотят добавить функционал, использующий онлайн-вызовы к 1С.

Предварительная подготовка

  1. Включить работу в режиме онлайн через web-сервисы или COM-соединение.

  2. Через конфигуратор 1С открыть интеграционную обработку и добавить в её модуль свою функцию с необходимыми входящими параметрами и возвращаемым результатом. Обязательно сделать её экспортной.

  3. Добавить вызов метода внешней системы «ВызовПроизвольнойФункции» в конфигурацию Mobile SMARTS там, где необходимо обратиться за данными в 1С, указав в параметрах имя своей добавленной функции и тип возвращаемых данных.

Настройка

  1. Для работы внешних вызовов обязательно должен быть включен онлайн-обмен с 1С.

  2. Для добавления функции, вызываемой с мобильного устройства, в интеграционную обработку, откройте конфигуратор «1С: Предприятия».


  3. Откройте интеграционную обработку из папки с базой Mobile SMARTS.


  4. Откройте общий модуль объекта интеграционной обработки и добавьте свою функцию, которая обязательно должна быть экспортной.



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

  6. Запустите панель управления Mobile SMARTS.

  7. Добавьте в нужное место конфигурации вызов внешнего метода. Настройте его, указывая имя функции, тип значения и передаваемые параметры (до 10 параметров).

Параметры функции «ВызовПроизвольнойФункции»

  • ИмяФункции (cтрока) — наименование функции в интеграционной обработке.
  • ТипВозвращаемогоЗначения (строка) — тип объекта Mobile SMARTS.
  • Параметр1.Параметр10 (произвольный) — параметры, передаваемые из Mobile SMARTS в 1С.

Рассмотрим использование данной функции на примере конфигурации 1С «Управление торговлей 11.4» и программного продукта «Склад 15». Будем считать, что подключение к «1С: Предприятию» уже выполнено и настроен онлайн-режим через web-сервисы.

Пример 1

Задача: получить описание номенклатуры из 1С по артикулу на ТСД.

Решение: создаем в интеграционной обработке экспортную функцию ПолучитьОписаниеНоменклатурыПоАртикулу, которая по входящему параметру АртикулСтрокой будет возвращать нам наименование и описание найденного товара. В случае если товар не найден, будет возвращаться строка «Товар не найден».


В панели управления Mobile SMARTS добавим поле для ввода артикула в переменную АртикулДляПоиска. Полученный результат должен выводиться через переменную ОписаниеТовара.


После ввода артикула добавим вызов метода внешней системы «ВызовПроизвольнойФункции» со следующими параметрами:

  • ПолучитьОписаниеНоменклатурыПоАртикулу — наименование нашей функции из интеграционной обработки.
  • Пустая строка, т.к. нам не нужно преобразование в объект Mobile SMARTS, ожидаемый результат — строковое значение.
  • {АртикулДляПоиска} — введенный артикул.


Перейдем к выполнению:

  1. В «1С: Предприятии» заведена номенклатура с артикулом 50976201.


  2. Вводим этот артикул в строку поиска на ТСД, после чего на экране отображается информация о товаре по данному артикулу.


Пример 2

Задача: найти товар по артикулу и отобразить на ТСД 10 последних приходных документов с этим товаром. Необходимо вывести дату, номер, контрагента и количество этого товара из документов.

Решение: создаем в интеграционной обработке экспортную функцию ПолучитьПоследниеПоступленияПоТовару, которая по входящему параметру «Артикул» будет формировать таблицу значений с колонками «Дата», «Номер», «Контрагент», «Количество».


На форме из примера 1 добавим отображение списка из коллекции «СписокДокументов».


Добавим вызов метода внешней системы «ВызовПроизвольнойФункции» со следующими параметрами:

  • ПолучитьПоследниеПоступленияПоТовару — наименование нашей функции из интеграционной обработки.
  • Cleverence.Warehouse.RowCollection, Cleverence.MobileSMARTS — т.к. нам в результате нужен объект RowCollection.
  • {АртикулДляПоиска} — введенный артикул.


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



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