Elbuz Tunnel кладе дані каталогу в тимчасові таблиці бази вашого сайту, по таблиці на сутність, — за цим довідником запити до них пишуть без здогадок.
Коли це знадобиться:
- Пишете злиття для своєї CMS — таблиця покаже, звідки брати товари, категорії, атрибути й фото.
- Запит має відсікти варіанти товарів — колонка type_id відрізняє товар-опцію від звичайного.
- Потрібне власне поле каталогу — воно лежить у колонці з іменем виду product_f451.
З чого почати: перелік таблиць нижче.
Що є в довіднику
- Таблиці — товари, категорії, виробники, атрибути, фото, магазини, склади, довідники.
- Службові колонки — uuid, row_exist, type_id, ідентифікатори сайту й Elbuz.
- Власні поля каталогу — як вони називаються в тимчасових таблицях.
Де це і хто має доступ
Пункту меню в Elbuz немає: таблиці лежать у базі вашого сайту, поруч із таблицями CMS.
- Інші входи
- phpMyAdmin або інший клієнт MySQL хостингу сайту
- Право доступу
- доступ до бази сайту
- Підготувати
- хоча б один прогін тунельного шаблону
Довідник тимчасових таблиць
Тунель створює в базі сайту понад тридцять таблиць — рівно ті, які потрібні для відзначених вами даних. Ось ті, з якими працюють найчастіше.
| Таблиця | Що в ній |
|---|---|
etrade_category_temp | Категорії: назва, описи, SEO-поля, uuid, uuid_parent, рівень вкладеності, порядок |
etrade_product_temp | Товари: ціни (price, price_rrp, price_old, price_cost), quantity, артикули (sku, mpn, model), штрихкоди, габарити, описи, SEO, статус наявності, type_id |
etrade_product_to_category_temp | Зв’язка «товар — категорія», з ознакою головної категорії |
etrade_manufacturer_temp | Виробники: назва, логотип, описи, SEO-поля |
etrade_attribute_block_tempetrade_attribute_tempetrade_attribute_value_tempetrade_product_attribute_temp | Блоки атрибутів, самі атрибути, довідник значень і значення, проставлені товарам |
etrade_image_tempetrade_image_seo_temp | Фотографії категорій і товарів та тексти alt/title до них |
etrade_store_tempetrade_warehouse_tempetrade_product_store_tempetrade_product_warehouse_temp | Магазини й склади, а також кількість і ціна товару в розрізі магазину або складу |
etrade_currency_tempetrade_language_tempetrade_measure_temp | Довідники валют із курсами, мов і одиниць вимірювання |
etrade_article_tempetrade_review_tempetrade_faq_temp | Статті, відгуки та питання-відповіді, якщо ви їх відзначили |
Службові колонки і власні поля
Колонки, які є майже скрізь і потрібні в кожному запиті:
| Колонка | Призначення |
|---|---|
uuid | Символьний ідентифікатор запису в Elbuz — головний ключ зіставлення |
row_exist | Ваш прапорець: 1 — запис на сайті знайдено, 0 — треба створити |
*_uuid | Посилання на інший запис (category_uuid, manufacturer_uuid, product_uuid, item_uuid, language_uuid) |
*_id | Числовий ідентифікатор на сайті; спершу порожній, його проставляєте ви на кроці опізнання |
*_id_jumper | Числовий ідентифікатор у самому Elbuz. Є в чотирьох таблицях: product_id_jumper — у товарах, category_id_jumper і parent_id_jumper — у категоріях, language_id_jumper — у мовах, review_id_jumper — у відгуках. Зручно, коли на сайті треба зберегти посилання назад у програму |
type_id | Тільки в товарах: 1 — звичайний товар, 2 — товар-опція (варіант) |
language_id | Мова рядка; для багатомовного сайту без неї не обійтися |
Крім типових полів, у чотирьох таблицях — товари, категорії, виробники й контрагенти — з’являються ваші власні поля базового каталогу, ті, що ви завели самі. Їхні імена складаються з типу запису й номера поля: product_f451, category_f120, manufacturer_f88. Підглянути потрібне ім’я можна в налаштуваннях сітки базового каталогу. У решті таблиць, зокрема в атрибутах і фотографіях, власних полів немає.
Часті запитання
Де мені взяти список полів тимчасової таблиці?
Найпростіше — подивитися саму таблицю в базі сайту одразу після прогону командою SHOW COLUMNS FROM etrade_product_temp. Склад полів залежить від того, що відзначено у вивантаженні.
Навіщо потрібні поля product_id_jumper і category_id_jumper?
У них лежать числові ідентифікатори записів у самому Elbuz — наприклад, щоб записати ідентифікатор Elbuz у поле «Модель» і потім зіставляти замовлення. Для звичайного оновлення каталогу вони не потрібні: зіставлення тримається на uuid.
Чи видаляються тимчасові таблиці після прогону?
Для CMS зі списку — так, останнім кроком прогону. У режимі «MySQL (SQL custom query)» вони навмисно лишаються в базі сайту, щоб було видно, що приїхало з Elbuz; наступний прогін перестворює їх заново.
Чим type_id = 2 відрізняється від type_id = 1?
1 — звичайний товар, 2 — товар-опція (варіант). Без умови type_id = 1 у запитах оновлення й вставки кожен варіант поїде на сайт окремою карткою.
Чому в таблиці фото немає моїх власних полів?
Власні поля базового каталогу є тільки в чотирьох таблицях: товари, категорії, виробники й контрагенти. У решті таблиць, зокрема в атрибутах і фотографіях, їх немає.
Суміжні теми
- Якщо потрібна загальна картина тунелю — Як вивантажувати товари в базу свого сайту.
- Якщо пишете злиття крок за кроком — Оновлення сайту власними SQL-запитами.
- Якщо поле Elbuz треба лише покласти в нестандартне поле сайту — «Додаткові параметри» без SQL.