Configurer les programmes dans l'application Maintenance¶

À propos des programmes¶

Traditionally, public health information systems have been reporting aggregated data of service provision across their health programs. This does not allow you to trace the people provided with these services. In DHIS2, you can define your own programs with stages. These programs are an essential part of the "tracker" functionality which lets you track individual records. You can also track other ‘entities’ such as wells or insurances. You can create two types of programs:

Tableau : Types de programmes

Pour créer un programme, vous devez d'abord configurer plusieurs types d'objets de métadonnées. Vous pouvez créer ces objets de métadonnées dans l'application Maintenance.

Tableau : Objets de métadonnées du programme dans l'application Maintenance

Configurer les programmes d'événements dans l'application Maintenance¶

À propos des programmes d'événements¶

Les événements uniques sans programmes d'inscription sont appelés programmes d'événements. Vous pouvez les configurer dans l'application Maintenance. Les programmes d'événements peuvent avoir trois types de formulaires de saisie de données :

Tableau : Types de formulaires de saisie de données pour les programmes d'événements

Note

• Custom forms take precedence over section forms if both are present.

• If no custom or section form is defined, the basic form will be used.

• The Android apps only support section forms.

Vous pouvez créer des notifications de programme pour les programmes d'événements. Les notifications sont envoyées soit par le système de messagerie interne de DHIS2, soit par e-mail, soit par message texte (SMS). Vous pouvez utiliser les notifications de programme pour, par exemple, envoyer un rappel automatique à une entité suivie 10 jours avant un rendez-vous prévu. Vous utilisez les attributs de l'entité suivie du programme (par exemple le prénom) et les paramètres du programme (par exemple la date d'inscription) pour créer un modèle de notification. Dans le champ Paramètres, vous trouverez une liste des attributs de l'entité suivie et des paramètres du programme disponibles.

Flux de production : Créer un programme d'événement¶

1. Entrez les détails du programme de l'événement.

2. Attribuer des éléments de données.

3. Créer un ou plusieurs formulaires de saisie de données : Base, Section ou Personnalisé.

4. Affectez le programme à une ou plusieurs unités d'organisation.

5. Créer une ou des notifications de programme.

Créer ou modifier un programme d'événement¶

Entrez les détails du programme de l'événement.¶

1. Ouvrez l'application Maintenance et cliquez sur Programme > Programme.

2. Cliquez sur le bouton d'ajout et sélectionnez Programme de l'événement dans le menu popup.

3. Entrez les détails du programme, puis cliquez sur suivant.

   Field	Description
   Name	The name of the program.
   Color	Color used for this program in the data capture apps.
   Icon	Icon used for this program in the data capture apps.
   Short name	A short name of the program. The short name is used as the default chart or table title in the analytics apps.
   Description	A detailed description of the program.
   Version	The version of the program. This is used for example when people collect data offline in an Android implementation. When they go online and synchronize their metadata, they should get the latest version of the program.
   Category combination	The category combination you want to use. The default setting is None.
   Open days after category option end date	If you selected a category combination other than None, you may enter zero or a positive number. This lets you enter data for this program for a category option up to the specified number of days after that category option's end date.
   Completed events expiry date	Defines the number of days for which you can edit a completed event. This means that when an event is completed and the specified number of expiry days has passed, the event is locked. If you set "Completed events expiry days" to 10", an event is locked ten days after the completion date. After this date you can no longer edit the event.
   Expiry period type Expiry days	The expiry days defines for how many days after the end of the previous period, an event can be edited. The period type is defined by the expiry period type. This means that when the specified number of expiry days has passed since the end date of the previous period, the events from that period are locked. If you set the expiry type to "Monthly" and the expiry days to "10" and the month is October, then you can't add or edit an event to October after the 10th of November.
   User assignment of events	Select check box to enable user assignment of the event This means that in the form there will be a list of users to which the event can be assigned.
   Block entry form after completed	Select checkbox to block the entry form after completion of the event of this program. This means that the data in the entry form can't be changed until you reset the status to incomplete.
   Feature type	Sets whether the program is going to capture a geographical feature type or not. - None Nothing is captured. - Polygon An area is captured. For single event programs the area will be the area representing the event being captured. For tracker programs, the area will represent the area of the enrollment. - Point A point/coordinate is captured. For single event programs the point will be representing the event being captured. For tracker programs, the point will represent the enrollment.
   Validation strategy	Sets the server and client side validation requirement. Data type validation is always performed regardless of the validation strategy. An integer field is never stored containing text, for example. - On complete This option will enforce required field and error messages to be fixed when completing the event, but the event can be saved to the server without passing these validation requirements. For legacy reasons, this is always the validation strategy for tracker programs, where each data value in the event is stored to the server while entering data. - On update and insert This option will enforce required field validation when saving the event to the server regardless of the completion status. When using this option no events can be stored without passing validations.
   Pre-generate event UID	Select checkbox to pre-generate unique event id numbers.
   Custom label for report date	Type a description of the report date. This description is displayed in the case entry form.

4. Cliquez sur suivant.

Attribuer des éléments de données¶

1. Cliquez sur Attribuer des éléments de données.

2. Dans la liste des éléments disponibles, double-cliquez sur les éléments de données que vous souhaitez attribuer au programme de l'événement.

3. (Facultatif) Pour chaque élément de données, ajoutez des paramètres supplémentaires :

   Paramètres	Description
   Obligatoire	La valeur de cet élément de données doit être renseignée dans le formulaire de saisie pour que vous puissiez terminer l'événement.
   Autorisation obtenue ailleurs	Spécifiez si la valeur de cet élément de données provient d'un autre établissement, et non de l'établissement dans lequel cette donnée est saisie.
   Affichage dans les rapports	Affiche la valeur de cet élément de données dans l'événement unique sans fonction de saisie des données d'enregistrement.
   Date future	Permet à l'utilisateur de sélectionner une date future pour les éléments de données relatifs à la date.
   Type de rendu mobile	Peut être utilisé pour sélectionner différents types de rendu pour les appareils mobiles. Les options disponibles varient en fonction du type de valeur de l'élément de données. Par exemple, pour une valeur numérique, vous pouvez sélectionner "Défaut", "Valeur", "Curseur", "Échelle linéaire" et "Spinner".
   Type de rendu pour les ordinateurs de bureau	AVERTISSEMENT : PAS ENCORE IMPLÉMENTÉ. Peut être utilisé pour sélectionner différents types de rendu pour les ordinateurs de bureau (c'est-à-dire l'interface web). Les options disponibles varient en fonction du type de valeur de l'élément de données. Par exemple, pour une valeur numérique, vous pouvez sélectionner "Défaut", "Valeur", "Curseur", "Échelle linéaire" et "Spinner".

4. Cliquez sur suivant.

Créer des formulaires de saisie de données¶

Les formulaires de saisie définissent comment les éléments de données s'afficheront à l'utilisateur dans l'application Saisie d'événements.

1. Cliquez sur Créer un formulaire de saisie de données.

2. Cliquez sur Base, Section ou Personnalisé.

3. Pour créer un formulaire de saisie de base : Glissez et déposez les éléments de données dans l'ordre que vous souhaitez.

4. Pour créer un formulaire ** À section** :

   1. Cliquez sur le bouton "Ajouter" et entrez le nom, la description et le type de rendu d'une section pour PC et mobile.

   2. Cliquez sur la section pour qu'elle soit surlignée par une ligne noire.

   3. Ajoutez des éléments de données en cliquant sur le signe "+" à côté du nom des éléments de données.

   4. Repeat the above steps until you have all the sections you need.

   5. Modifiez l'ordre des sections : cliquez sur le menu des options, puis faites glisser la section à l'endroit souhaité.

5. To create a Custom data entry form: Use the WYSIWYG editor to créer un formulaire entièrement personnalisé. Si vous sélectionnez Source, vous pouvez coller un code HTML directement dans la zone d'édition. Vous pouvez également insérer des images, par exemple des drapeaux ou des logos.

6. Cliquez sur suivant.

Accès¶

Les options d'accès déterminent qui peut saisir les données pour le programme ou visualiser/modifier les métadonnées du programme. Un programme peut être partagé avec des unités d'organisation, et en outre, les options d'accès au programme principal et à toutes les étapes du programme peuvent être configurées par le biais de la boîte de dialogue Partage. Les options d'accès sont disponibles dans l'onglet Accès.

Attribuer des unités d'organisation :

1. Dans l'arbre d'organisation, double-cliquez sur les unités d'organisation que vous want to add to the program.

   Vous pouvez localiser une unité d'organisation dans une arborescence en développant les branches (cliquez sur le symbole en forme de flèche) ou en la recherchant par son son nom. Les unités d'organisation sélectionnées s'affichent en orange.

Changer les rôles et l'accès :

1. Faites défiler vers le bas jusqu'à la section Rôles et accès.

   La première ligne présente les options d'accès au programme principal, et chaque ligne suivante présente les options d'une étape du programme. Les étapes du programme accompagnées d'une icône d'avertissement (point d'exclamation) contiennent des options d'accès différentes de celles du programme principal, ce qui signifie qu'elles sont accessibles à une combinaison d'utilisateurs différente.

2. Cliquez sur l'une des lignes et la boîte de dialogue Partage s'affichera.

3. Modifiez les options d'accès en conséquence. Voir la documentation sur le dialogue de partage pour plus de détails.

4. Cliquez sur le bouton Appliquer.

5. Répétez le processus pour chaque programme/étape du programme. Vous pouvez également copier toutes les options d'accès du programme principal dans vos programmes subordonnés:

   1. Sélectionnez les étapes du programme pour lesquelles vous souhaitez disposer d'options d'accès similaires à celles du programme principal en cochant les cases situées à droite des étapes du programme. Vous pouvez également choisir de Sélectionner toutes les étapes du programme, Désélectionner toutes les étapes du programme ou Sélectionner des étapes similaires, en termes d'options d'accès, à celles du programme principal. Les étapes similaires sont cochées par défaut.

   2. Cliquez sur Appliquer aux étapes sélectionnées.

Créer des notifications de programme¶

1. Créez le message que vous voulez envoyer :

   1. Cliquez sur Quoi envoyer?.

   2. Entrez un Nom.

   3. Créez le Modèle d'objet : Double-cliquez sur les paramètres dans le champ Modèle de variables pour les ajouter à votre objet.

      Note

      The subject is not included in text messages.

   4. Créez le Modèle de message : Double-cliquez sur les noms des paramètres dans la liste Modèle de variables pour les ajouter à votre message.

      Cher A{w75KJ2mc4zz}, Vous êtes maintenant inscrit au V{programme_nom}.

2. Définissez quand vous voulez envoyer le message :

   1. Cliquez sur Quand l'envoyer?.

   2. Sélectionnez un Déclencheur de notification.

      Déclencher une notification	Description
      Fin de l'étape d'un programme	La notification de l'étape d'un programme est envoyée lorsque l'étape d'un programme est terminée.
      Jours prévus (date d'échéance)	La notification de l'étape de programme est envoyée XX jours avant ou après la date d'échéance Vous devez préciser le nombre de jours avant ou après la date prévue pour l'envoi de la notification.

3. Définissez à qui vous voulez envoyer le message :

   1. Cliquez sur L'envoyer à ?.

   2. Sélectionnez un Destinataire de la notification.

      Notification recipient	Description
      Tracked entity instance	Receives program notifications via e-mail or text message. To receive a program notification, the recipient must have an e-mail address or a phone number attribute.
      Organisation unit contact	Receives program notifications via e-mail or text message. To receive a program notification, the receiving organisation unit must have a registered contact person with e-mail address and phone number.
      Users at organisation unit	All users registered to the selected organisation unit receive program notifications via the internal DHIS2 messaging system.
      User group	All members of the selected user group receive the program notifications via the internal DHIS2 messaging system
      Program attribute	Receives program notifications via e-mail or text message. To receive a program notification, the recipient must have an e-mail address or a phone number attribute.
      Data element	Receives program notifications via e-mail or text message. To receive a program notification, the recipient must have an e-mail address or a phone number data element.
      Web hook	TBA

   3. Click Save.

4. Répétez les étapes ci-dessus pour créer toutes les notifications de programme dont vous avez besoin.

5. Cliquez sur Sauvegarder.

Note

You configure when the program notifications are sent in the Data Administration app > Scheduling > Program notifications scheduler.

• Click Run now to send the program notifications immediately.

• Select a time and click Start to schedule the program notifications to be sent at a specific time.

Informations de référence : Paramètres de notification du programme¶

Tableau : Paramètres de notification de programme à utiliser dans les notifications de programme

Configurer les programmes Tracker dans l'application Maintenance¶

À propos des programmes Tracker¶

Les programmes à événement unique ou multiple avec inscription sont appelés des programmes Tracker. Un programme doit être spécifié avec une seule entité suivie. Seules les entités suivies identiques à l'entité suivie du programme peuvent s'inscrire à ce programme. Un programme a besoin de plusieurs types de métadonnées que vous pouvez créer dans les applications Maintenance.

Flux de production : Créer un programme tracker¶

1. Entrez les détails du programme Tracker.

2. Entrer les détails de l'inscription.

3. Assigner des attributs et créer un formulaire d'inscription à section ou personnalisé.

4. Créer des étapes de programme.

5. Configurer l'accès et l'attribuer aux unités d'organisation.

6. Créer une ou plusieurs notifications de programme et d'étape de programme.

Créer ou modifier un programme Tracker¶

1. Ouvrez l'application Maintenance et cliquez sur Programme > Programme.

2. Cliquez sur le bouton Ajouter et sélectionnez Programme Tracker dans le menu popup.

Entrer les détails de programme¶

Saisir les détails de l'inscription¶

Affecter les attributs de l'entité suivie.¶

1. Dans la liste des Attributs d'entités suivies de programme disponibles, double-cliquez sur les attributs que vous souhaitez attribuer au programme.

2. (Optional) For each assigned attribute, add additional settings:

1. Créer un formulaire d'inscription

Le formulaire d'inscription définit la manière dont les attributs seront affichés à l'utilisateur dans les applications consommatrices, telles qu'Android et Saisie Tracker.

1. Cliquez sur **Créer un formulaire d'inscription**.

2. Cliquez sur **À section** ou **Personnalisé**.

3. Pour créer un formulaire ** À section** :

    1. Cliquez sur le bouton "Ajouter" et entrez le nom, la description et le type de rendu d'une section pour PC et mobile.
    2. Cliquez sur la section pour qu'elle surlignée par une bordure noire.
    3. Ajoutez des éléments de données en cliquant sur le signe "+" à côté du nom des éléments de données que vous souhaitez ajouter.
    4. Répétez les étapes ci-dessus jusqu'à ce que vous ayez toutes les sections dont vous avez besoin.
        Pour modifier l'ordre des sections : cliquez sur le menu des options, puis faites glisser la section à l'endroit souhaité.

4. Pour créer un formulaire d'enregistrement **Personnalisé** : Utilisez l'éditeur WYSIWYG pour créer un formulaire entièrement personnalisé. Si vous sélectionnez Source, vous pouvez alors coller le code HTML directement dans la zone d'édition. Vous pouvez également insérer des images, par exemple des drapeaux ou des logos.

5. Cliquez sur ajouter une étape.

Créer des étapes de programme¶

A program consists of program stages. A program stage defines which actions should be taken at each stage.

Note

Changes to a program stage are not saved until you save the program.

1. Cliquez sur le signe "+" pour créer une étape du programme.
2. Entrer les détails de l'étape du programme
   1. Entrez un Nom.
   2. (Facultatif) sélectionnez une Couleur et une Icône qui seront utilisées par les applications de saisie de données pour identifier cette étape du programme
   3. Tapez une Description.
   4. Enter the required number of days into the Scheduled days from start field: The first event in this program stage will be scheduled this many days after the enrollment or the incident date, depending on the configuration. If Show incident date in Enrollment details is configured, the system will use incident date as start. If Generate events based on enrollment date in Program stage details is configured the system will use enrollment date as start.
3. Entrez les détails reproduisibles des étapes du programme.
   1. Précisez si l'étape du programme est Reproduisible ou non.
   2. Sélectionnez un Type de période.
   3. Décochez Afficher la boîte de génération d'événement après avoir terminé si vous ne voulez pas afficher Créer une nouvelle boîte d'événement pour créer un nouvel événement pour une étape répétable après avoir cliqué sur Terminé pour un événement de l'étape dans le formulaire de saisie de données. Ce champ est sélectionné par défaut.
   4. Saisissez Jours d'intervalle standard. Cette valeur correspond à l'intervalle suggéré entre le dernier événement d'une étape répétitive et la date prévue pour l'événement suivant.
   5. (Facultatif) Sélectionnez une Date prochaine prévue par défaut. Une liste des éléments de données attribués de type date apparaîtra. Si un élément est sélectionné, le client Tracker utilisera cette date comme date de début par défaut. L'élément de données peut être utilisé par les règles du programme pour programmer de façon dynamique des intervalles entre les événements.
4. Entrez les détails du formulaire

1. Attribuer des éléments de données à une étape du programme :

   1. Dans la liste des Éléments de données disponibles, double-cliquez sur les éléments de données que vous souhaitez affecter à l'étape du programme.

   2. Pour chaque élément de données attribué, examinez les propriétés. Vous pouvez sélectionner :

1. Créer des formulaires de saisie de données pour une étape du programme

   Les formulaires de saisie définissent comment les éléments de données seront affichés à l'utilisateur dans l'application Saisie Tracker.

2. Cliquez sur Créer un formulaire de saisie de données.

3. Cliquez sur Base, Section ou Personnalisé.

4. Pour créer un formulaire de saisie de base : Glissez et déposez les éléments de données dans l'ordre que vous souhaitez.

5. Pour créer un formulaire ** À section** :

   1. Cliquez sur le bouton "Ajouter" et entrez le nom, la description et le type de rendu d'une section pour PC et mobile.

   2. Cliquez sur la section pour qu'elle soit mise en évidence par une bordure noire.

   3. Ajoutez des éléments de données en cliquant sur le signe "+" à côté du nom des éléments de données.

   4. Repeat the above steps until you have all the sections you need.

   5. Modifiez l'ordre des sections : cliquez sur le menu des options, puis faites glisser la section à l'endroit souhaité.

6. To create a Custom data entry form: Use the WYSIWYG editor to créer un formulaire entièrement personnalisé. Si vous sélectionnez Source, vous pouvez alors coller le code HTML directement dans la zone d'édition. Vous pouvez également insérer des images, par exemple des drapeaux ou des logos.

7. Cliquez sur ajouter une étape.

Accès¶

Les options d'accès déterminent qui peut saisir les données pour le programme ou visualiser/modifier les métadonnées du programme. Un programme peut être partagé avec des unités d'organisation, et en outre, les options d'accès au programme principal et à toutes les étapes du programme peuvent être configurées par le biais de la boîte de dialogue Partage. Les options d'accès sont disponibles dans l'onglet Accès.

Attribuer des unités d'organisation :

1. Dans l'arbre d'organisation, double-cliquez sur les unités d'organisation que vous want to add to the program.

   Vous pouvez localiser une unité d'organisation dans une arborescence en développant les branches (cliquez sur le symbole en forme de flèche) ou en la recherchant par son son nom. Les unités d'organisation sélectionnées s'affichent en orange.

Changer les rôles et l'accès :

1. Faites défiler vers le bas jusqu'à la section Rôles et accès.

   La première ligne présente les options d'accès au programme principal, et chaque ligne suivante présente les options d'une étape du programme. Les étapes du programme accompagnées d'une icône d'avertissement (point d'exclamation) contiennent des options d'accès différentes de celles du programme principal, ce qui signifie qu'elles sont accessibles à une combinaison d'utilisateurs différente.

2. Cliquez sur l'une des lignes et la boîte de dialogue Partage s'affichera.

3. Modifiez les options d'accès en conséquence. Voir la documentation sur le dialogue de partage pour plus de détails.

4. Cliquez sur le bouton Appliquer.

5. Répétez le processus pour chaque programme/étape du programme. Vous pouvez également copier toutes les options d'accès du programme principal dans vos programmes subordonnés:

   1. Sélectionnez les étapes du programme pour lesquelles vous souhaitez disposer d'options d'accès similaires à celles du programme principal en cochant les cases situées à droite des étapes du programme. Vous pouvez également choisir de Sélectionner toutes les étapes du programme, Désélectionner toutes les étapes du programme ou Sélectionner des étapes similaires, en termes d'options d'accès, à celles du programme principal. Les étapes similaires sont cochées par défaut.

   2. Cliquez sur Appliquer aux étapes sélectionnées.

Créer des notifications de programme¶

Vous pouvez créer des notifications de programme pour les programmes avec enregistrement et leurs étapes. Les notifications sont envoyées soit par le système de messagerie interne DHIS2, soit par e-mail, soit par (SMS). Vous pouvez utiliser les notifications de programme pour, par exemple, envoyer un rappel automatique à une entité suivie 10 jours avant un rendez-vous prévu. Vous utilisez les attributs de l'entité suivie du programme (par exemple le prénom) et les paramètres du programme (par exemple la date d'inscription) pour créer un modèle de notification.

1. Ouvrez l'application Maintenance et cliquez sur Programme puis notifications.

   Une liste des notifications de programme existantes pour le programme sélectionné s'ouvre. Si le programme n'a pas de notifications de programme, la liste est vide.

2. Cliquez sur le bouton ajouter et sélectionnez Notification du programme.

   

3. Entrez un Nom.

4. Créer le Modèle d'objet.

   Double-cliquez sur les paramètres dans le champ Paramètres pour les ajouter à votre objet.

   Note

   The subject is not included in text messages.

5. Créer le Modèle de message.

   Double-cliquez sur les noms des paramètres dans le champ Modèle de variables pour les ajouter à votre message.

   Cher A{w75KJ2mc4zz}, Vous êtes maintenant inscrit au V{programme_nom}.

6. Dans le champ Quand l'envoyer, sélectionnez ce qui doit déclencher la notification.

   Trigger	Description	Note
   Program enrollment	The program notification is sent when the TEI enrols in the program.	-
   Program completion	The program notification is sent when the program of TEI is completed	-
   Days scheduled (incident date)	The program notification is sent XX number of days before or after the incident date	You need to enter the number of days before or after the scheduled date that the notification will be sent.
   Days scheduled (enrollment date)	The program notification is sent XX number of days before or after the enrollment date	You need to enter the number of days before or after the scheduled date that the notification will be sent.
   Program Rule	Notification will be triggered as a result of program rule execution.	Program rule with ProgramRuleActionType.SENDMESSAGE need to be in place to make this trigger successful.

7. Dans le champ À qui l'envoyer, sélectionnez la personne qui doit recevoir la notification du programme.

   Type de destinataire	Description	Remarque
   Instance d'entité suivie	Reçoit des notifications de programme par courrier électronique ou par message texte.	Pour recevoir une notification de programme, le destinataire doit disposer d'une adresse e-mail ou d'un attribut de numéro de téléphone.
   Contact de l'unité d'organisation	Reçoit les notifications du programme par courrier électronique ou par message texte.	Pour recevoir une notification de programme, l'unité d'organisation destinataire doit avoir une personne de contact enregistrée avec une adresse électronique et un numéro de téléphone.
   Utilisateurs au sein de l'unité d'organisation :	Tous les utilisateurs enregistrés dans l'unité d'organisation sélectionnée reçoivent les notifications du programme via le système de messagerie interne DHIS2.	-
   Groupe d'utilisateurs	Tous les membres du groupe d'utilisateurs sélectionné reçoivent les notifications du programme via le système de messagerie interne DHIS2	-
   Limiter à la Hiérarchie	Envoyer la notification uniquement aux utilisateurs qui appartiennent à l'une des unités d'organisation de la hiérarchie.	Cette option n'est disponible que lorsque le Groupe Utilisateur est sélectionné comme destinataire.
   Unité d'organisation mère uniquement	Envoyer la notification uniquement aux utilisateurs qui appartiennent à l'unité d'organisation mère.	Cette option n'est disponible que lorsque le Groupe Utilisateur est sélectionné comme destinataire.
   Attribut du programme	TrackedEntityAttribute peut également être sélectionné comme destinataire.	Ce paramètre ne sera effectif que si le type de valeur de TrackedEntityAttribute est NUMERO DE_TÉLÉPHONE / ADDRESSE ÉLECTRONIQUE.

8. Cliquez sur Sauvegarder.

Créer une notification d'étape de programme¶

1. Ouvrez l'application Maintenance et cliquez sur Programme puis notifications.

   Une liste des notifications d'étapes de programme existantes pour l'étape de programme sélectionnée s'ouvre. Si l'étape de programme n'a pas de notifications d'étape de programme, la liste est vide.

2. Cliquez sur le bouton d'ajout et sélectionnez**Notification de l'étape du programme**.

3. Cliquez sur AJOUTER.

4. Entrez un Nom.

5. Créer le Modèle d'objet.

   Double-cliquez sur les noms des paramètres dans le champ Modèle de variables pour les ajouter à votre objet.

   Note

   The subject is not included in text messages.

6. Créer le Modèle de message.

   Double-cliquez sur les noms des paramètres dans le champ Modèle de variables pour les ajouter à votre message.

   Cher A{w75KJ2mc4zz}, veuillez vous présenter au rendez-vous le V{due_date}.

7. Dans le champ Quand l'envoyer, sélectionnez ce qui doit déclencher la notification.

   Trigger	Description	Note
   Program stage completion	The program stage notification is sent when the program stage is completed	-
   Days scheduled (due date)	The program stage notification is sent XX number of days before or after the due date	You need to enter the number of days before or after the scheduled date that the notification will be sent.
   Program Rule	Notification will be triggered as a result of program rule execution.	Program rule with ProgramRuleActionType.SENDMESSAGE need to be in place to make this trigger successful.

   1. Allow notification to be sent multiple times

      This flag can be used if notification is required to be sent multiple times. For example in case of repeatable program stage, same notification will be sent as many times as the stage is repeated.

8. Dans le champ Destinataires, sélectionnez qui doit recevoir la notification de l'étape du programme. Vous pouvez sélectionner :

   Recipient type	Description	Note
   Tracked entity instance	Receives program notifications via e-mail or text message.	To receive a program stage notification, the recipient must have an e-mail address or a phone number attribute.
   Organisation unit contact	Receives program notifications via e-mail or text message.	To receive a program stage notification, the receiving organisation unit must have a registered contact person with e-mail address and phone number. The system selects the same organisation unit as where the event took place.
   Users at organisation unit:	All users registered to the selected organisation unit receive program notifications via the internal DHIS2 messaging system.	-
   User group	All members of the selected user group receive the program notifications via the internal DHIS2 messaging system	-
   Limit To Hierarchy	Send notification only to those users who belong to any of the organisation unit in the hierarchy.	-
   Parent OrgUnit Only	Send notification only to those users who belong to parent organisation unit.	-
   Data Element	Data Element associated with ProgramStage can be selected as recipient.	Data Element will only be effective if DataElement has value type PHONE_NUMBER/EMAIL.
   Tracked Entity Attribute	Tracked Entity Attribute associated with ProgramInstance/Enrollment can be selected as recipient.	Attribute will only be effective if it has value type PHONE_NUMBER/EMAIL.
   Web Hook	Web hooks are automated HTTP messages sent to an external URL configured in web hook URL field. Notification template variables will be sent as key-value pairs in the HTTP request.	-

9. Cliquez sur Sauvegarder.

Informations de référence : Paramètres de notification du programme¶

Tableau : Paramètres de notification de programme à utiliser dans les notifications de programme

Configurer les indicateurs du programme¶

À propos des indicateurs du programme¶

Les indicateurs de programme sont des expressions basées sur les éléments de données et les attributs des entités suivies qui peuvent être utilisées pour calculer des valeurs à partir d'une formule. Les indicateurs de programme se composent d'un type d'agrégation, d'un type d'analyse, d'une expression et d'un filtre.

Les indicateurs de programme sont évalués sur la base du type d'agrégation, de l'expression et du filtre attribués. L'ordre d'évaluation est le suivant :

1. Le filtre filtrera les événements qui font partie de la routine d'évaluation/agrégation.

2. La expression sera évaluée par événement.

3. Toutes les valeurs d'expression évaluées seront agrégées selon le type d'agrégation de l'indicateur de programme.

Tableau : Composantes des indicateurs du programme

Dans l'application Maintenance, vous pouvez gérer les objets d'indicateurs de programme suivants :

Créer ou modifier un indicateur de programme¶

N.B.

Un indicateur de programme appartient à un seul programme.

1. Ouvrez l'application Maintenance et cliquez sur Indicateur > Indicateur de programme.

2. Cliquez sur le bouton Ajouter.

3. Sélectionnez un Programme et entrez :

   • Nom.

   • le nom court

   • Code

   • Couleur

   • Icône

   • Description

   • Sélectionnez le nombre de Décimales dans la production de données.

4. Sélectionnez un Type d'agrégation.

5. Select if you want to Display in form.

6. Attribuez une ou plusieurs Légende.

7. (Facultatif) Entrez une Combinaison d'options de catégorie pour l'exportation de données agrégées.

8. (Facultatif) Entrez une Combinaison d'options d'attributs pour l'exportation de données agrégées.

9. Créer l'expression.

   1. Cliquez sur Modifier l'expression.

   2. Créez l'expression à partir des opérateurs mathématiques et des attributs, variables et constantes énumérés à droite.

10. Créer le filtre.

    1. Cliquez sur Modifier le filtre.

    2. Créez l'expression à partir des opérateurs mathématiques et des attributs, variables et constantes énumérés à droite.

11. Cliquez sur Sauvegarder.

Créer ou modifier un groupe d'indicateurs de programme¶

1. Ouvrez l'application Maintenance et cliquez sur Indicateur > Indicateur Groupe d’indicateurs.

2. Cliquez sur le bouton Ajouter.

3. Entrez Nom et Code.

4. Dans la liste des indicateurs de programme disponibles, double-cliquez sur les indicateurs de programme que vous souhaitez affecter à votre groupe.

5. Cliquez sur Sauvegarder.

Informations de référence : Exemples d'expressions et de filtres par type de valeur¶

Le tableau ci-dessous présente des exemples de comment d'écrire des expressions et des filtres pour différents types d'éléments de données et de valeurs d'attribut :

Tableau: Exemples d'expressions et de filtres par type de valeur

Informations de référence : Fonctions, variables et opérateurs à utiliser dans les expressions d'indicateurs de programmes et les filtres¶

Une expression qui comprend à la fois des attributs, des éléments de données et des constantes ressemble à ceci :

(A{GPkGfbmArby} + #{mCXR7u4kNBW.NFkjsNiQ9PH}) * C{bCqvfPR02Im}

Une expression qui utilise le type d'agrégation personnalisé et peut donc utiliser les types d'agrégation en ligne ressemble à ceci :

(sum(#{mCXR7u4kNBW.K0A4BauXJDl} * #{mCXR7u4kNBW.NFkjsNiQ9PH}) / sum(#{mCXR7u4kNBW.NFkjsNiQ9PH})) * 100

Prêtez attention à la façon dont l'opérateur d'agrégation "somme" est utilisé à l'intérieur de l'expression elle-même.

Ajouter des commentaires dans l'expression de l'indicateur de programme ou dans le filtre¶

La syntaxe uniforme est prise en charge pour les commentaires à une ligne et à plusieurs lignes.

d2:hasValue(#{mCXR7u4kNBW.NFkjsNiQ9PH}) /* this is comment */

d2:hasValue(#{mCXR7u4kNBW.NFkjsNiQ9PH}) && /* this is 
comment */
d2:daysBetween(V{enrollment_date},PS_EVENTDATE:mCXR7u4kNBW)

Fonctions à utiliser dans une expression ou un filtre d'indicateur de programme¶

L'expression des indicateurs de programme et le filtre prennent en charge une série de fonctions. Ces fonctions peuvent être appliquées à des éléments et des attributs de données :

Tableau: Fonctions à utiliser dans une expression ou un filtre d'indicateur de programme

Un filtre utilisant la fonction "hasValue" ressemble à ceci :

d2:hasValue(#{mCXR7u4kNBW.NFkjsNiQ9PH})

Un filtre utilisant la fonction "relationshipCount(relationshipTypeUid)" ressemble à ceci :

d2:relationshipCount('KLkjshoQ90U')

Un filtre utilisant la fonction "is( x in y, z )" ressemble à ceci :

est(#{oahc9ooVema} dans 'Nouveau', 'Rechute')

Une expression utilisant les fonctions "zing" et "oizp" ressemble à ceci :

d2:zing(A{GPkGfbmArby}) + d2:oizp(#{mCXR7u4kNBW.NFkjsNiQ9PH}))

Une expression utilisant la fonction "daysBetween" ressemble à ceci :

d2:daysBetween(#{mCXR7u4kNBW.k8ja2Aif1Ae},'2015-06-01')

Voici une expression qui utilise la fonction "yearBetween" pour comparer le dernier événement de la phase du programme "mCXR7u4kNBW" à la date d'inscription :

d2:daysBetween(V{enrollment_date},PS_EVENTDATE:mCXR7u4kNBW)

Une expression qui utilise la fonction "condition" ressemble à ceci :

d2:condition('#{mCXR7u4kNBW.NFkjsNiQ9PH} > 100',150,50)

Une expression qui utilise la fonction "countIfValue" pour ne compter que le nombre de fois où la valeur 10 a été recueillie ressemble à ceci :

d2:countIfValue(#{mCXR7u4kNBW.NFkjsNiQ9PH}),10)

Une expression utilisant la fonction "zpvc" ressemble à ceci :

d2:zpvc(A{GPkGfbmArby}),#{mCXR7u4kNBW.NFkjsNiQ9PH}),4,-1)

Une expression utilisant les fonctions "if" et "isull" ressemble à ceci :

if(isNull(A{GPkGfbmArby}),10,20)

Une expression utilisant la fonction "firstNonNull" ressemble à ceci :

firstNonNull(A{GPkGfbmArby}),#{mCXR7u4kNBW.NFkjsNiQ9PH},44)

V{program_stage_name} == 'ANC first visit'

V{program_stage_id} == 'YPSSfbmAtt1'

d2:daysBetween(#{WZbXY0S00lP.w4ky6EkVahL}, V{analytics_period_start})

greatest(#{mCXR7u4kNBW.k8ja2Aif1Ae},#{mCXR7u4kNBW.NFkjsNiQ9PH},1)

Variables à utiliser dans une expression ou un filtre d'indicateur de programme¶

L'expression et le filtre des indicateurs de programme prennent en charge toute une série de variables :

Tablleau: Variables à utiliser dans une expression ou un filtre d'indicateur de programme

Un filtre utilisant la variable "Fin de la période d'analyse" pour n'inclure que les femmes ayant une DM qui surviendrait au premier trimestre :

d2:daysBetween(#{WZbXY0S00lP.w4ky6EkVahL}, V{analytics_period_end}) <= 84

Une expression utilisant la variable "value count" ressemble à ceci :

(#{A03MvHHogjR.a3kGcGDCuk6} + #{A03MvHHogjR.wQLfBvPrXqq}) / V{value_count}

Une expression qui utilise les variables "date_événement" et "date_incident" ressemble à ceci :

d2:daysBetween(V{incident_date},V{event_date})

Opérateurs à utiliser dans un filtre d'indicateurs de programme¶

Tableau: Opérateurs à utiliser dans un filtre d'indicateurs de programme

Ces opérateurs peuvent être utilisés pour constituer des expressions logiques qui, en fin de compte, évaluent à vrai ou à faux. Vous pouvez par exemple affirmer que plusieurs éléments de données doivent avoir une valeur spécifique, ou que des attributs spécifiques doivent avoir des valeurs numériques inférieures ou supérieures à une constante.

Un filtre qui utilise à la fois des attributs et des éléments de données ressemble à ceci :

A{cejWyOfXge6} == 'Female' and #{A03MvHHogjR.a3kGcGDCuk6} <= 2

Astuce

DHIS2 utilise la bibliothèque JEXL pour l'évaluation des expressions utilisant une syntaxe supplémentaire hormis ce qui est proposé dans cette documentation. Voir la référence sur la [page d'accueil du projet] (http://commons.apache.org/proper/commons-jexl/reference/syntax.html) pour savoir comment créer des expressions plus sophistiquées

Setting up new Program disaggregation Mappings¶

DHIS2 v42 introduces the ability to assign Disaggregation Category Combinations to a Program Indicator and create a mapping between the program data and each category option contained in the combination. This creates a relationship between the tracker and aggregate data models which allows for analysing individual data in the same way and alongside aggregated data.

The Program Indicator Disaggregation mappings, defined at the Program level, provide a connection between the two data models within DHIS2. This ultimately allows a user to create disaggregated views of program data within the Data Visualizer using a single Program Indicator where previously one for each disaggregation was needed.

1. Install or update the new Maintenance app (Preview)

   If your instance does not already have the new version of the maintenance app installed go to the App Management App and search for Maintenance in the App Hub and install the app. If you already have it installed, then you should update the app to the latest version. Updates to this app are continuously released so it is good to make sure that you are using the most recent release.

   

2. Load the Program Disaggregation section of the Maintenance (Preview) App by selecting Program Disaggregations under the Other section or browsing to yourinstanceurl/apps/maintenance-preview#/programDisaggregations/

   

3. Select a Program from the drop down to enter the edit section and add Mappings to, for this example we will use the Inpatient morbidity and mortality program

4. This will load the Program Indicator Mapping and Categories definition screen

   

5. Select a Program Indicator from the drop down list, in this example we will use BMI

6. Under Disaggregation category combination Select Gender and U5y (you may need to create a new category combination containing the categories Gender and Under 5/5 and above of age if not present)

   

   Loading this category combination will display the Mapping selection drop down for each of the categories defined, as this is the first time these categories have been selected there are no mappings currently available.

7. Under the Disaggregation categories section you should see both of the categories from the combination added as suggestion. Click Add category for both Gender and U5y

   

Create the category mappings¶

1. In the text field under each Category enter an expression using the Program Data Elements and Attributes that defines the category. The expression uses the same syntax as the Filter section of the Program Indicator creation screen. It is recommended to open a Program Indicator within the Program you are mapping, use the Filter screen to construct the expression and then copy it into this field. This allows you to use the inbuilt expression validation of the Program Indicator filter builder. Program Indicator functions and Variale operators

   

   This example is linking the value selected in the Gender data element in the Program to the category option. Since the Option set in this case is a text field the expression is set to match the text ‘Female’. The next example for age shows a different way to define the relationship.

   

   To add the mapping for the Under 5 years and 5 years and above, since it is a numerical field you can use the operators > >= < <= == != to define the relationship

   

2. When mappings for all the category options are complete, click Save and exit

3. Open Data Visualizer, first let’s look at how these data were previously displayed. To do this create a visualisation to show the data of the 5 existing Program indicators with the built in disaggregations shown below.

   

   

4. Now remove the 4 Program Indicators with disaggregations specified and leave only the BMI Program Indicator.

   

5. You can now add Gender and Under 5/5 and above of age as disaggregation categories from the Your Dimensions column for the Program Indicator, click update and see the results.

   

   You can now compare the data from the two separate program indicators and the single program indicator that has been disaggregated.

Transferring Program Indicator data via the Aggregate data exchange app¶

In addition to viewing a disaggregated Program Indicator in the Data Visualiser you can now transfer the Program Data, via the Disaggregated Program indicator, into a Data Element that shares the same Category Combination.

By adding the ID of a Data Element in the Data element for aggregate data export field and then setting up the aggregate data exchange app* to transfer data you can save Program data in the aggregate data model

Configurer les règles du programme¶

À propos des règles du programme¶

Program rules allow you to create and control dynamic behaviour of the user interface in the Tracker Capture and Event Capture apps. During data entry, the program rules expressions are evaluated each time the user interface is displayed, and each time a data element is changed. Most types of actions will take effect immediately when the user enters values in the Tracker Capture and Event Capture apps.

Tableau: Composantes de la règle du programme

Dans l'application Maintenance, vous gérez les objets de règles de programme suivants :

Déroulement¶

1. Dans l'application Maintenance, créez la ou les variable(s) de règle du programme si nécessaire.

2. Dans l'application Maintenance, créez la règle du programme :

   1. Entrer les détails des règles de programme.

   2. Créez l'expression de la règle du programme.

   3. Définissez les actions de la règle du programme.

3. Dans les applications Saisie Tracker ou Saisie d'événement, vérifiez que la règle du programme fonctionne comme prévu.

Créer ou modifier une variable de règle de programme¶

1. Ouvrez l'application Maintenance et cliquez sur Programme > Variable de la règle du programme.

2. Cliquez sur le bouton Ajouter.

3. Sélectionnez un Programme et entrez un Nom.

   Please note that the name of the program may not contain any of the following excluded keywords: - and - or - not

4. Sélectionnez si vous voulez Utiliser le code pour l'ensemble des options.

   Cette option n'est effective que lorsque l'élément de données ou l'attribut de l'entité suivie est connecté à un ensemble d'options. Si vous ne sélectionnez pas cette option, la variable de la règle de programme sera remplie avec le nom de l'ensemble d'options. Si vous sélectionnez cette option, la variable de règle de programme sera remplie avec le code de l'ensemble d'options.

5. Sélectionnez un Type de source et saisissez les informations requises.

   Selon le type de source, vous aurez à sélectionner, par exemple, une étape du programme, un élément de données ou un attribut de l'entité suivie.

   Les types de source déterminent comment saisir une valeur dans la variable de règle de programme.

   Source type	Description
   Data element from the newest event for a program stage	This source type works the same way as Data element from the newest event in the current program, except that it only evaluates values from one program stage. This source type can be useful in program rules where the same data element is used in several program stages, and a rule needs to evaluate the newest data value from within one specific stage. In order to know what event is the newest, the report date (event date) is used. If you have many events with the same report date, the system choose the one with the latest createdAt property of the event.
   Data element from the newest event in the current program	This source type is used when a program rule variable needs to reflect the newest known value of a data element, regardless of what event the user currently has open. This source type is populated slightly differently in Tracker Capture and Event Capture apps: Tracker Capture: the program rule variable will be populated with the newest data value collected for the given data element within the enrollment. Event Capture: the program rule variable will be populated with the current events data. NB Future dates are "newer" than current or past dates. In order to know what event is the newest, the report date (event date) is used. If you have many events with the same report date, the system choose the one with the latest createdAt property of the event.
   Data element in current event	Program rule variables with this source type will contain the data value from the same event that the user currently has open. This is the most commonly used source type, especially for skip logic (hide actions) and warning/error rules.
   Data element from previous event	Program rule variables with this source type will contain the value from a specified data element from a previous event. Only older events is evaluated, not including the event that the user currently has open. This source type is commonly used when a data element only should be collected once during an enrollment, and should be hidden in subsequent events. Another use case is making rules for validating input where there is an expected progression from one event to the next - a rule can evaluate whether the previous value is higher/lower and give a warning if an unexpected value is entered.
   Calculated value	Program rule variable with this source type is not connected directly to any form data - but will be populated as a result of some other program rules ASSIGN action. This variable will be used for making preliminary calculations, having a ASSIGN program rule action and assigning a value, this value can be used by other program rules - potentially making the expressions simpler and more maintainable. These variables will not be persisted and will stay in memory only during the execution of the set of program rules. Any program rule that assigns a data value to a preliminary calculated value would normally also have a priority assigned - to make sure that the preliminary calculation is done before the rule that consumes the calculated value.
   Tracked entity attribute	Populates the program rule variable with a specified tracked entity attribute for the current enrollment. Use this is the source type to create program rules that evaluate data values entered during registration. This source type is also useful when you create program rules that compare data in events to data entered during registration. This source type is only used for tracker programs (programs with registration).

6. Cliquez sur Sauvegarder.

Créer ou modifier une règle de programme¶

N.B.

Une règle de programme appartient à un seul programme.

1. Ouvrez l'application Maintenance et cliquez sur Programme > Règle de programme.

2. Cliquez sur le bouton Ajouter.

3. Saisissez les détails de la règle du programme. Ces champs ne sont pas affichés pour l'utilisateur final, ils sont uniquement destinés à l'administrateur du programme.

   • Programme

   • Règle de déclenchement uniquement pour la phase du programme

     Si une étape de programme est sélectionnée, la règle de programme ne s'appliquera qu'à l'étape de programme sélectionnée, au lieu de s'appliquer à toutes les étapes du programme.

   • Nom.

   • Description

   • Priorité

     Supposons que votre programme comporte 16 règles. Vous configurez les règles de programme avec les paramètres de priorité suivants :

     • Priorité 1 pour la règle A du programme

     • Priorité 2 pour les règles B - K du programme

     • Pas de priorité pour les règles L - P du programme

     Résultat : le système exécute les règles du programme dans l'ordre suivant :

     1. Règle A du programme

     2. Règles de programme B - K (vous ne pouvez pas savoir ou configurer l'ordre dans lequel le système exécute ces règles de programme)

     3. Règles L - P du programme

4. Cliquez sur Saisir l'expression de la règle de programme et créez l'expression de la règle de programme à l'aide de variables, de fonctions et d'opérateurs.

5. Cliquez sur Définir les actions de la règle du programme et créez les actions exécutées lorsque l'expression est vraie.

   1. Cliquez sur le bouton d'ajout, sélectionnez une Action et entrez les informations requises.

      Selon le type d'action, vous aurez à effectuer différents types de paramétrages. Pour certains types d'action, vous devez également saisir librement un texte ou créer des expressions.

      Action type	Required settings	Description
      Assign value	Data element to assign value to Tracked entity attribute to assign value to Program rule variable to assign value to Expression to evaluate and assign	Used to help the user calculate and fill out fields in the data entry form. The idea is that the user shouldn’t have to fill in values that the system can calculate, for example BMI. When a field is assigned a value, the user sees the value but the user can't edit it. NOTE: To assign a value to a tracked entity attribute, the user needs to open the tracked entity profile widget for the rule to trigger. Example from Immunization stock card i Zambia: The data element for vaccine stock outgoing balance is calculated based on the data element for incoming stock balance minus the data elements for consumption and wastage. Advanced use: configure an 'assign value' to do a part of a calculation and then assign the result of the calculation to a program rule variable. This is the purpose with the "Calculated value" program rule variable.
      Display text	Display widget Static text Expression to evaluate and display after static text	Used to display information that is not an error or a warning, for example feedback to the user. You can also use this action to display important information, for example the patient's allergies, to the user.
      Display key/value pair	Display widget Key label Expression to evaluate and display as value	Used to display information that is not an error or a warning. Example: calculate number of weeks and days in a pregnancy and display it in the format the clinician is used to see it in. The calculation is based on previous recorded data.
      Error on complete	Data element to display error next to Tracked entity attribute to display error next to Static text Expression to evaluate and display after static text	Used whenever you've cross-consistencies in the form that must be strictly adhered to. This action prevents the user from continuing until the error is resolved. This action differs from the regular Show error since the error is not shown until the user tries to actually complete the form. If you don't select a data element or a tracked entity attribute to display the error next to, make sure you write a comprehensive error message that helps the user to fix the error.
      Hide field	Data element to hide Tracked entity attribute to hide Custom message for blanked field	Used when you want to hide a field from the user. Custom message for blanked field allows you to define a custom message displayed to the user in case the program rule hides and blanks out the field after the user typed in or selected a value. If a hide field action hides a field that contains a value, the field will always removed. If no message is defined, a standard message will be displayed to alert the user.
      Hide section	Program stage section to hide	Used when you want to hide a section in a program stage from the user.
      Prevent adding new events to stage	Program stage where users will not be able to add new events	Used when you do not want users to add any more events to a program stage. Existing events will not be hidden.
      Make field mandatory	Data element to make mandatory Tracked entity attribute to make mandatory	Used when you want to make a data element or tracked entity attribute mandatory so they have to be filled out before the form can be saved.
      Show error	Data element to display error next to Tracked entity attribute to display error next to Static text Expression to evaluate and display after static text	Used whenever there are rules which must strictly be adhered to. The show error action prevents the user from continuing until the error is resolved. Such a strict validation should only be used when it's certain that the evaluated expression is never true unless the user has made a mistake in data entry. It's mandatory to define a message that is shown to the user when the expression is true and the action is triggered. You can select which data element or tracked entity attribute to link the error to. This will help the user to fix the error. In case several data elements or attributes are involved, select the one that is most likely that the user would need to change.
      Show warning	Data element to display warning next to Tracked entity attribute to display warning next to Static text Expression to evaluate and display after static text	Used to give the user a warning about the entered data, but at the same time to allow the user to save and continue. You can use warnings to help the user avoid errors in the entered data, while at the same time allow the user to consciously disregard the warnings and save a value that is outside preset expectations. Static text defines the message shown to the user when the expression is true and the action is triggered. You can select which data element or tracked entity attribute to link the error to. This will help the user to fix the error. In case several data elements or attributes are involved, select the one that is most likely that the user would need to change.
      Warning on complete	Data element to display warning next to Tracked entity attribute to display warning next to Static text Expression to evaluate and display after static text	Used to give the user a warning if he/she tries to complete inconsistent data, but at the same time to allow the user to continue. The warning is shown in a dialog when the user completes the form. Static text defines the message shown to the user when the expression is true and the action is triggered. This field is mandatory. You can select which data element or tracked entity attribute to link the error to. This will help the user to fix the error. If you don't select a data element or a tracked entity attribute to display the error next to, make sure you write a comprehensive error message that helps the user to fix the error.
      Send Message	Message template to send	Send Message triggers a notification based on provided message template. This action will be taken immediately. The message template will be parsed and variables will be substituted with actual values.
      Schedule Message	Message template to send Data field which contains expression to evaluate the date which notification should be sent at. If this expression results in any value other than Date, then resultant will be discarded and notification will not get scheduled.	Schedule Message will schedule notification at date provided by Expression in the data field. Sample expression is given below d2:addDays( '2018-04-20', '2' ) Message template will be parsed and variables will be substituted with actual values.
      Schedule event	Program stage to schedule event for Expression to evaluate the scheduled date	Automatically schedules a new event for the specified program stage on the date returned by the expression. The expression must evaluate to a valid date; if it does not, no event will be scheduled. The event is only scheduled once — if the rule condition evaluates to true again, no duplicate event is created. Useful for programs where the timing of the next visit or follow-up can be derived from existing data, for example scheduling a second vaccination dose a fixed number of days after the first. Example expression that schedules an event 28 days after a recorded date: d2:addDays(#{dateOfFirstDose}, 28)
      Hide option	Data element to hide option for Tracked entity attribute to hide option for Option that should be hidden	Used to selectively hide a single option for an option set in a given data element/tracked entity attribute. When combined with show option group the hide option takes precedence.
      Hide option group	Data element to hide option group for Tracked entity attribute to hide option group for Option group that should be hidden	Used to hide all options in a given option group and data element/tracked entity attribute. When combined with show option group the hide option group takes precedence.
      Show option group	Data element to show option group for Tracked entity attribute to show option group for Option group that should be shown	Used to show only options from a given option group in a given data element/tracked entity attribute. To show an option group implicitly hides all options that is not part of the group(s) that is shown.

   2. Click Save.

   3. (Optional) Repeat above steps to add more actions.

6. Cliquez sur Sauvegarder.

Exemple : Règles du programme¶

N.B.

Vous pouvez voir tous les exemples sur le serveur de démo : https://play.dhis2.org/dev/dhis-web-maintenance/#/list/programSection/programRule

This example shows how to configure a program rule which calculates number of weeks and days in a pregnancy and display the result in the format the clinician is used to see it in. The calculation is based on previous recorded data.

1. 

2. 

3. 

   L'expression complète dans le champ Données :

   d2:concatenate(d2:weeksBetween(#{lmp}, V{current_date}), '+',
   d2:modulus(d2:daysBetween(#{lmp}, V{current_date}), 7))
   

Cet exemple montre comment configurer une règle de programme pour afficher du texte dans le widget Feedback de l'application Saisie Tracker.

Cet exemple montre comment configurer une règle de programme pour afficher toujours certaines données dans le widget Feedback de l'application Saisie Tracker. Ceci est utile lorsque l'on veut s'assurer que les données vitales, en l'occurence les allergies aux médicaments, sont toujours visibles.

En utilisant une règle de programme du type "Attribuer une valeur", vous pouvez calculer la valeur "Âge gestationnel à la visite" et la saisir dans le formulaire de saisie. Vous configurez la règle du programme pour calculer l'"âge gestationnel à la visite" sur la base de la "Date des dernières règles" ou de la "Date d'échéance estimée de l'échographie".

Informations de référence : Opérateurs et fonctions à utiliser dans l'expression de la règle du programme¶

Note

When using absolute dates in program rule expressions, always use 'YYYY-MM-DD' date format irrespective of the System Date format setting.

Tip

You can nest functions within each other and with sub-expressions to form more complex conditions. An example that produces the gestational age in weeks, based on last menstrual date:

d2:floor( d2:daysBetween(#{lastMenstrualDate},V{event_date}) / 7 )

Tip

The source type will determine how the d2: function calls will evaluate a (sourcefield) parameter.

Example: where #{hemoglobinCurrent} is set to source type Data element in current event. The following function call with evaluate whether haemoglobin is entered in the current event.

d2:hasValue( 'hemoglobinCurrent' )

Example: where #{hemoglobin} is set to source type Data element from the newest event in the current program. The following function call with evaluate whether there exists a value for the haemoglobin in any event in the enrollment.

d2:hasValue( 'hemoglobin' )

Example: where #{hemoglobinPrevious} is set to source type Data element from previous event . The following function call with evaluate whether there exists a value for the haemoglobin among the events preceding the current event.

d2:hasValue( 'hemoglobinPrevious' )

Tableau : Opérateurs possibles à utiliser dans une expression de règle de programme

Tableau : Fonctions personnalisées à utiliser dans une expression de règle de programme

Tableau : Codes de la matrice de données

Tableau : Variables standard à utiliser dans les expressions des règles du programme

Configurer les types de relation.¶

À propos des types de relation¶

Une relation est un lien entre deux entités dans le modèle Tracker. Une relation est considérée comme une donnée dans DHIS2 et est basée sur un type de relation, de la même manière qu'une entité suivie est basée sur un type d'entité suivie.

Les relations comprennent toujours deux entités, et ces entités peuvent comprendre des entités suivies, des inscriptions et des événements, ainsi que toute combinaison de ces éléments.

[!REMARQUE] Notez que ce ne sont pas toutes ces combinaisons qui sont disponibles dans les applications actuelles. Actuellement, dans l'application Saisie, vous pouvez créer : * des relations d'entités suivies à entités suivies * des relations entre événements dans des programmes d'événements et des entités suivies (uniquement à partir de l'événement) *des relations entre événements d'une étape de programme et des événements d'une autre étape au sein du même programme (étapes liées - Plus d'informations [ici] (https://docs.dhis2.org/en/use/user-guides/dhis-core-version-241/tracking-individual-level-data/capture.html#related-stages-and-linked-events-for-tracker-programs)).

En outre, les relations peuvent être définies comme unidirectionnelles ou bidirectionnelles. La seule différence fonctionnelle est qu'elles nécessitent actuellement différents niveaux d'accès pour être créées. Les relations unidirectionnelles exigent que l'utilisateur ait un accès en écriture de données à l'entité "de" et un accès en lecture de données à l'entité "à", tandis que les relations bidirectionnelles exigent un accès en écriture de données pour les deux parties.

Pour plus d'informations sur la configuration et la signification de 'De la contrainte' et 'À la contrainte', voir Modèle de relation.

Créer ou modifier un type de relation¶

1. Ouvrez l'application Maintenance et cliquez sur Programme > Type de d'indicateur.

2. Cliquez sur le bouton Ajouter.

3. Entrez un Nom du type de relation.

4. (Facultatif) Attribuez un Code.

5. (Facultatif) Faites une Description de la relation.

6. (Facultatif) Choisissez si la relation doit être bidirectionnelle

7. Provide Relationship name seen from initiating entity. This is the name of the relationship that will be shown in the Data Entry app at the 'left' side of the relationship. E.g. in a Mother-child relationship this could be 'Mother of'.

8. (Facultatif) Indiquez Nom de la relation vu de l'entité réceptrice. C'est le nom de la relation qui s'affichera à droite de la relation dans l'application Saisie de données. Par exemple, dans le cas d'une relation mère-enfant, il peut s'agir de "Mère".

9. Sélectionnez "De la contrainte". Cette contrainte limite le type d'entités pouvant être incluses dans la relation. Modèle de relation. Après avoir sélectionné "De la contrainte", vous avez la possibilité de choisir les attributs ou les éléments de données qui doivent être affichés dans le widget de la relation dans la saisie Tracker et la saisie "De la contrainte". La liste varie en fonction de la contrainte :

   • Lorsque vous sélectionnez "Instance d'entité suivie", puis un type d'entité suivie uniquement, vous devez choisir parmi les attributs de type d'entité suivie configurés.
   • When selecting “Tracked Entity Instance”, then a Tracked Entity Type and a Program, choose between the attributes that have been configured for both the Tracked Entity Type and for the Program
   • Lorsque vous sélectionnez "Inscription au programme", vous devez choisir parmi les attributs qui ont été configurés pour le programme.
   • Lorsque vous sélectionnez "Événement dans le programme ou l'étape du programme", vous devez choisir parmi les éléments de données qui ont été configurés pour ce programme d'événement ou cette étape du programme.

10. Sélectionnez 'À la contrainte'. Cela limite le type d'entités pouvant être incluses dans la relation. Modèle de relation. Répétez la sélection des attributs ou des éléments de données qui doivent être affichés dans le widget de relation pour " À la contrainte ".

11. Cliquez sur Sauvegarder.

Configurer les types d'entités suivies¶

À propos des types d'entités suivies¶

A tracked entity is a type of entity which can be tracked through the system. It can be anything from persons to commodities, for example a medicine or a person.

A program must have one tracked entity. To enroll a tracked entity instance into a program, the tracked entity type of the entity and the tracked entity type of the program must be the same.

Les attributs d'entités suivies sont utilisés pour enregistrer des informations supplémentaires pour une entité suivie. Les attributs des entités suivies peuvent être partagés entre les programmes.

Créer ou modifier un attribut d'entité suivie¶

1. Ouvrez l'application Maintenance et cliquez sur Programme > Attribut d'entité suivie.

2. Cliquez sur le bouton Ajouter.

3. Dans le champ Nom, saisissez le nom de l'attribut de l'entité suivie.

4. (Facultatif) Tapez un Nom abrégé.

5. (Facultatif) Entrez un nom du formulaire.

6. (Facultatif) Dans le champ Code, attribuez un code.

7. (Facultatif) Saisissez une Description.

8. (Facultatif) Dans le champ Masque de champ, vous pouvez taper un modèle qui est utilisé pour fournir des conseils permettant un bon formatage de l'élément de donnée. NB : Uniquement implémenté à ce jour, dans l'application de saisie Android du DHIS2, pas dans les applications de saisie et de saisie de suivi web. Voici donc les caractères spéciaux qui peuvent être utilisés dans le masque. Les caractères spéciaux correspondent exactement à un caractère du type donné.

Par exemple, le modèle peut être utilisé pour afficher des traits d'union dans le champ de saisie de l'élément de données selon les besoins. Par exemple, "\d\d\d-\d\d\d-\d\d\d" montre un trait d'union après chaque troisième chiffre.

1. Sélectionnez un ensemble d'options.

2. Dans le champ Type de valeur, sélectionnez le type de données que l'entité suivie pourra enregistrer.

   Value types

   Value type	Description
   Age	Dates rendered as calendar widget OR by entering number of years, months and/or days which calculates the date value based on current date. The date will be saved in the backend.
   Coordinate	A point coordinate specified as longitude and latitude in decimal degrees. All coordinate should be specified in the format "-19.23 , 56.42" with a comma separating the longitude and latitude.
   Date	Dates render as calendar widget in data entry.
   Date & time	Is a combination of the DATE and TIME data elements.
   E-mail	Valid email address.
   File	A file resource where you can store external files, for example documents and photos.
   Image	A file resource where you can store photos. Unlike the FILE data element, the IMAGE data element can display the uploaded image directly in forms.
   Integer	Any whole number (positive and negative), including zero.
   Letter	A single letter.
   Long text	Textual value. Renders as text area with no length constraint in forms.
   Negative integer	Any whole number less than (but not including) zero.
   Number	Any real numeric value with a single decimal point. Thousands separators and scientific notation is not supported.
   Percentage	Whole numbers inclusive between 0 and 100.
   Phone number	Phone number.
   Positive integer	Any whole number greater than (but not including) zero.
   Positive of zero integer	Any positive whole number, including zero.
   Organisation unit	Organisation units rendered as a hierarchy tree widget. If the user has assigned "search organisation units", these will be displayed instead of the assigned organisation units.
   Unit interval	Any real number greater than or equal to 0 and less than or equal to 1.
   Text	Textual value. The maximum number of allowed characters per value is 50,000.
   Time	Time is stored in HH:mm format. HH is a number between 0 and 23 mm is a number between 00 and 59
   Username	DHIS2 user. Rendered as a dialog with a list of users and a search field. The user will need the "View User" authority to be able to utilise this data type.
   Yes/No	Boolean values, renders as drop-down lists in data entry.
   Yes only	True values, renders as check-boxes in data entry.

3. Sélectionnez un Type d'agrégation.

   Table: Aggregation operators

Il existe deux options pour ce cadre unique :

  - **Système complet** : Les valeurs de l'attribut d'entité suivie
    peuvent être dupliquées avec des valeurs appartenant à d'autres attributs d'entité
    suivie. Mais les valeurs contenues dans cet attribut d'entité suivie ne doivent 
    pas être dupliquées.

    Sélectionnez **Généré automatiquement** pour permettre la génération automatique
    de la valeur de l'attribut de l'entité suivie. Lorsque le paramètre de génération
    est activé, un champ facultatif permettant de spécifier un modèle s'affiche
    également. Ce champ doit contenir un motif basé sur la 
    syntaxe TextPattern. Lorsque la valeur est générée automatiquement,
    elle est unique pour cet attribut dans l'ensemble du système. Voir
    la section TextPattern pour plus d'informations sur son fonctionnement.

  - **Unité d'organisation** : Les valeurs de l'attribut de l'entité suivie 
    ne doivent pas être dupliquées dans la même unité d'organisation.

1. Sélectionnez Hériter pour enregistrer une nouvelle entité en relation avec une entité disponible. Toutes les valeurs des attributs de l'entité héritée seront pré-remplies dans le formulaire d'enregistrement.

2. (Facultatif) Sélectionnez Confidentiel.

   Cette option n'est disponible que si vous avez configuré le cryptage du système.

[!WARNING] The Confidential flag does not guarantee encryption of data at rest and is not currently functioning as intended. Currently, values are stored as both encrypted and plain text values in the database.

For implementations requiring encryption of sensitive data, it is recommended to use encryption-at-rest features provided by the underlying operating system at the file system level or the block level. Many operating systems support this functionality, including Windows.

Going forward, the Confidential flag should be understood strictly as a visibility control mechanism at Analytics Output level, and not as an encryption feature.

The DHIS2 Core team therefore discourages use of the Confidential flag for data protection or encryption purposes. Upcoming versions will implement and document consistent functionality and recommendations for security approaches.

1. (Facultatif) Sélectionnez Afficher dans la liste sans programme.

2. (Facultatif) Attribuez une ou plusieurs Légendes.

3. Cliquez sur Sauvegarder.

Créer ou modifier un type d'entité suivie¶

1. Ouvrez l'application Maintenance et cliquez sur Programme > Attribut type d'entité.

2. Cliquez sur le bouton d'ajout ou sur un type d'entité d'indicateur.

3. Entrez un Nom de l'entité suivie.

4. (Facultatif) sélectionnez une Couleur et une Icône qui seront utilisées par les applications de saisie des données pour identifier ce type d'entité suivie.

5. (Facultatif) Entrez une Description de l'entité suivie.

6. (Facultatif) Saisissez un Nombre minimum d'attributs requis pour la recherche. Cela indique le nombre d'attributs qui doivent être remplis pour pouvoir rechercher ce type d'entité suivie dans une recherche globale. Voir Configurer la recherche pour plus d'informations.

7. (Facultatif) Saisir un Nombre maximum d'entités suivies à renvoyer dans la recherche. Cette valeur spécifie le nombre d'entités suivies qui sera renvoyée lors d'une recherche hors du champ de saisie de l'utilisateur. Voir Configurer la recherche pour plus d'informations.

8. (Facultatif) Ajouter les attributs du type d'entité suivi. Ceci est utilisé pour configurer la recherche, voir Configurer la recherche pour plus d'informations.

9. (Facultatif) Entrez un Nom alternatif de l'entité suivie.

10. Cliquez sur Sauvegarder.

Configurer la recherche¶

Les utilisateurs peuvent se voir attribuer des unités d'organisation de recherche, ce qui permet de rechercher des instances d'entités suivies en dehors de leurs unités d'organisation de saisie de données.

Searching can be done either in the context of a program, or in the context of a tracked entity type. To give users the option of searching in the context of a program, it is necessary to configure which of the programs tracked entity attributes is searchable. To give users the option of searching in the context of a tracked entity type, you will have to configure which of the tracked entity type attributes is searchable.

Configurer la recherche pour le programme Tracker¶

Pour pouvoir effectuer une recherche avec un programme, vous devrez rendre certains des attributs du programme consultables. Les attributs de programme uniques seront toujours consultables.

1. Ouvrez l'application Maintenance et cliquez sur Programme

2. Ouvrir ou créer un programme tracker

3. Aller à Attributs

4. Si vous n'avez pas d'attributs, ajoutez-en un

5. Définir l'attribut interrogeable

Searchable program attributes will be assigned to a search group.

• Groupe unique. Un groupe par attribut unique du programme. Les attributs uniques ne peuvent pas être combinés avec d'autres attributs de programme dans une recherche. Le résultat de la recherche ne peut être que 0 ou 1 instance d'entité suivie.

• Groupe non unique. Ce groupe contient tous les attributs de programme non uniques et permet de combiner plusieurs attributs dans une recherche.

Il y a deux limites qui peuvent être établies pour une recherche de programme, dans le cadre de la configuration des Détails du Programme.

• Nombre minimum d'attributs requis pour effectuer une recherche : Cette propriété définit le nombre d'attributs non uniques qui doivent être saisis avant qu'une recherche puisse être effectuée.

• Nombre maximum d'entités suivies à renvoyer : Cette propriété définit le niveau de précision qu'une recherche doit avoir, en limitant le nombre d'entités suivies qu'un utilisateur peut obtenir avec ses critères de recherche. Si le nombre d'enregistrements correspondants est supérieur à ce paramètre, ils ne seront pas renvoyés. L'utilisateur doit alors fournir des critères de recherche plus spécifiques, afin de réduire le nombre des enregistrements correspondants, avant qu'ils ne soient renvoyés. Pour en savoir plus sur les limites, cliquez ici.

  NOTE

  This maximum limit setting is only applied to search results when searching outside the users capture org unit. Within the capture scope, the user can see any number of results.

Configurer la recherche pour le type d'entité suivie¶

N.B.

TET = Type d'entité suivie

Pour pouvoir effectuer une recherche sans programme, vous devrez rendre certains des attributs du TET consultables. Les attributs uniques du TET seront toujours interrogeables.

1. Ouvrez l'application Type d'entité suivie

2. Ouvrez un type d'entité suivie

3. Si le TET n'a pas d'attributs, ajoutez-en un

4. Définir l'attribut interrogeable

Searchable TET attributes will be assigned to a search group.

• Groupe unique. Un groupe par attribut TET unique. Les attributs uniques ne peuvent pas être combinés avec d'autres attributs TET dans une recherche. Le résultat de la recherche ne peut être que 0 ou 1 instance d'entité suivie.

• Groupe non unique. Ce groupe contient tous les attributs TET non uniques et permet de combiner plusieurs attributs dans une recherche.

Deux limites peuvent être établies pour une recherche de TET

• Nombre minimum d'attributs requis pour effectuer une recherche : Cette propriété définit le nombre d'attributs non uniques qui doivent être saisis avant qu'une recherche puisse être effectuée.

• Nombre maximum d'instances d'entité suivie à renvoyer : Cette propriété définit le degré de spécificité d'une recherche, en limitant le nombre d'instances d'entité suivie correspondantes qu'un utilisateur est autorisé à obtenir pour ses critères de recherche. Si le nombre d'enregistrements correspondants est supérieur à ce maximum, ils ne seront pas renvoyés. L'utilisateur doit fournir des critères de recherche plus spécifiques, afin de réduire le nombre d'enregistrements correspondants, avant qu'ils ne soient renvoyés.

  NOTE

  This maximum is only applied to search results outside the users capture org unit. Within the capture scope, the user can see any number of results.

Configurer les unités d'organisation de la recherche pour un utilisateur¶

To be able to search in other organisation units than the users data capture organisation units, the user must be assigned with search organisation units. Giving a user a search organisation unit will also give them access to search in all children of that organisation unit.

1. Ouvrir l'application**Utilisateurs**

2. Cliquez sur un utilisateur

3. Ouvert Attribuer des unités d'organisation de recherche

4. Sélectionnez les unités d'organisation

5. Cliquez sur Enregistrer

Cloner des objets de métadonnées¶

Le clonage d'un élément de données ou d'autres objets peut faire gagner du temps lorsque vous créez plusieurs objets similaires.

1. Ouvrez l'application Maintenance et cherchez le type d'objet de métadonnées que vous voulez cloner.

2. Dans la liste des objets, cliquez sur le menu Options et sélectionnez Cloner.

3. Modifiez les options que vous voulez.

4. Cliquez sur Sauvegarder.

Supprimer les objets de métadonnées¶

N.B.

Pour supprimer un élément de données et d'autres objets d'éléments de données, aucune donnée ne doit être associée à cet élément de données.

Avertissement

Tout ensemble de données que vous supprimez du système est définitivement perdu. Tous les formulaires de saisie de données et les formulaires de section créés seront également supprimés. Songez à sauvegarder votre base de données avant de supprimer un ensemble de données au cas où vous auriez besoin de le restaurer à un moment donné.

1. Ouvrez l'application Maintenance et cherchez le type d'objet de métadonnées que vous voulez supprimer.

2. Dans la liste des objets, cliquez sur le menu Options et sélectionnez Supprimer.

3. Cliquez sur Confirmer.

Modifier les paramètres de partage des objets de métadonnées¶

Vous pouvez attribuer différents paramètres de partage aux objets de métadonnées, par exemple des unités d'organisation et des attributs d'entités suivies. Ces paramètres de partage déterminent les utilisateurs et les groupes d'utilisateurs qui peuvent visualiser ou modifier un objet de métadonnées.

Some metadata objects also allow you to change the sharing setting of data entry for the object. These additional settings control who can view or enter data in form fields using the metadata.

N.B.

Le paramètre par défaut signifie que tout le monde (Accès public) peut trouver, visualiser et modifier les objets de métadonnées. >

1. Ouvrez l'application Maintenance et cherchez le type d'objet de métadonnées que vous voulez modifier.

2. Dans la liste des objets, cliquez sur le menu contextuel et sélectionnez Paramètres de partage.

3. (Facultatif) Ajoutez des utilisateurs ou des groupes d'utilisateurs : recherchez un utilisateur ou un groupe d'utilisateurs et sélectionnez-le. L'utilisateur ou le groupe d'utilisateurs est ajouté à la liste.

4. Modifiez les paramètres de partage pour les groupes d'accès que vous souhaitez modifier.

   • Peut modifier et visualiser : Le groupe d'accès peut visualiser et modifier à l'objet.

   • Peut seulement visualiser : Le groupe d'accès peut seulement visualiser l'objet.

   • Pas d'accès (uniquement applicable à L'accès public) : Le public n'aura pas accès à l'objet.

5. Modifiez les paramètres de partage des données pour les groupes d'accès que vous voulez modifier.

   • Peut saisir des données : Le groupe d'accès peut visualiser et saisir des données pour l'objet.

   • Peut visualiser les données : Le groupe d'accès peut visualiser les données relatives à à l'objet.

   • Pas d'accès : Le groupe d'accès n'aura pas accès aux données relatives à l'objet.

6. Cliquez sur Fermer

Afficher les détails des objets de métadonnées¶

1. Ouvrez l'application Maintenance et cherchez le type d'objet de métadonnées que vous voulez visualiser.

2. Dans la liste des objets, cliquez sur le menu Options et sélectionnez Afficher les détails.

Traduire les objets de métadonnées¶

DHIS2 dispose des fonctionnalités pour la traduction du contenu des bases de données, par exemple les éléments de données, les groupes d'éléments de données, les indicateurs, les groupes d'indicateurs ou les unités d'organisation. Vous pouvez traduire ces éléments pour plusieurs emplacements. Un emplacement représente une région géographique, politique ou culturelle spécifique.

Astuce

Pour activer une traduction, ouvrez l'application Paramètres du système, cliquez sur > > Apparence et sélectionnez une langue.

1. Ouvrez l'application Maintenance et cherchez le type d'objet de métadonnées que vous voulez traduire.

2. Dans la liste des objets, cliquez sur le menu Options et sélectionnez Traduire.

   Tip

   If you want to translate an organisation unit level, click directly on the Translate icon next to each list item.

3. Sélectionnez un emplacement.

4. Tapez un Nom, Nom court et Description.

5. Cliquez sur Sauvegarder.