Якорь
------crm4dev1575 ------crm4dev1575

Инструкция: структура фида Обмен с сайтами 

Якорь

...

Документ описывает, как в CRM 4DEV формируется JSON-фид для сайта через механизм Дев_ОбменССайтомОнлайн, какие поля попадают в структуру и откуда они берутся в 1С.

Актуальная целевая версия по коду: origin/develop, коммит 7ded6ad55 CRM4DEV-1575.

Важно: в origin/release, коммит f68bf6a61 CRM4DEV-1575, на момент проверки поле ceiling_height еще отличается: в JSON-ключе есть пробел в конце ("ceiling_height "). В origin/develop это исправлено на "ceiling_height".

...

-- --

Где находится код

Основная логика формирования фида:

• src/HTTPServices/RestApi/Ext/Module.bsl, обработчик feedsGET.
• src/CommonModules/RestAPI_Методы/Ext/Module.bsl, область feeds.
• src/ExchangePlans/Дев_ОбменССайтомОнлайн/

...

Основная логика формирования фида:

• src/HTTPServices/RestApi/Ext/Module.bsl, обработчик feedsGET.
• src/CommonModules/RestAPI_Методы/Ext/Module.bsl, область feeds.
• src/ExchangePlans/Дев_ОбменССайтомОнлайн/Templates/СхемаВыгрузкиДанных/Ext/Template.xml, макет СКД СхемаВыгрузкиДанных.
• src/ExchangePlans/Дев_ОбменССайтомОнлайн.xml, план обмена и табличная часть ДополнительныеРеквизитыСведения.

...

Следствие для сайтовиков: состав additional_properties[] не фиксированный в коде. Он зависит от настройки конкретного узла обмена. Если в узел добавили свойство Погреб, Теплый балкон, Номер парковки, Площадь террасы и у лота есть значение, оно попадет в этот массив. Если свойство не добавлено в узел обмена, оно не выгрузится, даже если заполнено в карточке объекта недвижимости.

...

По смыслу изменения задачи:

• удален отдельный раздел/механизм “Новые параметры” в карточке объекта недвижимости;
• новые поля должны выгружаться из основного раздела “Параметры” объекта недвижимости;
• в структуру лота добавлены/перенесены поля:
• wardrobes -> ОбъектНедвижимости.Кладовые;
• ceiling_height -> ОбъектНедвижимости.ВысотаПотолкаНедвижимости;
• view_from_the_windows -> ОбъектНедвижимости.ВидИзОкон;
• side -> ОбъектНедвижимости.Сторона.

Технически в origin/develop эти поля берутся из ВремНедвижимость.ОбъектНедвижимости.<Реквизит>, то есть из реквизитов объекта недвижимости, а не из старого отдельного раздела “Новые параметры”коде. Он зависит от настройки конкретного узла обмена. Если в узел добавили свойство Погреб, Теплый балкон, Номер парковки, Площадь террасы и у лота есть значение, оно попадет в этот массив. Если свойство не добавлено в узел обмена, оно не выгрузится, даже если заполнено в карточке объекта недвижимости.

Якорь
-- --

Важные нюансы контракта

1. complexe написано с буквой e на конце. Это текущее имя поля в фиде. Если сайт ожидает complex, потребуется отдельное изменение контракта.
2. Balconies начинается с заглавной буквы. Это текущее имя поля в фиде.
3. В sections[] нет отдельного номера секции. Есть только id и name.
4. additional_properties[] динамический и зависит от настройки узла обмена.
5. Часть числовых значений может сериализоваться как число, а часть как строка, потому что в коде местами используется XMLСтрока(...) или Строка(...).
6. Даты commissioning_period и construction_completion сериализуются через ЗаписатьДатуJSON(..., ФорматДатыJSON.ISO).
7. description, address, images и часть файлов ограничиваются ПОДСТРОКА(..., 1, 1000) в запросах.

Якорь
--- ---

...

Якорь
1-commissioningperiod--constructioncompletion--- 1-commissioningperiod--constructioncompletion---

1. commissioning_period и construction_completion: в чем разница?

...