Імпорт: XML

Вступ

Тип Xml читає файли xml і yml. Над полями показано: Налаштування xml, yml файлів завантаження.

Селектори за замовчуванням уже заповнені під звичайний YML Prom. Для іншої структури їх змінюють вручну або вмикають AI помічник.

Спільні налаштування постачальника описані на сторінці Постачальники.

Посилання на файл

Поле Посилання на файл, до 1200 символів. Його можна залишити порожнім і завантажувати файл у ручному імпорті.

Поруч із полем дві кнопки: око показує початок файлу, стрілка завантаження зберігає файл.

Для автовивантаження потрібне постійне посилання. Якщо файл не завантажено вручну, імпорт береться за цим посиланням.

AI помічник

Перемикач Використати AI помічника. Підказка: AI помічник допоможе атоматично підібрати налаштування для прайса та заповнить всі необхідні поля.

Якщо ключ Gemini вже заданий, за замовчуванням обрано Да. Поки помічник увімкнений, поля селекторів заблоковані.

Без ключа перемикач вимкнений і стоїть Нет. Під ним додається: Спочатку необхідно налаштувати AI: додайте GEMINI_API_KEY у ENV файл.

Помічник спрацьовує на початку імпорту. Він читає початок файлу за посиланням або з файлу ручного імпорту, заповнює селектори і сам вимикається. Наступні імпорти йдуть уже зі збереженими селекторами. Щоб підібрати їх знову, увімкніть помічник ще раз.

Якщо файл не вдалося прочитати, імпорт зупиняється з помилкою в логах.

Селектори

Кожен селектор — рядок до 200 символів. Значення за замовчуванням підставляються лише під час створення постачальника.

Обов'язкові для типу Xml:

  • Селектор id категорії товару
  • Селектор назви товару
  • Селектор роздрібної ціни товару

Решта селекторів необов'язкова. Порожній селектор означає, що це поле з файлу не береться. Текст всередині CDATA читається як звичайний текст тега.

Як вказувати

Приклад фрагмента:

<yml_catalog date="2022-04-19 12:38">
    <shop>
        <offers>
            <offer id="uniq_id" available="true">
                <name>iPhone</name>
                <price>10000</price>
                <categoryId>475</categoryId>
                <param name="Вага" unit="гр">250</param>
            </offer>
        </offers>
    </shop>
</yml_catalog>

Тег без атрибутів вказують його назвою. Для <name>iPhone</name> селектор — name.

У тега з атрибутами:

  • вміст тега — @value. Для 250 у <param> це param.@value
  • атрибут — @attributes. Для Вага це param.@attributes.name. Для id товару — @attributes.id

Обгортку товару або категорії пишуть повним шляхом через крапку. Для фрагмента вище це yml_catalog.shop.offers.offer.

Селектори товару

Блок Селектори товару. Після тире — значення для нового постачальника.

  • Селектор обгортки товару — yml_catalog.shop.offers.offer
  • Селектор id товару — @attributes.id
  • Селектор id категорії товару — categoryId, обов'язковий
  • Селектор назви товару — name, обов'язковий
  • Селектор назви UA товару — name_ua
  • Селектор роздрібної ціни товару — price, обов'язковий
  • Селектор оптової ціни товару(ціна постачальника) — opt_price
  • Селектор старої ціни товару(у разі знижки) — oldprice
  • Селектор group_id(різновиди) товару — @attributes.group_id
  • Селектор наявності(available) товару — @attributes.available
  • Значення наявності товару — true. Товар у наявності, коли значення за селектором дорівнює цьому рядку
  • Селектор попереднього замовлення(stock expected) товару — порожнє
  • Значення попереднього замовлення товару — порожнє. Товар стає передзамовленням, коли значення за селектором дорівнює цьому рядку
  • Селектор кількості товару(залишок) — stock_quantity
  • Селектор опису товару — description
  • Селектор опису UA товару — description_ua
  • Селектор виробника товару — vendor
  • Брати виробника з параметру — порожнє. Працює, коли селектор виробника порожній: сюди пишуть назву характеристики, з якої взяти виробника
  • Селектор зображення/ній товару — picture. Кілька однакових тегів збираються в список фото
  • Селектор артикула товару — vendorCode
  • Селектор країни товару — country
  • Селектор опцій товару — param
  • Селектор назви характеристики — @attributes.name
  • Селектор значення характеристики — @value
  • Селектор keywords — keywords
  • Селектор keywords UA товару — keywords_ua

Селектори категорій

Блок Селектори категорій.

  • Селектор обгортки категорії — yml_catalog.shop.categories.category
  • Селектор ID категорії — @attributes.id
  • Селектор id батьківської категорії — @attributes.parentId
  • Селектор назви категорії — @value

Категорія без id в систему не додається. Далі їх зв'язують з категоріями магазину на сторінці зв'язані категорії.

Приклад

  1. Відкрийте файл постачальника в браузері або блокноті. Кнопка з оком біля посилання показує початок файлу прямо в формі.
  2. Звірте селектори з тегами файлу або залиште значення YML і увімкніть AI помічник.

Приклад селекторів категорій. Селектори товару заповнюють так само.

Image