Hromadné úpravy produktů (XLSX Import/Export)
Tato stránka dokumentace popisuje fungování, nastavení a výhody hromadných úprav produktů pomocí XLSX importu a exportu v systému Elasticr ecommerce.
O funkci
Hlavním účelem této funkce je maximálně zrychlit a zjednodušit správu rozsáhlého produktového katalogu.
Namísto zdlouhavého editování každého produktu v administraci zvlášť, umožňuje tato funkce upravovat parametry, hodnoty a další data produktů pro stovky či tisíce produktů hromadně v prostředí tabulky (např. Google Sheets či Excel).
Kromě úpravy již existujících produktů umí funkce také hromadně založit zcela nové produkty, které se v aplikaci zatím vůbec nenachází.
- Export: Vyberete a stáhnete si produkty do XLSX souboru.
- Úprava produktů: V XLSX tabulce provedete požadované změny hodnot.
- Import: Upravený soubor nahrajete zpět do administrace pro provedení změn.
Export produktů
Prvním krokem je získání aktuálních dat z e-shopu. V administraci si pomocí filtrů (kategorie, parametry) připravte seznam produktů, které chcete exportovat a upravovat.
Soubor bude obsahovat unikátní identifikátor SKU produktu a sloupce odpovídající aktuálně vyplněným hodnotám produktu.
Úprava produktů v tabulce
Pro správné zpracování importu je klíčové porozumět tomu, jak systém čte sloupce a jaké instrukce mu skrze hlavičku předáváte.
Hlavička
Každý sloupec (kromě SKU) musí mít v prvním řádku instrukci, která systému říká, "o jaký parametr produktu jde a jak s ním naložit."
- Formát zápisu:
Název [Slug: alias; Akce: název_akce] - Název: Název parametru/atributu
- Slug (Alias/Kód): Alias parametru/atributu ze systému
- Akce: Příkaz určující, zda se má hodnota nahradit, přidat nebo smazat.
Povolené akce
Akce v hlavičce určuje, jak systém naloží s daty vzhledem k aktuálnímu stavu na e-shopu:
ReplaceValueúplně nahradí stávající hodnoty produktu těmi z tabulky.AddValueponechá stávající hodnoty a přidá k nim nové z tabulky (vhodné pro doplňování parametrů).DeleteValuesmaže hodnotu uvedenou v buňce. Pokud do buňky zapíšete hvězdičku*, smažou se všechny hodnoty.
Úprava vs založení produktu
O tom, co systém s řádkem (SKU) v tabulce udělá, rozhoduje povinný sloupec Action.
- Pro úpravu existujícího produktu: Do sloupce
Actionzadejte hodnotu edit. - Pro založení nového produktu: Do sloupce
Actionzadejte hodnotu create.
Jaké atributy a hodnoty lze upravovat
Níže naleznete podrobný přehled atributů, které můžete u produktů prostřednictvím XLSX importu hromadně editovat či vyplnit při založení.
Tabulka uvádí přesnou syntaxi hlaviček (a vzorovou akci ReplaceValue) pro jednotlivé typy polí a definuje, v jakém formátu mají být data v buňkách zapsána, aby je systém správně rozpoznal.
Pozor: Systém vyžaduje pro import minimální sadu informací pro správné fungování v katalogu (viz tabulka níže). Ostatní pole jsou volitelná a při nevyplnění zůstanou prázdná nebo se nastaví na výchozí hodnotu.
| Formát hlavičky s akcí | Zápis hodnot k úpravě |
|---|---|
| Povinné | |
SKU | Unikátní kód produktu BOTA-RED-42 |
Action [Slug: action; Akce: ReplaceValue] | edit - upraví produkt create - založí produkt |
Název produktu [Slug: productTitle; Akce: ReplaceValue] | Libovolný název produktu Pánská bota Nike Glow 47 |
Cena [Slug: priceRetail; Akce: ReplaceValue] | Prodejní cena v Kč bez DPH 1500.50 |
Skupina DPH [Slug: taxRule; Akce: ReplaceValue] | ID daňové skupiny ze systému 1 |
Stav [Slug: state; Akce: ReplaceValue] | published - zveřejněno unpublished - nezveřejněno archived - archivováno |
Revize [Slug: revision; Akce: ReplaceValue] | approved - schváleno rejected - zamítnuto awaiting - čeká na revizi |
| Volitelné | |
Nákupní cena [Slug: pricePurchase; Akce: ReplaceValue] | kód_dodavatele|cena_bez_dph nike-cz|2100 |
Cenová strategie [Slug: priceStrategy; Akce: ReplaceValue] | retail - maloobchodní cena supplier - nákupní cena |
Při vyprodání [Slug: outOfStockAction; Akce: ReplaceValue] | archive - archivuje produkt allow_purchase - dovolí objednat watchdog - zapne hlídacího psa inquire - dovolí poptat |
EAN [Slug: eans; Akce: ReplaceValue] | EAN kód 123456789 |
Dodavatelský kód [Slug: supplierSkus; Akce: ReplaceValue] | kód_dodavatele|sku_dodavatele nike-cz|123456C489 |
Titulek [Slug: metaTitle; Akce: ReplaceValue] | Titulek pro vyhledávače Pánská bota Nike Glow 47 |
Meta Description [Slug: metaDescription; Akce: ReplaceValue] | Krátký SEO popisek produktu Pánská bota Nike Glow 47 * Nyní skladem na E-shop.cz |
Obrázky [Slug: images; Akce: ReplaceValue] | URL_obrázku|popis https://media.eshop.cz/foto.jpg|Detail |
Videa [Slug: videos; Akce: ReplaceValue] | youtube:kód_videa youtube:kt3_M2CdpgI |
Přílohy [Slug: attachments; Akce: ReplaceValue] | URL_souboru|název https://eshop.cz/navod.pdf|Návod |
Alias [Slug: itemAliases; Akce: ReplaceValue] | Alias do vyhledávání Bota na běhání |
Typ [Slug: productType; Akce: ReplaceValue] | ID-Název typu 20-Obuv |
Název parametru [Slug: alias; Akce: ReplaceValue] | Konkrétní hodnota parametru Značka: Nike |
| *Pokud má produkt dostat více hodnot (např. více EANů, dodavatelských kódů nebo obrázků), oddělujte je v rámci buňky novým řádkem (Alt + Enter). | |
| **Při akci edit sloupec SKU nikdy neměňte. Slouží k identifikaci existujícího produktu. | |
Práce s listy
Při exportu Elasticr produkty automaticky rozřazuje do jednotlivých listů podle jejich Typu produktu. Název listu pak vždy odpovídá ID + názvu daného typu (např. 10-Obuv).
Při nahrávání souboru zpět není pojmenování listů povinné, ale slouží jako jeden z nástrojů pro určení Typu produktu.
Typ produktu lze změnit/přiřadit dvěma způsoby:
- Názvem listu: Pokud se produkt nachází v listu, jehož název odpovídá existujícímu Typu produktu, systém mu tento typ automaticky přiřadí či ponechá
- Akcí v tabulce: Typ lze určit přímo v buňce pomocí sloupce se slugem
productType(viz tabulka výše).
Pokud určíte typ produktu názvem listu a zároveň i sloupcem productType, hodnoty se sečtou. Je tedy na rozhodnutí administrátora, kterou metodu (nebo jejich kombinaci) zvolí.
Dynamické přiřazování parametrů
Tato funkce umožňuje přidat parametr k typu produktu přímo přes XLSX soubor bez nutnosti předchozího nastavování v administraci.
- Princip: Pokud do tabulky přidáte sloupec s parametrem, který již v systému existuje u jiného Typu produktu, import tento parametr automaticky "přiřadí" k aktuálnímu typu produktu.
- Vytvoření hodnot: Zároveň se v rámci importu automaticky založí i nové hodnoty tohoto parametru, které jste v tabulce vyplnili.
Příklad: Pokud již v systému existuje parametr „Materiál“ (např. u obuvi) a vy jej chcete začít používat i u bund, stačí tento sloupec jednoduše přidat do importního souboru pro bundy. Systém parametr k novému typu (bundy) v importu automaticky přiřadí a produkty rovnou doplní o zadané hodnoty.
Import produktů
Poté, co v tabulkovém procesoru dokončíte veškeré úpravy, uložte soubor ve formátu XLSX a nahrajte ho zpět do Elasticr aplikace.
Tip: Původní exportovaný soubor si vždy uschovejte jako zálohu. Poslouží vám pro rychlou obnovu dat, pokud byste potřebovali provedené změny vzít zpět.
Proces zpracování
Proces aktualizace dat neprobíhá kvůli optimalizaci výkonu okamžitě, ale je řízen automatizací, která běží v Elasticru na pozadí.
- Interval spouštění: Automatizace se spouští pravidelně každou 1 minutu.
- Zpracování: Elasticr při každém spuštění kontroluje, zda byl nahrán soubor. Pokud jej nalezne, provede zápis změn.
- Úklid souborů: Systém po sobě systém vždy smaže. Díky tomu můžete nahrávat nové soubory prakticky každých pár minut.
Kontrola v Audit logu
Průběh a výsledek každého importu můžete sledovat přímo v sekci Nastavení -> Auditlog. Vyhledejte či vyfiltrujte automatizaci s názvem Import produktů z XLSX souboru.
- Automat doběhl v pořádku - Import proběhl bez problémů a veškeré produkty v katalogu jsou v tuto chvíli aktualizovány.
- Automat zaznamenal chybu - V souboru narazila automatizace na chybu (např. překlep v hlavičce, nepovolená akce či chybný formát).
Pokud automatizace narazí na chybu, produkty se nepodařilo upravit. V takovém případě stačí XLSX opravit a znovu nahrát.
