VOLITELNÉ VLASTNOSTI

V této části CMDB je možné upravovat existující vlastnosti a vytvářet nové. Ty je následně možné použít pro evidenci libovolných doplňujících údajů ve formulářích různých komponent systému CDESK jako například:

• Adresář (Společnosti, Kontakty)
• Požadavky (Všeobecné požadavky, Katalog požadavků)
• Zakázky
• CMDB (CI types, CI záznamy)

Tento článek popisuje evidenci a vytváření volitelných vlastností a jejich součástí. Práce s volitelnými vlastnostmi a přiřazování k jednotlivým formulářům a objektům je blíže popsána v článku Všeobecné funkce->Volitelné vlastnosti.

Hierarchie volitelných vlastností

• Vlastnosti – nebo také volitelné vlastnosti, jsou množinou jedné nebo více základních vlastností. Umožňují evidenci doplňujících údajů ve formulářích CDESK. Pokud vlastnost obsahuje více než jednu základní vlastnost, jedná se o složenou vlastnost
  • Základní vlastnosti – určují typ hodnoty, kterou vlastnost zaznamenává – například text, číslo, datum, zaškrtávací pole, údaj z databáze, či vlastní číselník
    • Vlastní číselníky – množina uživatelsky definovaných hodnot, které jsou přístupné k výběru ve vlastnosti používající základní vlastnost typu číselník

Základní vlastnosti

V této části jsou definovány základní vlastnosti a jejich typy. Každá čistá instalace CDESK již obsahuje množinu běžně používaných základních vlastností, jejichž detail si zobrazíte výběrem volby z kontextového menu Detail . Tyto předdefinované vlastnosti není možné editovat. Pokud předdefinované základní vlastnosti nepostačují vašemu účelu, můžete přidat vlastní pomocí tlačítka +Přidat základní vlastnost . Otevře se formulář s možnostmi:

Základní typ – vyberte typ údaje, který si přejete ve volitelných vlastnostech evidovat:

• Checkbox (true/false) – zaškrtávací políčko
• Counter – pole pro zadávání číselné hodnoty k zvolenému datu
• Custom Enum – pole pro výběr z předdefinované množiny hodnot z uživatelsky definovaného číselníku
• Date – pole pro výběr data
• Datetime – pole pro výběr data a času
• DB relation – pole pro výběr hodnot uložených v databázi
• File upload – pole pro přiložení souboru
• IP – pole pro záznam IP adresy
• Long text (65535 chars) – pole pro zadávání dlouhého textu do 65535 znaků
• Number (decimal) – pole pro zadávání čísla s desetinnou čárkou
• Number (whole number -2mld .. +2mld) – pole pro zadávání celého čísla
• String (255 chars) – pole pro zadání textu s délkou do 256 znaků
• Time – pole pro výběr času
• Tri-state checkbox (true/false/maybe) – přepínač s evidencí tří možných stavů

• V závislosti na vybraném základním typu se zpřístupní další pole formuláře:
• Vlastní číselník – zpřístupní se po výběru typu Custom Enum – vyberte z uživatelsky definovaných číselníků. Více o vlastních číselnících se dočtete v samostatném odstavci níže
• API cesta – uveďte cestu k databázi, odkud se mají načítat hodnoty, jsou dvě možnosti:

• Předdefinovaná – vyberte si z definovaných cest k používaným číselníkům v databázi CDESK (například seznam zakázek, počítačů, jednotek, zemí..)
• Vlastní – umožňuje použití cesty k dalším částem databáze CDESK, podle dokumentace API (například k seznamu objektů patřících pod CI Main group/CI Type, místo ID použijte Slug). Zároveň umožňuje načítání hodnot z externí databáze

• Query parameter – kliknutím na +Přidat query parameter přidáte řádek pro vyplnění parametru a hodnoty – seznam parametrů najdete v API dokumentaci CDESK

Název – uveďte název základní vlastnosti, zobrazí se v poli formuláře jako zástupný text (místo prázdného políčka)

Typ vlastnosti – vyberte, pro evidenci jakého údaje základní vlastnost vytváříte. V API podle zvoleného typu je možné vyhledat údaje, které jsou evidovány pod jiným názvem (například výběrem typu phone, vyhledáte všechna telefonní čísla, i když budou v databázi evidována jednou pod názvem Telefonický kontakt, podruhé jako Pevná linka)

Slug (alias) – alias pro ID – umožňuje práci se základními vlastnostmi v API rozhraní CDESK, bez nutnosti znát jejich ID v databázi. Používejte výrazy bez diakritiky a mezer – místo mezer použijte pomlčku. Slug má být jedinečný, tj. smí být použit v rámci základních vlastností maximálně jednou

Pro vytvoření základní vlastnosti, nebo aplikování změn, klikněte na Uložit.

Vlastnosti

V této části jsou definovány vlastnosti, využívané pro evidenci doplňujících údajů ve formulářích. Je možné je přiřazovat formulářům jako jsou společnosti, kontakty, zakázky, požadavky, či objekty. Každá instalace CDESK již obsahuje množinu vlastností, jejichž detail si zobrazíte výběrem volby z kontextového menu Detail. Tyto předdefinované vlastnosti není možné upravovat ani mazat. Můžete přidávat i vlastní vlastnosti pomocí tlačítka +Přidat vlastnost. Otevře se formulář s možnostmi:

Název – uveďte název vlastnosti, zobrazí se ve formuláři jako název pole, či množiny polí v případě složené vlastnosti

Popis – můžete uvést stručný popis vlastnosti (například přiřazené základní vlastnosti v případě složené vlastnosti)

Skupina – Všeobecné/Technické/Ostatní – vyberte, do jaké skupiny vlastnost patří. Nemá vliv na funkčnost vlastnosti, rozlišení podle skupiny pomáhá vizuálnímu třídění vlastností v seznamu vlastností

Property type – vyberte, pro evidenci jakých údajů vlastnost vytváříte. V API, podle zvoleného typu, je možné vyhledat údaje, které jsou evidovány pod různým názvem (například výběrem typu phone, vyhledáte všechna telefonní čísla, i když budou evidována jednou jako Telefonický kontakt, jednou jako Pevná linka)

Slug (alias) – alias pro ID – umožňuje práci s vlastnostmi v API rozhraní CDESK, bez nutnosti znát jejich ID v databázi. Používejte výrazy bez diakritiky a mezer – místo mezer použijte pomlčku. Slug má být jedinečný, tj. smí být použit v rámci vlastností maximálně jednou

Základní vlastnosti – kliknutím na Přidat základní vlastnost se otevře okno pro výběr základních vlastností tříděných podle základních typů vlastností definovaných v CMDB->Volitelné vlastnosti->Základní vlastnosti. Kliknutím na < přidáte základní vlastnost. Zvolením více základních vlastností je možné vytvářet tzv. složené vlastnosti (například vlastnost Adresa se může skládat ze základních vlastností Ulice, Číslo, PSČ, Země)

Pro vytvoření vlastnosti, nebo aplikování změn, klikněte na Uložit.

Vlastní číselníky

V této části definujete číselníky s vlastními množinami hodnot. Ty mohou být následně k dispozici k výběru u volitelných vlastností používajících vybraný číselník hodnot.

Nový číselník přidáte tlačítkem +Přidat číselník.

Název – uveďte název číselníku, zobrazí se v poli formuláře jako zástupný text (místo prázdného políčka)

Popis – můžete uvést stručný popis číselníku

Tlačítkem +Přidat přidáte nový řádek pro zadání hodnoty číselníku. Kliknutím na × řádek odstraníte – odstranění je možné jen před uložením. Po uložení číselníku je možné nepoužívané hodnoty vypnout přepnutím přepínače do stavu vypnuto . Pořadí hodnot číselníku upravíte potažením za ikonu .

Pro vytvoření vlastního číselníku, nebo aplikování změn, klikněte na Uložit>.

Příklad vytvoření složené vlastnosti

Předpokládejme složenou vlastnost, která bude mít za úkol evidovat údaje o stavu zařízení odevzdávaného do servisu.

Pro zaznamenávání informací o stavu zařízení budeme evidovat, zda je zařízení ještě v záruce, datum prodeje, známky poškození, odevzdávané příslušenství. Doporučujeme začít od té nejnižší úrovně jako v postupu níže:

1. Vytvořit vlastní číselník s názvem Typy poškození a možnostmi popisujícími úroveň poškození:
   • Bez viditelných známek poškození
   • Drobné škrábance
   • Praskliny, nebo promáčkliny
   • Odlomené, nebo chybějící části
2. Vytvořit základní vlastnosti, které definují typ hodnoty
   • V záruce – budou se zaznamenávat pouze dva stavy, můžeme proto použít typ pole Checkbox (true/false) – zaškrtávací políčko
   • Datum prodeje – pole typu Date – výběr data
   • Známky poškození – bude se vybírat z předdefinovaných hodnot – pole typu Custom Enum – s číselníkem Typy poškození vytvořeným v prvním kroku
   • Odevzdávané příslušenství – vytvářená vlastnost bude použitelná pro zařízení různého typu, přičemž každé může obsahovat jiné příslušenství. Pro univerzálnost proto bude vhodné pole typu String (255 chars) – krátký text do 255 znaků
3. Vytvořit vlastnost s názvem Stav zařízení
   • Přiřadit základní vlastnosti vytvořené v druhém kroku

Tímto je složená vlastnost Stav zařízení vytvořena a je možné ji přiřadit například k požadavku. Díky její univerzálnosti je použitelná pro zařízení různých typů. Přiřazení volitelné vlastnosti k formuláři požadavku je blíže popsáno v článku Všeobecné funkce->Volitelné vlastnosti.