DefRollEditor.exe - Editor definovatelných číselníků

Základní popis

V levé části okna je zobrazen seznam nadefinovaných číselníků (po otevření nástroje prázdný). Zobrazené záznamy si lze filtrovat podle toho, zda jde o záznamy dodávané výrobcem či definované uživatelem. K tomu slouží omezovací panel v horní části:

Všechny
Jen uživatelské
Jen systémové

Tato filtrace je synchronizovaná pro všechny další záložky, takže stačí přepnout filtr pouze na jedné z nich.

V pravé části jsou údaje rozděleny do subzáložek:

Záložka Číselník - údaje potřebné pro založení a identifikaci číselníku.

Záložka Agenda - údaje potřebné pro založení agendy následné zobrazované v systému ABRA Gen.

Záložka Business objekt - údaje potřebné pro založení a identifikaci potřebného Business objektu.

Záložka Dyn SQL - údaje potřebné pro vytvořené SynSQL pro nový číselník.

Jak bylo zmíněno v kap. Věcný obsah obecné, definice číselníku neznamená definici pouze agendy, kterou pak uživatel "vidí" mezi jinými agendami, ale definici i jiných objektů. Ty provede na následujících záložkách. Definice je ale velmi jednoduchá, uživatel v zásadě zadává pouze názvy, zbytek již nástroj zajistí automaticky sám při uložení do repozitoře.

DefRollEditor.exe vyžaduje přístup k repozitoři. Proto, máte-li pouze jednouživatelskou (singl) instalaci, nemůžete jej spouštět paralelně za běhu systému ABRA Gen. Z toho důvodu jej v takovém případě ANI NELZE VYVOLAT ze složky Moduly podsložky Nástroje přizpůsobení. Je nutno nejdřív systém ABRA Gen ukončit a spustit daný nástroj samostatně.

Režimy práce s aplikací

Nástroj umožňuje práci z příkazové řádky i prostřednictvím grafického rozhraní.

Pokud nástroj spouštíte z prostředí systému ABRA Gen (jako jeden z Nástrojů přizpůsobení), spustí se automaticky v grafickém režimu.
Pokud jej spouštíte jako samostatnou aplikaci, režim spuštění závisí na použitých parametrech příkazové řádky. Možnosti:
```
DefRollEditor.exe
```
Spuštění aplikace bez parametrů vyvolá interaktivní grafický režim.
```
DefRollEditor.exe -h
```
Spuštění aplikace s parametrem -h zobrazí informační dialogové okno se seznamem podporovaných parametrů, po jehož zavření se aplikace ukončí.
```
DefRollEditor.exe [-p<heslo>] [-h|-r|-x|-m|-c|-l] [-d<soubor>|-i<soubor>|-o<soubor>]
```
Spuštění aplikace s jinými parametry (seznam viz DefRollEditor.exe -h) vyvolá řádkový režim.
Pokud je pro danou instalaci zadáno bezpečnostní heslo a v řádkovém režimu je požadováno provedení operace, která bezpečnostní heslo vyžaduje, je zapotřebí v příkazové řádce heslo specifikovat (parametrem -P), jinak aplikace vypíše chybu a ukončí se.
```
DefRollEditor.exe -r -iD:\repo.txt

DefRollEditor - command line tool
ABRA Gen [18.13.03 release cs-CZ]

Neplatné heslo do repozitoře.
```

Popis záložek podrobněji

Číselník

Položka	Hodnota
CLSID	Předvyplněno je vygenerované unikátní.
Název	Název číselníku; typicky anglicky. Měl by začínat písmenem, být bez diakritiky a obsahovat znaky 0-9, a-z, A-Z a _. Název by neměl být duplicitní s názvem jiného číselníku systému ABRA Gen. Pro tyto podmínky existuje soft valiadce, a to kvůli správnému fungování konstant ve skriptingu: Roll_<nazev_ciselniku>, Class_<nazev_ciselniku> a Site_<nazev_ciselniku>. Pokud je mezi definovatelnými číselníky použit název, který je duplicitní s názvem jiného definovatelného číselníku systému ABRA Gen, nebude takový číselník zaregistrován do skriptingu.
Uživatelský název	Uživatelský název číselníku.
Systémový	Nastavení, zda se jedná o definici systémovou či nikoliv. Běžný uživatel však nemá možnost toto nastavovat, položka mu není k dispozici k editaci. Systémové a nesystémové definovatelné číselníky jsou odlišeny pouze touto položkou. Odlišení prefixem doplňovaným automaticky v kódu či názvu číselníku (jako je tomu u některých jiných typů systémových záznamů) se zde nepoužívá. Pro systémové záznamy platí omezení, co se týče uživatelských oprav a jsou automaticky aktualizovány.

Business objekt

Položka	Hodnota
CLSID	ClassID Business objektu (GUID). Předvyplněno je vygenerované unikátní.
Název	Název Business objektu; typicky anglicky. Měl by začínat písmenem, být bez diakritiky a obsahovat znaky 0-9, a-z, A-Z a _. Název by neměl být duplicitní s názvem jiného business objektu systému ABRA Gen. Pro tyto podmínky existuje soft valiadce, a to kvůli správnému fungování konstant ve skriptingu: Roll_<nazev_ciselniku>, Class_<nazev_ciselniku> a Site_<nazev_ciselniku>. Pokud je mezi definovatelnými business objekty použit název, který je duplicitní s názvem jiného business objektu systému ABRA Gen, nebude takový objekt do skriptingu zaregistrován.
Uživatelský název	Uživatelský název Business objektu.
Název kolekce ve Web API	Uživatelský název kolekce Business objektu, pod kterým bude daný definovatelný číselník dostupný pro dotazování ve WebAPI. Viz Struktura URI.

Agenda

Položka	Hodnota
CLSID	ClassID agendy (GUID). Předvyplněno je vygenerované unikátní.
Název	Název agendy; typicky anglicky. Měl by začínat písmenem, být bez diakritiky a obsahovat znaky 0-9, a-z, A-Z a _. Název by neměl být duplicitní s názvem jiné agendy systému ABRA Gen. Pro tyto podmínky existuje soft valiadce, a to kvůli správnému fungování konstant ve skriptingu: Roll_<nazev_ciselniku>, Class_<nazev_ciselniku> a Site_<nazev_ciselniku>. Pokud je mezi definovatelnými agendami použit název, který je duplicitní s názvem jiné agendy systému ABRA Gen, nebude taková agenda zaregistrována do skriptingu.
Uživatelský název	Uživatelský název agendy.
Uživatelský popis	Uživatelský název agendy. Typicky česky, s diakritikou. Např. Agenda uživatelského číselníku, Auta pro dopravu zboží, ...
Ikona	Zde se definovala ikona, pod kterou se v dřívějších verzích zobrazoval odkaz na danou agendu v okně pro spouštění agend. Tato možnost aktuálně není podporována. Více viz Změna vzhledu a související funkční změny od verze 21.1.
Umístění číselníku	Zde zadáte, kam se nový číselník má zařadit v okně pro spouštění agend. Můžete jej umístit (registrovat) i na více míst najednou. Pro syntaxi definice umístění platí: \jméno složky\jméno podsložky\jméno další podsložky$pořadí agendy v rámci podsložky nebo \jméno složky\^jméno podsložky typu pořadač\jméno ucha záložky$pořadí agendy v rámci záložky, přičemž pokud chcete definovat horkou klávesu (ála Alt + písmeno), pak před příslušné písmeno resp. číslici zadáte znak & příp. horkou klávesu definujete za pipelinu \| (např. \|Ctrl+D). K dispozici jsou funkční tlačítka Přidat, Nahradit, Smazat, pomocí nichž lze přidat novou definici umístění, upravit příp. vymazat existující. Zadání nové definice umístění uživ. číselníku resp. editace existující, na níž stojí kursor, se provádí v poli pod seznamem již existujících umístění, kde je mj. k dispozici funkční tlačítko . Umístění nemusíte vypisovat ručně úplně od nuly, ale pomocí funkčního tlačítka si můžete vybrat jedno z existujících a to buď ponechat, jak je, nebo příp. upravit dle potřeby. Po stisku tlačítka se podle vaší instalace nabídnou vybrané systémové složky sekce AGENDY. Nabízí se zatím i v uspořádání "klasickém", které bylo k dispozici dříve. Tato možnost aktuálně není podporována. Více viz Změna vzhledu a související funkční změny od verze 21.1. Nabízí jen ty složky a jejich podsložky resp. záložky, které obsahují alespoň jeden odkaz na agendu. Tj. pokud obsahují odkazy např. jen na externí nástroje, soubory s dokumentací apod. (jako např. záložka "2- Nástroje" v podsložce Nástroje přizpůsobení), pak se zde k výběru nenabízí. Nicméně i do takových lze vlastní číselník umístit, pouze je třeba zadat cestu ručně. Nejrychlejší způsob jak zadat umístění do vlastní větve, je vybrat jedno z existujících po stisku funkčního tlačítka a pak jej jen upravit. Nadefinujeme si číselník Auta, který umístíme následovně: Uspořádání dle modulů=DYFHDJA1XJYOLJ5RRBMS1KCXGG\^Nástroje přizpůsobení\|Alt+T\&4 - Definovatelné číselníky$0001 - tj. bude v sekci AGENDY v podsložce "Nástroje přizpůsobení" s kl. zkratkou Alt+T na subzáložce s uchem "4-Definovatelné číselníky" jako první v pořadí. Uspořádání dle modulů=DYFHDJA1XJYOLJ5RRBMS1KCXGG\^Definovatelné číselníky\|Ctrl+D\&1 - Definovatelné číselníky$0002" - tj. bude v sekci AGENDY v podsložce "Definovatelné číselníky" s kl. zkratkou Ctrl+D na subzáložce s uchem "1-Definovatelné číselníky" jako druhý v pořadí. Takto přidaná složka Definovatelné číselníky se bude nadále nabízet k výběru umístění číselníku, tj. pokud do ní budete chtít umísťovat další číselníky, nebudete již muset cestu zadávat ručně resp. výběrem jiné a následnou úpravou, ale budete ji moci rovnou vybrat z existujících. Pokud si umístění číselníku nijak nezadáte, umístí se defaultně do složky s názvem Definovatelné číselníky.
Pozice	Výchozí pozice (pořadí) agendy ve skupině. Celé číslo.
Skrýt systémové položky	Umožňuje skrýt si zobrazování základních položek číselníku v záložce Detail.

DynSQL

Položka	Hodnota
ID DynSQL	Identifikace definice DynSQL (GUID). Předvyplněno je vygenerované unikátní.
Název DynSQL	Název DynSQL definice. Typicky česky, s diakritikou. Např. DynSQL uživatelského číselníku, Auta pro dopravu, ...

ID prog.bodu	Identifikace programového místa (GUID). Předvyplněno je vygenerované unikátní.
Název prog.bodu	Název programového místa. Typicky česky, s diakritikou. Např. Programový bod uživatelského číselníku, Auta pro dopravu, ...

Funkce, které jsou k dispozici

Vybrané funkce, které jsou zde k dispozici (některé jsou dostupné jako funkční tlačítko pod seznamem definic i z menu, některé pouze z menu):

Název	Kl.	Doplňující popis:
Nový	Ctrl +N	Zadání nového číselníku. Jednotlivé položky se předvyplní defaultními údaji a podle tohoto vzoru je stačí pozměnit dle přání uživatele.
Kopie		Zkopíruje aktuální. Kopie systémového již nebude pochopitelně systémový.
Vymazat		Vymaže aktuální definici. Mazání provádějte s rozmyslem! Zejména pokud k danému číselníku již máte nadefinované definovatelné položky či definovatelné formuláře. Po smazání Udf položek a Udf formulářů ke smazanému číselníku se může objevit chybové hlášení ála "(10) OLE Chyba...".
Otevřít	Ctrl +O	Akce pro načtení uložení definic číselníků ze souboru zadaného jména.
Uložit Uložit jako Export do XML	Ctr +S (vše)	Akce pro uložení definic číselníků do souboru zadaného jména, příp. provedení exportu definic do XML. Uživatel si vybírá, zda se exportuje vše nebo jen uživatelské definice.
Exportovat do repozitoře	Ctrl +F12 (vše)	Akce, které exportují data do repozitoře. Uživatel si vybírá, zda se exportuje vše nebo jen uživatelské definice. Export není aditivní. Tedy exportuje se tak, že se nejdříve data z repozitoře smažou a pak se teprve exportuje znovu aktuální stav definic. Po spuštění funkce program nejdříve kontroluje, zda pro danou instalaci již bylo zadáno bezpečnostní heslo. Heslo je společné pro všechny chráněné nástroje a zadává se vždy po nové instalaci resp. po instalaci update. Pokud heslo dosud v dané instalaci nebylo zadáno v rámci spuštění některého z chráněných nástrojů, program na tuto skutečnost upozorní a nabídne možnost jej zadat. Zadání hesla není povinné, ale v každém případě jej doporučujeme využívat. Můžete tak předejít nežádoucím manipulacím např. ze strany neznalé osoby, které mohou pro váš systém mít i značně destruktivní následky. Pokud bezpečnostní heslo pro spouštění nástrojů bylo v rámci spuštění některého z chráněných nástrojů v dané instalaci již zadáno, zobrazí se přihlašovací dialog do nástrojů, v němž se uživatel musí přihlásit zadáním bezpečnostního hesla. Po stisku OK se ověřuje jeho správnost. Nebylo-li heslo zadáno správně, program umožní uživateli opětovné zadání jména a hesla (např. pro případ překlepu). Pokud ani opakovaně není heslo zadáno správně, program danou funkci nevyvolá. Bylo-li přihlášení úspěšné, systém pokračuje požadovaným exportem.
Importovat z repozitoře		Akce, které importují data z repozitoře. Uživatel si vybírá, zda importuje vše nebo jen uživatelské definice.
Lokalizovat		Funkce pro vyhrání řetězců pro provedení překladů do příslušné národní verze. Běžný uživatel nemá tuto funkci k dispozici, jelikož pro něj nemá význam.