Перейти к содержанию

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

  • Актуально для: 3.5

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

Рассмотрим пример создания интеграции с 1С.

1. Создайте канал связи.

Сначала необходимо создать канал связи для синхронизации с веб-сервисом. Для этого перейдите в Глобальные настройки, затем в раздел Каналы связи. Нажмите кнопку «Создать», в появившемся окне выберите вариант «Канал связи для синхронизации с веб-сервисом».

В открывшемся окне заполните следующие поля:

Настройка канала связи

  • Имя канала связи;
  • Тип исходящего подключения  в данном примере это Odata;
  • Адрес веб-сервиса  путь к данным с информацией;
  • Тип аутентификации  есть три вида:
    • без аутентификации, при его выборе не требуется имя пользователя и пароля
    • Windows
    • Basic. В данном примере тип аутентификации Basic, поэтому нам необходимы имя пользователя и пароль;
  • Имя пользователя – логин, с помощью которого можно получить доступ к веб-сервису;
  • Пароль  пароль от пользователя;
  • Формат данных  есть два варианта xml или json, в данном примере xml;
  • Версия Odata  есть 3 версии, которые поддерживает платформа V4, V2, V3, в данном примере версия V3;
  • Заголовок  если есть необходимость, можно передать значение в header;
  • Операция «Проверить соединение»  в случае успешного соединения выдает результатом перечисление справочников из базы 1С, а в случае неуспешного соединения - «Произошла ошибка.». В таком случае проверьте правильность введенных данных и наличие прав у пользователя, под которым настраиваете аутентификацию, на доступ к 1С.
  • Операция «Сохранить».

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

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

Раздел интеграций

Затем нажмите кнопку «Создать».

Настройка интеграции

В открывшемся окне заполните следующие данные:

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

Затем переходим на вкладку импорт.

Настройки импорта

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

Сохраняем настройки.

Как происходит постпроцессинг?

В «преобразовании полей», в котором мы маппим данные, необходимо записать идентификатор единиц измерения в новое созданное поле «Единица измерения из 1C», которое затем мы сравниваем в настройках постпроцессинга с уникальным идентификатором из единиц измерения «Ед.изм.UID 1С», и проставляем в ссылке «Ед.изм.» необходимое нам значение.

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

Затем переходим в журнал.

Журнал интеграции

В случае неудачной настройки, статус интеграции будет «Прерван по ошибке».

В случае частично удачной выполненной интеграции, статус будет «Завершена с предупреждениями».

В случае успешной интеграции, статус будет «Завершена успешно».

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

Исследования осуществляются <br>ООО «Колловэар» при грантовой <br>поддержке Фонда «Сколково»
Comindware