Вы просматриваете старую версию данной страницы. Смотрите текущую версию.

Сравнить с текущим просмотр истории страницы

« Предыдущий Версия 26 Следующий »

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

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

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

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


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

ВерсияДата публикацииВнесенные изменения
1.1128.05.2018Модуль интеграции обновлен до версии 1.3.1.10: добавлено дополнительное форматирование даты
1.9.229.03.2018Модуль интеграции обновлен до версии 1.3.1.9: добавлено заполнение реквизита "ВариантПриемкиТоваров" в документе "ВозвратОтКлиента" 
1.6.114.09.2017Модуль интегарции обновлен до версии 1.3.1.4
1.612.09.2017Добавлена новая версия модуля интеграции
1.408.08.2017Добавлена новая версия модуля интеграции
1.326.06.2017Добавлено описание условий выгрузки "Заказов клиента".
1.211.06.2017Актуализированы скриншоты и порядок установки и настройки
1.119.06.2017Добавлены видеоинструкции
1.003.05.2017Исходная публикация
  • Нет меток