Popis editoru definovatelných exportů

Pokud vyvoláte opravu definice def. exportu ze záložky Detail číselníku def. exportů, zpřístupní se v záložce Detail editor definovatelných exportů k dané definici exportu. Dále naleznete popis těchto témat:

CELKOVÝ POPIS EDITORU

Panely nástrojů, ovládání

V horní části editoru je panel nástrojů pro editor def. exportů:

Panel nástrojů, pomocí něhož lze vyvolávat funkce okna editoru

Kromě toho je v levé části okna editoru k dispozici další svislý panel nástrojů pro vlastní editaci prvků definice def. exportu:

Panel nástrojů, pomocí něhož lze vyvolávat funkce okna editoru pro editaci obsahu definice def.exportu. Obrázek panelu je z důvodu úspory místa otočen o 90 stupňů.

Pohybovat se v obou panelech nástrojů můžete:

Po jednotlivých tlačítkách (ikonách) pomocí myši. Tlačítko, na kterém aktuálně stojíte kurzorem, je zvýrazněné.

Změna pozice panelu nástrojů:

V této části programu je umístění panelu pevné a nelze jej měnit.

Spustit funkci z panelu nástrojů můžete:

Kliknutím myší na příslušné tlačítko (ikonku) na panelu nástrojů:

Strom definice

V levé části okna se pak nachází strom definice daného def. exportu, který reprezentuje hierarchickou strukturu objektů, obsažených v definici. U každého objektu je pro přehlednost a rychlou orientaci grafická ikona, která reprezentuje jeho typ:

Příklad stromu definice def. exportu

Pomocí funkce Ukázka před exportem z horizontálního panelu, si lze zobrazit, jak bude vypadat výsledný soubor vzniklý zpracováním dané definice.

Ovládání stromu definice formuláře:

Prvek stromu je podobný tomu, kterého znáte z jiných částí systému (např. stromových číselníků) a obdobně se také ovládá:

Úrovně stromu:

Úrovně do stromu se přidávají automaticky podle toho, jaký prvek přidáváte a kam (viz dále). Má-li záznam alespoň jeden podřízený záznam, pak se vlevo od něj zobrazuje symbol nebo , takovým místům stromu pak říkáme uzly stromu:

- uzel stromu pro danou větev má podřízené větve a je zabalený, jemu podřízené záznamy nejsou viditelné. To, který ze symbolů je zobrazen, závisí na zvoleném vzhledu systému ABRA Gen.
- uzel stromu pro danou větev je rozbalený a ve stromu jsou viditelné i všechny záznamy podřízené rozbalenému záznamu. To, který ze symbolů je zobrazen, závisí na zvoleném vzhledu systému Abra.

Rozbalit/zabalit uzel stromu můžete následovně:

Kliknutím myší na uzly stromu.
Klávesnicí kurzorovými šipkami vpravo/vlevo na aktuálním záznamu, platí jen, je-li fokus dané větvi stromu

Pohybovat se po záznamech ve stromu můžete následovně:

Kliknutím myší na příslušný záznam.
Klávesnicí kurzorovými šipkami vpravo/vlevo - platí pro pohyb mezi nadřízenými/podřízenými záznamy, přičemž platí, že stojí-li kurzor na uzlu stromu, který je zabalený, první stisk šipky vpravo tento uzel stromu nejprve rozbalí, další stisk šipky vpravo posune kurzor na první podřízený záznam. Obdobně pro pohyb v opačném směru.
Klávesnicí kurzorovými šipkami nahoru/dolů.
Klávesnicí klávesami PageDn/PageUp, Home/End.

Změnit poměrnou velikost levé části okna se zobrazením stromu můžete:

standardně uchopením dělící příčky mezi stromem a seznamem a tažením myší na požadovanou velikost.

Přidání větve stromu - prvku do definice

Přidání prvků do definice exportu provedete výběrem příslušné volby z nabídky lokálního menu vyvolané pravým tlačítkem myši nad větví stromu (prvkem), po níž chcete nový prvek umístit, příp. vyvoláním horkých kláves, nebo výběrem příslušné volby z nabídky vertikálního panelu. vyvolané nad větví stromu (prvkem), po níž chcete nový prvek umístit. Popis funkcí lokálního menu a možných prvků, které lze použít, naleznete dále.

Funkce horizontálního panelu

Název	Kl.	Doplňující popis:
	`ctrl+P`	Ukázka před exportem. Viz popis téže funkce v záložce Detail číselníku def. exportů. Umožňuje vyvolat ukázku před exportem s tím, že se poté vrátí opět do editace do záložky Detail. Vyvolání ukázky před exportem z Detailu s návratem zpět do Detailu, aniž byste museli ukončovat editaci def. exportu, s výhodou využijete při definici exportu, abyste si mohli průběžně ověřovat, jak se právě provedené definice budou exportovat, a např. teprve poté editaci ukončit s uložením nebo bez uložení provedených změn.
	-	Uložení dat (definice exportu) do souboru. Viz popis téže funkce v záložce Detail číselníku def. exportů. Tato funkce vyvolaná z editoru def. exportů, tj. v rámci editace definice exportu, umožňuje definici uložit s tím, že se po uložení vrátí opět do editace. Exportovaná systémová definice bude po importována jako nesystémová, tj. po následném importu ze souboru se zruší příznak "systémový".
	-	Načtení dat (definice exportu) ze souboru. Načte data (definici exportu) ze souboru ve formátu AEF – "Abra export format", tedy inverzní funkce k Uložení dat do souboru.
	-	Vyčistit definici exportu. Vymaže pracovní plochu pro návrh definice.
	-	Paměťové tabulky. Definice paměťových tabulek. Význam a použití paměťových tabulek v def. exportech je obdobné jako tomu je v definicích tisk. sestav, dále viz popis paměťových tabulek v rámci definice tisk. sestav.
	-	Vyhledávání. Umožňuje v definici exportu vyhledávat zadané texty, a to přes celou definici. Využijete např. hledáte-li konkrétní položku výraz apod. a nevíte, kde jsou přesně umístěny a použity

Funkce vertikálního panelu

Název	Kl.	Doplňující popis:
	-	Vloží text. Dále viz prvek Text v části Seznam prvků, vkládání a vlastnosti prvků.
	-	Vloží výraz. Dále viz prvek Výraz v části Seznam prvků, vkládání a vlastnosti prvků.
	-	Vloží text z databáze, tedy položku z databáze. Dále viz prvek Text z databáze v části Seznam prvků, vkládání a vlastnosti prvků.
	-	Vloží systémový údaj, tj. např. čas, datum, číslo stránky apod. Dále viz prvek Systémový údaj v části Seznam prvků, vkládání a vlastnosti prvků.
	-	Vloží prvek, který definuje, z jaké tabulky se budou exportovat údaje dle definice následujících, tabulce podřízených prvků. Dále viz Tabulka v části Seznam prvků, vkládání a vlastnosti prvků.
	-	Vloží skupinu. Dále viz Skupina, Hlavička a Patička skupiny v části Seznam prvků, vkládání a vlastnosti prvků.
	-	Vloží cyklický pruh. Dále viz Cyklický pruh v části Seznam prvků, vkládání a vlastnosti prvků.

Funkce lokálního menu

Nad jednotlivými prvky vloženými do sestavy lze vyvolat lokální nabídku menu:

Příklad lokální nabídky menu vyvolané v definici tisk. sestavy

Název	Popis:
Přidat	Funkce pro vložení nového prvku do definice do příslušného místa def. exportu. Jednotlivé možnosti je možno vybrat z nabídky lokálního menu dostupné pod volbou Přidat (viz obrázek výše) nebo je možno si je vyvolat i jinak pomocí horkých kláves (dostupné horké klávesy jsou uvedeny u jednotlivých voleb lokálního menu). K dispozici jsou k výběru vždy jen ty prvky, které je možno v daném okamžiku vložit s ohledem na to, v jakém místě definice def. exportu se nacházíte, a s ohledem na již nadefinované prvky (některé kombinace nejsou povoleny). Význam jednotlivých voleb viz Seznam prvků, vkládání a vlastnosti prvků. Většina nabízených voleb je paralelně dostupná přes ikony vertikálního panelu popsané výše.
Smazat	Daný prvek z definice vymaže. Pokud je daný prvek "kontejnerem" pro jiné prvky (tj. např. jsou pod ním umístěné již nějaké položky apod.), pak jeho smazáním se smažou i definice daných položek (tj. smaže se CELÁ daná "větev" definice i s podřízenými)!
Posunout nahoru/dolů	Umožní změnit pořadí umístění daného prvku v definici v rámci úrovně, na které je nadefinován.
Posunout vlevo/vpravo	Umožní změnit umístění daného prvku v definici mimo úroveň, na které je aktuálně nadefinován. Tedy při posunu vlevo jej "vynořit" o jednu úroveň výše a naopak při posunu vpravo jej "vnořit" o jednu úroveň níže pod prvek, za kterým je aktuálně umístěn. Pokud v daném místě definice není příslušné vnoření/vynoření možné (jelikož by vznikla kombinace prvků, které nemohou spolu být na jedné úrovni nebo pod sebou nemohou být vnořeny), pak program posun neprovede. Příklad... Mějme následující definici: Příklad jednoduché definice, která z tabulky faktur vypíše seznam jmen odběratelů s textem "Odběratel:" Výsledný soubor dle předchozí definice exportu Pokud nad prvkem Text vyvoláme funkci Posunout vlevo, prvek Text se "vynoří" a už nebude vnořen pod tabulkou. Bude vyhodnocován mimo záznamy z tabulky. Po úpravě pořadí (posunu nahoru), obdržíme: Nyní bude text mít charakter nadpisu nad seznamem, jelikož se vyhodnotí před záznamy z tabulky. (Aby byl odřádkován, je třeba u prvku Text nastavit Konec řádku). Výsledný soubor dle předchozí definice exportu

Vlastnosti def. exportu

Lze nastavit, pokud kurzor ve stromu definice exportu stojí aktuálně na hlavní větvi Export.

Pro nastavení vlastností def. exportu jsou k dispozici následující možnosti:

Nabídka (volba)

Umožňuje si nastavit, která volba ke zpracování exportu se má nabízet resp. použít jako výchozí po vyvolání funkce Export, resp. Ukázka před exportem z horizontálního panelu tohoto editoru, příp. ze záložky Detail číselníku def. exportů. Možnosti:

Příkaz uložený v definici - Pak se použije příkaz zadaný přímo v definici exportu ve vlastnosti Spustit po zpracování.
Otevřít asociovaným programem - Funkce otevře vyexportovaný soubor v aplikaci, která je pro daný typ souboru (určený koncovkou - XML, XLS, XLSX, CSV atd.) nastavena jako výchozí.
Otevřít v agendě Editor - Funkce vyvolá agendu Editoru a otevře ji "přes" agendu definovatelných exportů, resp. agendu, ze které byl export vyvolán. V editoru je pak založena editace nového souboru, v němž je pak obsah exportu, tj. data, která jsou výsledkem zpracování daného def. exportu. Soubor můžete uložit, příp. ukončit jeho editaci bez uložení. K dispozici jsou všechny funkce agendy Editor. Po zavření takto otevřené agendy Editoru se program vrátí do agendy, odkud byl export vyvolán.
Příkaz definovat před spuštěním - Pak příkaz budete zadávat až v dialogovém okně nabídnutém po vyvolání exportu. Příkazem musí být spustitelný soubor (program), který dostane ke zpracování data vzniklá zpracováním definice daného exportu. Příkaz může obsahovat tzv. divoké proměnné, které budou nahrazeny hodnotami vrácenými z parametrů spuštění (pojmenovaných skriptů) definovaných k danému exportu. Dále viz Parametry spuštění (dříve Pojmenované skripty) a použití příkazů u definovatelných exportů.
Jedná se tedy o obdobou první volby ovšem s tím, že zde není příkaz přímo uložen v definici exportu, ale máte možnost jej zadat až před vlastním exportem. Použijete tedy v případech, kdy očekáváte, že se příkaz ke zpracování bude v čase měnit. Dialogové okno umožňuje i dohledání spustitelného příkazu a pamatuje si příkaz naposledy použitý. V případě této volby se nehledí na nastavení vlastnosti Nabídka(ukázat) a nabídka se ukazuje vždy.

Vytvořit dokument - V tomto případě se z daného exportu vytvoří dokument v agendě Dokumenty a naplní se obsahem daného exportu. Volba je určena pro případy, kdy výsledek exportu chcete archivovat resp. dále nějak zpracovat, např. opatřit elektronickým podpisem a odeslat e-mailem.

Do v. 9.02 včetně zde byla místo této volby k dispozici volba Vytvořit doklad komunikace - Byla určena pro případy, kdy se chtělo výsledek exportu dále nějak zpracovat, typicky elektronicky odeslat na cílové místo (např. přes VREP.). V takovém případě se vytvářel záznam v tehdejší agendě "Doklady komunikace" a naplnil se obsahem daného exportu. Před jeho vytvořením bylo ještě nutno zvolit odpovídající ovladač (komunikační driver). Ten se pak staral jednak o zobrazení obsahu daného dokladu komunikace, ale hlavně o jeho další zpracování (např. právě odeslání na VREP a zjištění odpovědi z VREP). Aby uživatel snadněji vybral správný ovladač pro daný typ exportu (např. při exportu RELDP ovladač pro RELDP), byl v definicích exportů nastaven ovladač, který se má pro daný export použít (předvyplnit) pomocí parametru spuštění (pojm. skriptu) "CommDriver". Pokud nebyl tento parametr spuštění (pojm. skript) v definici exportu implementován, předvyplňoval se Obecný komunikační driver. Od v. 9.03 byla agenda Doklady komunikace zrušena a nahrazena agendou Dokumenty. Z daného exportu lze tedy vytvořit dokument do agendy "Dokumenty" a to dokument zvolené kategorie.

Další zpracování dokumentu s daným exportem opět zajišťuje příslušný ovladač (driver), ale ten je určen už v rámci definice zvolené kategorie dokumentu. Uživatel tedy před tvorbou dokumentu nevolí přímo ovladač, ale volí kategorii dokumentu, přičemž kategorie dokumentu se předvyplňuje podle toho, jak je zadána v položce Kategorie dokumentu v definici exportu. Viz dále.

Příklad zadání hlavičkových údajů pro tvořený Dokument

Zadávané položky:

Název	Popis
Kategorie	Kategorie pro tvořený dokument. Kategorii zadáte ručně anebo vyberete z číselníku Kategorií dokumentů. Na základě vybrané kategorie dokumentu se může předvyplnit řada dokumentů a příp. některé další údaje, podle toho, které a jak jsou pro danou kategorii nastaveny v její definici. Předvyplňuje se kategorií zadanou v položce Kategorie dokumentu v definici exportu. Zde zvolená kategorie je důležitá, protože určuje, o jaký dokument se bude jednat a definuje ovladač (driver), kterým bude daný dokument zobrazován a zpracován. Zde je třeba mít na paměti, že každý ovladač může být napsán konkrétně pro použití jen s určitým konkrétním typem exportu a očekává data v nějakém tvaru. Tudíž není smysluplné jej používat ve spojení s exporty, pro které není určen (např. kategorii RELDP s driverem pro RELDP použít pro zpracování exportu ze servisní knížky apod.), dokonce toto může vést i k chybovým hlášením. Viz též Zpracování dokumentů.
Řada	Zkratka označující řadu dokladů odpovídajícího typu, tj. typu dokumenty, do které bude doklad vystaven. Povinná položka. Číselník se zde defaultně může nabízet omezený s ohledem na řady dokladů připojené v definici kategorie dokumentů v její subzáložce Řady dokladů.
Období	Zkratka označující období, do kterého je resp. bude doklad zařazen, tj. do kterého věcně patří. (Který údaj se má v položce zadávat resp. zobrazovat, lze nastavit.) Povinná položka. Předvyplňuje se a kontroluje se dle pravidel uvedených v kap. Předvyplňování datumů.
Středisko	Slouží pro předvyplnění stejnojmenné položky v hlavičce vystaveného Dokumentu. Předvyplňuje se hodnotou nastavenou u stejnojmenné položky v definici kategorie dokumentu zadané výše, ale lze samozřejmě zadat jinou. Zadáte kód střediska nebo vyberete z číselníku středisek. (Který údaj se má v položce zadávat resp. zobrazovat, lze nastavit.) Zda je položka k dispozici a zda je povinná, závisí na nastavení u stejnojmenné položky v definici kategorie dokumentu zadané výše. Tudíž nastavení způsobu používání zakázek zadané v parametru Používání zakázek ve Firemních údajích se zde neuplatní.
Zakázka	Slouží pro předvyplnění stejnojmenné položky v hlavičce vystaveného Dokumentu. Předvyplňuje se hodnotou nastavenou u stejnojmenné položky v definici kategorie dokumentu zadané výše, ale lze samozřejmě zadat jinou. Zadáte kód zakázky nebo vyberete z číselníku zakázek. (Který údaj se má v položce zadávat resp. zobrazovat, lze nastavit.) Zda je položka k dispozici a zda je povinná, závisí na nastavení u stejnojmenné položky v definici kategorie dokumentu zadané výše. Tudíž nastavení způsobu používání zakázek zadané v parametru Používání zakázek ve Firemních údajích se zde neuplatní.
Obchodní případ	Totéž jako položka Zakázka, jen zde se jedná o Obchodní případ.
Projekt	Totéž jako položka Zakázka, jen zde se jedná o Projekt.
Popis	Libovolný popis daného dokladu, uloží se do agendy Dokumenty. Popis se automaticky předvyplňuje podle jména definice exportu. K zadanému popisu je pro snazší identifikaci konkrétního dokumentu navíc automaticky přidáno aktuální datum. Uživatel však může předvyplněný popis dle potřeby změnit. Pokud je v definici exportu implementován parametr spuštění (pojmenovaný skript) "CommDocDescription", pak se popis může předvyplnit podle něj. Defaultně je použit např. v exportu oznámení zaměstnavatele o nástupu/výstupu ze zam., kde se název modifikuje podle toho, jestli jde o nástup či výstup.

Podle zadaných údajů systém vytvoří záznam v agendě Dokumenty a uloží do jeho obsahu data zpracovaná exportem. Poté systém nabídne možnost rovnou otevřít agendu Dokumentů a otevře ji "přes" agendu definovatelných exportů, resp. agendu, ze které byl export vyvolán. Takto odtud vyvolaná agenda Dokumentů se otevře rovnou s přednastaveným omezením, tzv. červeným omezením, a to za právě vytvořený dokument. Toto červené omezení však můžete v záložce Omezení standardně zrušit (vyčistit) a získat záznamy podle libovolného jiného omezení, nebo zcela bez omezení. Vytvořený dokument, v němž je pak obsah exportu, tj. data, která jsou výsledkem zpracování daného def. exportu, můžete v agendě dokumentů prohlížet příp. rovnou zpracovat.

Odeslat e-mailem - Odeslání exportu e-mailem v podobě přílohy zprávy. Jedna z možností, jak vyvolat odeslání výstupu e-mailem, popis viz Věcný obsah - Odeslání e-mailem ve zvoleném formátu. Funkce se chová stejně jako odeslání tiskové sestavy, tj. používá tzv. parametry spuštění (pojmenované skripty) EMAIL, EMAIL_BODY atd.
Otevře se příslušný e-mailový klient, máte-li nějakého k dispozici, s tímto připojeným souborem jakožto přílohou. Zda se použije standardně SimpleMAPI rozhraní nebo OLE rozhraní Outlooku, závisí na nastavení parametru UseOutLookWithOLE v Nexus.cfg, resp. na tom, jaký je váš výchozí klient pro SimpleMAPI. Více viz Využití MAPI.
U SimpleMAPI rozhraní v kombinacemi s Outlookem však dochází k potížím, kdy Outlook použije formát odeslaného e-mailu RTF, přestože má nastaveno, aby tak nečinil, což vede na potíže s čitelností příloh u adresátů e-mailu. Proto je k dispozici zmíněný parametr, kterým lze zajistit, že se SimpleMAPI rozhraní nepoužije. Více viz Využití MAPI.
Najít soubor - Otevře soubor výstupu v okně průzkumníka windows. Analogie funkce "Najít cíl..." ve vlastnostech na zástupci ve Windows.

Typ exportu

Určuje, zda bude export proveden do textového formátu nebo do Excelu.

Textový - jedná o prostý text, např. TXT, CSV

Excel - data se vyexportují přímo pro Excel, XLSX formát. Více o exportu do XLS formátu níže.

Vlastnosti exportu do Excelu:

Export do Excelu může být prováděn i z počítače, kde není Excel instalován (pro export není potřeba Excel, ani OLE Excel)
Export musí mít na nejvyšší úrovni alespoň jednu tabulku. Tabulky na nejvyšší úrovni jsou jednotlivé Listy (Sheet). Vše, co bude mimo tyto tabulky se interně zpracuje, ale do Excelu nepropíše. Podřízené tabulky jsou zobrazovány v Listě nadřízené tabulky.
Název tabulky se zobrazí v exportu jako název listu (sheetu).
Tabulka může obsahovat všechny prvky (Text, Data, Výraz...). Každý podřízený prvek tabulky je jeden sloupec v Excelu. Pokud tento prvek bude mít podřízený prvek bude zobrazován ve stejném sloupci.
Hlavička nebo Patička se vloží přidáním prvku Skupina.
Číselným sloupcům lze nastavit masku formátu nebo si zvolit z již předefinovaných pojmenovaných masek.
Po 1 milionu vygenerovaných řádcích se v souboru automaticky založí nový list stejného jména s číselným sufixem na konci, např. List2 (jedná se o vlastnost MS Excel).

Odskočení /posunutí dat o jeden sloupec lze vyřešit vložením prázdného prvku

Vzorové definice exportu do Excelu najdete v agendách Faktury vydané, Dodací listy a Účetní deník.

Jak bylo řečeno v kap. Věcný obsah - obecné, definice exportů je podobná definicím tisk. sestav, jen s tím rozdílem, že se liší technologie zadávání hodnot: dialogová okna u tisk. sestav a Object inspektor u def. exportů. Proto je řada vlastností def. exportů, prvků, které lze použít a jejich vlastností shodná, jako u tisk. sestav, pouze s tím, že se může lišit jejich pojmenování, či místo, kde se definují.