Как преобразовать спецификацию XML назначения в шаблон экспорта B2BLIX

Что поможет сделать это руководство

Назначение может предоставлять спецификацию XML, описывающую ожидаемую структуру и информацию о товарах. Ваша задача — преобразовать эту спецификацию в проекцию экспорта, использующую данные каталога B2BLIX.

Обычно это включает определение повторяющегося пути товара, создание необходимых выходных полей, выбор источника для каждого значения и подготовку значений, требующих расчёта или форматирования.

B2BLIX Feed создаёт XML-экспорты на основе сопоставленных данных каталога, выборок товаров для конкретного экспорта, фильтров, правил преобразования данных и настроек шаблона.

Краткий ответ

Начните с преобразования спецификации назначения в простой план полей. Для каждого поля назначения укажите:

• Имя XML-элемента и его расположение в документе.
• Является ли поле обязательным или необязательным.
• Какой атрибут B2BLIX должен предоставлять значение.
• Нужно ли рассчитывать, переформатировать, переводить или заменять значение.
• Использует ли поле фиксированное значение, одинаковое для каждого товара.
• Что должно происходить, если исходное значение пустое.

Затем вы сможете создать структуру в шаблоне экспорта и использовать правила преобразования данных для значений, которые нельзя использовать напрямую.

Изменения в активном экспорте могут повлиять на XML-файл, используемый веб-сайтом, маркетплейсом, платформой сравнения цен или другим назначением. Перед изменением рабочего шаблона проверьте текущие настройки и сгенерированный XML.

Сначала подготовьте требования назначения

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

Используйте точные имена полей и документированные форматы назначения. Не переименовывайте поле назначения только потому, что соответствующий атрибут B2BLIX называется иначе.

Разберитесь в составных частях шаблона XML

Корневые пути и пути контейнеров

Корень — это внешняя структура XML-документа. Обычно он появляется один раз и содержит коллекцию экспортируемых товаров.

Например, спецификация назначения может помещать все товары в структуру вроде catalog/products.

Путь товара

Путь товара определяет XML-элемент, который повторяется для каждого выбранного товара. Если в спецификации используется catalog/products/product, каждый экспортируемый товар записывается как отдельный элемент product по этому пути.

Имена выходных полей

Имена выходных полей — это имена XML-элементов, требуемые назначением, например ean, price, stock или title.

Они описывают структуру назначения. Они не определяют источник значения поля.

Динамические значения

Динамическое значение берётся из текущих данных товара. Оно может использовать:

• Стандартный сопоставленный атрибут, например ean, price, stock или title.
• Значение, выбранное из данных поставщика.
• Новый атрибут, созданный правилом преобразования данных, например price_for_website.

Поэтому значение может отличаться для каждого товара.

Константы

Константа — это фиксированное значение, записываемое для каждого подходящего товара. Она полезна, когда назначению требуется информация, не меняющаяся от товара к товару.

Например, для поля валюты можно использовать константу EUR, если это подходит для всего экспорта.

Используйте константу только тогда, когда значение действительно подходит для каждого затронутого товара. Фиксированное значение не следует использовать для сокрытия неполных или несогласованных данных поставщика.

Значения по умолчанию

Значение по умолчанию — это подготовленный запасной вариант, используемый, когда обычное исходное значение пустое. Значения по умолчанию уместны только в том случае, если назначение допускает такой вариант и значение остаётся точным.

Перед добавлением значения по умолчанию проверьте:

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

Создайте шаблон экспорта

Чтобы настроить структуру XML, откройте экспорты в своём аккаунте. Подробнее о настройках экспорта и интерфейсе шаблона читайте в руководстве Создание и настройка проекций экспорта XML.

1. Создайте новый экспорт или откройте экспорт, который вы подготавливаете.
2. Настройте общие параметры экспорта и выберите соответствующих поставщиков и товары.
3. Задайте повторяющийся путь товара согласно спецификации назначения.
4. Добавьте обязательные имена выходных полей назначения.
5. Свяжите каждое выходное поле со стандартным атрибутом, преобразованным атрибутом или подходящей константой.
6. Добавляйте необязательные поля только в том случае, если они содержат полезные данные и соответствуют спецификации назначения.
7. Сохраните конфигурацию и проверьте сгенерированный XML перед использованием в рабочем канале.

Используйте преобразования, когда значение нельзя экспортировать напрямую

Некоторые требования назначения можно выполнить с помощью стандартных сопоставленных атрибутов. Другие значения необходимо подготовить до добавления в шаблон.

Чтобы создать или проверить эти правила, откройте правила преобразования данных в своём аккаунте. Объяснение фильтров правил, выражений, приоритетов и преобразованных атрибутов приведено в руководстве Правила преобразования данных.

Распространённые случаи использования:

• Расчёт цены для конкретного назначения.
• Применение НДС, фиксированной или процентной наценки.
• Округление числовых значений.
• Создание названия для конкретного назначения.
• Перевод выбранного содержимого.
• Преобразование описаний HTML в обычный текст.
• Изменение регистра букв или форматирования названия.
• Объединение нескольких атрибутов в одно выходное значение.
• Использование условной логики, когда для разных товаров требуются разные значения.
• Создание дополнительного атрибута без замены исходного значения.

Когда использовать идентификаторы или коды категорий

Названия категорий могут быть длинными, переведёнными или различаться у разных поставщиков. Идентификатор категории часто удобнее использовать в фильтре или условном преобразовании, поскольку он является более коротким и единообразным ориентиром.

Например, правило может применять определённое значение только тогда, когда category id совпадает с выбранной категорией. Оно также может исключать товары из этой категории или создавать атрибут для конкретного назначения.

Чтобы просмотреть доступные категории B2BLIX и их идентификаторы, откройте карту категорий в своём аккаунте. Подробнее об иерархии категорий и связях между категориями поставщиков читайте в руководстве Интерфейс карты категорий.

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

Обрабатывайте пустые значения, HTML и специальные символы

Пустые значения

Используйте условия для пустых значений в правиле преобразования, когда результат зависит от доступности атрибута. В зависимости от требования назначения правило может создать утверждённый запасной вариант, выбрать другой атрибут или помочь определить товары, которые не следует включать.

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

Содержимое HTML

Если назначение требует обычный текст, а описание поставщика содержит HTML, используйте функцию html-to-text в правиле преобразования данных. Свяжите полученный преобразованный атрибут с полем назначения в шаблоне экспорта.

Специальные символы

Проверьте сгенерированный XML, чтобы убедиться, что названия, описания, имена производителей и другие текстовые значения отображаются правильно. Особое внимание уделите товарам, содержащим кавычки, амперсанды, буквы с диакритическими знаками или многоязычное содержимое.

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

Проверьте сгенерированный XML

После сохранения шаблона откройте общие настройки экспорта в разделе Экспорты. Войдя в аккаунт, используйте публичный URL экспорта, чтобы открыть сгенерированный XML в браузере и проверить его текущее содержимое.

Проверьте следующее:

• Внешняя структура XML соответствует спецификации назначения.
• Элемент товара повторяется по правильному пути.
• Обязательные выходные поля имеют правильные имена.
• Поля содержат ожидаемые значения товаров.
• Константы используются только там, где это предусмотрено.
• Рассчитанные и преобразованные значения присутствуют.
• Пустые значения обрабатываются согласно вашему плану.
• Небольшая выборка товаров с необычными данными также выглядит корректно.

Успешная генерация и открытие XML подтверждают, что B2BLIX создал выходной файл. Это не подтверждает, что внешний маркетплейс, веб-сайт или партнёр принял, импортировал или опубликовал файл.

Не публикуйте и не передавайте публично URL закрытого экспорта, предназначенного для конкретного клиента, а также не предоставляйте его неуполномоченным лицам.

Проверяйте отдельные товары, если результат неожиданный

Если у товара отсутствует поле, отображается неожиданное значение или товар не включён, используйте Export Checker для проверки результата на уровне товара.

Откройте проверку экспортов в своём аккаунте. Подробнее об исходных данных, информации об обработке и отображаемом XML-экспорте читайте в руководстве Проверка экспортов: просмотр данных товаров и результатов экспорта.

В зависимости от товара проверьте:

• Исходные значения поставщика.
• Сопоставленные атрибуты B2BLIX.
• Поставщика, выбранного для товара.
• Фильтры экспорта, которые могли включить или исключить товар.
• Правила преобразования, изменившие его значения.
• Итоговые атрибуты, использованные экспортом.
• Представительный XML-экспорт.

Распространённые проблемы реализации

• Неверно указано имя выходного поля. Вместо имени XML-элемента, требуемого назначением, использовано имя атрибута B2BLIX.
• Путь товара задан на неправильном уровне. Повторяющийся путь должен представлять один полный товар, а не всю коллекцию или отдельный атрибут.
• Для обязательного поля нет сопоставленного значения. Проверьте сопоставление поставщика и убедитесь, что товар содержит необходимые исходные данные.
• Рассчитанный атрибут не создан. Создайте необходимое правило преобразования данных и убедитесь, что оно включено для экспорта.
• Преобразование не применяется к нужным товарам. Проверьте условия фильтра, приоритет и настроенное в экспорте поведение остановки при совпадении.
• Константа используется там, где требуются данные конкретного товара. Замените её сопоставленным или преобразованным динамическим значением.
• Идентификаторы категорий приняты за коды назначения. Уточните, какую систему категорий ожидает назначение, и при необходимости преобразуйте значение.
• XML открывается корректно, но отклоняется внешней системой. Сравните его с обязательными полями, форматами, допустимыми значениями и правилами импорта назначения. Одна лишь генерация XML не подтверждает принятие файла назначением.

Пример: подготовка записи товара для маркетплейса

Предположим, маркетплейсу требуется один повторяющийся элемент product, содержащий ean, price, stock, title и currency.

• ean использует стандартный атрибут ean.
• stock использует текущее экспортируемое значение остатка.
• title использует сопоставленное название или преобразованное название для конкретного назначения.
• price использует преобразованный атрибут, включающий требуемую наценку и округление.
• currency использует константу eur, поскольку каждая цена в этом экспорте подготовлена в евро.

Если назначение требует описания в виде обычного текста, создайте дополнительное преобразованное описание с помощью функции html-to-text и свяжите этот атрибут с соответствующим выходным полем.

Что делать дальше

1. Преобразуйте спецификацию назначения в контрольный список обязательных и необязательных полей.
2. Убедитесь, что необходимые атрибуты поставщика сопоставлены и доступны в B2BLIX.
3. Создайте расчёты, правила форматирования, значения по умолчанию или условные значения в правилах преобразования данных.
4. Создайте путь товара XML и сопоставления полей в шаблоне экспорта.
5. Сгенерируйте XML и сравните его со спецификацией назначения.
6. Проверьте показательные товары, включая товары с пустыми или необычными значениями.
7. Используйте Export Checker, если результат для отдельного товара неясен.
8. Протестируйте файл с назначением на ограниченной выборке товаров, прежде чем расширять экспорт.

По возможности держите тестовый экспорт отдельно от рабочего процесса канала продаж. Расширение каталога только после проверки структуры и значений снижает риск публикации неверных цен, остатков, содержимого или выборок товаров.