DefRollEditor.exe - Editor definovateľných číselníkov

Defaultne dodávaný exe súbor. Ide o nástroj určený na definíciu definovateľných číselníkov.

Tento nástroj je určený predovšetkým servisným konzultantom servisnej siete výrobcu a správcom systému. Pomocou neho môžu v prípade požiadaviek klientov definovať užívateľské číselníky. Bežný užívateľ tento nástroj k svojej práci nebude potrebovať. Nakoľko sa jedná o nástroj, ktorý pri neznalom použití môže mať deštruktívne následky, tak ako je to aj pri niektorých ďalších nástrojoch, je možné prístup do niektorých jeho funkcií chrániť bezpečnostným heslom.

V ľavej časti okna je zobrazený zoznam nadefinovaných číselníkov (po otvorení nástroja prázdny). Zobrazené záznamy si je možné filtrovať podľa toho, či ide o záznamy dodávané výrobcom alebo definované užívateľom. Na to slúži obmedzovací panel v hornej časti:

  • Všetky
  • Len užívateľské
  • Len systémové

Táto filtrácia je synchronizovaná pre všetky ďalšie záložky, takže stačí prepnúť filter iba na jednej 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.

Ako bolo spomenuté v kap. Vecný obsah všeobecné, definícia číselníka neznamená len definíciu agendy, ktorú potom užívateľ "vidí" medzi inými agendami, ale i definíciu iných objektov. Tie uskutoční na nasledujúcich záložkách. Definícia je ale veľmi jednoduchá, užívateľ v zásade zadáva len názvy, zvyšok už nástroj zabezpečí automaticky sám pri uložení do repository.

DefRollEditor.exe vyžaduje prístup k repository. Preto, ak máte len jednoužívateľskú (single) inštaláciu, nemôžete ho spúšťať paralelne počas chodu 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 prispôsobenia. Je nutné najskôr systém ABRA Gen ukončiť a spustiť daný nástroj samostatne.

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.

Položka Hodnota
CLSID Predvyplnené je vygenerované unikátne.
Názov

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_<nazov_ciselnika>, Class_<nazov_ciselnika> a Site_<nazov_ciselnika>. 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žívateľský názov Užívateľský názov číselníka.
Systémový

Nastavenie, či ide o definíciu systémovú alebo nie. Bežný užívateľ však nemá možnosť toto nastavenie zadávať, položka mu nie je na editáciu k dispozícii.

Systémové a nesystémové definovateľné číselníky sú odlíšené len touto položkou. Odlíšenie prefixom, dopĺňaným automaticky do kódu či názvu číselníka (ako pri niektorých iných typoch systémových záznamov), sa tu nepoužíva.

Pre systémové záznamy platí obmedzenie, čo sa týka užívateľských opráv a sú automaticky aktualizované.
Položka Hodnota
CLSID ClassID Business objektu (GUID). Predvyplnené je vygenerované unikátne.
Názov

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_<nazov_ciselnika>, Class_<nazov_ciselnika> a Site_<nazov_ciselnika>. 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žívateľský názov Užívateľský názov 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.
Položka Hodnota
CLSID ClassID agendy (GUID). Predvyplnené je vygenerované unikátne.
Názov

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_<nazov_ciselnika>, Class_<nazov_ciselnika> a Site_<nazov_ciselnika>. 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žívateľský názov Užívateľský názov agendy.
Užívateľský popis Užívateľský názov agendy. Typicky po slovensky, s diakritikou. Napr. Agenda užívateľského číselníka, Autá na dopravu tovaru, ...
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. Táto možnosť aktuálne nie je podporovaná.

Viac viď Zmena vzhľadu a súvisiace funkčné zmeny od verzie 21.1.
Umiestnenie číselníka

Tu zadáte, kam sa nový číselník má zaradiť v okne na spúšťanie agend. Môžete ho umiestniť (registrovať) aj na viac miest naraz. Pre syntax definície umiestnenia platí:

  • \meno zložky\meno podzložky\meno ďalšej podzložky$poradie agendy v rámci podzložky alebo
    \meno zložky\^meno podzložky typu triediaci katalóg\meno ucha záložky$poradie agendy v rámci záložky,

    pričom ak chcete definovať horúci kláves (á la Alt + písmeno), tak pred príslušné písmeno resp. číslicu zadáte znak & príp. horúci kláves definujete za pipelinu | (napr. |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. Táto možnosť aktuálne nie je podporovaná.

Viac viď Zmena vzhľadu a súvisiace funkčné zmeny od verzie 21.1.

Nabízí jen ty složky a jejich podsložky resp. záložky, které obsahují alespoň jeden odkaz na agendu. Tzn. ak obsahujú odkazy napr. len na externé nástroje, súbory s dokumentáciou a pod. (jako např. záložka "2- Nástroje" v podsložce Nástroje prispôsobenia), pak se zde k výběru nenabízí. No aj do takých je možné vlastný číselník umiestniť, akurát je potrebné zadať cestu ručne.

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 Autá, ktorý umiestnime nasledovne:

  • 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.

Ak si umiestnenie číselníka nijako nezadáte, umiestni sa defaultne do zložky s názvom Definovateľné číselníky.
Pozícia Východisková pozícia (poradie) agendy v skupine. Celé číslo.
Skryť systémové položky Umožňuje skryť si zobrazovanie základných položiek číselníka v záložke Detail.
Položka Hodnota
ID DynSQL Identifikácia definície DynSQL (GUID). Predvyplnené je vygenerované unikátne.
Názov DynSQL Názov DynSQL definície. Typicky po slovensky, s diakritikou. Napr. DynSQL užívateľského číselníka, Autá na dopravu, ...
ID prog.bodu Identifikácia programového miesta (GUID). Predvyplnené je vygenerované unikátne.
Názov prog.bodu Názov programového miesta. Typicky po slovensky, s diakritikou. Napr. Programový bod užívateľského číselníka, Autá na dopravu, ...

Vybrané funkcie, ktoré sú tu k dispozícii (niektoré sú dostupné ako funkčné tlačidlo pod zoznamom definícií aj z menu, niektoré len z menu):

Názov Kl. Doplňujúci popis:
Nový Ctrl +N Zadanie nového číselníka. Jednotlivé položky sa predvyplnia defaultnými údajmi a podľa tohto vzoru ich stačí pozmeniť podľa želania užívateľa.
Kópia   Skopíruje aktuálny. Kópia systémového už pochopiteľne nebude systémový.
Vymazať  

Vymaže aktuálnu definíciu.

Mazanie vykonávajte s uvážením! Najmä pokiaľ k danému číselníku už máte nadefinované definovateľné položky alebo definovateľné formuláre.

Po zmazaní Udf položiek a Udf formulárov k zmazanému číselníku sa môže objaviť chybové hlásenie á la "(10) OLE Chyba...".
Otvoriť Ctrl +O Akcia na načítanie uloženia definícií číselníkov zo súboru so zadaným menom.
Uložiť

Uložiť ako

Export do XML

 Ctr
+S
(všetko)		 Akcia na uloženie definícií číselníkov do súboru zadaného mena, príp. na vykonanie exportu definícií do XML. Užívateľ si vyberá, či sa exportuje všetko alebo len užívateľské definície.
Exportovať do repository Ctrl +F12
(všetko)

Akcie, ktoré exportujú dáta do repository. Užívateľ si vyberá, či sa exportuje všetko alebo len užívateľské definície. Export nie je aditívny. Teda exportuje sa tak, že sa najskôr dáta z repository zmažú a až potom sa exportuje znovu aktuálny stav definícií.

Po spustení funkcie program najskôr skontroluje, či pre danú inštaláciu už bolo zadané bezpečnostné heslo. Heslo je spoločné pre všetky chránené nástroje a zadáva sa vždy po novej inštalácii resp. po inštalácii update. Pokiaľ heslo zatiaľ v danej inštalácii nebolo zadané v rámci spustenia niektorého z chránených nástrojov, program na túto skutočnosť upozorní a ponúkne možnosť ho zadať.

Zadanie hesla nie je povinné, ale v každom prípade ho odporúčame využívať. Môžete tak predísť nežiaducim manipuláciám napr. zo strany neznalej osoby, ktoré môžu mať pre váš systém aj značne deštruktívne následky.

Pokiaľ bezpečnostné heslo na spúšťanie nástrojov bolo v rámci spustenia niektorého z chránených nástrojov v danej inštalácii už zadané, zobrazí sa prihlasovací dialóg do nástrojov, v ktorom sa užívateľ musí prihlásiť zadaním bezpečnostného hesla. Po stlačení OK sa overuje jeho správnosť. Ak nebolo heslo zadané správne, program užívateľovi umožní opätovné zadanie mena a hesla (napr. v prípade preklepu). Pokiaľ ani opakovane nie je heslo zadané správne, program danú funkciu nevyvolá. Ak bolo prihlásenie úspešné, systém pokračuje požadovaným exportom.
Importovať z repository   Akcie, ktoré importujú dáta z repository. Užívateľ si vyberá, či importuje všetko alebo len užívateľské definície.
Lokalizovať   Funkcia na vyhranie reťazcov na uskutočnenie prekladov do príslušnej národnej verzie. Bežný užívateľ nemá túto funkciu k dispozícii, pretože pre neho nemá význam.