V dokumentaci 'Praktické příklady' naleznete ukázky konfigurací parametrů.
Identifikátor - Jedná se o unikátní strojový název parametru, se kterým systém interně pracuje. Pomocí identifikátoru je možné se na parametr odkazovat například v rámci automatizace nebo při tisku dokumentů. Zvolte ideálně anglická slova psaná všemi velkými písmeny a oddělená podtržítky místo mezer.
Typ - Určuje typ hodnoty, jakým způsobem bude parametr editován a jakých bude moci nabývat hodnot. Mezi základní typy pak patří:
- Ano/Ne
- Rozlišení pouze dvou stavů Ano / Ne, ve formulářích reprezentováno zaškrtávátkem (checkbox)
- Řetězec
- Zadání krátkého jednořádkového textu, ve formulářích reprezentováno běžný textovým polem.
- Text
- Zadání delšího textu, typicky i víceřádkového. Oproti typu řetězec je reprezentováno víceřádkovým textovým polem.
- Seznam
- Výběr hodnoty z předem daného seznamu. Ve formulářích reprezentováno jako výběr (popuplist), jednotlivé nabízené hodnoty jsou pak definovány pomocí definičního oboru (viz níže).
- Stromová struktura
- Typ podobný seznamu zmíněnému výše. Oproti němu ale obsahuje více na sobě navzájem závislých úrovní, kdy výběrem hodnoty v jedné úrovni dojde ke změně položek v úrovni nižší. Vyžaduje definici víceúrovňového číselníku.
- Celé číslo
- Jednoduché celé číslo bez desetinné části.
- Číslo
- Číslo včetně desetinné části
- Datum
- Datum ve formátu DD:MM:RRRR
- Čas
- Čas ve formátu HH:MM:SS
- Datum a Čas
- Datum a čas ve formátu DD:MM:RRRR HH:MM:SS
Závislosti - Umožňují definovat u parametru v jakém stavu procesu bude viditelný, editovatelný nebo dokonce povinný. Je-li parametr pouze viditelný, má uživatel možnost vidět jeho hodnotu, ale nemůže jej měnit, je-li parametr editovatelný, může uživatel měnit jeho hodnotu a je-li parametr povinný, musí uživatel nějakou hodnotu zadat. Zároveň platí, že je-li parametr povinný je zároveň i editovatelný a je-li parametr editovatelný je automaticky i viditelný.
Viditelnost, editovatelnost a povinnost se nastavuje pomocí pravidel, které se skládají z podmínek. Pravidlo je splněno, pokud jsou splněny všechny podmínky v něm. A zároveň parametr je viditelný (editovatelný, povinný) pokud je splněno alespoň jedno jeho pravidlo. (kombinace logických operátorů AND a OR umožňuje definici jakkoliv složitého logického výrazu).
Při definici podmínek pravidla je možné odkazovat se na stav procesu, přechod mezi procesy či jiné parametry procesu. Pokud je připojen zákazník nebo provozovna, je možné se také odkazovat na jejich vlastnosti. Parametr může odkazovat i na svou vlastní hodnotu (hojně využíváno v případě například zobrazení parametru vždy, když byl v předchozích krocích vyplněn)
Pravidla pro zobrazení (editovatelnost, povinnost) parametru se vyhodnocují okamžitě při práci s procesem.
Při nastavování můžete využít praktické příklady, které naleznete v dokumentaci 'praktické příklady parametrů'.
Definiční obor - udává jakých hodnot může parametr nabývat. Definiční obor se skládá z jednotlivých definic, které mohou být různě kombinovány:
- Hodnota - udává jednu konkrétní hodnotu
- Číselný rozsah - udává rozsah čísel od - do
- Číselník - hodnoty jsou načteny z předem definovaných číselníků Mango.
- Předpřipravený seznam - hodnoty se automaticky generují z dat uložených v Mango. Jedná se o předdefinované SQL dotazy, v případě potřeby implementace je možné po konzultaci přidat další.
Je-li pak potřeba například vytvořit parametr nabývající pouze hodnot 1, 2 a 3, je možné zadat buď tři definice typu hodnota (1, 2, 3) nebo jednu definici typu rozsah (1..3). Složitější definiční obory pak vznikají analogicky.
Indexovaný - Indexované parametry mohou být zadány pro jeden proces vícenásobně, kdy na každý jednotlivý výskyt parametru se lze odkazovat jeho názvem a číselným indexem.
Použití - Slouží pro skrytí parametrů, které jsou využívány systémem pro interní účely. Systém očekává nějakou konkrétní definici takových parametrů, a proto je není možné uživatelsky měnit.
- Interní
- Slouží pouze interní systémové účely - pro práci v procedurách, workflow atd..
- Uživatelský
- Běžný parametr, se kterým pracuje operátor v dialogu procesu, může jej měnit.
Skupina - Umožňuje zařadit parametr do skupiny a sloučit jich tak několik dle specifického významu. Skupina pak může umožňovat zobrazení parametrů jako řádek nebo dokonce tabulka. Skupiny musí být předem vytvořené.
Proměnná do dokumentů - Název, který zde vyplníte je možné použít jako proměnnou v 'Šablonách' typu "Text emailu (systémový)", "Servisní proces" a "Seznam servisních úkolů". V
šabloně je potřeba před název použít '%'. Např. název proměnné do dokumentů je SERIAL_NUMBER. V Šabloně pak bude uvedeno %SERIAL_NUMBER. Pokud zde název nevyplníte, je i tak možné použít parametr v šabloně, akorát musíte použít formát ML_PARAM_xxx, kde
xxx je identifikátor parametru procesu. Unikátnost proměnné do šablon není kontrolována!
Pořadí - Pořadí zobrazení parametrů v dialogu. Je-li parametr zařazen do skupiny, pak se jedná o pořadí pouze v rámci skupiny
Součást názvu procesu - Zaškrtnutí zajistí doplnění obsahu tohoto parametru do názvu procesu.
Viditelnost v tabulkách - Definuje jak se parametr zobrazí jako nový sloupec v tabulce (např. Seznam procesů nebo dashboard).
- Nezobrazovat
- Parametr není možné v tabulce vůbec zobrazit.
- Zobrazit ve skupině
- Parametr se v dialogu na zobrazení volitelných sloupců zobrazí zatříděný ve skupině podle skupiny, v níž je zařazen.
- Zobrazit mimo skupinu
- Parametr není v dialogu na zobrazení volitelných sloupců přiřazen pod skupinou, v níž je obsažen. Je ale začleněn pod skupinou nepřiřazeno.
Statistika - Zaškrtnutí zajistí zobrazení parametru ve Statistikách parametrů'.