Konfigurátor CSV souborů

Máte datový soubor ve formátu CSV, ale není přesně v Upgates formátu? Nevadí! Upgates vám umožní importovat CSV bez složitých úprav snadno a rychle. Stačí nastavit šablonu s konfigurací, podle které bude Upgates import CSV zpracovávat. Tu pak lze použít opakovaně při každém využití daného datového souboru.

Vlastní CSV lze použít pro:

• Produkty - Import i Export
• Kategorie - Import i Export
• Objednávky - Pouze Export
• Zákazníci - Import i Export

Jak konfigurátor aktivovat?

CSV konfigurátor je přístupný zdarma vrácmi Upgates doplňku.

1. Ve své administraci přejděte do sekce Doplňky.
2. Vyhledejte CSV konfigurace.
   
3. Klikněte na tlačítko Aktivovat.

Tím se vám doplněk automaticky zpřístupní a můžete přikročit k vytváření samotných CSV šablon.

Vytvoření šablony

Každý import a export musí z něčeho vycházet. Musí mít šablonu, podle které se bude řídit. Abychom tedy docílili toho, že se soubor správně exportuje / naimportuje, musíme nejdříve takovou šablonu vytvořit.

Každou vytvořenou šablonu je možné použít jak pro Export, tak pro Import. Důležité dávat pozor na povinné pole a typ šablony (nelze šablonu vytvořenou pro Produkty, použít pro export Zákazníků, atd.).

Postup v administraci

Pro příklad zde uvádíme jak vytvořit CSV šablonu s konfigurací pro produkty. Nezapomeňte, že šablonu je možné použít pro Export i Import a tedy není důležité v jaké podsekci jí vytvoříte.

1. V administraci přejděte do sekce Doplňky.
   Konfigurace je možné vytvářet pro tyto sekce.
2. Klikněte na doplněk CSV konfigurace. (Doplněk je potřeba mít aktivováný)
3. V tlačítku + Nová vyberte sekci Produkty, Kategorie, Objednávky, anebo Zákazníci.
4. Následně si zvolte typ šablony:
   • Produkty
     • Vlastní formát  - Umožňuje vytvořit vlastní šablonu od základu.
     • Ceny - Obsahuje základní pole pro editaci cen produktů.
     • Sklad - Obsahuje základní pole pro editaci stavu zásob a dostupnosti.
     • Vše - Předpřipraví šablonu se všemi sloupci, které aktuálně lze použít.
   • Zákazníci
     • Vlastní formát  - Umožňuje vytvořit vlastní šablonu od základu.
     • Vše - Předpřipraví šablonu se všemi sloupci, které aktuálně lze použít.
   • Kategorie
     • Vlastní formát - Umožňuje vytvořit vlastní šablonu od základu.
     • Vše - Předpřipraví šablonu se všemi sloupci, které aktuálně lze použít.
   • Objednávky
     • Vlastní formát - Umožňuje vytvořit vlastní šablonu od základu.
     • Vše - Předpřipraví šablonu se všemi sloupci, které aktuálně lze použít.
5. Po kliknutí na vámi zvolený typ šablony se vytvoří příslušná šablona.

Příklad

Pro účely tohoto manuálu, budeme vytvářet a používat šablonu pro editaci ceny a skladu u produktů.

Jelikož neexistuje předvytvořená šablona na ceny a sklad zároveň, musíme nejdříve takovou šablonu vytvořit. Nejjednodušší způsob je přes Vlastní formát šablony produktů.

1. V tlačítku + Nová najdeme sekci Produkty.
2. Zvolíme šablonu Vlastní formát.
   
3. Přepíšeme název tak, abychom šablonu kdykoli dokázali jednoduše identifikovat.
   

Uložení názvu dosáhnete jednoduše tak, že dáte Enter, vykliknete se myší mimo dané pole, anebo přidáte nějaký sloupec.

Tímto máte novou šablonu konfigurací založenou. Nyní je potřeba přidat jednotlivé sloupce.

Přidání a odebrání sloupců

Každý CSV soubor by měl obsahovat nějaké sloupce, do kterých se budou exportovat / importovat data. 

Přidání sloupce

1. V pravé horní části stránky klikněte na tlačítko + Přidat.
2. Otevře se vám seznam možností, které lze pro CSV export / import použít.
   Pokud nějaké pole je pouze pro export - nelze jej použít pro zpětný import (import jej přeskočí).
   Takové pole je označeno ikonkou "i".
   
3. Vyberte data (sloupce), které chcete používat.
   Po kliknutí na tlačítko Přidat se vám automaticky do šablony daná hodnota přidá.
   
4. Jakmile pole přidáte, tlačítko Přidat zašedne a další takové pole nepřidáte.
   Nicméně existují data (sloupce), kterých lze přidávat více. Jedná se pole například Ceny, Parametry, Vlastní sloupce, atd.
   

Sloupce lze přidávat i hromadně

Jistě vás napadlo, jak si ulehčit práci s nutností složitého vyklikávání v případě, kdy máte spoustu parametrů, ceníků, atd.
Sloupce, které lze přidávat opakovaně, protože v e-shopu jich můžete vytvářet více (Ceníky, parametry, vlastní pole, ..), lze přidávat i hromadně.

1. V pravém horním rohu klikněte na tlačítko + Přidat.
2. Vyberte sekci, kterou potřebujete přidat vícekrát (například Parametry).
3. Ve výběrovém poli naklikejte příslušné hodnoty, které potřebujete přidat hromadně.
   
4. Potvrďte tlačítkem Přidat.
5. Systém automaticky přidá jednotlivé sloupce a přiřadí vámi vybrané parametry do nových sloupců.
   

Abychom zajistili přehlednost šablony, je každý řádek roven jednomu sloupci v CSV souboru. V orientaci vám může pomoci sloupec s rozpisem pořadí (A = 1. sloupec, B = 2.sloupec, atd.)

Pozor! Pokud vytvořenou šablonu chcete použít pro zpětný import, je důležité dodržet povinnost povinných polí. Pokud je mít nebudete, import se nebude mít jak spárovat s existujícími produkty.

Pozor! Pokud v CSV šablonách využíváte Vlastní pole, anebo jiné sekce, které lze přidávat jako (Parametry, Ceníky, Štítky, atd.), tak šablony se dynamicky nemění spolu se založením nového parametru, ceníku, štítků, atd. Je potřeba vždy šablonu dodatečně upravit a nový parametr, ceník, štítek do ní přidat.

Příklad

Jak jsme uváděli výše. Vytváříme šablonu pro editaci ceny a skladu zároveň. Vybereme sloupce, které nám pomohou identifikovat správné produkty a umožní jejich editaci stavu zásob a cen.

Výstupní soubor po exportu

Smazání sloupce

Pokud se náhodou u vybírání sloupců ukliknete, můžete vždy daný řádek se sloupcem smazat. Při nájezdu myší na konkrétní řádek, můžete přes ikony na pravé straně konkrétní sloupec smazat. Po kliknutí stačí jen potvrdit potvrzovací okno, které brání nechtěnému smazání a poté se řádek odebere.

Pokaždé když nějaký sloupec přidáte nebo odeberete, se celková šablona přeuloží. Neztratíte tak vámi rozpracované data v případě, kdy byste si omylem stránku například zavřeli.

Editace sloupců

Tabulka šablony se skládá z několika sloupců

• Sloupec - Obsahuje hodnoty určující pořadí sloupců.
• Zdroj - Určuje typ obsahu sloupce (například Kód produktu).
• Název - Určuje název sloupce (záhlaví).
• Hodnota - Určuje z které sekce se hodnota vezme (například z kterého příznaku, parametru, skladu, atd.).
  Zobrazuje se pouze v případě, že vaše šablona obsahuje pole například Vlastní sloupec.

Pořadí sloupců

Sloupce se primárně řadí podle toho, jak jednotlivé sloupce přidáváte a odebíráte.

Defaultně je jejich pořadí uzamčeno, abyste si náhodou omylem nerozhodili konfiguraci, která by pak následně nemusela sedět s již vytvořeným souborem. Z toho důvodu je pořadí sloupců přístupné jen pod "vědomou akcí" na zapnutí.

Pozor! Když změníte pořadí sloupců, které neodpovídá vašemu souboru, který používáte například pro importy, import se nemusí provést správně.

1. V pravé horní části klikněte na tlačítko Pozice.
   
2. V tabulce se vám přidá nový sloupec s pořadím sloupců.
3. Nyní již stačí jednoduše chytit řádek v místě ikonky šipek a přetáhnout do příslušné pozice.
   
4. Každý přesun se vám automaticky uloží.

Po dokončení přesunů doporučujeme tlačítko zase odkliknout, abyste si konfiguraci omylem nerozhodili.

Výběr zdroje hodnoty

Pokud jste podle návodu výše nepřidali sloupce hromadně, ale vybrali jste si sloupec, kterému je nutné určit zdroj, ukážeme si nyní jak na to.

Každý typ sloupec má svou hodnotu. Ve většině případů se jedná o sloupce, které generuje Upgates. 
Například Typ sloupce Kód produktu, generuje hodnotu kódu produktu a vy jí nemáte možnost nijak ovlivnit.

Avšak existují i sloupce, které vám umožní určit si vlastní zdroj hodnoty. Tyto sloupce se dělí na dva typy:

• Systémový - Jedná se o sloupec, který je systémový, ale umožňuje ruční změnu zdroje (Například Parametry, Ceny, atd.)
  Takový sloupec vám umožní vybrat konkrétní zdroj hodnoty například tedy sloupec Cena vám umožní vybrat z jakého ceníku se daná cena bude generovat.
  
• Vlastní - Jedná se o sloupec, u kterého si definujete vlastní název i vlastní hodnotu.
  Hodnoty nelze dynamicky měnit například přes různé proměnné. Slouží na vložení "pevné" hodnoty, která se bude opakovat v každém řádku CSV souboru.
  

Pozor! U produktového CSV při výběru skladů může dojít k tomu, že ve výběru zdroje některé sklady neuvidíte. To je z toho důvodu, že sklad, nemá vyplněný kód. Jakmile jej doplníte ve výběru se následně sklad nabídne k vybrání.

Změna názvu sloupce

Každý název sloupce si můžete přizpůsobit podle svého.

Například: Máte svého dodavatele, odběratele nebo dopravce, který vyžaduje specifické názvy sloupců, po kterých identifikuje, co se v daném sloupci nachází.
Díky tomuto přejmenování dosáhnete toho, že systémové názvy sloupců přejmenujete tak, aby externí systém přesně věděl, co se v daném sloupci nachází.

1. Vyhledejte Název, který chcete upravit
2. Na pravé straně klikněte na editační tužku.
   
   
3. Objeví se prázdné pole do kterého si můžete napsat vlastní název.
   
   
   • Pokud pole ponecháte prázdné, bude název sloupce prázdný.
   • Při editaci nemusíte používat závorky [ ]. Můžete napsat i svůj text.

Export podle šablony

Jakmile šablonu máte vytvořenou lze jí používat pro Export i Import. Export lze provádět automaticky (v 24h intervalu), anebo jednorázově ("ihned").

Automatický export

1. V administraci přejděte například do sekce Produkty / Export.
   Konfigurace je možné používat i v těchto sekcích: Kategorie, Objednávky a Zákazníci
2. Klikněte na tlačítko + Nový.
3. Vyberte možnost Vlastní (CSV).
   
   
4. Ve spodní části stránky se vám následně zobrazí možnosti s výběrem šablon konfigurace.
5. Zvolte vytvořenou CSV šablonu, kterou chcete vyexportovat (My vybereme Editace ceny skladu, kterou jsme si vytvořili výše)
   
6. Upravte případně z jakého jazyka se bude export provádět.
   
7. Klikněte na tlačítko Uložit.
8. Tím se vám založí nový export a otevře nové exportní rozhraní, ve kterém si případný export můžete doupravit.
   Doporučujeme zvolit přesný název tohoto exportu. Zjednodušíte si tím pozdější identifikaci exportu.
9. Jakmile budete mít nastavení hotové, klikněte znovu na Uložit.

Po uložení se vám do seznamu všech exportů přidá vámi vytvořený export.

Jednorázový export

1. V administraci přejděte například do sekce Produkty / Seznam produktů.
   Jednorázový export konfigurace je možné používat i v těchto sekcích: Kategorie, Objednávky a Zákazníci
2. Pokud chcete provést export všech záznamů, přejděte rovnou na bod 4.
3. Pokud chcete provést export pouze části záznamů, tak v levé části seznamu (produktů, kategorií, objednávek nebo zákazníků) zatrhněte checkboxy.
4. V pravém horním rohu v tlačítku Více vyberte Export.
   (případně klikněte ještě poté v seznamu na tlačítko Označit vše, abyste skutečně měli všechny produkty zvolené)
5. Zvolte Vlastní CSV.
   
   
6. Zvolte vámi vytvořenou CSV šablonu.
   
7. Následně potvrďte tlačítkem Export.

• Pokud záznamů bylo méně, automaticky se soubor vygeneruje a stáhne.
• Pokud záznamů bylo více, export se automaticky přidá do fronty a vygeneruje při nejbližší možné době. Po jeho vygenerování si jej můžete stáhnout.
  

Import podle šablony

Jakmile šablonu máte vytvořenou lze jí používat pro Export i Import. 

Pozor! Pokud vytvořenou šablonu chcete použít pro zpětný import, je důležité dodržet povinnost povinných polí. Pokud je mít nebudete, import se nebude mít jak spárovat s existujícími produkty.

1. V administraci přejděte do sekce Produkty / Import.
   Konfigurace je možné používat i v těchto sekcích: Kategorie, Objednávky a Zákazníci
2. Klikněte na tlačítko + Nový.
3. V sekci Vlastní vyberte Vlastní - CSV.
   
   
4. Ve spodní části stránky se vám následně zobrazí možnosti s výběrem šablon konfigurace.
5. Zvolte konfiguraci, kterou chcete vyexportovat.
   U importu Upgates defaultně nabízí dva typy importů:
   • Párovat automaticky podle názvů sloupců
     • Tento typ umožňuje nahrát jakýkoli CSV soubor, který nemusí odpovídat vámi předvytvořené šablony, nicméně bude brát pouze takové sloupce, kterým rozumí. Ostatní sloupce přeskočí. Seznam názvů polí, který Upgates zná, najdete v těchto dokumentacích.
   • Vámi vytvořené šablony
     
6. Po výběru šablony, vyskočí nová sekce Jak data chcete importovat
   Určíte zda-li chcete pouze nové, aktualizovat stávající anebo oboji.
7. Následně zvolte Jak často chcete importovat
   Určíte zda-li Jednorázově, Pravidelně anebo Pravidelně - malý import (pouze u produktů).
8. Vyberte příslušný soubor, případně pokud jste zadali Pravidelně tak vložte URL adresu.
9. Klikněte na tlačítko Vytvořit import.
10. Tím se vám založí nový import a otevře nové rozhraní, ve kterém si případný import můžete doupravit.
    Doporučujeme zvolit přesný název tohoto importu (nejlépe podle názvu šablony, kterou pro import používáte). Zjednodušíte si tím pozdější identifikaci importu.
11. Jakmile budete mít nastavení hotové, klikněte znovu na uložit.

Po uložení se vám do seznamu všech importů přidá vámi vytvořený import a jen vyčkáte na jeho dokončení.

Povinné pole

Povinné pole jsou důležité pro správné spárování, anebo založení produktů. Bez nic importní soubor nemusí udělat přesně to co od něj očekáváte.

Import produktů

• Spárování s již existujícími produkty - Je nutné mít sloupec Kód produktu
• Založení nového produktu - Je nutné mít sloupec Název (doporučujeme i Kód produktu)
• Založení nové varianty - Je nutné mít obsažené sloupce s Parametry

Import Kategorií

• Spárování s již existujícími kategoriemi - Je nutné mít sloupec Kód kategorie
• Založení nové kategorie - Je nutné mít sloupec Název (doporučujeme i Kód kategorie)

Import Zákazníků

• Spárování s již existujícími zákazníky - Je nutné mít sloupec email

Více informací v dokumentacích Produkty, Kategorie, Zákazníci