Интеграция ELMA365 и 1С без кода (Архив)

В данной статье опубликовано описание прежней версии решения. Описание новой версии решения Коннектор к 1С 2.0 доступно здесь.

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

Эффективное взаимодействие между учетной системой и платформой автоматизации бизнес-процессов — ключевой фактор повышения операционной эффективности. Onellect разработал коннектор для интеграции 1С и ELMA365, обеспечивающий надежный и прозрачный обмен данными между системами.
Решение позволяет организовать синхронизацию данных в обе стороны, что исключает необходимость повторного ввода информации и минимизирует риски возникновения ошибок. В результате обеспечивается высокая целостность данных, контроль над их актуальностью и повышается производительность сотрудников, работающих с клиентами и первичной документацией.

Основные функциональные особенности:
* Управление взаимодействиями: сопряжение справочников и табличных частей 1С с приложениями и сущностями ELMA365.
* Гибкий запуск процессов: определение периодичности, расписания, частоты и приоритетов.
* Контроль целостности: настройка правил сопоставления объектов и процессов дедупликации данных по заданным полям.
* Соответствие: сопоставление категорий в ELMA365 с перечислениями в 1С.

Интеграция 1С и ELMA настраивается через интуитивный интерфейс без написания кода, что ускоряет внедрение, снижает затраты и упрощает поддержку. Для запуска полноценного обмена необходимо установить коннектор, указать параметры подключения к обеим системам и определить правила синхронизации. В коннекторе поддерживаются все поставки 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. Откроется окно добавления табличной части



4. Заполните необходимые поля:

1. Общие настройки:
   1. Интеграция - выберите существующую интеграцию из списка объектов интеграции.
   2. Вариант синхронизации:
      • В приложение - строки табличной части 1С будут созданы как элементы приложения.
      • В таблицу - строки табличной части 1С будут созданы как строки в таблице.
   3. Активна? - от выбора значения зависит будет ли использоваться данная табличная часть в объекте интеграции при запуске
   4. Раздел Elma365 - доступно при выборе "Варианта синхронизации" = В приложение. Поисковое поле. Необходимо выбрать раздел, в котором находится приложение для хранения табличной части.
   5. Приложение Elma365 - доступно при выборе "Варианта синхронизации" = В приложение. Поисковое поле. Необходимо выбрать приложение для хранения табличной части.
   6. Раздел 1С - поисковое поле. Необходимо выбрать раздел 1С содержащий табличную часть.
      ВАЖНО: Сам раздел не содержит табличную часть, необходимо выбирать именно табличную часть.
      Пример:
      Catalog_Контрагенты - каталог не содержит табличную часть.
      Catalog_Контагенты_КонтактнаяИнформация - табличная часть каталога.
      
      
   7. Поле для связи с родительской записью - выберите поле приложения Elma365, выбранного Вами при создании Объекта интеграции. В этом поле должна находиться ссылка на приложение, выбранное для хранения "Табличной части". Тип поля = приложение.
   8. Поле табличной части в родительской записи - доступно при выборе "Варианта синхронизации" = В приложение. Выберите поле приложения Elma365, выбранного Вами на текущей форме. В этом поле должна находиться ссылка на приложение, выбранное для хранения "Объекта интеграции". Тип поля = приложение.
   9. Табличная часть в 1С - выберите поле каталога 1С, являющегося целевой табличной частью.
2. Детальные настройки:
   1. Сопоставление значимых полей - таблица для сопоставления полей которые необходимо получить во время интеграции. Для добавления новой строки при выборе "Варианта синхронизации" = В приложение. необходимо нажать на "+". Откроется модальное окно сопоставления полей. Необходимо сопоставить поле в Elma с полем в 1С и нажать кнопку "Добавить". При выборе "Варианта синхронизации" = В таблицу. Поля 1C и Elma заполнятся вручную.

В результате получаем строку в таблице с сопоставленными полями и чек-боксами для настройки
​

• Используется* - обязательное поле. Заполнено по умолчанию. Возможность указать будет ли поле заполняться при интеграции.
• Используется для поиска дублей - возможность установить поле в проверку на дубли, коннектор получает значение из поля исходной системы и смотрит есть ли уже такое же значение в поле принимаемой системы

2. Сопоставление ссылочных полей - таблица для сопоставления ссылочных полей(поля, значениями которых являются ссылки на другие объекты в информационной базе), которые необходимо получить во время интеграции. Работа аналогично Сопоставление значимых полей
3. Константные значения - таблица для указания константных значений, которые будут заполнены при выполнении интеграции
4. Сопоставление категорий - необходимо выбрать элемент приложения "Сопоставление категории и перечисления"
5. Колонки идентификации - доступно при выборе "Варианта синхронизации" = В приложение. Необходимо указать поля, по которым интеграция найдет уникальный элемент приложения и обновит его. Полей может быть несколько. Обратите внимание, что поля из колонок идентификации должны быть добавлены в одну из таблиц сопоставления полей.​

5. Нажмите кнопку "Сохранить".
6. Созданная "Табличная часть" добавиться в указанный Объект интеграции.


>>> Настройка сопоставления перечисления 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)


>>> Бесплатная версия коннектора

Вы можете получить бесплатный триал коннектора на 2 недели с полным функционалом в каталоге ELMA365 Store