Инструкция "Интеграция с Управлением Торговлей 11.3"

Версия 1.0 от 03.05.2017

Содержание

Общее описание

Модуль интеграции (далее Модуль) позволяет передавать из типового решения “1С: Управление Торговлей 11.3” (далее УТ 11.3) в прикладное решение “Grotem.Express” документы “Поручения экспедитору” и “Заказы клиента”, и получать из прикладного решения результаты выполнения этих “Поручений экспедитору” (документы отгрузки и оплаты).

Модуль используется совместно с типовой подсистемой доставки, реализованной в УТ 11.3. Обмен ориентируется на документы “Поручение экспедитору”, и связанные с ней документы “Заказ клиента”.

Настройка осуществляется в режиме “мастера” - последовательных действий, которые контролируют заполнение необходимых данных.

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

Модуль позволяет настроить регламентное задание и указать расписание, по которому будет выполняться обмен с сервером Grotem.Express.

Ограничения использования

1. Модуль в типовом варианте не работает для баз данных УТ11.3, использующих РИБ (распределенные информационные базы).

Установка

Скачать актуальный релиз можно скачать по ссылке Скачать

Для включения Модуля в интерфейс типовой конфигурации УТ 11.3 требуется выполнить следующие действия.

• Разместить файл *.epf на диске, куда у вас имеется доступ

• Запустить УТ 11.3 в режиме “Предприятия”.

• Перейти в раздел “НСИ и администрирование” - “Печатные формы, отчеты и обработки” - “Дополнительные отчеты и обработки” и подключить внешнюю обработку, указав файл из п.1 (меню “Создать” - выбрать файл)

• На вкладке “Команды” в открывшемся элементе “Дополнительная обработка” - выбрать пункт “Размещение” и указать раздел командного интерфейса, в котором будет размещена ссылка открытия Модуля.

• Нажать кнопку “Сохранить”.

• Зайти в раздел командного интерфейса, который был указан в размещении (п.4), найти подраздел «Сервис» и выбрать пункт «Дополнительные обработки». В появившемся окне нажать гиперссылку «Настроить список» и отметить флажком пункт «Панель управления Grotem.Express», затем нажать кнопку «ОК».

Первоначальная настройка

Настройка адреса подключения

Первый шаг в настройке Модуля - установка параметров подключения к мобильному серверу Grotem.Express. Для подключения потребуются следующие данные:

• URL-адрес, по которому доступно мобильное решение “Grotem.Express”
• пароль администратора мобильного решения (задается при создании решения и указывается в “Паспорте Клиента”).

Запустите УТ 11.3 в режиме “Предприятия” (если еще не запущена) и перейдите в подсистему, которая была выбрана в п.4 раздела “Установка” в качестве места размещения Модуля.

Запустите Модуль. Так как первоначальные настройки не заданы - откроется первый шаг мастера заполнения.

В окне требуется заполнить:

• адрес сервера - адрес или имя сервера, на котором запущен "Grotem.Mobile"
• порт сервера - порт, на котором отвечает "Grotem.Mobile" (если не указан или равен 0, то используется порт в зависимости от протокола: 80 для http, 443 для https)
• защищенное соединение - использовать http или https
• URI решения - путь, по которому опубликовано мобильное решение "Grotem.Express"
• логин администратора решения - по умолчанию admin
• пароль от мобильного решения - пароль, заданный для мобильного решения при его публикации

После ввода параметров нужно нажать кнопку “Проверить связь”. В случае успеха - будет выдано соответствующее сообщение. Если связь установить не удалось - в информационное окно будет выдана техническая информация о проблемах.

В случае - необходимости - изменить параметры для выгрузки:

• “Выгружаемый вид цен” - по этому виду будут установлены цены для номенклатуры в мобильном приложении
• “Выгружаемый вид адреса Партнера” - какой из адресов будет указываться для партнеров в мобильном приложении.

Параметры “Использовать типовой план обмена” и “Использовать внешние правила регистрации” изменять не нужно, если используется типовая конфигурация УТ 11.3. По умолчанию они включены.

Если при первоначальной настройке необходимо зарегистрировать изменения справочников к выгрузке, то необходимо установить флаг «Регистрировать изменения объектов».

Инициализация настроек

После успешной проверки связи требуется выполнить инициализацию Модуля, нажав на соответствующую кнопку “Инициализировать”.

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

Выполнение инициализации сопровождается выводом на экран сообщений о текущем шаге.

Перечень выполняемых действий:

• проверка заполнения настроек
• проверка защиты от опасных действий пользователя
• включение функциональной опции “Синхронизация данных” (из раздела “НСИ и администрирование” - "Настройка интеграции" - "Синхронизация данных" - флаг “Синхронизация данных”)
• проверка связи
• инициализация хранилища значений для настроек обмена
• регистрация узла плана обмена “Полный”
• загрузка правил регистрации для созданного узла
• получение первоначальной информации из решения Grotem.Express (значения перечислений, списка пользователей, служебных справочников) и сопоставление полученных данных с данными УТ 11.3
• первоначальная регистрация изменений для обмена

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

После выполнения инициализации Модуль готов к работе и обычно не требует дополнительных настроек.

Настройка регламентного задания

Чтобы Модуль выполнял обмен автоматически, требуется настроить регламентное задание.

Перейти в раздел “НСИ и администрирование” - “Печатные формы, отчеты и обработки” - “Дополнительные отчеты и обработки”.

В списке внешних обработок найти “Обмен данными с Grotem.Express” и открыть ее. На вкладке “Команды” в табличной части напротив пункта “Обмен данными с Grotem.Express” - установить флаг “Выполнять команду по расписанию” (иконка в виде часов).

При установке флага откроется типовое окно по настройке расписания.

Использование

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

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

Настройка новых пользователей

При обработке “Заказов клиента” и “Поручений экспедитору” Модуль анализирует, на какого пользователя назначено “Поручение” и, если пользователь отсутствует в мобильном решении, добавляет его в список:

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

Управление пользователями производится в разделе Модуля “Настройки обмена” - “Настройки выгрузки” - “Выгружаемые пользователи”. Здесь можно добавить нового пользователя, установить логин пользователя или изменить пароли (в том числе и для существующих пользователей).

Ручное выполнение обмена

Если по какой-либо причине требуется выполнить обмен вручную - можно воспользоваться кнопкой “Выполнить обмен данными”. После выполнения обменов (как вручную, так и при автоматических фоновых) обновляются статусы обмена и дата их выполнения.

Регистрация изменений

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

Описание операций:

• Зарегистрировать изменения - выполняется принудительная регистрация к обмену всех объектов, подпадающих под правила выгрузки (ВНИМАНИЕ после этой операции выгрузка может занять продолжительное время)
• Удалить регистрацию изменений - очистка списка зарегистрированных к выгрузке объектов.
• Регистрация изменений для обмена - открывает типовую обработку регистрации к обмену с установленным фильтром по выгрузке в мобильное решение.
• Получить зарегистрированные объекты - не используется (планируется получения статуса обмена)

Экспертный режим

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

Раздел в разработке...

Возврат к исходному состоянию

Если на этапе инициализации произошли ошибки или необходимость в Модуле отпала - можно удалить Модуль из системы. После удаления можно начать процедуру установки с начала.

Для выполнения операции откройте Модель из интерфейса программы и перейдите в меню “Сервис” - “Удалить данные” (доступно в экспертном режиме). Все созданные служебные объекты помечаются на удаление. После выполнения процедуры можно выполнить типовую процедуру “Удаление помеченных объектов”.

Внедрение в нетиповую конфигурацию

Раздел в разработке...

1. Добавить план обмена <ИмяПланаОбмена>
2. ОбщийМодуль.ОбменДаннымиПереопределяемый -> Процедура ПолучитьПланыОбмена() -> Добавить: ПланыОбменаПодсистемы.Добавить(Метаданные.ПланыОбмена.<ИмяПланаОбмена>);
3. Добавить общий модуль <ИмяОбщегоМодуля>.
4. Добавить подписку на событие перед записью справочников с обработчиком в общем модуле <ИмяОбщегоМодуля>: Если Не ОбщегоНазначенияПовтИсп.РазделениеВключено() Тогда ОбменДаннымиСобытия.МеханизмРегистрацииОбъектовПередЗаписью(<ИмяПланаОбмена>, Источник, Отказ); КонецЕсли;
5. Добавить подписку на событие перед записью документов с обработчиком в общем модуле <ИмяОбщегоМодуля>: Если Не ОбщегоНазначенияПовтИсп.РазделениеВключено() Тогда ОбменДаннымиСобытия.МеханизмРегистрацииОбъектовПередЗаписьюДокумента(<ИмяПланаОбмена>, Источник, Отказ, РежимЗаписи, РежимПроведения); КонецЕсли;

6. Запустить обработку "Обновление вспомогательных данных"

7. В правилах регистрации поменять имя плана обмена на <ИмяПланаОбмена>. Можно отключить использование внешних правил регистрации, тогда фитрацию данных при регистрации объектов необходимо будет реализовать в обработчиках подписок на события.

Обновление модуля интеграции

Для обновления версии тебуется выполнить следюущие шаги:

• скачать актуальную версию с сайта https://grotem.atlassian.net/wiki/pages/viewpage.action?pageId=33072157
• заменить текущую обработтку на скачанную с сайта
  • зайти в раздел "НСИ и администрирование" - “Печатные формы, отчеты и обработки” - “Дополнительные отчеты и обработки”
  • выбрать в списке текущий загруженный модуль "Панель управления Grotem Express"
  • нажать кнопку "Загрузить из файла..."
  • выбрать скачанный файл обработки

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

Видеоинструкции

Установка и настройка

Использование

Версии документа и внесенные изменения