...

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

Тема в разделе "Описание бизнес-решений", создана пользователем ssimonov, 24 ноя 2023.

  1. ssimonov

    ssimonov Новичок

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

    Модуль предназначен для двустороннего обмена данными между ELMA365 и 1С
    Состав решения

    Решение включает в себя следующие объекты:
    1. Модуль Интеграция с 1C;
    2. Раздел Настройки интеграции с 1C.
    Раздел Настройки интеграции с 1C состоит из следующих приложений и бизнес-процессов
    upload_2023-11-24_12-2-40.png
    Первичная настройка решения
    1. Импортируйте готовое решение из каталога ELMA365 Store или из файла формата .e365.
    2. Перейдите в раздел Администрирование > Токены и создайте токен
    3. Перейдите в раздел Администрирование > Модули > Пользовательские модули и включите модуль Интеграция с 1С
    4. Убедитесь, что на стороне сервера 1С настроен интерфейс OData, а также что в список доступных ресурсов включены целевые сущности. Сделать это можно получив метаданные http-get запросом по адресу: http://адрес-сервера-1С/odata/standard.odata/$metadata
    5. Настройте подключение с 1С:
    • Адрес сервера 1С — текущий фактический адрес сервера 1С, пример: "http://адрес-сервера-1С/odata/standard.odata";
    • Имя пользователя — имя пользователя для автоматического REST-интерфейса;
    • Пароль — пароль пользователя для автоматического REST-интерфейса;
    • Токен пользователя для обращения к API — токен, созданный на шаге 2.
    • Временная зона сервера 1С — для корректной обработки полей типа Дата/Время. Необходимо указать смещение времени сервера относительно UTC
    upload_2024-2-15_12-38-51.png
    Так же в дополнительных параметрах раздела Коннектора 1С необходимо указать токен api, сформированный для модуля Коннектора 1С и адрес сервера Elma365 (взятый из строки браузера, прим. этот адрес также возвращается методом System.getBaseUrl());
    upload_2024-2-15_12-37-35.png
    upload_2024-2-15_12-37-44.png

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

    Настройка синхронизации объектов системы
    Рассмотрим настройку синхронизации объектов систем на примере приложения Компании в ELMA365 и справочника Catalog_Контрагенты в 1С. Синхронизация любых других объектов настраивается похожим образом.
    Чтобы настроить синхронизацию объектов/справочников между двумя системами:
    1. Перейдите в раздел Настройки интеграции с 1С, откройте приложение Объекты интеграции.
    2. В правом верхнем углу нажмите кнопку + Объект интеграции.
      upload_2023-11-24_11-57-25.png
    3. Заполните открывшуюся форму: выберите направление интеграции, состояние, периодичность запуска. Укажите код раздела и приложения ELMA365, которое необходимо синхронизировать с 1С. Также укажите раздел 1С из которого будут загружаться данные.
      upload_2023-11-24_11-57-25.png
    4. В детальных настройках: сопоставьте поля ELMA365 и 1С, участвующие в интеграции, константные значения (при необходимости), сопоставьте ссылочные поля – те, значения которых берутся из приложений, связанных с приложением Компании.
    5. Сохраните изменения.
    6. Перейдите в приложение Табличная часть.
    7. В правом верхнем углу нажмите + Табличная часть
      upload_2023-11-24_11-57-25.png
    8. В открывшемся окне укажите: объект интеграции, созданный на предыдущем шаге, код раздела и приложения ELMA365, куда будут загружаться данные, а также наименование табличной части в 1С, откуда будут загружаться данные. Также укажите код поля, которое используется для связи записи табличной части и родительского объекта
    9. Заполните детальные настройки по аналогии с основным объектом интеграции
    Настройка сопоставления перечисления 1C и категории в ELMA365
    Рассмотрим настройку сопоставления перечисления и категории на примере приложения Валюты в ELMA365 с каталогом Catalog_Валюты в 1С. Сопоставление подобных значений для любых других объектов и табличных частей настраивается похожим образом.
    Чтобы настроить сопоставление перечисления и категорий между двумя системами:
    1. Перейдите в раздел Настройки интеграции с 1С, откройте приложение Сопоставление категории и перечисления.
    2. В правом верхнем углу нажмите кнопку + Сопоставление категории и перечисления.
      upload_2023-12-6_15-29-37.png
    3. В открывшемся окне укажите название создаваемого объекта. Также выберите раздел, приложение и свойство с типом Категория в ELMA365
    4. Нажмите кнопку Загрузить значения
      upload_2023-12-6_15-29-45.png
    5. В таблице Сопоставление значений, в колонке Значение ELMA365 появился список значений поля с типом Категория на шаге 2
    6. В колонке Значение в 1С укажите соответствующее значение перечисления из 1С
    7. Сохраните запись и перейдите в Настройки интеграции с 1С > Объекты интеграции
    8. Создайте или откройте существующую настройку интеграции для приложения Валюты в ELMA365
    9. В открывшемся окне в таблице Сопоставление категорий в поле Категория выберите запись, созданную на шаге 7. Также укажите название поля в ELMA365 и в 1С, которые содержат категорию и перечисление
    10. Установите признак Используется = Да и сохраните запись

    Вложения:

    Последнее редактирование: 15 фев 2024