Пример интеграции с 1С

В Comindware Business Application Platform присутствует возможность настраивать интеграции без помощи разработчиков, лишь силами аналитика. Для этого достаточно мышкой, используя интерфейс продукта, настроить необходимую интеграцию.

В данной статье мы рассмотрим пример создания интеграции с 1С.

1. Создайте новое подключение для синхронизации с веб-сервисом. В открывшемся окне заполните следующие поля:

• Название — имя создаваемого подключения;
• Тип исходящего подключения — в данном примере это OData;
• Адрес веб-сервиса — путь к данным с информацией;
• Тип аутентификации — в данном примере тип аутентификации «Обычная», поэтому нам необходимы имя пользователя и пароль;
• Имя пользователя — логин, с помощью которого можно получить доступ к веб-сервису;
• Пароль — пароль от пользователя;
• Версия OData — в данном примере версия V3;
• Заголовок — если есть необходимость, можно передать значение в header;
• Проверить соединение — в случае успешного соединения выдает результатом перечисление справочников из базы 1С, а в случае неуспешного соединения — сообщение «Произошла ошибка». В таком случае проверьте правильность введенных данных и наличие прав у пользователя, под которым настраиваете аутентификацию, на доступ к 1С.
• Создать.

2. Настройте интеграцию.

2.1. Перейдите в бизнес-приложение, в котором будете настраивать интеграцию, затем в раздел «Интеграции».

2.2. Нажмите кнопку «Создать». В открывшемся окне заполните следующие данные:

• Название — имя создаваемой интеграции;
• Подключение по OData — выбираем ранее созданное подключение для синхронизации с веб-сервисом, в данном примере «1С»;
• Тип — в данном примере импорт.
• Шаблон записи — шаблон записи в продукте, куда будут импортироваться данные, в данном случае «(1С) Номенклатура. Объекты»;
• Внешняя сущность — сущность, из которой будут импортироваться данные в систему, в данном случае сущность «Catalog_Номенклатура»;
• Какие объекты синхронизировать — в данном примере все;
• Тип запуска — в данном случае вручную.
• Преобразование атрибутов — таблица для настройки соответствия атрибутов;
  • Внутренние данные — атрибуты шаблона записи, в которые будут записываться импортируемые данные;
  • Внешние данные — поля внешней сущности, из которой будут импортироваться данные (в данном случае, из 1С);
  • Ключевое свойство — primary_key, первичный ключ, ограничение, позволяющее однозначно идентифицировать каждую запись в таблице данных.

2.3. Перейдите на вкладку «Настройки импорта». Заполните следующие данные:

• Зависит от — здесь выбирается другая интеграция, которая запустится до текущей интеграции, в данном случае это сделано так, потому что у объектов есть единицы измерения и перед актуализацией объектов необходимо актуализировать единицы измерения;
• Добавить новую настройку постпроцессинга — с помощью данной операции можно передавать значения в атрибуты с типом данных «Ссылка», используя уникальный идентификатор, в данном случае «primary_key»;
• Целевой атрибут — атрибут с типом данных «Ссылка», в который необходимо будет передавать значение, в данном случае «Ед.Изм.»;
• Атрибут в выбранном шаблоне — атрибут из шаблона записи, куда ссылается «Ед.изм.», в котором хранится уникальное значение, с которым будет сравниваться значение из целевого свойства;
• Атрибут в ссылочном шаблоне — атрибут из «1С_Номенклатуры.Объекты», в который мы записали уникальный идентификатор «Ед.изм.», взятый из базы 1C.

2.4. Нажмите кнопку «Сохранить».

2.5. После того как настройки сохранены, выделите галочкой настроенную интеграцию и нажмите «Запуск синхронизации».

2.6. Затем перейдите в журналы, откройте таблицу «Интеграция по OData».

При неудачных интеграциях ознакомьтесь с логами для более детальной информации об ошибках.