Tipy a příklady

Článek
07/26/2023

Vzorec metriky

Definujte vzorec metriky v textové podobě. Může se skládat z předdefinovaných operací.

Jednotlivé operace se dělí do dvou základních skupin:

Agregační operace: Vstupem agregační operace je množina hodnot, pro které bude výsledná hodnota vypočtena (například průměr, maximum a další).
Skalární operace: Vstupem skalární operace je jedna nebo více hodnot, pro které bude výsledná hodnota vypočtena (například absolutní hodnota čísla, získání části daně a další).

Operace mohou používat konstanty, lze je kombinovat pomocí unárních nebo binárních operátorů (například sčítání, odčítání a více), nebo vnořené.

Mezi skalární operace patří i operace k získání hodnoty, buď přímo dostupné ve formě atributu, nebo ve formě odvozené statistiky (trvání události).

Některé operace také podporují specifikaci kontextu, pro který je operace vyhodnocována. To je důležité pro agregační operace, které mohou agregovat hodnoty, například pouze pro konkrétní aktivitu nebo pro všechny aktivity nebo události. Podporován je také implicitní kontext vyplývající z kontextu metriky nebo kontextu nadřazené operace.

Vzorec metriky může vrátit jeden z podporovaných datových typů. Datové typy pro konkrétní vzorce jsou definovány v tomto článku vedle definice syntaxe vzorce.

Agregační operace

Základem každé metriky jsou agregační operace. Mezi nejčastěji používané agregované operace patří:

COUNT: Vrátí počet agregovaných hodnot (incl. COUNTIF, COUNTUNIQUE).
SUM: Vrátí součet agregovaných hodnot (incl. SUMIF).
AVG: Vrátí průměr agregovaných hodnot.
MIN: Vrátí minimum agregovaných hodnot.
MAX: Vrátí maximum agregovaných hodnot.

Volitelným parametrem agregačních operací bude operační kontext a skalární operace pro úpravu vstupní hodnoty. Úplný seznam podporovaných kontextů výpočtu je popsán v části Kontext výpočtu.

Skalární operace

Účelem skalárních operací je získání jedné hodnoty a její transformace do požadovaného stavu. Aktuálně podporované operace lze rozdělit do několika typů:

Matematické – zahrnuje operace pro získání absolutní hodnoty čísla, zaokrouhlení atd.
Datum a čas: zahrnuje operace pro práci s datem, jako je získání části data, sečtení dat atd.
Řetězec: zahrnuje operace pro práci s daty řetězců, jako je získání podřetězce, rozdělení řetězců atd.
Statistické: zahrnuje operace pro získání různých statistik, jako je počet případů, doba čekání na případ atd.
Ostatní: zahrnuje další operace, jako např. operace přistupující k události, případu, odvozeným statistikám atd.

Názvy atributů

Pokud je název atributu použit jako parametr pro operaci, existují tři způsoby, jak na něj odkazovat:

Použít název atributu přímo (například Resource).
Použít operaci GETVALUE("název atributu") (například GETVALUE("Resource")).
Použít zkrácený název atributu přímo (například attribute "Resource ID" může být odkazováno jako ResourceID).

Druhá forma se používá, když název atributu nesplňuje konvenci pojmenování. Konvence pojmenovávání atributů je definována takto:

Název atributu musí začínat písmenem nebo podtržítkem.
Název atributu může obsahovat pouze znaky z následujících standardních tříd Unicode: znak písmene (Lu, Ll, Lt, Lm, Lo nebo Nl), kombinační znak (Mn nebo Mc), znak desetinné číslice (Nd), spojovací znak (Pc) nebo formátovací znak (Cf).

Informace o výše zmíněných kategoriích znaků Unicode najdete v části 4.5 dokumentu The Unicode Standard, verze 3.0.

Třetí tvar se používá volitelně, pokud název atributu splňuje konvenci pojmenování, ale obsahuje také mezery. Místo použití druhé formy GETVALUE("attribute name") je možné odstranit mezery a použít zkrácenou verzi attributename. Obě formy jsou ekvivalentní.

Příklady PLATNÝCH názvů atributů

DocumentCategory
DocCat
DocCat23

Příklady NEPLATNÝCH názvů atributů

Document.Category
Document Category
23DocCat

Příklady vzorce metriky

Chcete-li vypočítat relativní dobu trvání aktivity na mapě:

AVG (DURATION()) / AVG (VIEWCASES, DURATION())

Sdílet prostřednictvím