DAX-БУС. Обмен. V2.0. Техническое задание на расширения RestApi в Битрикс Управление Сайтом. 4 Общая информация 4 Модуль symmetron restapi 5

• Название: Техническое задание на расширения RestApi в Битрикс Управление Сайтом. 4 Общая информация 4 Модуль symmetron restapi 5
• Дата: 29.01.2022
• Размер: 74.23 Kb.
• Имя файла: DAX-БУС. Обмен. V2.0.docx
• Тип: Техническое задание; #345558
• страница: 7 из 8

Обновление разделов ИБ по коду из учетной системы

Эндпоинт метода: symmetron.iblock.section.renew

Входные параметры:

SECTIONS	Массив объектов для обновления данных
IBLOCK_ID/IBLOCK_CODE	ID ИБ или код
UNIQUE_FIELD_CODE	Код поля для поиска объектов для обновления из учетной системы.

Массив SECTIONS содержит набор полей аналогичный методу symmetron.iblock.section.update.

Код поля, по которому будет производится поиск дубликатов передается в параметре запроса UNIQUE_FIELD_CODE.

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

Если совладения не найдены, то необходимо создать соответствующие разделы.

Возвращаемые данные:

ADDED:{

0: {

Код поля уникального идентификатора из УС: значение,

ID: значение,

},

1: {

Код поля уникального идентификатора из УС: значение,

ID: значение,

},

},

UPDATED:{

0: {

Код поля уникального идентификатора из УС: значение,

ID: значение,

UPDATE_STATUS: true

},

1: {

Код поля уникального идентификатора из УС: значение,

ID: значение,

UPDATE_STATUS: false

},

},
}

Получение полей и свойств элемента ИБ

Эндпоинт метода: symmetron.iblock.element.fields

Входные параметры:

IBLOCK_ID/IBLOCK_CODE	ID ИБ или код
FIELD_CODE	Может быть одиночное значение или массив
PROPERTY_CODE	Может быть одиночное значение или массив

В данном случае может применяться любой из двух параметров для определения ИБ. В случае, если в запросе указаны оба параметра, то в приоритете ID.
FIELD_CODE и PROPERTY_CODE – если поля не заполнены, возвращаются данные о всех полях и свойствах инфоблока. Если указано одно или несколько значений, то возвращается информация только о выбранных полях
Свойства, у которых не прописаны коды, не выводятся.

В случае, если инфоблок является каталогом, то должны вернуться все поля, которые относятся к каталогу. Цена, остаток, тип товара, включение ндс в цену, величина ндс, базовая валюта и прочее

За основу взяты методы: CIblock:GetFields и CIblock:GetProperties

Возвращаемые данные:

{

FIELDS:

{

Код поля: {

CODE: Код поля,

NAME: название поля

IS_REQUIRED: Y/N. Обязательное или не обязательное поле

},

},

PROPERTIES:

{

Код свойства: {

ACTIVE: Активность свойства

CODE: Код поля/свойства

ID: ID поля/свойства – может не быть у полей

NAME: название поля/свойства

IS_REQUIRED: Y/N. Обязательное или не обязательное поле

MULTIPLE: Y/N – множественное или одиночное поля,

SORT – сортировка - – может не быть у полей

PROPERTY_TYPE – тип поля,

USER_TYPE – пользовательский тип поля

LIST_TYPE – тип списка

LINK_IBLOCK_ID – id ИБ, к которому привязывается свойство

DEFAULT_VALUE – значение по умолчанию

VALUES -массив доступных значений у поля с типом список

}

}

}

Пример для сайта symmetron.ru

Запрос:

/symmetron.iblock.fields /?ID=4

{

FIELDS:

{

NAME:

{

CODE: NAME

NAME: Название

IS_REQUIRED: Y

},

ACTIVE:

{

CODE: ACTIVE

NAME: Активность

IS_REQUIRED: Y,

DEFAULT_VALUE: Y

}

},

PROPERTIES:

{

ARTICLES:

{

ACTIVE: Y

CODE: ARTICLES

ID: 44

NAME: Код товара у производителя

IS_REQUIRED: N

MULTIPLE: N,

SORT : 1

PROPERTY_TYPE: S,

LIST_TYPE: L

},

DOC_AND_FILES:

{

ACTIVE: Y

CODE: DOC_AND_FILES

ID: 3077

NAME: Документация и файлы для загрузки

IS_REQUIRED: N

MULTIPLE: Y,

SORT : 500

PROPERTY_TYPE: E,

LIST_TYPE: L

LINK_IBLOCK_ID: 16

},

}

И т.д

}