Готові шаблони — XML/YML, CommerceML, XLSX майданчиків EVO — розраховані на відомі формати, де колонки заздалегідь відомі. Але постачальники й системи обліку часто віддають файли зі своєю, довільною структурою: свої назви колонок, свій порядок, свої позначки. Для таких файлів є універсальний імпорт.
Його ідея проста: програма читає ваш файл, а ви самі кажете, яка колонка чи вузол файлу відповідає якому полю каталогу. Один раз розмітили — і далі файли того самого формату вантажаться за цим шаблоном без повторного налаштування. Це один зі способів із загального огляду завантаження даних — найгнучкіший, але й той, що вимагає трохи ручної роботи на старті.
Коли потрібен універсальний імпорт
Універсальний імпорт беруть тоді, коли готового шаблону під ваш файл немає. Це трапляється частіше, ніж здається: постачальник надіслав власний прайс у Excel зі своїми колонками; облікова система вивантажила CSV із крапкою з комою замість коми; сайт віддав XML із вузлами, названими не так, як у стандартному YML. У всіх цих випадках готовий шаблон не знатиме, де ціна, а де назва — і саме тут стане в пригоді ручна розмітка.
І навпаки: якщо ваш файл — це стандартний YML, обмін 1С чи вивантаження prom.ua, універсальний імпорт не потрібен. Візьміть готовий шаблон — він упізнає поля сам, і налаштовувати нічого не доведеться.
Які формати читає
Універсальний імпорт розуміє чотири типи файлів: XML (з довільною структурою вузлів), CSV (текстова таблиця з роздільником), XLS і XLSX (книги Excel). Тип файлу ви вказуєте на початку, а далі налаштування залежить від нього: для таблиці — з якого рядка починаються дані й де заголовки, для CSV — який роздільник між колонками, для XML — який вузол вважати одним товаром.
Головна ідея — зіставлення полів
Серце універсального імпорту — таблиця зіставлення. Ліворуч у ній — поля каталогу Elbuz (назва, ціна, артикул, категорія, картинки, наявність, опис, характеристики), праворуч — те, звідки їх брати у вашому файлі: назва колонки або вузол. Ви проходите по потрібних полях і вказуєте джерело для кожного. Поля, які вам не потрібні, можна лишити порожніми — вони просто не завантажаться.
Це та сама робота, яку в готових шаблонах програма робить за вас. Тут ви робите її руками — зате під будь-який файл, навіть саморобний. І робити її треба лише раз: розмітка зберігається в шаблоні.
Які поля каталогу можна заповнити
Набір полів, у які можна вантажити дані, — це поля картки товару базового каталогу: назва, артикул, ціна (причому не одна — базова, стара, закупівельна), наявність і залишок, категорія, виробник, картинки, короткий і повний опис, а також характеристики. Перелік той самий, що ви бачите в картці товару, тож зіставляти є з чим. Якщо якогось поля у вашому файлі немає, просто не зіставляйте його — картка отримає порожнє значення, і це нормально. Головне — зіставити ключове: назву, ціну, артикул і наявність, без яких товар неповний.
Де це у програмі
У вікні імпорту створюєте шаблон і обираєте тип «Універсальний (XML/CSV/XLS)». Вказуєте файл — завантаженням з комп'ютера або посиланням. Далі відкривається форма розмітки: обираєте формат, налаштовуєте параметри читання (роздільник, вузол товару, рядок заголовків) і зіставляєте поля. Збережений шаблон можна запускати скільки завгодно разів на файлах тієї самої структури.
Як налаштувати розмітку крок за кроком
Спочатку завантажте зразок файлу — той самий, який далі приходитиме регулярно. Оберіть його тип: XML, CSV, XLS чи XLSX. Для CSV укажіть роздільник (кома, крапка з комою, табуляція); для Excel — з якого рядка йдуть дані; для XML — який вузол відповідає одному товару. Після цього програма покаже, які колонки чи вузли є у файлі, і ви зіставите їх із полями каталогу: ця колонка — назва, ця — ціна, ця — артикул, і так далі.
Обов'язково перевірте результат на кількох товарах, перш ніж вантажити весь файл. Помилка в розмітці — скажімо, переплутані ціна й артикул — на десятку товарів помітна одразу, а на десяти тисячах виправляти її вже боляче.
Категорія як шлях
Окремо варто сказати про категорії. У багатьох файлах розділ товару записаний одним рядком-шляхом, наприклад «Електроніка / Смартфони / Аксесуари». Універсальний імпорт уміє розбирати такий шлях і будувати з нього дерево категорій: кожна частина між роздільниками стає рівнем. Для цього в зіставленні є окреме поле «категорія (шлях)». Так навіть із пласкої таблиці виходить нормальна структура розділів, а не звалище товарів в одній купі без поділу.
Збереження й повторне використання
Уся розмітка зберігається всередині шаблону. Тому наступного разу, коли постачальник надішле свіжий файл тієї самої структури, вам не треба нічого налаштовувати заново — просто підставте новий файл і запустіть. А якщо файл приходить за постійним посиланням, шаблон можна поставити на розклад, і оновлення відбуватиметься саме, як і з готовими форматами. Тому універсальний імпорт — не разова морока, а такий самий постійний інструмент: повозились із розміткою один раз, а користуєтесь нею місяцями, доки джерело не змінить формат.
Часті труднощі
Найчастіша проблема з CSV — роздільник. Якщо колонки «злиплися» в одну, майже завжди вказано не той роздільник: спробуйте крапку з комою замість коми або навпаки. Друга — кодування: текстові файли мають бути у UTF-8, інакше кирилиця поламається. Для XML типова помилка — не той вузол товару: якщо завантажилось замало або забагато позицій, перевірте, який вузол ви позначили як один товар. І пам'ятайте: універсальний імпорт переносить рівно те, що є у файлі й що ви зіставили, — незіставлене поле лишиться порожнім, а не заповниться саме.
Не намагайтеся зіставити геть усі поля одразу. Почніть із головного — назва, ціна, артикул, наявність, категорія. Цього досить, щоб товари завантажились і ожили. Опис, характеристики й решту додасте пізніше, коли переконаєтесь, що базова розмітка правильна й товари стали в каталог як треба.
Часті питання
Коли брати універсальний, а коли готовий шаблон?
Якщо файл стандартний (YML, обмін 1С, вивантаження prom.ua) — беріть готовий шаблон, він упізнає поля сам. Універсальний потрібен тоді, коли структура файлу довільна й готового шаблону під неї немає.
Які файли він читає?
XML із довільною структурою, CSV, XLS і XLSX. Тип ви вказуєте на початку, а далі налаштовуєте параметри читання під нього.
Колонки CSV злиплися в одну — що робити?
Майже завжди вказано не той роздільник. Спробуйте крапку з комою замість коми (або навпаки) — це найчастіша причина.
Категорії у файлі записані одним рядком, це підійде?
Так. Для цього є поле «категорія (шлях)»: програма розбере рядок на кшталт «Розділ / Підрозділ» і побудує з нього дерево категорій.
Чи треба розмічати щоразу?
Ні. Розмітка зберігається в шаблоні. Наступний файл тієї самої структури вантажиться за нею автоматично, а за постійним посиланням — ще й за розкладом.
Можна завантажити кілька картинок на товар?
Так, якщо у файлі вони перелічені — кількома колонками або кількома значеннями через роздільник. У зіставленні ви вказуєте, звідки брати зображення, і всі вони підтягнуться в картку.
Постачальник змінив структуру файлу — що робити?
Якщо у файлі з'явились чи зникли колонки або змінились їхні назви, стару розмітку доведеться поправити: відкрийте шаблон і перезіставте те, що поїхало. Поки структура стабільна, чіпати нічого не треба.