Definície definovateľných importov - záložka Detail

Obsiahnuté subzáložky: Hlavička Obsah Formuláre

Záložka zobrazí detailní informace k aktuální definici ze záložky Seznam. Položky jsou standardně rozděleny do subzáložek dle svého významu:

V hornej časti záložky Detail môže byť variantne zobrazený niektorý z Panelov definovateľných údajov detailu pre túto agendu. Zobrazenie panela definovateľných údajov detailu závisí od aktuálneho nastavenia v menu Nastavenie pre danú agendu a prihláseného užívateľa.

Subzáložka Hlavička

Tlačidlo v pravej hornej časti indikuje, že ide o variantný vstupný formulár.

Jedná se o definovatelné formuláře, tudíž jejich konkrétní vzhled v dané instalaci nemusí zcela přesně odpovídat stavu popsaném dále v tomto textu (zejména co se týče popisného pojmenování položek či jejich uspořádání v těchto formulářích). Preto je kvôli lepšej identifikácii ďalej popísaných položiek pri väčšine z nich uvedený aj jej konkrétny názov v databáze (italikou), viď identifikácia popisovaných položiek. Vďaka tomu si môžete definovať vlastný vzhľad tohto formulára, tzn. napr. založiť si a pridať si sem ďalšie položky, viď Pridávanie ďalších užívateľských položiek, môžete si definovať aj niekoľko variant takéhoto formulára a je potrebné ich aj podmienene prepínať, viď Tvorba ďalších variant formulára, prepínanie variant. Nepotrebné položky si je možné aj skryť, aby zbytočne na obrazovke neprekážali. Viď Skrývanie položiek.

Popis položiek var. formulára v továrenskom nastavení:

Názov Popis
Kód projektu
Code		 Kód pro danou definici importu. Všeobecne môže ísť o ľubovoľný alfanumerický reťazec 1-40 znakov dlhý. Je to nepovinná položka, ale odporúčame ju určite využívať. Kód by měl být unikátní a co nejvýstižnější, aby usnadňoval pozdější orientaci v seznamech definic importů.
Názov projektu
Name

Název pro danou definici importu. Všeobecne môže ísť o ľubovoľný alfanumerický reťazec 1-160 znakov dlhý. Je to nepovinná položka, ale odporúčame ju určite využívať. Název by měl být unikátní a co nejvýstižnější, aby usnadňoval pozdější orientaci v seznamech definic importů.

Zdroj dát
ImportDataSource_ID		 Zdroj dat importu odkazující do číselníku Zdroje dat definovatelných importů. Povinný údaj.
Rozširujúci modul
Extension

Volba, zda se má pro zpracování použít rozšiřující nástavba definovatelného importu např. EDI. Východisková hodnota: Žádný.
Len parsovať
IsOnlyParse

Informace, jestli se bude přímo zapisovat do business objektu (nezatrženo) nebo se jen provede parsování obsahu importního souboru a data se místo do business objektu uloží do dokladu dokumentů pro uživatelskou kontrolu (pole zatrženo)

Východisková hodnota: Ano (zatrženo).
Len overiť
IsOnlyValidate

informace, jestli se bude pouze testovat správnost definice pro založení nebo aktualizaci business objektu (zatrženo). Při tomto nastavení se nevytváří žádný dokument ani se nezakládá/neaktualizuje business objekt.

Východisková hodnota: Ne (nezatrženo).
Typ transakcie
TransactionType

V tuto chvíli nemá položka využití, je zde pouze připravena do budoucna. Bude možné zvolit, zda se bude import celého souboru zpracovávat v rámci jedné databázové transakce (hodnota: 0), po blocích dle nastaveného počtu záznamů (hodnota > 1) nebo bude transakce samostatná pro každý jednotlivý business objekt (hodnota: 1).

Východisková hodnota: 1

Archivovať dokument
IsDocumentArchive

Volba, zda se bude obsah původního (neparsovaného) importního souboru archivovat jako příloha v novém dokladu dokumentu.

Východisková hodnota: Ne (nezatrženo).

Prechádzať sekvenčne

ProcessSequentially

Pole určující, jestli se bude obsah importního souboru zpracovávat postupně tj. sekvenčně.

Východisková hodnota: Ano (zatrženo).

Sekvenční zpracování dat - Data jsou v importním souboru vždy uvedena za sebou a všechny položky jsou pro každý hlavičkový business objekt uvedeny v jednom řádku.

Nesekvenční zpracování dat - Data jsou v importním souboru uvedena napřeskáčku, tj. pořadí řádků v importních datech neodpovídá pořadí business objektů uvedených v importní definici. Pro nesekvenční import dat není možné mít v importních datech uvedeno více záznamů dané hlavičky

Riadky pre preskočenie

SkipLeadingRows

Volba má význam pro textový soubor. Určuje počet řádků, které se na začátku zpracování souboru přeskočí. Typicky se jedná o hlavičku sloupců.

Východisková hodnota: 0 (žádné řádky se nepřeskakují).

Typ importu

ImportType

Informace, jakého typu je importní soubor. Povinná položka.

Typ importu TXT:

Jedná se o import dat v textovém formátu. Položky pro import se v importních datech definují pozicí a délkou.

Typ importu CSV:

Jedná se o import dat v textovém formátu. Položky pro import se v importních datech definují oddělovačem a pořadím položky v rámci jednoho řádku.

Pro správné importování diakritiky při použitém kódování UTF 8 je potřeba využít volbu UTF 8 s BOM.

Typ importu XML:

Jedná se o import dat v XML strukturovaném formátu. Položky pro import se v importních datech definují pomocí XML větví.

Typ importu Excel:

Jedná se o import dat z tabulky MS Excel. Položky pro import se v importních datech definují pomocí názvu sloupce v Excelu a názvu záložky. Podporován je formát XLS i XLSX.

Načítání dat z MS Excel probíhá pomocí OLE MS Excelu. Proto je nutné mít na počítači, kde import probíhá, MS Excel fyzicky nainstalován.

Vlastní zpracování importu pak probíhá jako pro typ importu CSV. Je tedy podporováno a většinou i přímo vyžadováno používání masek řádků pro rozlišení typů importovaných objektů.

Kromě oficiálně podporovaných formátu XLS a XLSX funguje import i z formátů jiných tabulkových kalkulátorů, např. Open Office (formát ODT). Přesto je ale nutné mít na počítači MS Excel nainstalován, jelikož, jak je již výše zmíněno, načítání dat z MS Excel probíhá pomocí OLE MS Excelu.

Východiskový oddeľovač CSV

CSV_DefaultSeparator

Znak oddělení položek CSV, použije se pro předvyplnění obdobné položky na položkách definice importu. Položka je pro typ importu CSV povinná.

Znak ohraničujúci CSV text

CSV_QuoteChar

Ohraničení textu CSV v importních datech. Jde především o situaci ,kdy je potřeba mít uvnitř položky středník (znak uvedený jako oddělovač), ale nejedná se o oddělovač.

CSV znaky konca riadka

XLS_LineBreak

Znaky odřádkování. Výběr z přednastavených voleb odřádkování typického pro platformy Windows, Mac a Unix.

Spôsob čítania dát z Excelu

XLS_ReadValueType

Položka je k dispozici jen v případě, že je zvolen Typ importu Excel. Volba určuje způsob přebírání dat z Excelu.

Skutečná hodnota - Data se budou přebírat bez ohledu na jejich formátování v MS Excel.

Zformátovaná hodnota - Data budou přebírat včetně použitého formátování v MS Excel.

Úroveň logovania

LogLevel

Volba ovlivňuje, které logované informace z procesu zpracování definovatelných importů budou do logu zapisovány.

Podrobná - Zobrazují se všechny logy kromě zobrazení naparsované struktury importního XML při XML importu. Východisková hodnota

Jen chyby - Zobrazují se jen chyby, pokud nějaké při importu a parsování vzniknou. (Log vznikne i v případě, kdy při importu žádná chyba nenastane.).

Podrobná s rozšířením pro XML - Zobrazují se všechny logy včetně zobrazení naparsované struktury importního XML při XML importu.

Prázdne importné dáta sú chyba

LIsEmptyDataError

Pokud je položka nastavena na hodnotu ANO, přistupuje se při zpracování definovatelného importu k prázdným importním datům jako k chybě. Prázdny súbor je označený ako chybný a presunie sa do adresára pre chyby, pokiaľ je adresár pre chyby zadaný. Nevznikne interní XML, a při nastavení volby Pouze parsovat nevznikne ani dokument s interním XML.

Pokud je položka nastavena na hodnotu NE, pracuje systém se souborem jako by nebyl prázdný. Prázdný soubor se import pokusí zpracovat a vznikne tedy v tomto případě prázdné interní XML, tedy vznikne i dokument pro volbu Pouze parsovat. Soubor se přesune do archivního adresáře, pokud je adresář zadaný. Výchozí hodnota Ne.

Logovať záznamy vzniknuté spracovaním definovateľného importu

CanLogBOCreatedByDefImport

Pole má význam při samotném zpracování parsovaného souboru a ukládání Business objektu. Je-li položka zatržena, začnou se plnit řádky v agendě Logy, subzáložka Riadky def. importu.V řádcích se lze snadněji orientovat, než ve standardním logování v subzáložce Poznámka. Položku má smysl mít aktivní (zatrženou) v případě, kdy logy obsahují často chyby a je třeba dohledávat jejich příčinu.

V případě, kdy je na hlavičce def. importu zatržena volba Pouze parsovat, tak se do subbzáložky Riadky def. importu nic nezapíše. Zápis proběhne až při zpracování rozparsovaného souboru v agendě Dokumenty.

Ukladať obsah chybných záznamov

CanLogContentsOfFaultyBO

Zatržením toho pole se v případě chyby začne obsah Business objektu, dále jen BO, který se nepodařilo naimportovat (uložit) vypisovat do subzáložky Riadky def. importu v agendě Logy, položka Obsah neuloženého BO. Z tohoto obsahu je možné často snadněji identifikovat možnou příčinu neuložení BO.

Ukladať skutočné importné dáta ako prílohy logu

CanLogRawInputData

V případě, kdy je položka zatržena se do agendy Logy, záložka Prílohy vytvoří dokument, jehož obsahem jsou skutečná importní data. Skutečnými importními daty se rozumí data po jejich případně transformaci, například pomocí skriptingu (háček “IEImportExport_AfterSetImportDocument_Hook”) nebo pomocí rozšiřujícího modulu definovatelných importů (EDI).

Importní data se ukládají do obsahu samostatného dokumentu. Kategorie a další nastavení je stejné jako u dokumentů definovatelných importů vznikajících při volbě Pouze parsovat. Tedy kategorie IMP. Dokumenty nelze zpracovat a mají jiný prefix popisu. Pro kategorii je nutné mít přiřazenou řadu (stejně jako u EDI apod.).

Dokument se skutečnými importními daty se automaticky připojí k záznamu logování jako příloha. V případě více záznamů logů se každý dokument připojuje pouze jednou.

V dokumentu připojeného v záložce Prílohyje dostupná položka Název souboru. Ta se v případě importu jednoho souboru přejmenuje dle automaqticky generováného názvu (kombinace znaků a čísel). V případě importu více souborů současně, odpovídají názvy souborů reálným názvům importovaných souborů.

Poznámka

Note

Zde je možno vepsat poznámku vztahující se k definicím definovatelných importů.

Subzáložka Obsah

Subzáložka Obsah slúži na zadanie riadkov dokladu. Obsahuje:

Zoznam riadkov

Ide o prvok editovateľný zoznam, v ktorom je zobrazený zoznam doposiaľ zadaných riadkov (na začiatku prázdny). V definovatelných importech nelze obecně volit z různých typů řádků, jako tomu je např. u vlastní faktury. Seznam řádků se dělí na horní a spodní.

Horní seznam - je určen pro zadání tříd business objektů.

Spodní seznam - je určen pro zadání položek subkolekce třídy business objektu zadaného v nadřízeném seznamu.

Horní seznam

Položky zadávané v řádcích horního seznamu tohoto dokladu:

Názov Popis
Trieda objektu Interní jednoznačná identifikace business objektu. Lze zadat výběrem z nabízených možností, nebo se automaticky vyplní po zadání položky CLSID.
BO názov triedy Interní název BO (např.TNxReceivedOrder - Objednávka přijatá). Položka jen ke čtení, předvyplní se po zadání CLSID nebo Třídy objektu.
CLSID Interní jednoznačná identifikace business objektu (BO). Lze zadat ručně, nebo se automaticky vyplní po zadání položky: Třída objektu. Povinná položka
Nadriadený Odkaz na nadřízený business objekt (BO). Povinná jen u kolekcí BO.
Typ importu

Určuje způsob práce s business objekty (platí pro hlavičky i položky kolekcí), tj. jestli se bude vytvářet nový BO (nový záznam) nebo půjde o opravu již existujícího BO (opravu existujícího záznamu).

Podporované volby:

Nový: Vždy se zakládá nový BO (nový záznam).

Oprava: Vždy se provádí oprava BO (oprava existujícího záznamu). Pokud se ID pro opravu nedohledá, záznam se nezpracuje.

Oprava nebo Nový: Pokud se dohledá ID pro opravu BO (existujícího záznamu), provede se oprava. V opačném případě se založí nový BO (nový záznam).

Východisková hodnota: Nový
XML s atribútmi

Položka je přístupná jen pro typ importu XML.

Pokud je položka zatržena, je možné importovat i XML, které obsahuje atributy.

Importní definice pro XML elementy i atributy je prakticky shodná.

Východisková hodnota: Neaktivní (nezatrženo).
Aktívne

Příznak, jestli se bude daný BO při importu zpracovávat. Pokud je nastaveno na Ne, pak se nastavení v podřízené subkolekci ignoruje (bez ohledu na nastavení subkolekce), tj. daný BO se importem nezpracuje.

Vykonávať predvyplnenie

Položka je ve výchozím stavu nastavena na hodnotu Ano. V závislosti na nastavení položky se na nových business objektech vznikajících zpracováním def. importu provádí předvyplnění (metoda prefill) nebo se tato metoda neprovádí. (pokud je nastaveno na Ne).

Možnost vypnutí předvyplňování je zde především z důvodu možnosti zakládat skladové karty v jednom jediném kroku. Vypnutí prefillu u jiných situací nedoporučujeme. Importy budou vyžadovat doplnit všechny potřebné položky, které jsou povinné pro založení BO - někdy až na takové úrovni, kterou zvládne pouze uživatel, který vidí do kódu systému.
Názov záložky Excelu

Položka je přístupná jen pro typ importu Excel. Položka určuje, ze které záložky Excelu budou hodnoty z Excelu pro daný objekt načítány. Je podporováno načítání hodnot pro více BO ze stejných nebo i různých záložek Excelu.

Vyplnění položky je kontrolováno měkkou validací. Pro spuštění importu je vyplnění položky povinné.

Omezení řádků

V zobrazeném seznamu položek ve spodním seznamu je možno zobrazit všechny záznamy nebo si jejich zobrazení omezit. K tomu slouží položka Omezení řádku v horní části spodního seznamu. Pokud zvolíte hodnotu Vše, pak uvidíte seznam všech položek, nehledě na to, jakou mají nastavenou hodnotu v položce Aktivní. Pokud budete chtít zobrazený seznam omezit pouze za položky Aktivní či Neaktivní, vyberete požadovanou možnost ze skrytého seznamu v této položce:

Příklad možnosti omezení zobrazených položek

Spodní seznam

Položky zadávané v řádcích spodního seznamu tohoto dokladu:

Kolekce je řazená a zpracovává se v nastaveném pořadí.

Seznam položek se aktualizuje při změně aktivního řádku v nadřízeném seznamu (viz horní seznam pro zadání tříd business objektů).

Názov Popis
Položka Název položky business objektu (BO) v ABRA Gen (např. Firma).
Meno

Interní název položky BO v ABRA Gen (např. Firm_ID). Povinné pole, pokud je položka Pro opravu nastavena na hodnotu Ne. Vyplní se automaticky výběrem pole Položka nebo ji lze zadat ručně.

Položku lze využít pro definování proměnné nastavením prefixu *VAR* (vysvětlení dále v textu).

K položkám vlastněné kolekce (Vlastněná kolekce je v GenDoc.chm definována textem (Owned), například: ResidenceAddress_ID(Owned)) se v definovatelných importech přistupuje jednoduše rozvinutím položky hlavního objektu pomocí názvu vlastněné kolekce a za tečkou přímo název položky vlastněné kolekce. Napríklad takto: ResidenceAddress_ID.Street.
Popis Libovolný popis nebo poznámka uživatele. Položka se předvyplní popisem z vybraného BO.
Typ dat

Dátový typ položky. K dispozici jsou tyto datové typy: Řetězec, Celé číslo, Desetinné číslo, Kolekce, Datum, Ano/Ne, XML kolekce, Neurčeno, Jedinečná přípona proměnné, Excel propojení, Podmínka

Pokud je nastaven datový typ Ano/Ne, pak zadaná položka musí nabývat hodnoty A nebo N.
Výraz

Výraz, který se vyhodnotí nad daným BO a hodnotou získanou z importního souboru. Ve výrazu lze využívat proměnné (viz níže).

Nelze zadat zároveň Výraz i SQL tj. nelze vyhodnocovat oba výrazy společně, vždy jen jeden z nich.

Výraz môžete zapísať ručne alebo ho môžete zostaviť komfortnejšie pomocou Editora výrazov, ktorý si môžete vyvolať po stlačení funkčného tlačidla (môže sa líšiť podľa verzie a nastaveného vzhľadu). Vo výrazoch sú k dispozícii funkcie a dáta objektov dostupných v danom mieste programu, viď funkcie a dátové položky objektu v editore výrazov.

Pokud použijete ve výrazu konstantu "%s" pro získání hodnoty z datového zdroje více než jednou, musí být použita indexace. To znamená, že místo "%s" je potřeba použít např "%0:s"
SQL

SQL výraz, který se vyhodnotí pro hodnotu získanou z importního souboru. Ve výrazu lze využívat proměnné (viz níže).

Nelze zadat zároveň Výraz i SQL tj. nelze vyhodnocovat oba výrazy společně, vždy jen jeden z nich.

Výraz SQL můžete zapsat ručně nebo jej můžete sestavit komfortněji pomocí Editoru výrazů, který si můžete vyvolat po stisku funkčního tlačítka (môže sa líšiť podľa verzie a nastaveného vzhľadu). Vo výrazoch sú k dispozícii funkcie a dáta objektov dostupných v danom mieste programu, viď funkcie a dátové položky objektu v editore výrazov.

Pokud použijete ve výrazu konstantu "%s" pro získání hodnoty z datového zdroje více než jednou, musí být použita indexace. To znamená že místo "%s" je potřeba použít např "%0:s".
Podmienka položky

Podmínka, která se vyhodnotí pro hodnotu získanou z importního souboru. V podmínce lze využívat proměnné (viz níže).

Výraz pro podmínku můžete zapsat ručně nebo jej můžete sestavit komfortněji pomocí Editoru výrazů , který si můžete vyvolat po stisku funkčního tlačítka (môže sa líšiť podľa verzie a nastaveného vzhľadu). Vo výrazoch sú k dispozícii funkcie a dáta objektov dostupných v danom mieste programu, viď funkcie a dátové položky objektu v editore výrazov.
Vyhodnotit podmínku před zpracováním

Při nastavené hodnotě NE se podmínka z pole Podmínka položky vyhodnocuje na již zpracované hodnotě z importních dat. Zpracováním se rozumí, že je provedena na hodnotě příslušná datová konverze a vyhodnoceny výrazy nebo SQL dotazy.

Při hodnotě ANO se podmínka z pole Podmínka položky vyhodnocuje na tzv “syrové” hodnotě z importních dat. To znamená dříve než je na hodnotě provedena příslušná datová konverze a před vyhodnocením výrazu nebo SQL dotazu.

Východisková hodnota: Nie

Mějme nadefinovaný základní import skladových karet v CSV formátu. Chceme v tomto importu kromě Kódu a Názvu skladové karty importovat také položku Procento obvyklé marže. Ta by měla být ve formátu desetinného čísla. Avšak v importním souboru zjistíme, že na dané pozici nejsou vždy jen čísla, ale třeba i text. Bez vyhodnocení podmínky před zpracováním by nám takový import skončil chybou v místě, kde by se místo čísla nacházel text.

Díky tomu, že použijeme podmínku, například CfxStrToFloatDef('%s', -1, ',') <> -1, a nastavení Vyhodnotit podmínku před zpracováním na hodnotu Ano, jsou zpracovány jen ty záznamy, které budou podmínkou vyhodnoceny jinak, než -1. U záznamů, které podmínce nevyhoví, nedojde k importu této položky. Tzn. záznam se naimportuje, ale položka Procento obvyklé marže bude prázdná (nulová).
Aktívne

Příznak, jestli se bude daná položka subkolekce zpracovávat (hodnota: Ano) nebo ignorovat (hodnota: Ne). Nastavení hodnoty je platné pro ověření, parsování, tvorbu BO. Po nastavení hodnoty Ano či Ne se tato hodnota přebere pro další přidanou položku BO.

Východisková hodnota: Áno
Pre opravu

Využití jen u typu importů: Oprava nebo Oprava nebo Nový. Při nastavení na hodnotu Ano se vyhodnocením výrazu na řádku získá ID pro opravu.

Východisková hodnota: Nie
Formát Speciální formátování pro typ položky, kde to má smysl (např. DateTime, Float ad.). Například formát datumu (YYYYMMDD), oddělovač desetinných čísel (tečka nebo čárka) atd.
Východisková hodnota

Výchozí hodnota, která se použije v případě, že se hodnotu nepodařilo z importního souboru získat. Výchozí hodnotu lze také nastavit pro ty případy, kdy nechcete, aby se hodnota čerpala z importního souboru, ale potřebujete ji zadat přímo. Takovým příkladem může být ID střediska, kód skladu, ID skladu, firma atd.

Položku lze využít pro získání hodnoty z proměnné definované prefixem *VAR*.

Položky nastavení pro párování na importní soubor:

Vyplnění položek je povinné v závislosti na nastaveném typu importního souboru na hlavičce definice.

Názov Popis
Maska riadka

Maska, jejímž vyhodnocením bude rozhodnutí, zda daný importní řádek zpracovávat či nikoliv (využití u TXT, CSV). Jinými slovy, pokud je na položce v Definici pro import maska zadaná, musí v importních datech řádek začínat znaky uvedenými v masce, jinak se nezpracuje. Zadávat lze na jedné položce pouze jednu masku. Pokud bychom zadali dvě masky oddělené středníkem, zpracovala by se jen ta data, která odpovídají celé masce včetně středníku. Maska rozlišuje velká a malá písmena (je key sensitive).

Použití masky si vysvětíme na příkladu níže. Zadaná maska na položce BO objektu se automaticky kopíruje i na další přidávanou položku BO.

Typickým příkladem využití je import dokladů, např. objednávek přijatých, kdy v importním souboru bude hlavička dokladu označena jako Header a řádky budou mít označení Rows, viz obrázek.

Následně je třeba nastavit stejnojmennou masku v ABRA Gen, aby systém rozpoznal, co je v importu Hlavička a co Řádky, a data zpracoval, viz obrázek.
Stĺpec Excelu

Položka je přístupná jen pro typ importu Excel. Určuje, ze kterého sloupce se daná položka bude z MS Excelu načítat. Hodnota sloupce musí být vždy velkými písmeny, při zadání malého písmena se provede automatická konverze na velké písmeno. Písmena se zadávají bez apostrofů.
Spôsob aktualizácie textovej položky

Položka je k dispozici pro typy importů “Oprava” nebo “Oprava nebo nový” a pro řetězcové položky. V ostatních případech je položka nedostupná.

Podle typu nastavení položky se při opravě řetězcové položky BO zapsání hodnoty chová takto:

Přepsat - Původní hodnota se vždy přepíše řetězcem z importu. Východisková hodnota.

Přidat na začátek - Hodnota z importu se přidá na začátek k již existujícímu řetězci.

Přidat na konec - Hodnota z importu se přidá na konec k již existujícímu řetězci.

Zvolená varianta u jedné položky BO se automaticky přebere do dalších přidávaných položek BO.

Ořezávat mezery

Pokud je položka nastavena na Ano, ořezávají se při parsingu automaticky koncové mezery zleva i zprava. Pokud je položka nastavena na Ne, pak se mezery neořezávají.

Na hodnotu položky se bere ohled pro typy importu TXT, CSV, Excel. Pro typ XML se vždy importuje bez ořezání mezer. Východisková hodnota je Áno.
Pozícia

Celé číslo, pozice začátku položky na řádku importního souboru. Pole dostupná jen pro Typ importu: TXT, CSV.
Dĺžka Celé číslo, délka položky. Pole dostupné jen pro Typ importu: TXT.
Oddeľovač Oddělovač položek v textovém formátu CSV. Pole dostupné jen pro Typ importu: CSV.
XML položka

Jednoznačný název položky v importním XML souboru. Pole dostupné jen pro Typ importu: XML Pokud není pole vyplněno nebo není vyplněno pole Výchozí hodnota, nedojde ke zpracování pole při importu. Na toto je uživatel upozorněn zprávou při uložení definice.
XML vetva

Název větve položek kolekce v importním XML souboru. Položka dostupná jen pro Typ importu: XML. Povinná položka, bez které není možné uložit definici.
Operátor kombinácie podmienok

Nabízí hodnoty AND a OR. Výchozí AND. Používá se pro logické spojení více než jedné podmínky aktuálního business objektu.

Položka je aktivní jen v případě, kdy v Typu dat je vybrána možnost: Podmínka.Dále je nutné mít vyplněnu položku Výraz.

Více informací k této položce viz níže
Zastaviť spracovanie po nesplnenej podmienke

Nabízí hodnoty Ano a Ne. Východisková hodnota: Ne. Pokud je aktuální stav vyhodnocení všech podmínek daného Business objektu, dále jen BO "NE" a položka je nastavena, ukončí se proces parsování všech následujících položek daného i podřízených BO. Při správném použití lze takto urychlit zpracování, typicky u položek, které jsou dále při nesplněné podmínce již zbytečné.

Položka je aktivní jen v případě, kdy v Typu dat je vybrána možnost: Podmínka.

Více informací k této položce viz níže
Kontrolovať duplicitu pri ukladaní

Nabízí hodnoty Ano a Ne. Východisková hodnota: Nie.

Hodnotu "Ano" lze nastavit pouze u položek datového typu:

  • Celé číslo
  • Áno/Nie
  • Desetinné číslo
  • Řetězec
  • Dátum

Pokud je položka nastavena na hodnotu „Ano" dojde v okamžiku ukládání nového business objektu (BO), připraveného zpracováním definovatelným importem (DI), k sestavení SQL dotazu podle DB tabulky daného BO a položky (fieldu). SQL obsahuje dotaz na hodnotu, která je do položky ukládaná. U dotazů do tabulek, které podporují skrývání, se do dotazu doplní nevyhledávání ve skrytých.

select ID from StoreCards where Hidden = ‘N' and Code = 'cod3x'
select ID from StoreUnits where ID <> '9M59000101' and Code = 'gr6’
select ID from StoreEANs where EAN = 'ean76'

Tímto způsobem se kontroluje duplicita unikátních položek. Pokud sestavený SQL dotaz vrátí nějaký záznam, znamená to, že se již stejná hodnota v databázi (DB) vyskytuje a daný BO se nebude ukládat.

Více informací k této položce viz níže

Při vyhodnocování výrazů a SQL dotazů lze využít dosazení hodnoty získané parsingem aktuální položky. Tato hodnota se ve výrazu vždy nahradí za konstantu %s. Ve výrazech a SQL výrazech lze využívat i proměnné dříve nadefinované v definici. Pomocí proměnných lze tedy ve výrazech využít i hodnoty z jiných položek, než je položka aktuální.

V rámci provádění parsování importního souboru je možné si zapamatovat položku jako proměnnou a její hodnotu později využít v rámci importu daného business objektu (BO) při dalším zpracovávání na jiném řádku. Hodnota proměnné je platná pouze v průběhu zpracovávání jednoho hlavičkového BO. Proměnná je v definici importu identifikována prefixem *VAR*. Hodnotu proměnné je možné využít pro vyplnění položky: Výchozí hodnota, v podmínce vyhodnocované pro řádek subkolekce, ve výrazu a v SQL výrazu. Při využití proměnné ve výrazu nebo podmínce je nutné ji vždy použít s prefixem *VAR* a ukončit sufixem *VAREND*.

Na tomto příkladu je demonstrováno využití proměnné *VAR*Store_ID definované na hlavičkovém business objektu a její následné využití na řádku BO (dosazení do položky „Výchozí hodnota“).

Konstanta „%s“ je využita např. pro získání ID skladové karty. Konstanta nabude hodnotu XML položky pro daný řádek (article_gtin[1]) z importního souboru a využije se pro vyhodnocení SQL dotazu.

Na obrázku je vidět, že v poli Jméno je definovaná proměnná *VAR*Store_ID. Hodnota této proměnné se získává pomocí SQL dotazu vpravo.

Na tomto obrázku je vidět proměnná *VAR*Store_ID použita v poli Výchozí hodnota pro položku Sklad.

Tuto možnost nastavíme v položce Typ dat tehdy, pokud potřebujeme proměnnou nadefinovanou na kolekci BO použít také v subkolekci BO. V takovém případě je potřeba na kolekci nejprve nadefinovat to, že proměnnou budeme používat i v subkolekcích, tzn. nastavit proměnné Typ dat: Jedinečná přípona proměnné. Ta bude sloužit jako vazební prvek mezi kolekcí a subkolekcí. Dále je potřeba v obsahu kolekce uvést proměnnou ještě jednou a přiřadit jí hodnotu. Poté se v subkolekci již proměnná použije běžným způsobem popsaným v příkladu výše. Definici proměnné s jedinečnou příponou si popíšeme na příkladu.

V tomto příkladu potřebujeme naimportovat skladovou kartu,a to včetně jednotek, obalů a EANů. V importních datech (viz obrázek níže) máme několik řádků. Každý je definován maskou řádku.

Řádek s maskou SC obsahuje data o kódu a názvu skladové karty.

Řádek s maskou UNIT obsahuje informace o jednotce a množství.

Řádek s maskou CONT obsahuje informace k obalům. Je zde vazební jednotka a kód skladové karty obalu.

Řádek s maskou EAN obsahuje informace k EANům. Je zde vazební jednotka mezi EANem a jednotkou a EAN.

Datový zdroj obsahuje řádky s maskou řádku. Jednotlivé hodnoty v tomto importním souboru jsou popsány nad obrázkem.

 

Na jednotce skladové karty je na první pozici nadefinována proměnná s názvem *VAR*UnitQuantity a typem dat Jedinečná přípona proměnné. Tato proměnná se odkazuje na řádek s maskou UNIT a na pozici 2, Tím je definován konkrétní vazební prvek, který později použijeme v subkolekci. Důležité je zde především definovat proměnnou s jedinečnou příponou na první pozici před jejím naplněním daty.

Na obrázku je vidět proměnná *VAR*UnitQuantity. Důležité je v položce Typ dat vybrat volbu Jedinečná přípona proměnné.

 

V dalším kroku zůstáváme stále na kolekci jednotky skladové karty, kde si do proměnné *VAR*UnitQuantity budeme načítat hodnotu. Opět z řádku s maskou UNIT, tentokrát z pozice 3.

Na obrázku je vidět proměnná *VAR*UnitQuantity s typem dat Desetinné číslo, do které načítáme hodnoty z pozice 3, řádků označené maskou UNIT.

 

Další krok již ukazuje Subkolekci Obal k jednotce skladové karty. Zde je opět použita proměnná *VAR*UnitQuantity pro Množství. Díky prvnímu řádku s typem dat Kolekce, odkazem na řádek s maskou CONT a pozice 2 se napojí správné množství obalů ke správné jednotce.

Na každém Business objektu (hlavičkové, kolekce i subkolekce.), dále jen BO definovatelných importů lze definovat podmínku a to i kombinaci podmínek spojených logickými operátory. Logický operátor se použije pro spojení s předchozí hodnotou podmínky. Podmínka musí mít vždy hodnotu Ano/Ne vyhodnocovanou při zpracování podmínky parsingem (pokud je použito cokoliv jiného, je potřeba ověřit, jak se systém zachová - např. výsledek “True“ bude vyhodnocovat jako “A“, ale také integer bude vždy “A“). V podmínce lze použít proměnné definovatelných importů a výchozí hodnoty, tedy známé běžné možnosti.

Podmínka je platná vždy pouze pro příslušný BO definice definovatelného importu. Hodnota podmínka je vždy uložena v Interním XML na první pozici každého BO.

Plnění podmínky pomocí Výrazu a vyhodnocení podmínky

Podmínka je vždy definována jako Výraz a platí pro celý BO. Položka Výraz tedy nesmí být v případě použití datového typu Podmínka prázdná.

SQL je nepřístupné, protože nevrací logickou hodnotu. Pokud bude v poli SQL obsah zapsán, změnou typu dat na Podmínku dojde k jeho vymazání.

Při zpracovávání Interního XML při přípravě BO pro uložení je hodnota podmínky u každého BO načtena. Pokud je podmínka neplatná, BO se neuloží.

Použití funkce: Zastaviť spracovanie po nesplnenej podmienke

Použitím této funkce dojde ke zrychlení zpracování importu, protože se nebudou parsovat následující "zbytečné" položky. Typickým příkladem použití podmínek je pro zamezení duplicitního ukládání již jednou uložených BO při opakovaném importu.

Uživatel, v případě výsledku vyhodnocení podmínky "Ne", má možnost proces parsingu při zpracování definovatelného importu zastavit. Uživatel si nastaví položku Zastavit zpracování po nesplněné podmínce na hodnotu: Áno. Takové nastavení dává smysl například pro jednu podmínku na objektu nebo pokud jsou 2 podmínky spojené pomocí operátoru AND (Pokud hned první vyhodnocení skončí jako “N“, tak rovnou zastavíme import po první podmínce, protože výsledek kombinace bude vždy “N“). Naopak, pokud máme 2 podmínky s operátorem OR, tak na první podmínce ještě import zastavit nechceme, teprve pokud bude kombinace podmínek vyhodnocena jako “N“, tj. zastavení importu nastavíme až na 2. podmínce.

Již existující položka s názvem Podmínka položky se týká pouze konkrétní položky - vyhodnocuje se buď před zpracováním nebo po zpracování položky.

Při sestavování BO pro uložení může neplatná podmínka různě ovlivnit i podřízené BO kolekcí, které mají jako svůj nadřízený objekt BO, který se nezpracovává kvůli neplatné podmínce. Neexistující hlavičkový BO kvůli neplatné podmínce logicky způsobí i neuložení všech svých podřízených objektů. Při zpracování Interního XML je s tímto počítáno.

Upravené logování

V mechanismu definovatelných importů bylo na různých místech upraveno i logování s ohledem na nové funkcionality. Z logu lze nyní vyčíst, jak byla podmínka BO vyhodnocena. V příkladu níže je situace, kdy se při parsování zjistilo, že podmínka BO pro řádek objednávky přijaté je vyhodnocena na "Ne". Nedojde tedy ani k uložení BO s informací o předchozí nesplněné podmínce.

Parsing: Objednávka přijatá - řádek:, BOFieldName "_BOCOND_05CPMINJW3DL342X01C0CX3FCC", Maska "", RawValue "2", ProcessedValue(BOCondition after combining with previous BOcondition value) "N", pořadí importu "2", XMLCollection X-Path "/orion_message/body[1]/line_items[1]/item[2]"

Save-BO: IE TNxIESaveBusinessObjects: Fill BO values finished OK. BO name: TNxReceivedOrderRow - Objednávka přijatá - řádek.

05.03.2024 14:21:42 614, Jaroslav Novák, reRuntimeExe: ---IE TNxIESaveBusinessObjects: BO will not be processed because the condition for no processing is set. BO name: TNxReceivedOrderRow - Objednávka přijatá - řádek. (log may belong to next BO)

Zde si vysvětlíme, jak přesně kontrola duplicit funguje.

Zamezení ukládání funguje pro hlavičkové BO i jednotlivé BO kolekce a subkolekce. Dohledávání duplicit se provádí napříč celou databází (DB). Tzn., že pokud kontrolujeme např. duplicitu položky EAN s hodnotou 123456 u jednotky skladové karty „ks“ pro skladovou kartu s názvem Televize a tento EAN se vyskytuje u jiné jednotky u zcela odlišné skladové karty, systém ji i tak vyhodnotí jako duplicitu a neuloží. V případě podřízených kolekcí se neuloží ani všechny případné podřízené záznamy kolekcí závislé na neukládaném nadřízeném BO.

V následující tabulce si vysvětlíme chování kontroly duplicit na importu. Sloupec Výchozí stav prezentuje data, která jsou již uložena v databázi. Sloupec Importovaná data prezentuje data, která budeme chtít importovat. Tato tabulka je pro všechny varianty, které si představíme stejná, rozdíl je pouze v tom, na které položce budeme duplicitu kontrolovat, viz níže.

Výchozí stav Kód

Názov

 Jednotka EAN Poznámka
  Kar01 Karta 01 kg 123456
  Kar02 Karta 02 km 789123  
  Kar03 Karta 03 m 111111
Importovaná data Kód Názov Jednotka EAN Poznámka
  Kar01 Karta 01 kg 123456  
  Kar04 Karta 04 km 789123  
  Kar05 Karta 05 m 111111  

1. varianta. Budeme mít kontrolu duplicity nastavenou na položce Kód.

Výsledek v databázi Kód

Názov

 Jednotka EAN Poznámka
  Kar01 Karta 01 kg 123456 Další Karta 01 se nenaimportuje (a ani subkolekce, které k ní patří), protože už v DB existuje skladová karta se stejným kódem
  Kar02 Karta 02 km 789123  
  Kar03 Karta 03 m 111111
  Kar04 Karta 04 km 789123  
  Kar05 Karta 05 m 111111  

2. varianta. Budeme mít kontrolu duplicity nastavenou na položce Jednotka

Výsledek v databázi Kód

Názov

 Jednotka EAN Poznámka
  Kar01 Karta 01 kg 123456  
  Kar01 Karta 01   Jednotka ke skladové kartě se nenaimportuje, protože jednotka „kg“ už v DB existuje. Nenaimportuje se ani EAN, který patří k této jednotce
  Kar02 Karta 02 km 789123  
  Kar03 Karta 03 m 111111
  Kar04 Karta 04   Jednotka ke skladové kartě se nenaimportuje, protože jednotka „km“ už v DB existuje. Nenaimportuje se ani EAN, který patří k této jednotce
  Kar05 Karta 05   Jednotka ke skladové kartě se nenaimportuje, protože jednotka „m“ už v DB existuje. Nenaimportuje se ani EAN, který patří k této jednotce

3. varianta. Budeme mít kontrolu duplicity nastavenou na položce EAN

Výsledek v databázi Kód

Názov

 Jednotka EAN Poznámka
  Kar01 Karta 01 kg 123456  
  Kar01 Karta 01 kg   EAN se k jednotce skladové karty nenaimportuje, protože už v DB existuje.
  Kar02 Karta 02 km 789123  
  Kar03 Karta 03 m 111111
  Kar04 Karta 04 km EAN se k jednotce skladové karty nenaimportuje, protože už v DB existuje.
  Kar05 Karta 05 m EAN se k jednotce skladové karty nenaimportuje, protože už v DB existuje.

Všechny tyto akce jsou logovány v agendě Logy.

Pokud je položka určena k opravě, v SQL dotazu se vynechává záznam sama sebe.

Tato část kapitoly popisuje, jak se import chová v některých nestardarních situacích. Tato část kapitoly bude postupně doplňována.

Oprava záznamu, kdy jsou v datech stejné údaje

Může se stát, že někdy máme v datech stejné údaje, např. máme dvě duplicitní střediska, nebo dva, či více duplicitních záznamů ve skladových kartách. Abychom chování při importu správně pochopili, ukážeme si jej na příkladu. Příklad je ryze informačního charakteru, duplicity by být neměly, ale ABRA Gen duplicity povoluje.

Mějme vytvořených 5 středisek v agendě Strediská s Kódem 100 a Názvem střediska např. "Středisko Praha". Potřebujeme u všech pěti záznamů s Kódem 100 importem změnit Název středisek na "Středisko Brno" Použijeme klasickou definici s Typem importu Oprava nebo nový. V obsahu zadáme ID pro dohledání podle Kódu střediska a SQL dotaz na dohledání ID pro opravu. V importním souboru budeme mít jeden záznam s kódem 100 a střediskem Středisko Brno. Import proběhne a změní všech pět nalezených záznamů z původní hodnoty na novou.

Situaci, kdy bychom importem chtěli změnit všech 5 středisek a každé na jiný Název není možné tímto způsobem provést, jelikož by se všechna střediska změnila na Název střediska posledního řádku importu. Taková situace by musela být ošetřena individuálně za pomocí Podmínky položky.

Lišta navigátora

V dolnej časti záložky je k dispozícii lišta navigátora: Lišta navigátoru je shodná pro horní i spodní seznam.

VložiťPridaťVymazať

Navigátor v subzáložce Obsah v této agendě.

Navigátor v tejto záložke obsahuje tlačidlá:

  • Na pohyb kurzora po riadkoch (na začiatok, predchádzajúci riadok, ďalší riadok, na koniec) dokladu, zmene ich poradia a hľadanie hodnoty v zozname.
  • Vložiť - Na vloženie nového riadka pred aktuálny riadok (na ktorom stojí kurzor).
  • Pridať - Na pridanie nového riadka na koniec.

  • Vymazať - Na vymazanie aktuálneho riadka, resp. označených, pokiaľ je nejaký označený.

Panel definovateľných formulárov riadkov

V spodnej časti subzáložky ďalej môže byť zobrazená oblasť na zobrazovanie a zadávanie položiek prostredníctvom užívateľsky definovateľných formulárov. Je k dispozícii len vtedy, ak je v menu Nastavenie aktuálne začiarknutá voľba na zobrazenie užívateľských formulárov riadkov. Umožňuje vyberať si z nadefinovaných užívateľských vstupných formulárov pre Business objekty riadkov danej agendy a zobrazovať a zadávať si cez ne potom jednotlivé údaje.

Pravidlá použitia tohto panela sú pre všetky agendy, v ktorých sa môže vyskytnúť, spoločné a boli podrobne popísané v kap. Panel definovateľných formulárov.

Subzáložka Formuláre

Subzáložka je k dispozícii iba, ak je v menu Nastavenie aktuálne začiarknutá voľba na zobrazenie užívateľských formulárov. Umožňuje vyberať si z nadefinovaných užívateľských vstupných formulárov a zobrazovať a zadávať si prostredníctvom nich potom jednotlivé údaje.

Pravidlá použitia tejto záložky sú pre všetky agendy, v ktorých sa môže vyskytnúť, spoločné a boli podrobne popísané v kap. Záložka Formuláre - všeobecne.

Zobrazenie zoznamu v Detaile

V niektorej časti tejto záložky môže byť zobrazený Zoznam (Panel na zobrazenie zoznamu na iných záložkách), teda záznamy zo záložky zoznam (podrobnejšie viď Spoločné prvky v dokladových agendách - záložka Detail).

Zobrazenie zoznamu závisí od aktuálneho nastavenia v menu Nastavenie pre danú agendu a prihláseného užívateľa.

Funkcia k záložke Detail:

Podmnožina funkcií zo záložky Zoznam.

V editačnom režime platia zásady platné pre editáciu záznamov v knihách. K dispozícii sú štandardné funkcie pre režim editácie, pričom po uložení záznamu v závislosti na jeho údajoch môže dôjsť k vyvolaniu nejakej ďalšej automatickej akcie, viď akcie volané po uložení záznamu.

Ďalšie obsiahnuté funkcie:

Názov Kl. Doplňujúci popis:
Sprievodca -

Umožňuje vyvolat průvodce, který ve dvou krocích provede naplnění BO a jejich subkolekcí. Podrobný popis Průvodce a jeho použití najdete v kapitole Věcný obsah - obecné.

Načítať definíciu

-

Funkce jejíž podrobný popis naleznete v popisu stejnojmenné položky na záložce Seznam.
Uložiť definíciu -

Funkce jejíž podrobný popis naleznete v popisu stejnojmenné položky na záložce Seznam.