Importování dat

Před importem dat je nutné import nastavit. Nejprve je potřeba vytvořit mapování pro číselníky.

Nové mapování číselníku

Formulář slouží k vytvoření nového mapování číselníku.

Do pole Název nového mapování číselníku vyplňte název, který jednoznačně identifikuje dané nastavení, protože tento název se jako jediný zobrazuje ve výběru nastavení.

Pole Popis mapování číselníku slouží jen jako krátká poznámka, která se zobrazuje pouze v detailu mapovani ciselniku.

V části Výběr číselníku nejprve zvolte číselník z výběru a pak teprve vyplňujte část Vyplnění příslušných hodnot k mapování číselníku, protože po změně číselníku bude zmíněná část vymazána.

V části Vyplnění příslušných hodnot k mapování číselníku se vyplňují jednotlivé hodnoty ve vstupním souboru a jim náležící význam.

Seznam mapování číselníků

Formulář obsahuje seznam všech vytvořených mapování číselníků pro číselník zvolený ve výběru Výběr číselníku. Umožňuje jejich úpravu (kliknutím na tlačítko Upravit) a výmaz (kliknutím na tlačítko Smazat).

Detail mapování číselníku

Do tohoto formuláře se dostanete ze seznamu mapování číselníků. Slouží ke zobrazení mapování číselníku a jeho úpravám. Upravené mapování je možné uložit kliknutím na tlačítko Ulož. Kliknutím na tlačítko Zpět se vrátíte do seznamu mapování číselníků bez uložení změn. Více o položkách v tomto formuláři naleznete v nápovědě k formuláři Nové mapování číselníku.

Nastavení mapování číselníku

Mapování číselníku obsahuje informace o tom, jaký význam mají hodnoty ve vstupním souboru. Mapování se vytváří pro číselník typů zásilek, měn, zemí a časů doručení. Mapování není nutné nastavovat, pokud odpovídá přednastavenému mapování. Přednastavené mapování typů zásilek má název „-Typ zásilky-“ a obsahuje tyto hodnoty:

Hodnota v importovaném souboru	Význam v číselníku
1	PPL Parcel CZ Business
Firemní balík	PPL Parcel CZ Business
2	PPL Parcel CZ Business - dobírka
Firemní balík - dobírka	PPL Parcel CZ Business - dobírka
7	PPL Dopolední balík
Dopolední balík	PPL Dopolední balík
8	PPL Dopolední balík - dobírka
Dopolední balík - dobírka	PPL Dopolední balík - dobírka
9	PPL Exportní balík
Exportní balík	PPL Exportní balík
10	PPL Exportní balík - dobírka
Exportní balík - dobírka	PPL Exportní balík - dobírka
13	PPL Parcel CZ Private
Soukromý balík	PPL Parcel CZ Private
14	PPL Parcel CZ Private - dobírka
Soukromý balík - dobírka	PPL Parcel CZ Private - dobírka
36	PPL Parcel Connect
PPL Parcel Connect	PPL Parcel Connect
37	PPL Parcel Connect - dobírka
PPL Parcel Connect - dobírka	PPL Parcel Connect - dobírka
38	PPL Parcel International
PPL Parcel International	PPL Parcel International
46	PPL Parcel CZ Smart
PPL Parcel CZ Smart - dobírka	PPL Parcel CZ Smart - dobírka
48	PPL Parcel Smart Europe
PPL Parcel Smart Europe - dobírka	PPL Parcel Smart Europe - dobírka

Přednastavené mapování měn má název „-Kód měny-“ a obsahuje tyto hodnoty:

Hodnota v importovaném souboru	Význam v číselníku
1	PPL Parcel CZ Business
Firemní balík	PPL Parcel CZ Business
2	PPL Parcel CZ Business - dobírka
Firemní balík - dobírka	PPL Parcel CZ Business - dobírka
7	PPL Dopolední balík
Dopolední balík	PPL Dopolední balík
8	PPL Dopolední balík - dobírka
Dopolední balík - dobírka	PPL Dopolední balík - dobírka
9	PPL Exportní balík
Exportní balík	PPL Exportní balík
10	PPL Exportní balík - dobírka
Exportní balík - dobírka	PPL Exportní balík - dobírka
13	PPL Parcel CZ Private
Soukromý balík	PPL Parcel CZ Private
14	PPL Parcel CZ Private - dobírka
Soukromý balík - dobírka	PPL Parcel CZ Private - dobírka
36	PPL Parcel Connect
PPL Parcel Connect	PPL Parcel Connect
37	PPL Parcel Connect - dobírka
PPL Parcel Connect - dobírka	PPL Parcel Connect - dobírka
38	PPL Parcel International
PPL Parcel International	PPL Parcel International
46	PPL Parcel CZ Smart
PPL Parcel CZ Smart - dobírka	PPL Parcel CZ Smart - dobírka
48	PPL Parcel Smart Europe
PPL Parcel Smart Europe - dobírka	PPL Parcel Smart Europe - dobírka

Přednastavené mapování zemí má název „-Kód země-“ a obsahuje tyto hodnoty:

Hodnota v importovaném souboru	Význam v číselníku
AT	Rakousko
Rakousko	Rakousko
BE	Belgie
Belgie	Belgie
CZ	Česká republika
Česká republika	Česká republika
DE	Německo
Německo	Německo
DK	Dánsko
Dánsko	Dánsko
EE	Estonsko
Estonsko	Estonsko
ES	Španělsko
Španělsko	Španělsko
FI	Finsko
Finsko	Finsko
FR	Francie
Francie	Francie
GB	Velká Británie
Velká Británie	Velká Británie
HU	Maďarsko
Maďarsko	Maďarsko
CH	Švýcarsko
Švýcarsko	Švýcarsko
IE	Irsko
Irsko	Irsko
IT	Itálie
Itálie	Itálie
LT	Litva
Litva	Litva
LV	Lotyšsko
Lotyšsko	Lotyšsko
NL	Nizozemí
Nizozemí	Nizozemí
NO	Norsko
Norsko	Norsko
PL	Polsko
Polsko	Polsko
PT	Portugalsko
Portugalsko	Portugalsko
SE	Švédsko
Švédsko	Švédsko
SI	Slovinsko
Slovinsko	Slovinsko
SK	Slovensko
Slovensko	Slovensko
US	USA
USA	USA

Přednastavené mapování časů doručení má název „-Název rozmezí-“ a obsahuje tyto hodnoty:

Hodnota v importovaném souboru	Význam v číselníku
1	Den
Den	Den
2	Večer
Večer	Večer

Přednastavené mapování kontroly věku při doručení (AgeCheck) obsahuje tyto hodnoty:

Hodnota v importovaném souboru	Význam v číselníku
15+	Přijemce starší než 15let.
A15	Přijemce starší než 15let.
18+	Přijemce starší než 18let.
A18	Přijemce starší než 18let.

Přednastavené mapování hmotnosti zásilky (pouze u zásilek do Německa):

Hodnota v importovaném souboru	Význam v číselníku
0+	Pod 10 kg
10+	10–20 kg
20+	Nad 20 kg

Pokud tedy hodnoty v importovaném souboru odpovídají hodnotám uvedeným v tabulkách nalevo a jejich význam hodnotám uvedeným napravo, není potřeba vytvářet žádné mapování číselníku. Pokud ne, více o vytváření mapování se dozvíte v nápovědě k formuláři pro vytvoření a editaci mapování číselníku. Mapování číselníku je po nastavení možné použít v libovolném nastavení importu.

Nastavení importu

Dalším krokem je nastavení samotného importu. To se provádí zvlášť pro zákazníky a zvlášť pro zásilky a v obou případech se dělí na dvě části. Nastavení formátu vstupních dat a nastavení, který sloupec ze vstupního souboru má být namapován na kterou položku zákazníka či zásilky. Dále se budu zabývat společnými vlastnostmi formulářů pro nastavení importu zákazníků a zásilek.

Do pole Název nastavení vyplňte název, který jednoznačně identifikuje dané nastavení, protože tento název se jako jediný zobrazuje ve výběru nastavení.

V části Typ importovaného souboru nejprve zvolte typ souboru z výběru a pak teprve vyplňujte ostatní údaje, protože po změně typu souboru se zobrazí jiné položky k nastavení.

Pokud zašktnete Importovat i záznamy s chybou, budou importovány i záznamy, při jejichž importu došlo k některé z následujících chyb:

některý ze sloupců nebyl ve vstupním souboru nalezen,

hodnotu v některém ze sloupců se nepodařilo převést na správný typ.

O těchto chybách sice budete informováni, ale budete pak muset chybné záznamy buď smazat nebo uptavit, což může být při větším množství záznamů zdlouhavé.

Nastavení importu souboru s pevnou šířkou sloupce

Import souboru s pevnou šířkou sloupce očekává na vstupu textový soubor, ve kterém je použit oddělovač na oddělení řádků a sloupce mají pevný počet znaků.

V poli Encoding se volí kódování vstupního souboru.

Do pole Šířka sloupce defaultní je vhodné zadat nejčastější šířku sloupce. Ta pak bude doplněna jako šířka všech sloupců, u kterých není šířka zadána v tabulce ve spodní části Parametrů souboru s pevnou šířkou sloupce.

Pole Šířka mezery defaultní má stejný význam jako předchozí pole, ale určuje šířku mezery mezi sloupci, která se nemá počítat jako obsah žádného z nich (obvykle žádná mezera mezi sloupci není a bývá proto vyplněna hodnota 0).

Pokud není zaškrtnuto pole Povolit konec řádku uprostřed sloupce, zakáže se import řádků, u nihž řádek končí uprostřed sloupce. Například když má řádek 100 znaků a je nastaveno, že každý sloupec má 30 znaků, nebude řádek importován, protože poslední sloupec má 10 znaků místo 30ti.

V poli Oddělovač řádků je potřeba buď vybrat znak, kterým jsou ve vstupním souboru odděleny řádky nebo zvolit hodnotu Tisknutelný znak ve vedlejším poli a oddělovač zadat do prázdného pole napravo.

Pokud je zaškrtnuto pole Ořezat bílé znaky, budou ořezány bílé znaky (mezera, tabulátor) na začátku a na konci textu každého sloupce.

Pokud je zaškrtnuto pole Vynechat první řádek, bude první řádek ze vstupního souboru vynechán. Tato volba se používá, pokud první řádek obsahuje názvy sloupců.

V tabulce dole se vyplňuje šířka sloupce a mezery u sloupců, jejichž parametry se neshodují s defaultní šířkou sloupce a nebo defaultní šířkou mezery.

Nastavení importu souboru s oddělovači

Import souboru s oddělovači očekává na vstupu textový soubor, ve kterém je použit oddělovač na oddělení sloupců a jiný oddělovač na oddělení řádků.

V poli Encoding se volí kódování vstupního souboru.

V poli Oddělovač sloupců je potřeba buď vybrat znak, kterým jsou ve vstupním souboru odděleny sloupce nebo zvolit hodnotu Tisknutelný znak ve vedlejším poli a oddělovač zadat do prázdného pole napravo.

V poli Únikový znak můžete zadat znak, který ruší speciální význam následujícího znaku a vypíše ho do výsledku. Pokud je potřeba vypsat únikový znak, musí být v souboru dvakrát za sebou. Pokud například zvolím jako únikový znak '' a jako oddělovač sloupců ';', pak dvojice znaků ';' neukončí sloupec ale vypíše do daného sloupce ';'.

V poli Uvozovací znak můžete zadat znak který je použit jako uvození řetězce. Řetězec začíná a končí uvozovacím znakem. V řetězci je zrušen speciální význam všech znaků kromě uvozovacího, který řetězec ukončuje.

Pokud je zaškrtnuto pole Dva uvozovací znaky jako jeden, jsou dva uvozovací znaky za sebou dány na výstup jako jeden uvozovací znak (toto chování je obvyklé při výstupu z tabulkových procesorů).

Pokud je zaškrtnuto pole Ořezat bílé znaky budou ořezány bílé znaky (mezera, tabulátor) na začátku a na konci textu každého sloupce.

Pokud je zaškrtnuto pole Vynechat první řádek bude první řádek ze vstupního souboru vynechán. Tato volba se používá, pokud první řádek obsahuje názvy sloupců.

Nastavení importu XML souboru

Abyste mohli nastavit import XML musíte mít alespoň základní informace o struktuře tohoto souborového formátu. Pokud nic o struktuře xml nevíte nebo si nebudete jisti významem některého z pojmů, který budu dále používat, odpověď můžete najít na webu například zde. V nastavení importu se pro identifikaci atributů a elementů používá vyhledávací jazyk XPath. XPath není triviálním jazykem, ale většinou Vám bude pro nastavení importu stačit znát jen malou část, kterou naleznete ve zkratce popsanou v kapitole Minimum jazyka XPath. Pokud Vám můj popis nestačí, více se můžete naučit například zde.

Pro usnadnění práce s XML byl do aplikace zabudován pomocník, který Vám bude napovídat, jak může dále pokračovat Váš XPath řetězec. Aby tento pomocník fungoval, musíte zvolit v poli testovací soubor co nejkratší soubor, který obsahuje všechny elementy a atributy, které budete chtít v importu použít. Jakmile soubor zvolíte, stiskněte tlačítko Použít napravo od pole, kde jste vyplnili cestu k souboru. Pokud bude soubor úspěšně načten, zobrazí se Vám pod tlačítkem text "Testovací soubor je načten.".

Do pole Výběr elementů reprezentujících řádky pak musíte zadat XPath, jehož počátek je nastaven na element dokumentu a vybere všechny elementy, které mají být považovány za jednotlivé zásilky nebo zákazníky ve Vámi definovaném importu. Pokud zachováte původní XPath //, budou vybrány všechny elementy, které jsou přímými potomky kořenových elementů.

Zásadním rozdílem mezi importem XML a ostatními nastavitelnými importy je, že není tabulkový, tudíž se v mapování hodnot do jednotlivých položek (Ulice, Město, ...) nemůžou použít čísla sloupců. Je zde opět použit jazyk XPath. Tentokráte je však pro XPath počáteční element nastaven na elementy reprezentující řádky a musíte se z nich dostat na alementy či atributy reprezentující jednotlivé položky. Jazyk XPath je zde pro zjednodušení rozšířen o spojky, na které jste již možná zvyklí při zadávání čísel sloupců, tedy znaky + a ;. Vzhledem k tomu musel být trochu upraven jazyk XPath a pokud v něm chcete použít znak + musíte napsat +, pro znak ; zase ; a znak \ musíte zdvojit na \. Je nepravděpodobné, že budete ve Vašem XPath řetězci jeden ze jmenovaných znaků potřebovat, a proto jsem popsaným způsobem zachoval možnost slučování obsahu elementů pomocí + a výběr prvního neprázdného elementu pomocí ; jako u tabulkových importů. Můžete tedy napsat například takovýto výraz:

ulice + cislo_domu ; ulice_a_cislo_domu

Uvedený příklad způsobí, že se do databáze vloží obsah elemetu ulice oddělený mezerou od obsahu elementu cislo_domu a pokud budou oba tyto elementy prázdné, vloží se obsah elementu ulice_a_cislo_domu. Prioritu + a ; nelze změnit a + zde má stejně jako u tabulkových importů přednost před ; (+ se vyhodnocuje jako první). Pokud by XPath výraz s počátkem na některém z elementů reprezentujících řádek vrátil více než jeden element respektive atribut, do databáze by byl vložen obsah všech vybraných elementů a atributů oddělených mezerami. Pokud bude XPath obsahovat element, který má potomky, bude do databáze vložen veškerý textový obsah jeho i jeho potomků.

Společné nastavení pro všechny typy souboru

Pod specifickým nastavením pro různé typy vstupních souborů je nastavení společné. Zde se vyplňují čísla sloupců (s výjimkou importu XML souboru), na kterých jsou údaje k nalezení ve vstupním souboru, defaultní hodnoty, které jsou do databáze vloženy, pokud není zadáno číslo sloupce nebo dojde k chybě při importu daného sloupce, a mapování, která se mají použít pro číselníky. Pole číslo sloupce může obsahovat více čísel sloupců oddělených znaky + a ;. Znak + spojuje obsah sloupců a vkládá mezi ně mezeru. Vkládání mezery je možné zakázat vložením -s na začátek definice čísel sloupců. Znak ; způsobí ukončení zpracování, pokud již je neprázdný výsledek, pokud ne, pokračuje dále. Můžete tedy napsat například toto:

1+2;3

Uvedený příklad způsobí, že se do databáze vloží obsah sloupce číslo 1 oddělený mezerou od obsahu sloupce číslo 2 a pokud budou oba tyto sloupce prázdné, vloží se obsah sloupce číslo 3. Příklad s použitím parametru -s :

-s 1+2;3

Vysledek bude téměř stejný, jako u předchozího příkladu, ale mezi sloupcem číslo 1 a sloupcem číslo 2 nebude mezera. Výraz se vyhodnocuje zleva doprava, + zde má přednost před ; (+ se vyhodnocuje jako první) a prioritu + a ; nelze změnit (nelze použít závorky). Místo čísel sloupců také můžete zadat text v uvozovkách. Zadaný text (bez uvozovek) pak bude považován za obsah sloupce. Tak se můžete vyhnout chybovým hlášením u sloupců, které na některých řádcích importovaného souboru vůbec nejsou (například chybějící poslední sloupec). Následující nastavení

10;"CZK"

importuje 10. soupec, ale pokud bude mít importovaný řádek pouze 9 sloupců, importuje text CZK. Uvozovky v textu musí být zdvojené jinak import nebude fungovat. Text Faktura "321654" bude vložen pokud bude v nastavení uvedeno "Faktura ""321654""".

Import dat

Jakmile je nastavem import dat, je možné toto nastavení opakovaně používat pro importování dat ve zvoleném formátu. Po importu jsou všechna data vložena do databáze a je zobrazen formulář se všemi importovanými záznamy a chybami, ke kterým při importu došlo. Importované záznamy je možné v tomto formuláři smazat a upravovat. Více o importu naleznete v nápovědě k formuláři pro import zákazníků a zásilek.

Nové mapování číselníku#

Seznam mapování číselníků#

Detail mapování číselníku#

Nastavení mapování číselníku#

Nastavení importu#

Nastavení importu souboru s pevnou šířkou sloupce#

Nastavení importu souboru s oddělovači#

Nastavení importu XML souboru#

Společné nastavení pro všechny typy souboru#

Import dat#