Beta verze nové dokumentace.

Základní vlastnosti

Základní vlastnosti určují, jaký typ hodnoty lze do pole zadat, jakým způsobem se hodnota vyplňuje a jaká omezení se na ni vztahují. Volba základní vlastnosti má přímý vliv na chování pole v celém životním cyklu záznamu – od vytvoření a úpravy, přes vyhledávání a filtrování, až po export a další navazující zpracování.

Prostřednictvím základních vlastností se uživatelská pole propojují s konkrétními datovými typy, číselníky a validačními pravidly. Jejich správná konfigurace má přímý vliv na kvalitu zadávaných údajů a možnosti dalšího zpracování dat v systému.

CDESK podporuje následující datové typy:

  • Čas – pole s výběrem času v hodinách a minutách
  • Čas a datum – pole s výběrem data i času v hodinách a minutách
  • Checkbox – zaškrtávací pole
  • Číslo – celé číslo. Podporuje pouze znaky 0-9, e
  • Číslo se dvěma desetinnými místy – číslo s desetinným místem. Podporuje znaky 0-9, e a desetinnou čárku
  • Datum – pole s výběrem data
  • Desetinné číslo – číslo s desetinným místem. Podporuje znaky 0-9, e a desetinnou čárku
  • Hyperlink – pole pro evidenci hypertextového odkazu. Po zadání adresy se změní na klikatelný link
  • IP adresa – pole pro evidenci IPv4 adresy. Kontroluje platnost zadaných číslic v rozsahu 0-255
  • IP rozsah – jako IP adresa výše, s možností zadat dvě IPv4 ohraničující interval IP
  • Počítadlo – typ vlastnosti pro zaznamenávání číselného stavu k datu. Využívá se při generování pravidelných požadavků podle parametru.
  • Soubor – umožňuje vkládání přílohy, např. fotografie a dokumenty
  • Textové pole (255 znaků) – jednořádkový text
  • Textové pole (65535 znaků) – textové pole s řádkováním, bez formátování
  • Textové pole s formátováním (65526 znaků) – textové pole s řádkováním a formátováním
  • Třístavový checkbox – přepínač se 3 stavy OFF – NULL – ON
  • Vazba – dynamický číselník, který čerpá hodnoty ze záznamů evidovaných v CDESK, například položka (CI), uživatelé, společnosti, požadavky apod. Na první trojici jmenovaných je také možné při použití vlastnosti v typu položky vytvářet i propojení s CI.
    • Vytvoření vazby: je třeba vybrat typ záznamu, na který bude vazba vytvořena. Podle vybraného typu záznamu se předvyplní obecná API cesta, vracející seznam všech záznamů vybraného typu. Množinu záznamů lze zúžit na užší skupinu záznamů doplněním této cesty podle API dokumentace.
    • Příklad: vazba na CMDB, předvyplní API cestu „cmdb/ci“, která vrátí seznam všech CI. Doplněním cesty na „cmdb/maingroups/ID/ci“, kde ID je identifikační číslo skupiny, se seznam CI zúží pouze na položky (CI) vybrané skupiny položek. Podobně „cmdb/type/ID/ci“, kde v tomto případě ID představuje identifikační číslo typu položky.
    • TIP: Namísto ID lze použít slug, pokud je pro skupinu a typ položky zadán alias
  • Vlastní číselník – uživatelsky vytvořený číselník, vyžaduje uvedení číselníku, který má být v základní vlastnosti tohoto typu použit

Vytvoření základní vlastnosti

Základní vlastnost lze vytvořit dvěma způsoby:

  • Ze seznamu základních vlastností – nacházejícího se v Konfigurační databázeUživatelem definovaná pole Základní vlastnosti, kliknutím na tlačítko + Přidat základní vlastnost.
  • Rychlým přidáním vlastnosti pro různé typy záznamů – např. typ položky, šablona požadavku – v takovém případě se společně s vlastností vytvoří také základní vlastnost se stejným názvem. Podrobný postup pro přidání polí v konkrétním záznamu uvádíme v jednotlivých částech dokumentace, např. Uživatelská pole v šabloně požadavku.
Obrázek: Tlačítko pro vytvoření základní vlastnosti ze seznamu

Po kliknutí na tlačítko pro vytvoření základní vlastnosti se zobrazí formulář pro vyplnění potřebných údajů. Význam jednotlivých polí je uveden v následujícím textu Význam polí formuláře základní vlastnosti. Po vyplnění údajů je nutné vlastnost uložit – kliknutím na tlačítko Vytvořit.

Význam polí formuláře základních vlastností

Formulář pro vytvoření základní vlastnosti se mírně liší podle zvolené hodnoty v poli Typ. Obecně formulář obsahuje následující pole:

  • Typ – typ základní vlastnosti, který určuje její hlavní charakteristiku. Vysvětlení jednotlivých typů je uvedeno výše v textu Základní vlastnosti.
  • Název – hlavní charakteristika základní vlastnosti. Pro název lze doplnit také překlad. Bez uvedeného překladu bude ve všech jazycích použit název výchozího jazyka.
  • Popis – stručná charakteristika základní vlastnosti, zobrazuje se jako nápověda u uživatelského pole ve formuláři. Pro popis lze doplnit také překlad, bez uvedeného překladu bude ve všech jazycích použit popis výchozího jazyka.
  • Poznámka – doplňující informace o základní vlastnosti, poznámka se zobrazuje v seznamu uživatelských polí.
  • Slug (alias) – reprezentuje alias pro položku ve srozumitelném tvaru, který se využívá při API voláních místo ID. Použitý výraz nesmí obsahovat diakritiku či mezery a je case sensitive (rozlišuje mezi velkými a malými písmeny).
Obrázek: Formulář pro vytvoření základní vlastnosti

Seznam základních vlastností

Seznam všech vytvořených základních vlastností je k dispozici v hlavním menu v části Konfigurační databázeUživatelem definovaná pole Základní vlastnosti. Záhlaví okna seznamu základních vlastností informuje o počtu zobrazených záznamů z celkového počtu, dále obsahuje ovládací prvky pro vytvoření nové základní vlastnosti a vyhledávání s použitím pokročilého filtru spolu s možností jeho uložení. Následuje výpis seznamu vlastností podle aktuálně nastaveného filtru, případně podle výsledků vyhledávání. V seznamu jsou aktuálně zobrazeny sloupce:

  • ID
  • Název
  • Poznámka
  • Typ
Obrázek: Seznam základních vlastností

Úprava vytvořené vlastnosti je dostupná dvojklikem na řádek příslušné vlastnosti, případně kliknutím na burger menu na konci řádku a výběrem možnosti Editovat. U některých základních vlastností je zobrazen příznak . Tyto základní vlastnosti jsou systémové, nelze je odstraňovat ani upravovat.

Obrázek: Úprava základní vlastnosti

Vyhledávání a filtrování v seznamu základních vlastností

Pro efektivní vyhledávání zadáním požadovaného výrazu můžete použít pole Vyhledávání umístěné nad seznamem základních vlastností. Toto tzv. fulltextové vyhledávání prohledává sloupce:

  • ID
  • Název
Obrázek: Vyhledávání v seznamu základních vlastností

Pokud potřebujete vyhledat vlastnosti podle více kritérií, slouží k tomu pokročilý vyhledávací filtr, který aplikujete kliknutím na tlačítko vedle pole Vyhledávání. V tomto filtru můžete určit konkrétní podmínky vyhledávání nad sloupci:

  • Libovolný sloupec
  • Název
  • Popis
  • Slug (alias)
  • Typ
Obrázek: Podmínky filtrování v seznamu základních vlastností

Podle typu sloupce si můžete vybrat podmínky typu „obsahuje“ nebo „neobsahuje“ hledaný výraz či jeho část, v případě číselníků vyberete jednu z nabízených hodnot. Podmínky vyhledávání můžete libovolně propojovat a rozšiřovat použitím logických spojek AND (a zároveň) a OR (nebo). Často používané nebo jinak specifické podmínky filtrování si můžete uložit pod názvem podle vašeho výběru a při dalším použití budou k dispozici jedním kliknutím nad seznamem.

Více informací o efektivní práci s filtry v CDESK najdete v textu Vyhledávání a pokročilé filtre.