Решение "Интеграция с 1С"

Назначение решения


Модуль предназначен для двустороннего обмена данными между ELMA365 и 1С. Поддерживаются все поставки 1С, где есть интерфейс OData

Состав решения


Решение включает в себя следующие объекты:


1. Модуль Интеграция с 1C;

2. Раздел Настройки интеграции с 1C.


Раздел Настройки интеграции с 1C состоит из следующих приложений и бизнес-процессов



Первичная настройка решения
Видео - демонстрация настройки, возможностей и работы коннектора Elma365 - 1C

1. Импортируйте готовое решение из каталога ELMA365 Store или из файла формата .e365.

2. Перейдите в раздел Администрирование > Токены и создайте токен

3. Перейдите в раздел Администрирование > Модули > Пользовательские модули и включите модуль Интеграция с 1С. В модуле Интеграция с 1С заполните настройки модуля:

Токен пользователя для обращения к API — токен, созданный в пункте 1.

4. В параметрах раздела Настройки интеграции с 1С укажите токен api, сформированный в пункте 1, а также адрес сервера Elma365



5. Настройка интеграций начинается с создания сущности "Сервер 1С" в соответствующем приложении. Следуйте инструкциям на форме.

6. Приступайте к настройке интеграций. Следуйте инструкциям на форме создания "Объекта интеграции"

Обновление установленного коннектора до актуальной версии

Для тех кто ранее использовал коннектор, нет необходимости делать первичную настройку. Необходимо произвести процесс миграции на новую версию с помощью бизнес-процесса Запуск миграции (запуск бизнес-процесса производится однократно нажатием по кнопке «Запуск миграции»).



Работа с решением

Настройка синхронизации объектов системы
Рассмотрим настройку синхронизации объектов систем на примере приложения Компании в ELMA365 и справочника Catalog_Контрагенты в 1С. Синхронизация любых других объектов настраивается похожим образом.
Чтобы настроить синхронизацию объектов/справочников между двумя системами, перейдите в раздел Настройки интеграции с 1С, откройте приложение Объекты интеграции. В правом верхнем углу нажмите кнопку + Объект интеграции.

Общие настройки



1. Заполните открывшуюся форму: выберите сервер 1С и направление интеграции, состояние. Укажите код раздела и приложения ELMA365, которое необходимо синхронизировать с 1С. Также укажите раздел 1С из которого будут загружаться данные.

Расписание запуска


1. Планирование интеграций осуществляется через виджет “Расписание запуска”



Виджет имеет следующие настройки:

· Дату начала и окончания выполнения интеграции (диапазон дат, в пределах которых будет выполнятся интеграция с указанными настройками периодичности): Запустить / Завершить

· Период повтора: Однократно, Ежедневно, Еженедельно, Ежемесячно

· При выборе Ежедневно можно задать период в днях для повтора

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

· При выборе Ежемесячно можно выбрать месяца, а также дни месяца (прим. При отсутствии такого дня (пример 30 февраля) он будет пропущен), в которые необходимо выполнять выбранную интеграцию

· Все опции кроме Однократно имеют параметр Повторять в течение дня, позволяющую настроить повтор выполнения интеграции в течение дня с заданным интервалом. Минимальный интервал - 10 минут, при установке интервала меньше, интервал будет считаться равным 10 минутам.

· Опции Ежедневно и Ежемесячно имеют параметр Только по рабочим дням, позволяющий исключить выполнение интеграций в выходные дни (прим. Обратите внимание выходные получаются из Рабочий календарь компании) Параметр позволяет выбрать одно из четырех действий, в случае попадания выполнения интеграции на выходной день: пропустить, следующий, предыдущий, ближайший. В зависимости от выбранной опции будет выбран соответственно следующий, предыдущий или ближайший рабочий день к выходному дню, либо выполнение интеграции будет пропущено.

2. По окончанию настройки необходимо нажать кнопку Сформировать правило, если правило составлено корректно, то вы увидите оповещение об успешном формировании.

В случае наличия ошибок в правиле, виджет уведомить вас об этом



Детальные настройки


1. В детальных настройках: сопоставьте поля ELMA365 и 1С, участвующие в интеграции, константные значения (при необходимости), сопоставьте ссылочные поля – те, значения которых берутся из приложений, связанных с приложением Компании.


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


2. Сохраните изменения.


Таблица “Заполнение по условию” заполняется способом аналогичным способу заполнения таблиц “Сопоставление значимых полей” и “Сопоставление ссылочных полей” (путем нажатия “+” рядом с наименованием таблицы).
В открывшемся модальном окне (см. скриншот ниже) выберите из предложенного списка поле, которое необходимо проверить на определенной условие и нажмите кнопку “Добавить поле”. Далее в таблице выберите оператор для проверки условия и введите значение, на которое будет проверяться условие. Следующим этапом выберите целевое поле, которое необходимо заполнить и введите значение для него.

Примечание:

· Для поле типа “Дата/Время” поддерживается следующий синтаксис: 2022-02-24T09:00:00+04:00

· Для поля типа “Булево” необходимо вписывать значение true или false

· Для поля типа “Число” подтипа “Дробное” необходимо вписывать значение разделяя дробную часть символом “.” (точка)



Табличная часть


1. Перейдите в приложение Табличная часть.

2. В правом верхнем углу нажмите + Табличная часть



3. В открывшемся окне укажите: объект интеграции, созданный на предыдущем шаге, код раздела и приложения ELMA365, куда будут загружаться данные, а также наименование табличной части в 1С, откуда будут загружаться данные. Также укажите код поля, которое используется для связи записи табличной части и родительского объекта

4. Заполните детальные настройки по аналогии с основным объектом интеграции


Настройка сопоставления перечисления 1C и категории в ELMA365
Рассмотрим настройку сопоставления перечисления и категории на примере приложения Валюты в ELMA365 с каталогом Catalog_Валюты в 1С. Сопоставление подобных значений для любых других объектов и табличных частей настраивается похожим образом.
Чтобы настроить сопоставление перечисления и категорий между двумя системами:


1. Перейдите в раздел Настройки интеграции с 1С, откройте приложение Сопоставление категории и перечисления.

2. В правом верхнем углу нажмите кнопку + Сопоставление категории и перечисления.


3. В открывшемся окне укажите название создаваемого объекта. Также выберите раздел, приложение и свойство с типом Категория в ELMA365

4. Нажмите кнопку Загрузить значения


5. В таблице Сопоставление значений, в колонке Значение ELMA365 появился список значений поля с типом Категория на шаге 2

6. В колонке Значение в 1С укажите соответствующее значение перечисления из 1С

7. Сохраните запись и перейдите в Настройки интеграции с 1С > Объекты интеграции

8. Создайте или откройте существующую настройку интеграции для приложения Валюты в ELMA365

9. В открывшемся окне в таблице Сопоставление категорий в поле Категория выберите запись, созданную на шаге 7. Также укажите название поля в ELMA365 и в 1С, которые содержат категорию и перечисление

10. Установите признак Используется = Да и сохраните запись


Получение только изменённых сущностей из 1С

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



Далее вкладку “Расширения” и нажатием кнопки “Добавить из файла” выбрать расширение “ИсторияИзменений”. В случае успешной установки настройка расширения закончена. После потребуется перезапустить клиент 1С.


Оправить произвольную запись в 1С



Входные параметры:


· Отправляемый элемент – запись любого приложения, которая должна быть отправлена в 1С

· Настойка интеграции – запись приложения «объекты интеграции»
Выбранный объект интеграции должен соответствовать следующим параметрам:

· Направление интеграции: [Elma ⟶  1С]

· Раздел Elma365: раздел отправляемого элемента

· Приложение Elma365: приложение отправляемого элемента

В противном случае элемент не будет отправлен
Выходные параметры


· Успешная отправка: содержит отметку “Да” в случае успешной отправки данных в 1С. Отметку “Нет” в случае неуспешной отправки в 1С

· Ошибка: текстовая информация о произошедшей ошибке по которой данные не были отправлены в 1С


Работа с фильтрами

Фильтр зависит от направления интеграции:
1) Если сущности переносятся из 1С в Elma365, то необходимо писать фильтр на языке интерфейса OData, коннектор его подставит в итоговый запрос в $filter
2) Если сущности переносятся из Elma365 в 1С, то необходимо написать строчное представление json-объекта фильтра (справка по фильтрам в Elma365)