Jak na skupinové parametry

V tomto návodu se podíváme na to, jak vytvořit a použít parametry z agend Skupiny parametrů a Definice parametrů. Ty nám pomohou rozšířit agendy o uživatelské položky, do kterých můžeme zadávat hodnoty, které jinak nelze v systému ABRA Gen evidovat. Nejčastější využití najdou skupiny parametrů ve výrobě, kde se často provádí různá kontrolní měření, nebo nad skladovými kartami, kde také můžeme provádět pravidelné kontroly, například kvality surovin, obsah, hmotnost, teplota atd.

Kontrola licence a oprávnění

Než začneme pracovat se skupinami parametrů, je potřeba ověřit, zda máme potřebnou licenci. Licenci si zkontrolujeme v agendě Správa licencí. Licence se jmenuje Uživatelské parametry.

U licence Uživatelské parametry máme 1 licenci k dispozici, to znamená, že můžeme agendu Skupiny parametrů používat.

Dále si zkontrolujeme, zda máme nastavena potřebná práva pro práci s agendami Skupiny parametrů a Definice parametrů. Viz agenda Role nebo Skupiny rolí→ záložka Práva k funkcím→volba Nástroje přizpůsobení→Skupiny parametrů.

Vytvoření Skupiny parametrů, naplnění parametry a přiřazení k agendě

Otevřeme agendu Skupiny parametrů. Nejprve si založíme novou skupinu. Vyplníme kód a název.

Na záložce Parametry budeme přidávat parametry, které vytvoříme v agendě Definice parametrů. Pro účely tohoto návodu si vytvoříme postupně několik parametrů s různými datovými typy, abychom si ukázali možnosti, které skupiny parametrů nabízejí.

Otevřeme agendu Definice parametrů a nejprve vytvoříme parametr Hmotnost, na kterém budeme hlídat, zda má kontrolované zboží požadovanou hmotnost. Typ nastavíme jako Desetinné číslo na dvě desetinná místa.

Pokud bychom věděli, že hmotnost nesmí překročit nějaké meze, ať už spodní nebo horní, mohli bychom tlačítky vpravo Min. hodnota a Max. hodnota nastavit tyto limity.

Po vyplnění parametr uložíme tlačítkem Uložit.

Tlačítkem Nový v pravé části přidáme další parametr, tentokrát typ Ano/Ne. Parametrem budeme evidovat, zda byla kontrola provedena v termínu.

A protože chceme, aby výchozí hodnota byla ANO, stiskneme tlačítko v pravé částí s názvem Výchozí hodnota a v zobrazeném okně zatrhneme políčko, aby výchozí hodnota byla ANO.

Další parametr vytvoříme s typem Text. Bude se jednat o poznámku k měření, kterou může pracovník provádějící měření napsat.

Další parametr bude také s typem Text, ale tentokrát si nastavíme i odkaz do číselníku přes volby Způsob editace a Odkaz do čísel. Z výběru nabízeních číselníků vybereme Číselník skladů. Budeme evidovat, na kterém skladě jsme měření prováděli, protože stejné zboží se může nacházet na více skladech.

Poslední parametr, který vytvoříme, bude Datum měření, abychom evidovali, kdy se měření provádělo. K tomu využijeme typ Datum.

Tímto jsme si připravili parametry, které následně využijeme v agendě Skupiny parametrů.

Otevřeme agendu Skupiny parametrů do skupiny, kterou jsme si vytvořili v úvodu tohoto návodu. Přepneme se na záložku Parametry. Abychom mohli parametry přidávat, je potřeba být v režimu editace, stiskneme proto tlačítko Opravit a následně dole tlačítko Přidat. Následně volbou Def. parametru otevřeme číselník Definice Parametrů a přidáme v předchozích částech vytvořený parametr.

Tlačítkem Přidat dole přidáme všechny vytvořené parametry, a poté následně skupinu uložíme. Záložka Parametry bude vypadat podobně jako na obrázku.

Na subzáložce Přiřazení provedeme výběr agendy, kde se budou parametry zobrazovat. My nastavíme třídu Skladová karta. Mohli bychom přidat i více agend, pro tento případ nám však bude stačit tato jedna.

Zobrazení parametrů na záložce Parametry nebudeme chtít vždy, ale pouze v případě, že jsou skladové karty typu Výrobky. To nastavíme v poli Podmínka, kde vytvoříme jednoduchou podmínku StoreCardCategory_ID.Code='V'.

Pořadí necháme nastaveno na výchozí hodnotu 0, protože budeme přidávat pouze jednu skupinu parametrů, zde pořadí nemá význam. Nastavení tedy bude vypadat tak, jako na obrázku níže.

Nyní máme v agendě Skupiny parametrů vytvořeny všechny parametry a máme je přiřazeny k agendě, kde se nám začne zobrazovat záložka Parametry, a v případě splnění podmínky, kterou jsme nadefinovali, se zobrazí i požadované parametry na této záložce.

Naplnění hodnot parametrů

Nyní otevřeme agendu Skladové karty, kde vidíme záložku Parametry, která se zde zobrazuje díky tomu, že jsme v agendě Skupiny parametrů přiřadili třídu Skladová karta. Záložka je však u typu skladové karty, který nesplňuje podmínku, prázdná. Například skladová karta typu Zboží nezobrazí žádné parametry.

U skladových karet typu Výrobek již budou parametry na záložce viditelné, jelikož byla splněna podmínka pro zobrazení parametrů.

Tlačítkem Úpravy přejdeme do režimu editace záznamu a vyplníme hodnoty jednotlivých parametrů, následně uložíme. Po uložení je vidět datum provedené změny a kdo změnu provedl.

Zobrazení parametrů v tiskových sestavách

Na konec návodu si ukážeme, jak lze s parametry pracovat na úrovni např. tiskových sestav. Stejný postup by ale bylo možné použít například pro sloupce nebo panely definovatelných údajů.

Klíčová je QR funkce NxGetUserParamValue, která umožní zobrazovat požadované parametry z požadovaných skupin. Ukážeme si nyní použití funkce na příkladu.

Do tiskové sestavy, která zobrazuje kód a název skladové karty, budeme chtít přidat z vytvořených parametrů Hmotnost a Datum kontroly. Nejprve přidáme Hmotnost.

Funkce NxGetUserParamValue má tři parametry:

CLSID agendy, na které je záložka Parametry. CLSID získáme z technické dokumentace GenDoc.chm, která je umístěna v adresáři s instalovaným systémem ABRA Gen. Zde sekce 0 - Jádro systému a skladové hospodářství, dále pak zvolíme Seznam business objektů a v něm si najdeme objekt s názvem StoreCard. Po rozkliknutí nás zajímá údaj z položky PackedCLSID.
ID záznamu z agendy, na které je záložka parametry. V našem případě u skladových karet se bude jednat o hodnotu Main.ID.
Třetím parametrem je ID parametru, který chceme v tiskové sestavě zobrazovat. ID získáme tak, že si otevřeme agendu Skupiny parametrů, subzáložku Parametry a zde se postavíme na záznam, jehož ID chceme získat. Na klávesnici stiskneme ctrl+I, čímž zkopírujeme ID záznamu do schránky. To pak následně pomocí ctrl+C vložíme do výrazu.

Zápis tedy bude vypadat v našem případě takto:

NxGetUserParamValue('C3V5QDVZ5BDL342M01C0CX3FCC', MAIN.ID, '1010000101')

Pro přidání datumu budeme muset použít navíc ještě jednu QR funkci, např NxFormatDate, a to z toho důvodu, že se datumové hodnoty vrací jako číslo. Touto funkcí zabalíme funkci předchozí. Zápis tedy bude vypadat následovně:

NxFormatDate('DD/MM/YYYY',NxGetUserParamValue('C3V5QDVZ5BDL342M01C0CX3FCC', MAIN.ID,'3020000101'))

Stejným způsobem bychom přidávali další parametry, které jsme vytvořili. Nezapomeňte, že pro každý parametr je potřeba použít funkci znova, protože funkce umí vrátit pouze informaci z jednoho parametru.