Konfigurátor CSV súborov

Máte dátový súbor vo formáte CSV, ale nie je presne v Upgates formáte? Nevadí! Upgates vám umožní importovať CSV bez zložitých úprav ľahko a rýchlo. Stačí nastaviť šablónu s konfiguráciou, podľa ktorej bude Upgates import CSV spracovávať. Tú potom je možné použiť opakovane pri každom využití daného dátového súboru.

Vlastné CSV je možné použiť pre:

• Produkty - Import aj Export
• Kategória - Import aj Export
• Objednávky - Len Export
• Zákazníci - Import aj Export

Ako konfigurátor aktivovať?

CSV konfigurátor je prístupný zadarmo vracami Upgates doplnku.

1. Vo svojej administrácii prejdite do sekcie Doplnky.
2. Vyhľadajte CSV konfigurácie.
   
3. Kliknite na tlačidlo Aktivovať.

Tým sa vám doplnok automaticky sprístupní a môžete prikročiť k vytváraniu samotných CSV šablón.

Vytvorenie šablóny

Každý import a export musí z niečoho vychádzať. Musí mať šablónu, podľa ktorej sa bude riadiť. Aby sme teda docielili to, že sa súbor správne exportuje/naimportuje musíme najskôr takú šablónu vytvoriť.

Každú vytvorenú šablónu je možné použiť ako pre Export, tak pre Import. Dôležité dávať pozor na povinné pole a typ šablóny (nie je možné šablónu vytvorenú pre Produkty, použiť pre export Zákazníkov, atď.).

Postup v administrácii

Pre príklad tu uvádzame ako vytvoriť CSV šablónu s konfiguráciou pre produkty. Nezabudnite, že šablónu je možné použiť pre Export aj Import a teda nie je dôležité v akej podsekcii ju vytvoríte.

1. V administrácii prejdite do sekcie Doplnky.
   Konfigurácie je možné vytvárať pre tieto sekcie.
2. Kliknite na doplnok CSV konfigurácie. (Doplnok je potrebné mať aktivovaný)
3. V tlačidle + Nová vyberte sekciu Produkty, Kategórie, Objednávky, alebo Zákazníci.
4. Následne si zvoľte typ šablóny:
   • Produkty
     • Vlastný formát  - Umožňuje vytvoriť vlastnú šablónu od základu.
     • Ceny - Obsahuje základné pole pre editáciu cien produktov.
     • Sklad - Obsahuje základné pole na editáciu stavu zásob a dostupnosti.
     • Všetko - Predpripraví šablónu so všetkými stĺpcami, ktoré aktuálne možno použiť.
   • Zákazníci
     • Vlastný formát  - Umožňuje vytvoriť vlastnú šablónu od základu.
     • Všetko - Predpripraví šablónu so všetkými stĺpcami, ktoré aktuálne možno použiť.
   • Kategória
     • Vlastný formát - Umožňuje vytvoriť vlastnú šablónu od základu.
     • Všetko - Predpripraví šablónu so všetkými stĺpcami, ktoré aktuálne možno použiť.
   • Objednávky
     • Vlastný formát - Umožňuje vytvoriť vlastnú šablónu od základu.
     • Všetko - Predpripraví šablónu so všetkými stĺpcami, ktoré aktuálne možno použiť.
5. Po kliknutí na vami zvolený typ šablóny sa vytvorí príslušná šablóna.

Príklad

Na účely tohto manuálu, budeme vytvárať a používať šablónu pre editáciu ceny a skladu pri produktoch.

Keďže neexistuje predvytvorená šablóna na ceny a sklad zároveň, musíme najskôr takú šablónu vytvoriť. Najjednoduchší spôsob je cez Vlastný formát šablóny produktov.

1. V tlačidle + Nová nájdeme sekciu Produkty.
2. Zvolíme šablónu Vlastný formát.
   
3. Prepíšeme názov tak, aby sme šablónu kedykoľvek dokázali jednoducho identifikovať.
   

Uloženie názvu dosiahnete jednoducho tak, že dáte Enter, vykliknete sa myšou mimo daného poľa, alebo pridáte nejaký stĺpec.

Týmto máte novú šablónu konfigurácií založenú. Teraz je potrebné pridať jednotlivé stĺpce.

Pridanie a odobratie stĺpcov

Každý CSV súbor by mal obsahovať nejaké stĺpce, do ktorých sa budú exportovať / importovať dáta.

Pridanie stĺpca

1. V pravej hornej časti stránky kliknite na tlačidlo + Pridať.
2. Otvorí sa vám zoznam možností, ktoré je možné pre CSV export/import použiť.
   Pokiaľ nejaké pole je iba pre export - nemožno ho použiť pre spätný import (import ho preskočí).
   Také pole je označené ikonkou "i".
   

3. Vyberte dáta (stĺpce), ktoré chcete používať.
   Po kliknutí na tlačidlo Pridať sa vám automaticky do šablóny daná hodnota pridá.
   

4. Akonáhle pole pridáte, tlačidlo Pridať zašedne a ďalšie také pole nepridáte.
   Avšak existujú dáta (stĺpce), ktorých je možné pridávať viac. Jedná sa pole napríklad Ceny, Parametre, Vlastné stĺpce, atď.
   

Stĺpce je možné pridávať aj hromadne

Iste vás napadlo, ako si uľahčiť prácu s nutnosťou zložitého vyklikávania v prípade, keď máte veľa parametrov, cenníkov, atď.
Stĺpce, ktoré je možné pridávať opakovane, pretože v e-shope ich môžete vytvárať viac (Cenníky, parametre, vlastné pole,..), je možné pridávať aj hromadne.

1. V pravom hornom rohu kliknite na tlačidlo + Pridať.
2. Vyberte sekciu, ktorú potrebujete pridať viackrát (napríklad Parametre).
3. Vo výberovom poli naklikajte príslušné hodnoty, ktoré potrebujete pridať hromadne.
   
4. Potvrďte tlačidlom Pridať.
5. Systém automaticky pridá jednotlivé stĺpce a priradí vami vybrané parametre do nových stĺpcov.
   

Aby sme zaistili prehľadnosť šablóny, je každý riadok rovný jednému stĺpcu v CSV súbore. V orientácii vám môže pomôcť stĺpec s rozpisom poradia (A = 1. stĺpec, B = 2.stĺpec, atď.)

Pozor! Pokiaľ vytvorenú šablónu chcete použiť pre spätný import, je dôležité dodržať povinnosť povinných polí. Ak ich mať nebudete, import sa nebude mať ako spárovať s existujúcimi produktmi.

Pozor! Ak v CSV šablónach využívate Vlastné polia, alebo iné sekcie, ktoré je možné pridávať ako (Parametre, Cenníky, Štítky, atď.), tak šablóny sa dynamicky nemenia spolu so založením nového parametra, cenníka, štítkov, atď. Je potrebné vždy šablónu dodatočne upraviť a nový parameter, cenník, štítok do nej pridať.

Príklad

Ako sme uvádzali vyššie. Vytvárame šablónu na editáciu ceny a skladu zároveň. Vyberieme stĺpce, ktoré nám pomôžu identifikovať správne produkty a umožnia ich editáciu stavu zásob a cien.

Výstupný súbor po exporte

Zmazanie stĺpca

Pokiaľ sa náhodou pri vyberaní stĺpcov ukliknete, môžete vždy daný riadok so stĺpcom zmazať. Pri nájazde myšou na konkrétny riadok, môžete cez ikony na pravej strane konkrétny stĺpec zmazať. Po kliknutí stačí len potvrdiť potvrdzovacie okno, ktoré bráni nechcenému zmazaniu a potom sa riadok odoberie.

Zakaždým keď nejaký stĺpec pridáte, alebo odoberiete sa celková šablóna preuloží. Nestratíte tak vami rozpracované dáta v prípade, keď by ste si omylom stránku napríklad zatvorili.

Editácia stĺpcov

Tabuľka šablóny sa skladá z niekoľkých stĺpcov

• Stĺpec - Obsahuje hodnoty určujúce poradie stĺpcov.
• Zdroj - Určujúce typ obsahu stĺpca (napríklad Kód produktu).
• Názov - Určuje názov stĺpca.
• Hodnota - Určuje z ktorej sekcie sa hodnota vezme (napríklad z ktorého príznaku, parametra, skladu, atď.).
  Zobrazuje sa iba v prípade, že vaša šablóna obsahuje pole napríklad Vlastný stĺpec.

Poradie stĺpcov

Stĺpce sa primárne radia podľa toho, ako jednotlivé stĺpce pridávate a odoberáte.

Defaultne je ich poradie uzamknuté, aby ste si náhodou omylom nerozhodili konfiguráciu, ktorá by potom následne nemusela sedieť s už vytvoreným súborom. Z toho dôvodu je poradie stĺpcov prístupné len pod "vedomou akciou" na zapnutie.

Pozor! Keď zmeníte poradie stĺpcov, ktoré nezodpovedá vášmu súboru, ktorý používate napríklad pre importy, import sa nemusí vykonať správne.

1. V pravej hornej časti kliknite na tlačidlo Pozícia.
   
   
2. V tabuľke sa vám pridá nový stĺpec s poradím stĺpcov.
3. Teraz už stačí jednoducho chytiť riadok v mieste ikonky šípok a pretiahnuť do príslušnej pozície.
   
4. Každý presun sa vám automaticky uloží.

Po dokončení presunov odporúčame tlačidlo zase odkliknúť, aby ste si konfiguráciu omylom nerozhodili.

Výber zdroja hodnoty

Pokiaľ ste podľa návodu vyššie nepridali stĺpce hromadne, ale vybrali ste si stĺpec, ktorému je nutné určiť zdroj, ukážeme si teraz ako na to.

Každý typ stĺpec má svoju hodnotu. Vo väčšine prípadov ide o stĺpce, ktoré generuje Upgates.
Napríklad Typ stĺpca Kód produktu, generuje hodnotu kódu produktu a vy ju nemáte možnosť nijako ovplyvniť.

Avšak existujú aj stĺpce, ktoré vám umožnia určiť si vlastný zdroj hodnoty. Tieto stĺpce sa delia na dva typy:

• Systémový - Jedná sa o stĺpec, ktorý je systémový, ale umožňuje ručnú zmenu zdroja (Napríklad Parametre, Ceny, atď.)
  Takýto stĺpec vám umožní vybrať konkrétny zdroj hodnoty napríklad teda stĺpec Cena vám umožní vybrať z akého cenníka sa daná cena bude generovať.
• Vlastné - Ide o stĺpec, pri ktorom si definujete vlastný názov aj vlastnú hodnotu.
  Hodnoty nemožno dynamicky meniť napríklad cez rôzne premenné. Slúži na vloženie "pevnej" hodnoty, ktorá sa bude opakovať v každom riadku CSV súboru.
  

Pozor! Pri produktovom CSV pri výbere skladov môže dôjsť k tomu, že vo výbere zdroja niektoré sklady neuvidíte. To je z toho dôvodu, že sklad, nemá vyplnený kód. Akonáhle ho doplníte vo výbere sa následne sklad ponúkne na vybranie.

Zmena názvu stĺpca

Každý názov stĺpca si môžete prispôsobiť podľa svojho.

Napríklad: Máte svojho dodávateľa, odberateľa alebo dopravcu, ktorý vyžaduje špecifické názvy stĺpcov, po ktorých identifikuje čo sa v danom stĺpci nachádza.
Vďaka tomuto premenovaniu dosiahnete to, že systémové názvy stĺpcov premenujete tak, aby externý systém presne vedel, čo sa v danom stĺpci nachádza.

1. Vyhľadajte Názov, ktorý chcete upraviť
2. Na pravej strane kliknite na editačnú ceruzku.
   
3. Objaví sa prázdne pole do ktorého si môžete napísať vlastný názov.
   
   
   • Ak pole ponecháte prázdne, bude názov stĺpca prázdny.
   • Pri editácii nemusíte používať zátvorky [ ]. Môžete napísať aj svoj text.

Export podľa šablóny

Akonáhle šablónu máte vytvorenú je možné ju používať pre Export aj Import. Export je možné vykonávať automaticky (v 24h intervale), alebo jednorazovo ("ihneď").

Automatický export

1. V administrácii prejdite do sekcie Produkty / Export.
   Konfigurácie je možné používať aj v týchto sekciách: Kategórie, Objednávky a Zákazníci
2. Kliknite na tlačidlo + Nový.
3. Vyberte možnosť Vlastné (CSV).
   
   
4. V spodnej časti stránky sa vám následne zobrazia možnosti s výberom šablón konfigurácie.
5. Zvoľte vytvorenú CSV šablónu, ktorú chcete vyexportovať (My vyberieme Editácia ceny skladu, ktorú sme si vytvorili vyššie)
   
6. Upravte prípadne z akého jazyka sa bude export vykonávať.
   
7. Kliknite na tlačidlo Uložiť.
8. Tým sa vám založí nový export a otvorí nové exportné rozhranie, v ktorom si prípadný export môžete doupraviť.
   Odporúčame zvoliť presný názov tohto exportu. Zjednodušíte si tým neskoršiu identifikáciu exportu.
9. Akonáhle budete mať nastavenie hotové, kliknite znovu na Uložiť.

Po uložení sa vám do zoznamu všetkých exportov pridá vami vytvorený export.

Jednorazový export

1. V administrácii prejdite napríklad do sekcie Produkty / Zoznam produktov.
   Jednorazový export konfigurácie je možné používať aj v týchto sekciách: Kategórie, Objednávky a Zákazníci
2. Ak chcete vykonať export všetkých záznamov, prejdite rovno na bod 4.
3. Pokiaľ chcete vykonať export iba časti záznamov, tak v ľavej časti zoznamu (produktov, kategórií, objednávok, alebo zákazníkov) zaškrtnite checkboxy.
4. V pravom hornom rohu v tlačidle Viac vyberte Export.
   (prípadne kliknite ešte potom v zozname na tlačidlo Označiť všetko, aby ste skutočne mali všetky produkty zvolené)
5. Zvoľte Vlastné CSV.
   
6. Zvoľte vami vytvorenú CSV šablónu.
   
7. Následne potvrďte tlačidlom Export.

• Pokiaľ záznamov bolo menej, automaticky sa súbor vygeneruje a stiahne.
• Pokiaľ záznamov bolo viac, export sa automaticky pridá do frontu a vygeneruje pri najbližšej možnej dobe. Po jeho vygenerovaní si ho môžete stiahnuť.
  

Import podľa šablóny

Akonáhle šablónu máte vytvorenú je možné ju používať pre Export aj Import.

Pozor! Pokiaľ vytvorenú šablónu chcete použiť pre spätný import, je dôležité dodržať povinnosť povinných polí. Ak ich mať nebudete, import sa nebude mať ako spárovať s existujúcimi produktmi.

1. V administrácii prejdite do sekcie Produkty / Import.
   Konfigurácie je možné používať aj v týchto sekciách: Kategórie, Objednávky a Zákazníci
2. Kliknite na tlačidlo + Nový.
3. V sekcii Vlastné vyberte Vlastné - CSV.
   
   
4. V spodnej časti stránky sa vám následne zobrazia možnosti s výberom šablón konfigurácie.
5. Zvoľte konfiguráciu, ktorú chcete vyexportovať
   Pri importe Upgates defaultne ponúka dva typy importov:
   • Párovať automaticky podľa názvov stĺpcov
     Tento typ umožňuje nahrať akýkoľvek CSV súbor, ktorý nemusí zodpovedať vami predvytvorené šablóny, ale bude brať iba také stĺpce, ktorým rozumie. Ostatné stĺpce preskočia. Zoznam názvov polí, ktorý Upgates pozná, nájdete v týchto dokumentáciách.
   • Vami vytvorené šablóny
     
     
6. Po výbere šablóny, vyskočí nová sekcia Ako dáta chcete importovať
   Určíte či chcete iba nové, aktualizovať existujúce alebo oboje.
7. Následne zvoľte Ako často chcete importovať
   Určíte či Jednorazovo, Pravidelne alebo Pravidelne - malý import(len pri produktoch).
8. Vyberte príslušný súbor, prípadne ak ste zadali Pravidelne tak vložte URL adresu.
9. Kliknite na tlačidlo Vytvoriť import.
10. Tým sa vám založí nový import a otvorí nové rozhranie, v ktorom si prípadný import môžete doupraviť.
    Odporúčame zvoliť presný názov tohto importu (najlepšie podľa názvu šablóny, ktorú na import používate). Zjednodušíte si tým neskoršiu identifikáciu importu.
11. Akonáhle budete mať nastavenie hotové, kliknite znova na uložiť.

Po uložení sa vám do zoznamu všetkých importov pridá vami vytvorený import a len počkáte na jeho dokončenie.

Povinné pole

Povinné polia sú dôležité pre správne spárovanie alebo založenie produktov. Bez nič importný súbor nemusí urobiť presne to čo od neho očakávate.

Import produktov

• Škárovanie s už existujúcimi produktmi - Je nutné mať stĺpec Kód produktu
• Založenie nového produktu - Je nutné mať stĺpec Názov (odporúčame aj Kód produktu)
• Založenie novej varianty - Je nutné mať obsiahnuté stĺpce s Parametre

Import Kategórií

• Škárovanie s už existujúcimi kategóriami - Je nutné mať stĺpec Kód kategórie
• Založenie novej kategórie - Je nutné mať stĺpec Názov (odporúčame aj Kód kategórie)

Import Zákazníkov

• Spárovanie s už existujúcimi zákazníkmi - Je nutné mať stĺpec email

Viac informácií v dokumentáciách Produkty, Kategórie, Zákazníci