Parametr
Parametrem obecně zde rozumíme vlastnost nějakého objektu a v Competentu rozlišujeme parametry dvou druhů: hlavní a vedlejší.
Každý hlavní objekt v systému má dané své hlavní parametry, jako je například jméno a příjmení u uživatele. U těchto parametrů je možné změnit nškteré atributy, jako pořadí, zda jsou povinné, viditelné atd., ale není možné je z objektu odebrat nebo mu přidat nové. Hlavní parametry se upravují v obrazovce Nastavení, v tabu Parametry 💻.
Dále má každý hlavní objekt definované své subtypy, které mu mohou přidat další vedlejší parametry. Jejich vlastnosti jsou shodné s hlavními parametry až na to, že je možné je libovolně subtypům přidávat a odebírat. Upravují se v nastavení subtypu 💻.
Vlastnosti parametru
Při přidání nového parametru nebo při jeho editaci se nám zobrazí okno s následujícími položkami:
- Pořadí (číslo) - určuje pořadí mezi všemi hlavními i vedlejšími parametry při vytváření nebo výpisu detailu objektu.
- Název (písmena bez mezer) - systémový název, řetězec znaků, kterými systém rozpoznává tento parametr. Pokud editujeme parametr, je tato položka neměnná.
- Překlady (JSON formát) - názvy parametru v jednotlivých jazycích Competentu, vždy ve formátu "kód_jazyka": "Název_parametru"
- Skrytý (ano/ne) - nastavuje, zda se parametr zobrazí mezi parametry objektu. Pokud je parametr skrytý, měl by mít povoleno být prázdný.
- Smí být prázdný (ano/ne) - nastavuje, zda je nutné, aby byla v parametru vyplněna nějak hodnota. Pokud parametr může být prázdný, nezobrazí se v modálovém okně při zakládání nového objektu.
- Typ (enum) - určuje typ parametru
- Výchozí hodnota (záleží na typu parametru) - hodnota, která se iniciálně vyplní při zakládání nového objektu
- Konfigurace (JSON formát) - pouze pro některé typy, například pro Typ Enum určuje možné hodnoty parametru.
"enumValues":["value1","value2"],
"valueTranslation":{
"value1":{"cs":"TranslationCS","en":"TranslationEN"},
"value2":{"cs":"TranslationCS","en":"TranslationEN"}
}
}
Řazení parametrů
Při řazení parametrů je nutno brát v potaz dvě věci. Máme hlavní parametry, které mají určitým způsobem nastavené pořadí pro každý hlavní objekt daného typu a toto pořadí je stejné pro každý objekt tohoto typu. Dále máme vedlejší parametry definované u každého subtypu a budeme pravděpodobně chtít určit i řazení těchto parametrů, přičemž je můžeme chtít zařadit mezi parametry hlavní. Subtypů jednoho hlavního objektu může být mnoho, může tedy exitovat i mnoho různých sad vedlejších parametrů, které vždy musíme zařadit mezi hlavní parametry a zařazení vedlejších parametrů různých subtypu se bude pravděpodobně lišit.
Z těchto důvodů doporučujeme seřadit hlavní parametry pomocí násobků čísla 100. To nám dává prostor vměstnat 99 dalších vedlejších parametrů mezi každé dva hlavní parametry, což by mělo být dostačující pro každý subtyp.