Indicateurs de programme¶
Vous trouverez ci-dessous une liste complète de toutes les variables d'indicateurs de programme disponibles dans DHIS2, ainsi que des remarques sur leur implémentation ou non dans l'application de saisie Android.
Tout problème lié à l'utilisation d'une fonctionnalité particulière avec Android est signalé par un point d'exclamation.
| légende | Description |
|---|---|
 | Composante implémentée |
 | Composant non implémenté (règle échouée) |
 | Non applicable |
 | Travail en cours. La fonctionnalité n'est pas encore complètement implémentée (pour le moment) ou présente une attitude inattendue déjà signalée. |
Fonctions courantes à utiliser dans un programme d'expression indicateur ou de filtre¶
| Fonction | Description | Statut | Notes relatives à la mise en œuvre |
|---|---|---|---|
| si | Évalue l'expression booléenne et, si elle est vraie, renvoie la valeur vraie de l'expression, si elle est fausse, renvoie la valeur fausse de l'expression. Les arguments doivent suivre les règles de toute expression d'indicateur. | | |
| isNull | Renvoie vrai si la valeur de l'élément est manquante (null), sinon faux. | | |
| isNotNull | Renvoie vrai si la valeur de l'élément n'est pas manquante (non nulle), sinon faux. | | |
| firstNonNull | Renvoie la valeur du premier élément non manquant (non nul). Le nombre d'arguments n'a pas de limite. Tout argument peut également être un texte numérique ou de chaîne, qui sera renvoyé si tous les objets précédents ont des valeurs manquantes. | | |
| plus grand | Renvoie la plus grande valeur (la plus élevée) des expressions données. Le nombre d'arguments peut être illimité. | | |
| moins | Renvoie le moins (plus petite) des valeur des expressions données. Le nombre d'arguments peut être illimité. | |
(d2) Fonctions à utiliser dans l'expression d'un indicateur de programme ou d'un filtre¶
| Fonction | Description | Statut | Notes relatives à la mise en œuvre |
|---|---|---|---|
| addDays | Produit une date basée sur le premier argument qu'est la date, en ajoutant le deuxième argument qu'est le nombre de jours. | | |
| limit | Arrondit l'argument d'entrée au nombre entier le plus proche. | | |
| condition | Évalue l'expression booléenne et, si elle est vraie, renvoie la valeur vraie de l'expression, si elle est fausse, renvoie la valeur fausse de l'expression . L'expression conditionnelle doit être citée. Les arguments vrai-expr et fausse-expr doivent suivre les règles de toute expression d'indicateur de programme (y compris les fonctions). | | |
| compter | Compte le nombre de valeurs de données qui ont été collectées pour l'étape du programme et l'élément de données donnés au cours de l'inscription. L'élément de données de l'argument est fourni avec la syntaxe #{programStage.dataElement}. | | |
| countIfCondition | Compte le nombre de valeurs de données qui correspondent aux critères de condition donnés pour l'étape du programme et l'élément de données indiqués au cours de l'inscription. L'élément de données de l'argument est fourni avec la syntaxe #{programStage.dataElement}. La condition est fournie sous la forme d'une expresssion entre guillemets | | |
| countIfValue | Compte le nombre de valeurs de données qui correspondent à la valeur littérale donnée pour l'étape du programme et l'élément de données indiqués au cours de l'inscription. L'élément de données de l'argument est fourni avec la syntaxe #{programStage.dataElement}. La valeur peut être un texte ou un nombre codé en dur. | | |
| countIfZeroPos | Compte le nombre de valeurs nulles ou positives saisies pour le champ source dans l'argument. | | |
| daysBetween | Produit le nombre de jours entre deux éléments de données/attributs sur le modèle de la date. | | |
| floor | Arrondit l'argument d'entrée au niveau inférieur du nombre entier le plus proche. | | |
| hasUserRole | Renvoie vrai si l'utilisateur actuel joue ce rôle, sinon faux. | | |
| hasValue | Renvoie vrai si l'élément/attribut de données a une valeur. | | |
| inOrgUnitGroup | Détermine si l'unité d'organisation actuelle fait partie du groupe d'arguments. L'argument peut être défini avec l'ID ou le code du groupe d'unités d'organisation. | | |
| gauche | Évalue la partie gauche d'un texte, en nombre de caractères à partir du premier caractère. | | |
| longueur | Trouver la longueur d'une chaîne. | | |
| minutesBetween | Produit le nombre de minutes entre deux éléments de données/attributs de type "date et heure". | | |
| modulus | Produit le module en divisant le premier argument par le second. | | |
| monthsBetween | Produit le nombre de mois entiers entre le premier et le deuxième argument. | | |
| oizp | Renvoie un si l'expression est nulle ou positive, sinon renvoie zéro. | | |
| relationshipCount | Produit le nombre de relations du même type qui sont liées à l'affiliation ou à l'événement. Si aucun type n'est indiqué, tous les types sont comptés. | | |
| droite | Évalue la partie droite d'un texte, en nombre de caractères à partir du dernier caractère. | | |
| Arrondir | Arrondit l'argument d'entrée au nombre entier le plus proche. | | |
| Diviser | RRépartie le texte en fonction du délimiteur et conserve le nième élément (0 est le premier). | | |
| substring | Évalue la partie d'une chaîne de caractères spécifiée par les numéros des caractères de début et de fin. | | |
| validatePatten | Prend la valeur " vrai " si le texte saisi correspond exactement au motif de l'expression régulière fournie. | | |
| weeksBetween | Produit le nombre de semaines complètes entre deux éléments de données/attributs de type date. | | |
| yearsBetween | Produit le nombre d'années entre le premier et le deuxième argument. | | |
| zing | Retourne à zéro si l'expression est négative, sinon retourne à la valeur de l'expression. | | |
| zpvc | Détermine le nombre de valeurs numériques nulles et positives parmi les arguments de l'objet donné. | |
Variables à utiliser dans une expression ou un filtre d'indicateur de programme¶
| Type de variable | Description du type de variable | Statut | Notes relatives à la mise en œuvre |
|---|---|---|---|
| Date de l'évenement évenement_date | La date à laquelle l'événement a eu lieu. | | |
| Creation Date* creation_date | La date de création d'un événement ou d'une affiliation dans le système. | | |
| Date limite date_limite | La date à laquelle un événement est prévu. | | |
| Date de synchronisaton* syncronisation_date | Date de la dernière synchronisation de l'événement ou de l'inscription avec l'application Android. | | |
| Date de l'incident incident_date | la date de l'incidence de l'événement. | | |
| Date d'inscription (non visible sur UI) enrollment_date | La date à laquelle l'instance de l'entité suivie a été inscrite au programme. | | |
| Statut de l'inscription enrollment_status | Peut être utilisé pour inclure ou exclure des affiliations dans certains statuts. | | |
| Date du jour current_date | La date du jour. | | |
| Date de fin | La date à laquelle l'événement est terminé. | | |
| Nombre de valeurs value_count | Le nombre de valeurs non nulles dans la partie expression de l'événement. | | |
| Nombre de valeurs nulles ou positives zero_pos_value_count | Le nombre de valeurs numériques positives dans la partie expression de l'événement. | | |
| Nombre d'événements event_count | Le nombre d'événements (utile en combinaison avec les filtres). | | |
| Nombre d'inscription enrollment_count | Le nombre d'inscriptions (utile en combinaison avec les filtres). | | Les indicateurs de l'application Android sont calculés dans le domaine d'une inscription TEI. La valeur est toujours 1. |
| Nombre de TEI tei_count | Le nombre d'instances d'entités suivies (utile en combinaison avec les filtres). | | Les indicateurs de l'application Android sont calculés dans le domaine d'une inscription TEI. La valeur est toujours 1. |
| Nom de l'étape du programme program_stage_name | Peut être utilisé dans les filtres pour inclure uniquement certaines étapes du programme dans un filtre pour les programmes tracker. | | |
| ID de l'étape du programme program_stage_id | Peut être utilisé dans les filtres pour inclure uniquement certaines étapes du programme dans un filtre pour les programmes tracker. | | |
| Début de la période de déclaration reporting_period_start | Peut être utilisé dans des filtres ou des expressions pour comparer une date quelconque à la première date de chaque période de déclaration. | | Les indicateurs de l'application Android sont calculés dans le domaine d'une inscription au TEI. |
| Fin de la période de déclaration reporting_period_end | Peut être utilisé dans des filtres ou des expressions pour comparer une date quelconque à la dernière date incluse dans chaque période de déclaration. | | Les indicateurs de l'application Android sont calculés dans le domaine d'une inscription au TEI. |
| Nombre d'unités d'organisation organisationunit_count | . | |