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).

Postup v kostce
  • Export: Vyberete a stáhnete si produkty do XLSX souboru.
  • Úprava produktů: V tabulce provedete požadované změny.
  • 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ů

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
  • Slug (Alias): Alias parametru ze systému
  • Akce: Příkaz určující, zda se má hodnota nahradit, přidat nebo smazat.

Co a jak lze upravovat

Níže naleznete podrobný přehled vlastností, které můžete prostřednictvím XLSX importu hromadně editovat. 

Tabulka uvádí přesnou syntaxi hlaviček 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.

VlastnostHlavičkaFormát a příklad
ProduktSKUUnikátní kód produktu
BOTA-RED-42
ParametrZnačka [Slug: znacka; Akce: ReplaceValue]Konkrétní hodnota
Adidas
ObrázkyObrázky [Slug: images; Akce: ReplaceValue]URL obrázku|popis
https://media.eshop.cz/foto.jpg|Detail boty
VideaVidea [Slug: videos; Akce: ReplaceValue]youtube:kód z URL na Youtube
youtube:kt3_M2CdpgI
PřílohyPřílohy [Slug: attachments; Akce: ReplaceValue]URL souboru|popis
https://eshop.cz/navod.pdf|Návod k použití
AliasyAlias [Slug: itemAliases; Akce: ReplaceValue]Alias do vyhledávání
Bota na běhání
Typ produktuTyp [Slug: productType; Akce: ReplaceValue]ID-Název typu
20-Obuv
*Pokud má produkt dostat více hodnot (např. Bílá, Modrá), oddělujte je v rámci buňky novým řádkem (Alt + Enter).
**Sloupec SKU nikdy neměňte. Slouží k tomu, aby systém věděl, ke kterému produktu data patří.

Povolené akce

Akce v hlavičce určuje, jak systém naloží s daty vzhledem k aktuálnímu stavu na e-shopu:

  1. ReplaceValue úplně nahradí stávající hodnoty produktu těmi z tabulky.
  2. AddValue ponechá stávající hodnoty a přidá k nim nové z tabulky (vhodné pro doplňování parametrů).
  3. DeleteValue smaže hodnotu uvedenou v buňce. Pokud do buňky zapíšete hvězdičku *, smažou se všechny hodnoty.

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:

  1. 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á
  2. 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.


Obsah

Potřebujete poradit?
Radim Vašek
Radim Vašek
Specialista na Elasticr FW