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

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

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

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

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

Настройка подключения

Настройка подключения

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

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

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

Расположение раздела «Интеграции»

Расположение раздела «Интеграции»

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

Настройка интеграции в бизнес-приложении

Настройка интеграции в бизнес-приложении

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

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

Настройки импорта данных из 1C

Настройки импорта данных из 1C

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

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

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

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

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

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

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

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

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