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

Версия 1.11.0 от 25.05.2018

Содержание

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

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

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

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

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

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

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

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

Условия, при которых "Заказы клиентов" будут выгружены в мобильное приложение:

1. "Заказ клиента"" должен быть проведен.
2. Статус "Заказа клиента" в соответствии с настройкой заказов покупателей в НСИ и Администрировании:
   1. Режим исполнения заказов = "Заказ как счет" - статус Заказа не проверяется, все Заказы выгружаются.
   2. Режим исполнения заказов = "Заказ только со склада" - выгружаются Заказы в статусе "К отгрузке".
   3. Режим исполнения заказов = "Заказ со склада и под заказ" - выгружаются Заказы в статусе "К выполнению".
3. На основании "Заказа клиента" должен быть проведенный документ "Поручение экспедитору".
   1. В "Поручении экспедитору"" должен быть заполнен реквизит "Ответственный" - пользователь МП, для которого выгружается заказ.
4. На основании "Заказа клиента"" не должно быть создано не помеченных на удаление документов вида "Реализация товаров и услуг".
5. При выгрузке "Заказа клиента" выгружаются и связанные справочники: "Партнеры", "Номенклатура".
6. Пользователи из поля "Ответственный" документа "Поручение экспедитору" автоматически попадает в список пользователей для выгрузки.

Установка

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

Для включения Модуля в интерфейс типовой конфигурации УТ 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С: Предприятие" будет загружен актуальный модуль интеграции. Никаких дополнительных действий после загрузки выполнять не требуется.

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

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

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

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