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

Defaultně dodávaný exe soubor. Jedná se o nástroj určený pro definici definovatelných číselníků.

Tento nástroj je určen především servisním konzultantům a správcům systému. Pomocí něho mohou v případě požadavků klientů definovat uživatelské číselníky. Běžný uživatel tento nástroj ke své práci nebude potřebovat. Jelikož se jedná o nástroj, který při neznalém použití může mít destruktivní následky, stejně jako je tomu u některých dalších nástrojů, je možno přístup do některých jeho funkcí chránit bezpečnostním heslem, viz dále

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 IS FLORES (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.

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 IS FLORES. 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 IS FLORES ukončit a spustit daný nástroj samostatně.

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.

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.

Obsažené záložky: Číselník Business objekt Agenda DynSQL

Čí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 IS FLORES.

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 IS FLORES, 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 IS FLORES.

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 IS FLORES, 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 IS FLORES.

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 IS FLORES, 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 Ikona, pod kterou bude odkaz na agendu zobrazen v okně pro spouštění agend. Např. .
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 a 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 (větve stromu). Minimálně to budou podložky hlavní složky IS FLORES a to ve všech uspořádáních, které jsou k dispozici. Nabízí se zde pod následujícími názvy:

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ě:

  • Agendy (dle modulů)=DYFHDJA1XJYOLJ5RRBMS1KCXGG\^Nástroje přizpůsobení|Alt+T\&4 - Definovatelné číselníky$0001 - tj. bude ve složce IS FLORES uspořádání dle modulů 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í.
  • "Agendy (dle modulů)=DYFHDJA1XJYOLJ5RRBMS1KCXGG\^Definovatelné číselníky|Ctrl+D\&1 - Definovatelné číselníky$0002" - tj. bude ve složce IS FLORES uspořádání dle modulů 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í.
  • "Agendy (dle modulů rozvětveně)=CCMERCTIHVT4X1D1PGSEAIYP1C\Definovatelné číselníky|Ctrl+D\Definovatelné číselníky$0002" - tj. bude ve složce IS FLORES uspořádání dle modulů rozvětveně v podsložce "Definovatelné číselníky" s kl. zkratkou Ctrl+D v její další podsložce "Definovatelné číselníky" jako druhý v pořadí.
  • "Agendy (klasicky)=YB2NDRNNWYD43IBKL1MQQFCXQG\Definovatelné číselníky|Ctrl+F$0002" - tj. bude ve složce IS FLORES uspořádání klasickém v podsložce "Definovatelné číselníky" s kl. zkratkou Ctrl+F 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.

Umístění ale lze zadat i např. následovně:

  • \Moje moduly\^Můj prodej\&2 - Zálohy a faktury$0001 - Pak přibude složka "Moje moduly" na stejné úrovni jako je složka IS FLORES y příslušném uspořádání a bude se chovat jako systémová. Bude mít podsložku typu pořadač s názvem "Můj prodej" a bude obsahovat záložku s názvem "2-Zálohy a faktury" a kl. zkratkou Alt+2. V ní bude umístěn náš číselník jako první v pořadí.

    Takto přidaná složka Moduly 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.