Programové Indikátory¶
Následuje úplný seznam všech proměnných indikátorů programu dostupných v DHIS2 a poznámky o tom, zda byly nebo nebyly implementovány v aplikaci Android Capture.
Jakékoli problémy spojené s používáním konkrétní funkce v systému Android jsou zvýrazněny vykřičníkem.
| legenda | popis |
|---|---|
| Komponenta implementována | |
| Komponenta není implementována (pravidlo selže) | |
| Nelze použít | |
| Ve vývoji. Funkce ještě není zcela implementována nebo již bylo hlášeno neočekávané chování. |
Běžné funkce pro použití ve výrazu indikátoru programu nebo filtru¶
| Funkce | Popis | Status | Poznámky k provádění |
|---|---|---|---|
| if | Vyhodnotí logický výraz a pokud true vrátí hodnotu true výrazu, pokud false vrátí hodnotu falešného výrazu. Argumenty musí dodržovat pravidla pro jakýkoli výraz indikátoru. | ||
| isNull | Vrátí true, pokud chybí hodnota prvku (null), jinak false. | ||
| isNotNull | Vrátí true, pokud hodnota prvku nechybí (není null), jinak false. | ||
| firstNonNull | Vrátí hodnotu prvního prvku, který nechybí (není null). Lze zadat libovolný počet argumentů. Jakýkoli argument může být také číselný nebo řetězcový literál, který bude vrácen, pokud všechny předchozí objekty mají chybějící hodnoty. | ||
| největší | Vrátí největší (nejvyšší) hodnotu zadaných výrazů. Lze uvést libovolný počet argumentů. | ||
| nejméně | Vrátí nejnižší (nejnižší) hodnotu zadaných výrazů. Lze uvést libovolný počet argumentů. |
(d2) Funkce pro použití ve výrazu indikátoru programu nebo filtru¶
| Funkce | Popis | Status | Poznámky k provádění |
|---|---|---|---|
| addDays | Vytvoří datum na základě data prvního argumentu a přidá počet dní druhého argumentu. | ||
| ceil | Zaokrouhlí vstupní argument na nejbližší celé číslo. | ||
| condition | Vyhodnotí logický výraz a pokud true vrátí hodnotu true výrazu, pokud false vrátí hodnotu výrazu false. Podmíněný výraz musí být označen uvozovkami. Argumenty true-expr a false-expr musí dodržovat pravidla libovolného výrazu indikátoru programu (včetně funkcí). | ||
| počet | Spočítá počet datových hodnot, které byly shromážděny pro danou fázi programu a datový prvek v průběhu registrace. Datový prvek argumentu je dodáván se syntaxí #{programStage.dataElement}. | ||
| countIfCondition | Spočítá počet datových hodnot, které odpovídají zadaným kritériím podmínek pro danou fázi programu a datový prvek v průběhu registrace. Datový prvek argumentu je dodáván se syntaxí #{programStage.dataElement}. Podmínka se dodává jako výraz v jednoduchých uvozovkách. | ||
| countIfValue | Spočítá počet datových hodnot, které odpovídají zadané přesné hodnotě pro danou fázi programu a datový prvek v průběhu registrace. Datový prvek argumentu je dodáván se syntaxí #{programStage.dataElement}. Hodnota může být pevně zapsaný text nebo číslo. | ||
| countIfZeroPos | Spočítá počet hodnot, které jsou nulové nebo kladné zadané pro zdrojové pole v argumentu. | ||
| daysBetween | Produkuje počet dní mezi dvěma datovými prvky / atributy typu datum. | ||
| floor | Zaokrouhlí vstupní argument na nejbližší celé číslo. | ||
| hasUserRole | Vrátí true, pokud má aktuální uživatel tuto roli, jinak false. | ||
| hasValue | Vrátí true, pokud má datový prvek / atribut hodnotu. | ||
| inOrgUnitGroup | Vyhodnocuje, zda je aktuální organizační jednotka ve skupině argumentů. Argument lze definovat buď ID, nebo kódem skupiny organizační jednotky. | ||
| left | Vyhodnocuje k levé části textu počet znaků od prvního znaku. | ||
| délka | Najděte délku řetězce. | ||
| minut mezi | Produkuje počet minut mezi dvěma datovými prvky / atributy typu „datum a čas“. | ||
| modulus | Produkuje absolutní hodnotu při dělení prvního a druhého argumentu. | ||
| monthsBetween | Produkuje počet celých měsíců mezi prvním a druhým argumentem. | ||
| oizp | Vrátí jeden, pokud je výraz nula nebo kladný, jinak vrátí nulu. | ||
| relationshipCount | Produkuje počet vztahů daného typu, který je připojen k zápisu nebo události. Pokud není uveden žádný typ, započítají se všechny typy. | ||
| vpravo | Vyhodnocuje na pravou část textu počet znaků od posledního znaku. | ||
| round | Zaokrouhlí vstupní argument na nejbližší celé číslo. | ||
| rozdělit | RSplit text oddělovačem a ponechat n-tý prvek (0 je první). | ||
| podřetězec | Vyhodnocuje se na část řetězce určenou počátečním a koncovým číslem znaku. | ||
| validatePatten | Vyhodnotí se jako true, pokud je vstupní text přesnou shodou s dodaným vzorem regulárního výrazu. | ||
| týdnů mezi | Produkuje počet celých týdnů mezi dvěma datovými prvky / atributy typu datum. | ||
| yearsBetween | Produkuje počet let mezi prvním a druhým argumentem. | ||
| zing | Vrátí nulu, pokud je výraz záporný, jinak vrátí hodnotu výrazu. | ||
| zpvc | Vrátí počet číselných nul a kladných hodnot mezi danými argumenty objektu. |
Proměnné, které se mají použít ve výrazu nebo filtru indikátoru programu¶
| Typ proměnné | Popis typu proměnné | Status | Poznámky k provádění |
|---|---|---|---|
| Datum události event_date | Datum, kdy se událost konala. | ||
| Creation Date* creation_date | Datum, kdy byla v systému vytvořena událost nebo registrace. | ||
| Datum platnosti due_date | Datum ukončení platnosti události. | ||
| Sync Date* sync_date | Datum, kdy byla událost nebo zápis naposledy synchronizována s aplikací pro Android. | ||
| Incident Date incident_date | Datum výskytu události. | ||
| Datum registrace (není vidět v uživatelském rozhraní) enrollment_date | Datum, kdy byla trasovaná instance entity zapsána do programu. | ||
| Stav zápisu enrollment_status | Lze použít k zahrnutí nebo vyloučení zápisů v určitých stavech. | ||
| Aktuální datum current_date | Aktuální datum. | ||
| Dokončené datum | Datum události je dokončeno. | ||
| Value Count value_count | Počet nenulových hodnot ve výrazové části události. | ||
| Zero or positive value count zero_pos_value_count | Počet číselných kladných hodnot ve výrazové části události. | ||
| Event Count event_count | Počet událostí (užitečné v kombinaci s filtry). | ||
| Enrollment Count enrollment_count | Počet zápisů (užitečné v kombinaci s filtry). | Indikátory v aplikaci pro Android se počítají v doméně jednoho zápisu TEI. Hodnota vždy 1. | |
| TEI Count tei_count | Počet trasovaných instancí entit (užitečné v kombinaci s filtry). | Indikátory v aplikaci pro Android se počítají v doméně jednoho zápisu TEI. Hodnota vždy 1. | |
| Program Stage Name program_stage_name | Lze použít ve filtrech pro zahrnutí pouze určitých fází programu do filtru pro programy sledování. | ||
| Program Stage ID program_stage_id | Lze použít ve filtrech pro zahrnutí pouze určitých fází programu do filtru pro programy sledování. | ||
| Reporting Period Start reporting_period_start | Lze použít ve filtrech nebo výrazech pro srovnání jakéhokoli data s prvním datem v každém vykazovaném období. | Indikátory v aplikaci pro Android se počítají v doméně jedné registrace TEI. | |
| Reporting Period End reporting_period_end | Lze použít ve filtrech nebo výrazech pro porovnání libovolného data s posledním inkluzivním datem v každém vykazovaném období. | Indikátory v aplikaci pro Android se počítají v doméně jedné registrace TEI. | |
| Organisation Unit Count organisationunit_count | . |