Интеграция ELMA365 и 1С без кода

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

Коннектор 1С к ELMA365 от Onellect - готовое решение для автоматической двусторонней интеграции учетной системы 1С и платформы ELMA365. Он обеспечивает надежный и прозрачный обмен данными о клиентах, документах и справочниках без дублирования и ручного ввода (по расписанию или вручную).

Интеграция повышает целостность и актуальность данных, снижает риск ошибок и сокращает время обработки первичной документации. Обновленная версия Коннектора 2.0 отличается удобной настройкой, стабильной работой и гибкой адаптацией под бизнес-процессы.

Настройка интеграции выполняется через интуитивный интерфейс без написания кода: достаточно установить коннектор, указать параметры подключения и правила синхронизации. Решение поддерживает все поставки 1С с интерфейсом OData.

>>>Возможности коннектора 1С к ELMA365:

• Настройка связи между сущностями в 1С с приложениями ELMA365.   

• Настройка частоты и приоритета запуска передачи данных между системами.

• Настройка списка полей для осуществления по ним процессов дедупликации.      

• Возможность обмена файлами между системами.  

• Возможность автоматического создания иерархических списков в ELMA365 и папок в 1С.  

• Возможностью сопоставления пользователей систем.  

• Активация и деактивация обмена данными для определенного объекта интеграции.   

• Возможность ручного запуска синхронизации данных для определенного объекта.

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

>>> Ключевые преимущества Коннектора 2.0:

Упрощенный интерфейс настройки.
Переработанный интуитивно понятный интерфейс, обеспечивающий простоту настройки.   

Дополнительные параметры в настройках модуля.
Расширенные параметры позволяют проводить более точную и гибкую настройку процессов интеграции. Например, флаг USE_SLOW_MODE - включение замедления процессов модуля, полезен для редакции системы SaaS, чтобы исключить интенсивную нагрузку на стенд и позволит не достигать установленных лимитов. 

Сопоставление сложных типов полей.
Поддержка сопоставления полей сложных типов ELMA365, таких как телефон, email, Ф.И.О. и категории.

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

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

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

Ограничения по редакциям ELMA365**.** 
Коннектор может работать в редакции SaaS Standard, но с ограничениями, связанными с лимитами на запросы к API. В редакции Enterprise коннектор работает без ограничений.
Ограничения по редакциям 1С.
Коннектор предназначен для работы в конфигурациях, где есть интерфейс OData.
Начиная с версии 8.3.5, в платформе «1С:Предприятие» поддерживается доступ через протокол OData к данным информационных баз «1С:Предприятия».
Так же возможны ограничения в работе с файлами в отдельных конфигурациях.
Описание предыдущей версии решения Коннектор к 1С доступно здесь.

>>> Коннектор успешно протестирован и работает с данными конфигурациями 1C:

• 1С:Бухгалтерия предприятия

• 1С:ERP. Управление предприятием

• 1С:Управление холдингом (УХ)

• 1С:Управление производственным предприятием (УПП)

• 1С:Зарплата и управление персоналом (ЗУП)

• 1С:Управление торговлей (УТ)

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

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

>>> Начало работы с коннектором:

Вся настройка интеграции выполняется в NoCode-режиме. Это означает, что Вам не потребуются услуги программистов, чтобы создать надежный «мост» для обмена контрагентами, номенклатурой, документами и другими данными.
В этой инструкции Вы найдете последовательные шаги по настройке и запуску коннектора. Четкое следование им позволит Вам быстро настроить интеграции и сосредоточиться на бизнес-задачах, минимизировав ошибки связанные с их настройкой.

Шаг 1-Первичная настройка

Перед началом работы с коннектором 1С, необходимо выполнить действия:

1. Перейдите в раздел Администрирование > Токены и создайте токен или воспользуйтесь кнопкой ниже для автоматической генерации. Далее скопируйте сгенерированный токен и перейдите к пункту 2

2. Перейдите в раздел Администрирование > Модули > Пользовательские модули и включите модуль Коннектор к 1С 2.0

3. В модуле Коннектор к 1С 2.0 заполните настройки модуля:
В разделе Общие настройки в поле Токен api добавьте токен, созданный в пункте 1

Шаг 2 - Добавьте сервер 1С

Создайте сервер 1С в приложении "Сервера 1С".

1.Укажите "Данные для подключения".

2. С помощью виджета "Временная зона сервера 1С" вы можете установить смещение по времени относительно часового пояса UTC. Это необходимо для корректного преобразования дат при их передачи между системами.

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

3. После указания данных для подключения вы можете проверить соединение с помощью кнопки "Проверить соединение".

4. После того, как сервер добавлен, запустите виджет загрузки метаданных с помощью кнопки "Загрузить метаданные".
Дождитесь выполнения процесса и проверьте полученные данные в "Конфигурация данных > Метаданные".

Обратите внимание!
> В случае возникновения ошибки при загрузке, появления записи об ошибке в разделе «Мониторинг и анализ > Логи» или отсутствия объектов в разделе «Конфигурация данных > Метаданные» проверьте объём загружаемых метаданных, он не должен превышать 8 МБ.

5. С помощью кнопки "Генерация технических интеграций" вы можете автоматически создать одну техническую интеграцию для стандартного справочника «Пользователи» - это минимально необходимая настройка, позволяющая настроить загрузку пользователей из 1С.

Если в вашей базе роль пользователя выполняет другая сущность, обязательно настройте интеграцию именно с этим справочником. Подробнее см. Шаг 3 > Вкладка "Сопоставление полей".



Шаг 3 - Добавьте интеграцию

Добавьте интеграцию в приложении "Интеграции".



1.Укажите общие настройки интеграции

Сервер 1С - выберете нужный сервер. Выбор осуществляется из приложения "Сервера 1С" , подробнее о создании сервера см. Шаг2.
Направление интеграции - укажите нужное направление, доступные варианты:

• 1C ⟶ ELMA365
• ELMA365 ⟶ 1C

Объект 1С - укажите объект 1С для интеграции.
Раздел/Приложение - укажите раздел/приложение ELMA365 для интеграции.

2. Выберите режим запуска

Планирование интеграций осуществляется через виджет "Параметры запуска":

• Ручной - запуск производится по кнопке на форме объекта интеграции "Запустить".
• Автоматический - коннектор начнет планировать и запускать интеграцию согласно указанным в настройках расписания, отображая в последующем дату следующего запуска интеграции.

Обратите внимание!
> При выборе автоматического запуска интеграции, в боковой панели отобразится таймер обратного отсчета времени до ближайшего запуска интеграции. Если такой таймер не отобразился - интеграция не запустится, необходимо проверить настройки интеграции.



Вы можете указать:

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

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

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



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



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



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

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

Для активации расписания нажмите кнопку "Сформировать".

3. Укажите детальные настройки

Вкладка "Фильтр данных".

Следуя инструкции синтаксиса фильтра, вы можете ввести ограничение данных для интеграции.



Синтаксис фильтра зависит от направления интеграции:

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

Примеры фильтров

1. 1С - DeletionMark eq false (Объекты без пометки на удаление)
2. Elma365 - { "like": [ {"field": "__name"}, {"const": "ООО"} ] } (Карточки содержащие ООО в названии)

Вкладка "Загрузка связанных объектов".

Укажите связанные объекты, если требуется их загрузка.



Виджет позволяет получить данные из связанных объектов в одном запросе. Например, если у вас есть запрос на получение продукта, вы можете использовать Загрузка связанных объектов, чтобы сразу получить информацию о его поставщике.

Предупреждение!
> Загрузка связанных объектов создает дополнительную нагрузку на систему 1С. Будьте осторожны при использовании и не добавляйте слишком много полей. Имеется риск, что при получении слишком большого числа вложенных сущностей интерфейс OData вернет ошибку.

Вкладка "Сопоставление полей".

Сопоставьте интегрируемые поля 1С и Elma365.



Простые поля - для указания сопоставления поля в Elma 365 с полем в 1С.
Доступные типы данных:

• Со стороны Elma365: Строка, Число, Дата (все подтипы), Булево, Деньги, Категория, Email, Телефон, ФИО.
• Со стороный 1С: Строка, Число, Дата, Булево, Guid (идентификатор).

Ссылочные поля - поля, значениями которых являются ссылки на другие объекты в информационной базе, которые необходимо получить во время интеграции.
Доступные типы данных:

• Со стороны Elma365: Приложение, Пользователь.
• Со стороный 1С: Guid (идентификатор).

Сопоставление пользователей 1С и Elma 365 (сопоставление 1к1)
> В коннекторе есть специальный справочник "Пользователи", который позволяет связать пользователя Elma 365 с соответствующей сущностью в 1С. Тип сущности зависит от структуры и настроек вашей базы 1С.
После добавления Сервера 1С, становится доступной кнопка «Генерация технических интеграций». Она автоматически создаёт одну техническую интеграцию для стандартного справочника «Пользователи» — это минимально необходимая настройка.
Если в вашей базе роль пользователя выполняет другая сущность, обязательно настройте интеграцию именно с этим справочником.
В некоторых конфигурациях 1С роль пользователя могут выполнять:

• физические лица.
• другие встроенные справочники.
• кастомные справочники.

Вы можете самостоятельно настроить интеграции для этих справочников.
Когда интеграция подключена:

• Данные выбранного справочника 1С загружаются.
• Коннектор сопоставляет пользователя Elma 365 с объектом этого справочника.
• Это обеспечивает гибкость и корректное маппирование под особенности вашей конфигурации 1С.

Также, такая интеграция может работать в двустороннем режиме. Это означает, что если в сущности 1С назначена роль или указано поле, в которое требуется подставить пользователя, — на это место может быть автоматически подставлен соответствующий пользователь Elma 365, сопоставленный через интеграцию. Таким образом обеспечивается корректная передача данных и действий между системами в обоих направлениях.


Константные значения - для указания константных значений, которые будут заполнены при выполнении интеграции.
Доступные типы данных:

• Со стороны Elma365: Строка, Число, Дата (все подтипы), Булево, Деньги, Категория, Email, Телефон, ФИО, Приложение, Пользователь, Произвольное приложение, Директория.
• Со стороный 1С: Строка, Число, Дата, Булево, Guid (идентификатор).

При нажатии на значок шестерёнки осуществляется переход в Настройки сопоставления:
Укажите элементы приложения, которыми необходимо заполнить поле.

Обратите внимание!
> Для поля "Приложение" необходимо выбирать элементы из целевого приложения, в противном случае они не будут заполнены!

Заполнение полей по условию - это настройка, которая позволяет при интеграции автоматически подставлять значения в нужные поля, но только если выполняются заданные условия.
При нажатии на значок шестерёнки осуществляется переход в Настройки сопоставления:



В столбце «Поле» выберите параметр, который нужно проверить на соответствие условию.
Выберите тип условия. Доступные варианты:

• И
• ИЛИ
• И НЕ
• ИЛИ НЕ

В столбце «Целевое значение» определите, чем будет заполняться основное поле:

• Из контекста — выбрать значение из доступных данных.
• Значение — указать постоянное (константное) значение.

Для значений в полях «Поле» и «Целевое значение» доступны следующие типы данных:

• Строка
• Число (целое/дробное)
• Булево
• Дата (дата/время/дата-время)
• Категория
• Деньги

Если все указанные условия дают истину, к выбранному полю будет применено заданное Целевое значение.

Табличные части - для указания сопоставления поля с типом Таблица/Приложение Elma 365
с табличной частью 1С.
При нажатии на значок шестерёнки осуществляется переход в Настройки сопоставления:
В таблице в качестве полей отображаются либо поля самой таблицы, либо поля выбранного приложения.
Сопоставьте поля Elma365 с полями 1С. Таблица заполняется по аналогии с основной таблицей.

Файлы - для указания полей с типом файл или изображение.
При нажатии на значок шестерёнки можно задать правила отбора файла: по названию/по расширению.
Создание масок строковых полей с помощью регулярных выражений
Передача файлов осуществляется в следующих конфигурациях:

• Бухгалтерия

• ERP

• Управление холдингом

• Управление торговлей

• Зарплата и управление персоналом

Если в списке нет нужной конфигурации!
> Если Вашей конфигурации нет в списке, либо под нее требуется доработка, наша команда может доработать коннектор под Вас.

Для передачи файлов необходимо в настройках автоматического REST-сервиса 1С, в объектах, предоставить доступ к:



Например, для файлов объекта Контрагент, необходимо предоставить доступ к "Присоединенные файлы (Контрагенты)"

• РегистрСведений > ДвоичныеДанныеФайлов (применимо к конфигурациям: Бухгалтерия, ERP, Управление холдингом)

Данная настройка доступна только через расширение {РедактированиеСоставаСтандартногоИнтерфейсаOData 2.epf}.
Достаточно его скачать и перенести в окно с открытой 1С, выбрать нужный объект и нажать "Сохранить".
Или, можете обратиться к специалисту по 1С для активации объекта.

• Справочник>ХранилищеДвоичныхДанных

Применимо к конфигураци: Зарплата и управление персоналом.



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

Обратите внимание!
> Поиск дублей выполняется только между системами. Если в исходной системе уже существуют дубли сущностей, они будут переданы и интегрированы без изменений.

Вкладка "Прочие".
При создании сущностей в Elma 365 в данной вкладке указываем, нужно ли генерировать событие о том, что эта сущность была создана.

Дополнительные возможности

Дополнительные настройки в модуле.

Модуль Коннектор к 1С 2.0.
С помощью модуля «Коннектор к 1С» вы можете дополнительно настроить его работу.
Например:

• если вам нужно изменить размер пакета данных, включите и настройте параметр CUSTOM_PACKAGE_SIZE;
• если требуется включить режим отладки, активируйте параметр DEBUG_MODE.

Эти настройки помогают гибко управлять поведением коннектора в зависимости от ваших задач.



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



Статистика интеграций.
Виджет для мониторинга выполнения интеграционных процессов между системами, позволяет отслеживать статусы, находить проблемы и анализировать временные метки выполнения операций.
Виджет состоит из двух вкладок:
Вкладка "Сводная информация" - панель дашборда для отображения числовой статистики интеграций. Статистика обновляется в реальном времени на основе данных приложения.




Вкладка "Детальная информация" - виджет отображает детальную информацию о выбранной интеграции: дату запуска, дату завершения, статистику и логи.



Логи.
В приложении фиксируются события, происходящие во время работы интеграций по следующим уровням:

• Отладка

• Информация

• Предупреждение

• Ошибка

• Критическая ошибка

Этот функционал помогает быстро находить и исправлять ошибки, а также проводить диагностику, если что-то в интеграции работает не так, как ожидается.



Миграция с решения "Коннектор к 1С" версии 1.0

Чтобы корректно перейти на новую версию коннектора и избежать ошибок в работе процессов,
пожалуйста, выполните следующие шаги:

1. Заново настройте интеграции в новом коннекторе.

В новой версии коннектора необходимо создать и настроить все интеграции заново,
ориентируясь на настройки прежней версии коннектора:

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

Обратите внимание!
> Прежнюю версию коннектора можно использовать как пример, но настройки из него не переносятся автоматически.

2. Выключите модуль «Коннектор к 1С» версии 1.0 и скройте раздел.

После того как новый коннектор настроен и работает:

• отключите старый модуль в настройках системы;

• скройте раздел интерфейса коннектора версии 1.0, чтобы пользователи не продолжали им пользоваться.

3. Проверьте процессы и замените блоки с прежней версией коннектора.

Обязательно убедитесь, что в ваших бизнес-процессах не используются блоки прежней версии коннектора.
Например:

• отправка сущности в 1С;
• другие действия, связанные с прежним модулем.

Если такие блоки используются:

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