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

Урок 692 из 741
Автор: Ольга Пичужкина
Сложность урока:
3 уровень - средняя сложность. Необходимо внимание и немного подумать.
3 из 5
Просмотров: 14442
Дата изменения: 16.11.2024
Недоступно в лицензиях:
Текущую редакцию Вашего 1С-Битрикс можно просмотреть на странице Обновление платформы (Marketplace > Обновление платформы).
Ограничений нет

В окне настройки интеграции объектов производится более тонкая настройка. Можно настроить:

  1. Отборы по выгружаемым из данным.
  2. Отборы по загружаемым в данным.
  3. Корректировать выгружаемые в Битрикс24 данные.
  4. Корректировать загружаемые в данные.

Тонкая настройка возможна для сущностей Бирикс24:

  • Компаний.
  • Контактов.
  • Реквизитов.
  • Банковских счетов.
  • Товаров.
  • Счетов.
  • Сделок.
  • Заказов.
  • Оплат.
  • Отгрузок.

При создании настройки синхронизации эти настройки заполняются по умолчанию. Для редактирования настроек нужно нажать на соответствующую кнопку в окне настройки синхронизации.

Алгоритм редактирования настроек идентичный для всех сущностей, поэтому рассматриваться будет тип сущности «Компания».

integration1.png

В Компании Битрикс24 из могут загружаться сущности с типом «Контрагенты» и «Организации» и наоборот. В верхней левой таблице две строки, каждая – своя настройка для каждого типа объекта . В таблице можно отключить выгрузку/загрузку конкретного типа или же обновление. Например, можно настроить так, чтобы Контрагенты синхронизировались с Компаниями, а Организации только выгружались.

Для Компаний, Контактов, Реквизитов и Банковских счетов можно указать алгоритм сопоставления при выгрузке в Битрикс24 или , который позволяет сократить количество дубликатов. Более подробное описание в главе Настройка правил сопоставления при выгрузке новых элементов.

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

Для выгрузки данных integration2.png из используется типовой механизм указания отборов. Можно задать как предопределенные отборы, так и добавить свой.

Отбор по загружаемым из Битрикс24 данным задается на вкладке Отборы загрузки данных в 1С integration3.png .

Для отбора необходимо указать ключ запроса. Ключом может быть как ключ REST-запроса, так и пользовательское поле сущности. Список ключей и пользовательских полей подгружается из Битрикс24 в момент открытия окна.

Виды сравнения поддерживаются самые распространенные: «Равно», «Не равно», «В списке», «Не в списке», «Содержит».

В поле «Значение» указывается значение, по которому сравнивается.

Если необходимо откорректировать алгоритмы заполнения данных, то при нажатии на кнопку integration4.png в окне развернется правая часть integration5.png , в которой можно корректировать алгоритмы заполнения данных.

На вкладке Выгрузка на портал integration6.png задаются алгоритмы заполнения объектов выгружаемых в Битрикс24.

«Ключ запроса» — это ключ REST API, передаваемый в Битрикс24. Источником данных для него могут быть:

  • Предопределенный алгоритм. Специальный алгоритм, реализованный модулем.
  • Фиксированное значение. Постоянное значение, которое будет всегда устанавливаться.
  • Реквизит объекта. Реквизит объекта 1С, созданный через конфигуратор .
  • Из дополнительного реквизита. Значение будет взято из значения дополнительного реквизита объекта .
  • Из дополнительного сведения. Значение будет взято из значения дополнительного сведения объекта .
  • Свой алгоритм integration7.png . Определенный алгоритм, написанный на коде .

После заполнения структуры данных, но до преобразования в REST-запрос можно отредактировать структуру данных пользовательским алгоритмом integration8.png . В примере – все Компании, заголовок которых равен «Битрикс».

На вкладке Загрузка в 1С integration9.png задаются алгоритмы заполнения объектов загружаемых в .

«Реквизит» — это реквизит объекта или его дополнительный реквизит/сведение. Источником данных для него могут быть:

  • Предопределенный алгоритм. Специальный алгоритм, реализованный модулем.
  • Фиксированное значение. Постоянное значение, которое будет всегда устанавливаться.
  • Из пользовательского поля. Значение ключа пользовательского поля, пришедшее с Битрикс24. Если тип реквизита – справочник, то значение ищется по наименованию справочника.
  • Ключ JSON. Значение ключа, пришедшее с Битрикс24. Если тип реквизита – справочник, что значение ищется по наименованию справочника.
  • Свой алгоритм Например, такой:
    Если [СтруктураДанных].Получить("name") = "Наименование" Тогда
                    [Результат] = [Объект1С].Наименование;
                Иначе
                    [Результат] = [Объект1С].ПолноеНаименование;
                КонецЕсли;
    

    . Определенный алгоритм, написанный на коде .

После заполнения объекта , но перед его записью, можно подкорректировать объект через пользовательский алгоритм integration10.png .

Также возможно сопоставлять пользовательские поля Битрикс24 с дополнительными реквизитами/сведениями . В том числе пользовательские поля Компаний, Контактов, Сделок, Счетов могут загружаться в реквизиты типа «Сотрудник» и наоборот. Окно сопоставлений открывается по кнопке «Пользовательские поля» при настройке интеграции объектов на вкладке Загрузка в 1С:

sopost_polz_pole.png



Нам жаль это слышать… Но мы постараемся быть лучше!

Мы благодарны Вам за помощь в улучшении документации.

Спасибо, мы рады что смогли помочь Вам. Ниже Вы можете оставить свой отзыв или пожелание :)
Мы стараемся сделать документацию понятнее и доступнее,
и Ваше мнение важно для нас
Курсы разработаны в компании «1С-Битрикс»