Як перенести каталог із Prom.ua в Elbuz файлом XLSX

Що вміє імпорт файлу Prom

• Готовий шаблон — колонки файлу Prom програма впізнає за назвами, розмічати нічого не треба.
• Зіставлення за ідентифікатором Prom — повторне завантаження оновлює картки, а не створює дублі.
• Повне збереження файлу — колонки Prom без місця в картці стають додатковими полями й вертаються на Prom вивантаженням.
• Розклад за посиланням — каталог оновлюється без ручного запуску.
• Режим дзеркала — каталог точно повторює файл.
• Журнал прогону — видно кожен крок і підсумок завантаження.

Де це і хто має доступ

Меню

Довідники → Операції → Завантаження даних → шаблон «XLSX - prom.ua, satu.kz, deal.by»

Право доступу

вікно «Завантаження даних» у «Правах груп»

Режим дзеркала

окреме право на налаштування: без нього прапорець сірий

Підготувати

файл .xlsx, вивантажений із Prom, або посилання на нього

1

Шаблон «XLSX - prom.ua, satu.kz, deal.by»

2

Створити новий шаблон

1. Рядок шаблону типу «XLSX - prom.ua, satu.kz, deal.by», за яким завантажують каталог із Prom.ua, Satu.kz, Deal.by.
2. Кнопка «Додати» відкриває форму створення нового шаблону завантаження.

Як налаштувати шаблон і запустити перше завантаження

• Джерело — файл з комп'ютера або посилання, за яким Elbuz забиратиме файл сам. Приймається лише .xlsx: старий .xls і CSV не пройдуть (як Elbuz читає файл).
• Що завантажується — категорії, товари, виробники й характеристики беруться з файлу автоматично, окремо вмикати їх не треба.
• Єдиний перемикач — режим повного дзеркала «Видаляти записи в базовому каталозі, яких немає в завантаженому файлі»; решта поведінки задана й перемикачів не має.

Перший запуск зробіть на невеликому або тестовому файлі й перевірте результат за цифрами журналу та колонками сітки. Лише переконавшись, що все стало правильно, вантажте повний файл і ставте шаблон на розклад.

1

Джерело даних — локальний файл або зовнішнє посилання

2

Блок «Що завантажувати»

1. Оберіть, звідки брати файл: завантажити з комп'ютера чи вказати зовнішнє посилання.
2. Опція визначає, чи видаляти в базовому каталозі записи, яких немає у завантаженому файлі.

Як програма впізнає товар і не робить дублів

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

Логіка така: спочатку Elbuz шукає товар за Ідентифікатором_товару. Якщо за ним товар не знайшовся (колонка порожня або такого ідентифікатора у вашому каталозі ще немає) — шукає за Унікальним_ідентифікатором. А якщо товар не знайшовся за жодним ідентифікатором — товар вважається новим, і для нього створюється власний внутрішній ключ.

Саме тут криється типова пастка: якщо у файлі немає стабільних ідентифікаторів, кожне повторне завантаження створюватиме дублі замість оновлення. Тому файл, вивантажений із самого Prom (де ідентифікатори вже проставлені), — найнадійніше джерело; саморобний файл без ідентифікаторів варто спершу перевірити на невеликій частині.

Куди лягають ці ідентифікатори — ключі синхронізації з Prom:

• Ідентифікатор_товару зберігається у системне поле товару «UUID» — унікальний ключ товару в Elbuz. Це головний ключ зіставлення: при імпорті в UUID лягає Ідентифікатор_товару з файлу, а далі UUID стає постійним ключем позиції у вашому каталозі.
• Унікальний_ідентифікатор Prom потрапляє в окреме додаткове поле з такою ж назвою (службовий числовий номер товару на Prom).

Що перезапише повторне завантаження

Шаблон Prom пише поля з файлу як є: порожня клітинка у файлі не зберігає старе значення картки. Фото товарів, що прийшли у файлі, замінюються повністю. Детальніше: що перезапише повторний прогін.

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

Своє значення в картці береже прапорець: «Не оновлювати» — усю картку, «Фіксована ціна» — лише ціну, «Не оновлювати фото» — лише фотографії. Детальніше: як закріпити своє значення. Прапорці діють лише на оновлення: від режиму дзеркала вони не захищають.

Як зробити каталог точною копією файлу Prom

У шаблоні є окремий режим повного дзеркала — прапорець «Видаляти записи в базовому каталозі, яких немає в завантаженому файлі». Увімкнений, він робить каталог точною копією файлу.

Усередині порядок такий: спершу програма позначає на видалення весь базовий каталог, потім знімає позначку з тих категорій і товарів, які знайшлися у файлі, решту видаляє — і тільки після цього додає й оновлює те, що у файлі є. Тобто видалення відбувається до завантаження нових даних, а не після звірки результатів.

Чого в цьому шаблоні немає — і про що варто знати до першого вмикання: перемикача «враховувати джерело завантаження» на формі Prom не виведено. Дзеркало не розрізняє, звідки взявся товар: під нього потрапляють і картки, заведені руками, і ті, що прийшли з прайс-листів чи від парсера, якщо їх немає у файлі Prom.

Разом із товаром зникають його опис, прив'язки до категорій і магазинів, характеристики, фото, запитання-відповіді та зв'язки «супутні товари». Разом із категорією — її опис, прив'язки до магазинів, місце в дереві, правила розподілу прайс-листів на цю категорію і її відбір у шаблонах вивантаження. Рядки прайс-листів при цьому не видаляються: у них обнуляється посилання на товар, і рядок лишається висіти без картки.

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

Як повернути видалене дзеркалом

Кнопки «скасувати завантаження» немає, кошика для видалених карток теж: рядки прибираються з бази остаточно. Робочий шлях один — повторно завантажити той самий файл, але повний. Товари повернуться за тим самим Ідентифікатором_товару: він лежить у файлі, тож картки отримають той самий UUID, і зв'язок із Prom не порушиться — зворотне вивантаження далі впізнає свої позиції.

Повторне завантаження повертає не все. Не повернуться:

• запитання-відповіді до картки — цих даних у файлі Prom немає, і взяти їх нізвідки; зв'язки «супутні товари» — колонки Супутні та ID_Супутніх приходять у додаткові поля картки, але самі зв'язки завантаження не відновлює;
• прив'язка рядків прайс-листів до карток — її відновлює повторне завантаження самого прайс-листа;
• правила розподілу прайс-листів, які були прив'язані до видалених категорій, і відбір цих категорій у шаблонах вивантаження;
• фото — тільки якщо у файлі заповнена колонка Посилання_зображення; характеристики — тільки якщо у файлі є трійки колонок характеристик.

І ще одне, чого не видно одразу: внутрішній номер картки буде новий. У рядках уже виписаних документів назва й артикул зберігаються текстом і нікуди не подінуться, а от посилання з документа на картку товару стане недійсним.

Як переконатися, що завантаження відпрацювало

Журнал прогону — у панелі «Операції»; одразу після запуску з'являється підказка «Завантаження запущено — стежте в «Операціях»». Вікно шаблону можна закрити: завантаження зупиняє тільки кнопка «Зупинити». Детальніше: як перевірити, що завантаження пройшло.

По ходу прогону журнал пише кроки в тому самому порядку, у якому йде робота:

1. «Створення тимчасових таблиць» → «Завантажуємо дані до базового каталогу» → «Визначаємо записи, які є в базі даних».
2. «Додаємо категорії товарів», «Оновлюємо категорії товарів» і «Оновлюємо ключі для категорій».
3. «Визначаємо виробників у товарів» → «Визначаємо наявність у товарів» → «Додаємо товари» і «Оновлюємо товари».
4. «Завантажуємо атрибути товарів» → «Завантажуємо фотографії товарів».
5. «Оновлення значень на основі формул» → «Перевірка цілісності даних» → «Індексування товарів».

Останній рядок — «Завантаження даних завершено!», а під ним «Витрачено часу:» з тривалістю прогону.

Цифр у журналі рівно дві, і читати їх треба буквально:

• «Всього товарів завантажено: N» — поки йде читання, це лічильник прочитаних рядків файлу, він оновлюється кожні 500 рядків. Наприкінці той самий рядок показує підсумок: скільки рядків товарів було у файлі. Це не кількість створених чи оновлених карток — скільки з них виявилися новими, а скільки оновилися, журнал не рахує.
• «Усього категорій завантажено: N» — те саме для аркуша груп.

Ще два рядки з'являються лише за потреби:

• «Не завантажено фотографій: N» — якщо частина посилань на фото виявилася непридатною;
• червоне «Частина даних не збереглася: база відхилила запит.» — якщо хоча б один запит база відхилила. Цей рядок означає, що прогін дійшов до кінця, але не всі дані доїхали, і плутати його з підсумковим «Завантаження даних завершено!» не можна.

Тепер куди дивитися в сітках:

• У списку шаблонів колонка «Останнє завантаження» показує, коли шаблон відпрацював востаннє і скільки це зайняло. «ще не завантажувався» означає, що прогонів не було жодного.
• У сітці базового каталогу факт оновлення підтверджує колонка «Дата оновлення»: у всіх оновлених карток вона стане часом прогону. Нові картки видно по колонці «Дата додавання» і по «Джерело: назва» — там буде назва вашого шаблону, а в «Джерело: код» — prom_xlsx.

Тривалість і підсумки прогонів за 30 днів показує кнопка «Історія запусків» — у шапці форми шаблону і в тулбарі списку.

1

Середня тривалість і найдовший запуск

2

Рядок запуску в таблиці

1. Середня тривалість і найдовший запуск — за ними видно, скільки зазвичай триває завантаження цього шаблону.
2. Рядок запуску — початок, стан, джерело, час виконання, користувач і підсумок кожного завантаження.

Якщо завантаження обірвалося або його зупинили

Робота йде у два заходи.

Спершу Elbuz читає файл цілком у свої проміжні таблиці й базового каталогу не чіпає взагалі. І лише коли файл дочитано до кінця, починається перенесення — у журналі це рядок «Завантажуємо дані до базового каталогу». Тому обрив на читанні (впав зв'язок, файл виявився пошкодженим, ви натиснули «Зупинити») лишає каталог рівно таким, яким він був, і повторювати можна спокійно.

Кнопка «Зупинити» в «Операціях» спрацьовує не миттєво. Програма звіряється з нею під час читання кожні 500 рядків, а потім ще у двох місцях — перед видаленням зайвого і після оновлення категорій. У панелі операція позначиться як «Зупинено» одразу, а сам прогін дійде до найближчої з цих точок. Далі:

• якщо зупинити під час читання — у журналі стане «Операція перервана користувачем!», а каталог лишиться незмінним;
• якщо зупинити вже після того, як категорії оновилися, — категорії будуть новими, а товари ще старими. Це не поломка: повторний прогін доведе справу до кінця.

Якщо прогін помер сам — уперся в межу часу, обірвався зв'язок із базою, — відкоту немає: усе, що встигло записатися, лишається записаним. Транзакцією обгорнуто одне-єдине місце — заміна фотографій: якщо вона впала посередині, старі фото повертаються, і ситуації «старих фото вже немає, нових ще немає» не буває.

Завислий прогін, у журналі якого 15 хвилин не з'являлося нових рядків, позначається перерваним, і наступний запуск за розкладом стартує нормально. Детальніше: якщо прогін обірвався.

Повторний запуск безпечний. Проміжні таблиці перед кожним прогоном створюються заново, а товари, які вже встигли створитися, знайдуться за ідентифікатором і оновляться. Дублі робить лише файл без ідентифікаторів товару (як програма впізнає товар).

Скільки триває прогін і де межі

Стелі на кількість рядків у файлі немає: програма читає файл до кінця, скільки б рядків у ньому не було. Обмежено інше:

• Дві години на прогін — стільки часу відводиться завантаженню файлу з комп'ютера. Якщо за дві години робота не завершилася, прогін обривається там, де був, з наслідками з розділу про обрив.
• Кожні 500 рядків — крок, з яким програма пише в журнал прочитану кількість і перевіряє кнопку «Зупинити». Між цими точками журнал мовчить, і зупинка теж чекає найближчої з них.
• До 20 фотографій на товар — стільки посилань програма розбере з колонки Посилання_зображення; двадцять перше й далі не завантажаться.
• Артикул — 25 символів (стільки ж дозволяє й сам Prom), назва товару, назва групи й meta-поля — 255 символів, GTIN — 14. Довші значення до картки повністю не доїдуть.
• Розмір файлу обмежує сервер, а не програма. Файл, який не доїхав, видно одразу: «Файл не вдалося передати на сервер. Можливо, він завеликий або зв'язок обірвався. Код помилки ...» — каталог при цьому не змінюється.

Два завантаження одночасно за розкладом не стартують: прогін, що наткнувся на інший шаблон, чекає наступного разу (два прогони одночасно). Скільки триває саме ваш файл, покаже «Середня тривалість» у вікні «Історія запусків» після першого-другого прогону.

Вимкнути шаблон чи видалити його

Пілюля «Активний» / «Вимкнений» у шапці форми або в колонці «Стан» списку вмикає й вимикає запуск за розкладом. Ручний запуск працює й на вимкненому шаблоні, а видалення шаблону завантажених товарів не чіпає. Детальніше: вимкнути шаблон чи видалити.

Поки цим шаблоном іде завантаження за розкладом, у колонці «Стан» стоїть «Виконується», і кліком стан тоді не перемикається. Готовий шаблон «XLSX - prom.ua, satu.kz, deal.by» системний: видалити його не можна, лише вимкнути.

1

Стан шаблону

2

Останнє завантаження

1. Пілюля «Вимкнений» у колонці «Стан» показує, що шаблон prom.ua не запускається за розкладом.
2. У колонці «Останнє завантаження» видно, коли шаблон запускали востаннє і скільки тривало завантаження.

Сценарії

Уперше перенести каталог із Prom у Elbuz

Задача: весь асортимент ведеться на Prom, і його треба отримати в базовий каталог.

Що ввімкнути: у шаблоні «XLSX - prom.ua, satu.kz, deal.by» в блоці «Джерело даних» вкладка «Локальний файл», кнопка «Вибрати файл – Каталог» — файл .xlsx, вивантажений із Prom. Прапорець «Видаляти записи в базовому каталозі, яких немає в завантаженому файлі» лишити вимкненим.

Що вийде: групи з аркуша «Export Groups Sheet» стануть категоріями, товари — картками, у яких UUID дорівнює Ідентифікатору_товару з Prom, а якщо він порожній — Унікальному_ідентифікатору. Поля Prom без місця в стандартній картці ляжуть у додаткові поля, характеристики — в атрибути, фото — до 20 на товар. У колонці «Джерело: назва» нових карток буде назва шаблону.

Чого не станеться: жодна наявна картка не видаляється, і картки з прайс-листів чи створені руками лишаються як були.

Регулярно оновлювати ціни й залишки з Prom за розкладом

Задача: ціни й наявність ведуться на Prom, а в Elbuz вони мають бути свіжими без ручного запуску.

Що ввімкнути: у блоці «Джерело даних» вкладка «Зовнішнє посилання», поле «Посилання на файл із товарами (Каталог)». У блоці «Повʼязані налаштування» — кнопка «Налаштування розкладу». Стан шаблону — «Активний».

Що вийде: за розкладом шаблон забирає файл за збереженим посиланням, знаходить товари за їхнім UUID і оновлює ціну, кількість, наявність і решту полів; ціни в іншій валюті перераховуються за курсом. Товари, яких у каталозі ще немає, додаються. Кнопка «Завантажити цей шаблон» у списку теж бере файл за цим посиланням.

Чого не станеться: шаблон зі станом «Вимкнений» за розкладом не запускається. Якщо в момент запуску за розкладом уже вантажиться інший шаблон, прогін пропускається з рядком «Скасовано завантаження за розкладом…» і чекає наступного разу.

Каталог має точно повторювати файл Prom

Задача: товари, зняті з Prom, мають зникати і з базового каталогу.

Що ввімкнути: прапорець «Видаляти записи в базовому каталозі, яких немає в завантаженому файлі». Якщо він сірий і не натискається, у вашої групи немає права на це налаштування.

Що вийде: перед додаванням і оновленням програма видаляє категорії й товари, яких немає у файлі, разом з описами, фото, характеристиками, запитаннями-відповідями та зв'язками «супутні товари».

Чого не станеться: файл, у якому не розпізналося жодного товару, товарів не видалить, те саме окремо для категорій. Рядки прайс-листів не видаляються — вони лише втрачають прив'язку до картки. Скасувати видалення не можна, повертають його повторним завантаженням повного файлу.

Вручну вивірені картки не мають перезаписуватися

Задача: частину карток ви доводите руками, а решту каталогу оновлює файл.

Що ввімкнути: у картці товару прапорець «Не оновлювати». Якщо берегти треба лише ціну — «Фіксована ціна», лише фотографії — «Не оновлювати фото».

Що вийде: з «Не оновлювати» файл не змінює в картці ціну, залишок, наявність, категорію, додаткові поля Prom, назву, опис, meta-поля й фото. З «Фіксованою ціною» оновиться все, крім ціни. З «Не оновлювати фото» — все, крім фотографій.

Чого не станеться: прапорці не рятують від режиму повного дзеркала — якщо такої картки немає у файлі, а дзеркало ввімкнене, вона буде видалена.

Що робити, коли завантаження пішло не так

Часті запитання

Що буде, якщо у файлі не заповнено ідентифікатор товару?

Elbuz шукає товар за Унікальним_ідентифікатором. Якщо немає й його — товар вважається новим, і кожне повторне завантаження такого файлу робить дублі. Надійніше брати файл, вивантажений із самого Prom. Детальніше: як програма впізнає товар.

Код_товару — це і є ідентифікатор для оновлення?

Ні. Код_товару — ваш артикул (SKU, до 25 символів), він записується в поля «артикул» і «MPN» картки. Товар при повторному імпорті Elbuz упізнає за внутрішнім ідентифікатором Prom, бо артикул продавці іноді змінюють.

Я створив новий товар у Elbuz — Prom підхопить його при вивантаженні?

Так. Новий товар іде у файл вивантаження зі своїм UUID у колонці Ідентифікатор_товару і з порожнім Унікальним_ідентифікатором — Prom додасть його як новий. Унікальний_ідентифікатор руками не заповнюйте. Детальніше: вивантаження на Prom (XLSX).

Чи можна завантажити каталог Prom у форматі XML замість XLSX?

Так, імпортом XML / YML. У XML теж є ідентифікатор товару, за яким Prom відрізняє новий товар від наявного: принцип зіставлення той самий, інший лише формат файлу.

Два кабінети Prom вантажу в один каталог — товари не змішаються?

Змішаються, якщо ідентифікатори збігаються: шаблон XLSX шукає товар по всьому каталогу, і в картці лишаються значення останнього прогону. Перемикача «враховувати джерело» в цьому шаблоні немає. Детальніше: два шаблони на той самий товар.

Суміжні теми

• Якщо треба знати, у яке поле картки лягла колонка файлу — куди в картці лягають колонки файлу Prom.
• Якщо після роботи в Elbuz каталог треба повернути на Prom — вивантаження на Prom.ua (XLSX).
• Якщо з Prom треба забирати ще й замовлення — завантаження замовлень із Prom.ua.
• Якщо ще обираєте спосіб завантаження — який спосіб обрати.