Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The template generated for event/tracker programs contains different tabsLe modèle généré pour les programmes de suivi des événements contient différents onglets :

  1. Instructions : This section contains comprehensive guidelines on how to effectively utilize the Excel template Cette section contient des lignes directrices complètes sur la manière d'utiliser efficacement le modèle Excel.

  2. TEAs (Program Tracked Entity Attributes) : Within this tab, you can manage the attributes associated with the tracked entities in the program.

  3. Stages: These tabs dynamically correspond to the program stages, generating a tab for each individual stage.

  4. Release Notes: Please note that this tab is provided solely for reference purposes and is not editable. For the latest features and fixes, kindly refer to this section.

  5. Mapping: This tab is also designed for reference purposes and is non-editable. It enumerates various components such as option sets, health areas, legends, etc., employed within the Excel spreadsheet.

Note

Keep in mind:

  • Rearranging the tab order in the Excel template will not impact the DHIS2 configurations.

  • This template is designed solely for the modification of existing DHIS2 programs; it does not support the creation of new programs.

The instructions tab

This tab provides brief information related to the Excel sheet. You can go through this tab to have a thorough understanding of all the fields in the sheet.

...

All cells within the spreadsheet are protected. The "Instruction" tab encompasses program settings for the chosen tracker or event, alongside a section detailing server information pertinent to the template's download source.

The TEAs tab

This tab contains the Tracked Entity Attributes assigned to the current program.

...

Managing sections

Adding a new section:

To add another section, the user only will have to add a new row (it is very important to remark that an entire row needs to be added) right below the previous section’s last TEAs.

  • For a new section, the user has to select "Section" on the Structure (A) column.

  • Then type a name on (C) column that will be displayed for the new section.

Info

If the newly added row is selected as a section, the entire row will be highlighted in a light blue color

Removing a section:

To remove a Section from the current program, simply delete the entire corresponding row. Importing this template into the Program Configuration App will interpret missing rows as elements to be removed from the Program's current configuration.

Managing TEA

Adding new TEAs:

To add a new TEA, you have to find the right position where you want it and add a new entire row right below. The following cell should be filled in:

  1. Structure (Column A): In this cell, users should select Tracked Entity Attribute (TEA) from the provided options. Upon has been selected TEA, the subsequent columns must be highlighted in red to indicate their mandatory status:

    1. UID

    2. Name

    3. Short Name

    4. Value type

    5. Aggregation type

  2. UID (Column B): This cell should be automatically filled in once the user enters the TEA name.

  3. Name (Column C): The user must enter TEA name and the following column should be automatically filled in:

    1. UID

    2. Short name

    3. Value type

    4. Aggregation type

  4. Short Name (Column D):This cell should be automatically filled in once the user enters the TEA name.

  5. Value Type (Column E): This cell should be automatically filled in once the user enters the TEA name.

  6. Aggregation Type (Column F): This cell should be automatically filled in once the user enters the TEA name.

  7. Mandatory (Column G): The user will be able to select between yes and no. If the user selects “Yes”. The TEA must be filled to complete the event.

  8. Searchable (Column H): The user will be able to select between yes and no. If the user selects “Yes”, allows the TEA to be used as a search filter in the Tracked Entity Instance list.

  9. Display in List (Column I): The user will be able to select between yes and no. If the user selects “Yes”, the value of the selected TEA will be displayed in the Tracked Entity Instances list.

  10. Allow Future Date (Column J): The user will be able to select between yes and no. If the user selects “Yes”, the TEA will allow selecting a future date.

  11. Error/Warning/Info (Column M): The template will show detail regarding the cell highlighting on each row.

  • The UID, Short name, Value Type and Aggregation Type are used to verify that the TEA exists in the server, in case the TEA doesn’t exit, the cells will display a “Not found” message.

  • In case the expected cells aren't automatically populated, you can resolve this by dragging the formula from another cell within the same column.

  • Columns I to L will default to "No" if the cells are left blank.

Removing a TEA:

To remove an existing Tracked Entity Attribute from the current program, simply delete the entire corresponding row. Importing this template into the Program Configuration App will interpret missing rows as elements to be removed from the Program's current configuration.

The Stages tab

A Tab is generated for every Program Stage available. Each Tab is used for the corresponding Program Stage management.

...

Please note the following points:

...

New Program Stages: This template is designed solely for the purpose of editing pre-existing program stages. It does not support the creation of new Program Stages.

...

  1. Dans cet onglet, vous pouvez gérer les attributs associés aux entités suivies dans le programme.

  2. Les étapes : Ces onglets correspondent dynamiquement aux étapes du programme, en générant un onglet pour chaque étape individuelle.

  3. Notes de mise à jour : Veuillez noter que cet onglet est fourni uniquement à titre de référence et n'est pas modifiable. Pour les dernières fonctionnalités et corrections, veuillez vous référer à cette section.

  4. Cartographie : Cet onglet est également conçu à des fins de référence et n'est pas modifiable. Il énumère divers composants tels que les jeux d'options, les zones de santé, les légendes, etc., utilisés dans la feuille de calcul Excel.

Note

N'oubliez pas :

  • La modification de l'ordre des onglets dans le modèle Excel n'aura pas d'incidence sur les configurations de DHIS2.

  • Ce modèle est conçu uniquement pour la modification des programmes DHIS2 existants ; il ne permet pas la création de nouveaux programmes.

...

L'onglet instructions

Cet onglet fournit de brèves informations sur la feuille Excel. Vous pouvez consulter cet onglet pour avoir une compréhension approfondie de tous les champs de la feuille.

...

Toutes les cellules de la feuille de calcul sont protégées. L'onglet "Instruction" comprend les paramètres du programme pour le traceur ou l'événement choisi, ainsi qu'une section détaillant les informations du serveur relatives à la source de téléchargement du modèle.

...

L'onglet AET

Cet onglet contient les attributs des entités suivies affectés au programme en cours.

...

Gestion des sections

Ajout d'une nouvelle section :

Pour ajouter une autre section, l'utilisateur devra simplement ajouter une nouvelle ligne (il est très important de noter qu'une ligne entière doit être ajoutée) juste en dessous des derniers AET de la section précédente.

  • Pour une nouvelle section, l'utilisateur doit sélectionner "Section" dans la colonne Structure (A).

  • Tapez ensuite dans la colonne (C) le nom qui sera affiché pour la nouvelle section.

Info

Si la ligne nouvellement ajoutée est sélectionnée en tant que section, la ligne entière sera mise en évidence dans une couleur bleu clair.

Suppression d'une section :

Pour supprimer une section du programme actuel, il suffit de supprimer toute la ligne correspondante. L'importation de ce modèle dans l'application de configuration des programmes interprétera les lignes manquantes comme des éléments à supprimer de la configuration actuelle du programme.

Gestion de l'AET

Ajout de nouveaux AET :

Pour ajouter une nouvelle AET, vous devez trouver la bonne position et ajouter une nouvelle ligne entière juste en dessous. La cellule suivante doit être remplie :

  1. Structure (colonne A): Dans cette cellule, l'utilisateur doit sélectionner l'attribut de l'entité suivie (TEA) parmi les options proposées. Une fois l'AET sélectionné, les colonnes suivantes doivent être surlignées en rouge pour indiquer leur caractère obligatoire :

    1. UID

    2. Nom

    3. Nom court

    4. Type de valeur

    5. Type d'agrégation

  2. UID (colonne B): Cette cellule doit être automatiquement remplie une fois que l'utilisateur a saisi le nom de l'AET.

  3. Nom (colonne C): L'utilisateur doit saisir le nom de l'AET et la colonne suivante se remplit automatiquement :

    1. UID

    2. Nom court

    3. Type de valeur

    4. Type d'agrégation

  4. Nom court (colonne D):Cette cellule devrait être automatiquement remplie une fois que l'utilisateur a saisi le nom de l'AET.

  5. Type de valeur (colonne E) : Cette cellule doit être automatiquement remplie une fois que l'utilisateur a saisi le nom de l'AET.

  6. Type d'agrégation (colonne F): Cette cellule doit être automatiquement remplie une fois que l'utilisateur a saisi le nom de l'AET.

  7. Obligatoire (colonne G) : L'utilisateur pourra choisir entre "oui" et "non". Si l'utilisateur choisit "Oui". L'AET doit être rempli pour compléter l'événement.

  8. Recherche possible (colonne H) : L'utilisateur peut choisir entre "oui" et "non". Si l'utilisateur sélectionne "Oui", l'AET peut être utilisée comme filtre de recherche dans la liste des instances d'entités suivies.

  9. Affichage dans la liste (colonne I) : L'utilisateur peut choisir entre "oui" et "non". Si l'utilisateur choisit "Oui", la valeur de l'AET sélectionnée sera affichée dans la liste des instances d'entités suivies.

  10. Autoriser la date future (colonne J) : L'utilisateur pourra choisir entre oui et non. Si l'utilisateur choisit "oui", l'AET permettra de sélectionner une date ultérieure.

  11. Erreur/Avertissement/Info (colonne M) : Le modèle affiche des détails concernant la mise en évidence des cellules sur chaque ligne.

  • L'UID, le nom court, le type de valeur et le type d'agrégation sont utilisés pour vérifier que l'AET existe dans le serveur. Si l'AET n'existe pas, les cellules afficheront un message "Introuvable".

  • Si les cellules prévues ne sont pas automatiquement remplies, vous pouvez résoudre ce problème en faisant glisser la formule à partir d'une autre cellule de la même colonne.

  • Les colonnes I à L prendront par défaut la valeur "Non" si les cellules sont laissées vides.

Suppression d'une AET :

Pour supprimer un attribut d'entité suivie existant dans le programme actuel, il suffit de supprimer la totalité de la ligne correspondante. L'importation de ce modèle dans l'application Configuration du programme interprétera les lignes manquantes comme des éléments à supprimer de la configuration actuelle du programme.

...

L'onglet Étapes

Un onglet est généré pour chaque phase de programme disponible. Chaque onglet est utilisé pour la gestion de l'étape de programme correspondante.

...

Veuillez noter les points suivants :

  • Nouvelles étapes du programme: Ce modèle est conçu uniquement pour modifier des étapes de programme préexistantes. Il ne permet pas de créer de nouvelles étapes de programme.

  • Stades Modification du nom: Le modèle ne permet pas de modifier les noms des étapes. Veuillez vous abstenir de modifier les noms des onglets. Si de telles modifications sont nécessaires, vous pouvez utiliser le PCA (Program Stage Configuration App).

...

Gestion des sections

...

Ajout d'une nouvelle section :

To add another section, the user only will have to add a new row (it is very important to remark that an entire row needs to be added) right below the previous section’s last data element.

  • For a new section, the user has to select "Section" on the Structure (A) column.

  • Then type a name on (D) column that will be displayed for the new section.

Removing a section:

To remove a Section from the current stage, simply delete the entire corresponding row. Importing this template into the Program Configuration App will interpret missing rows as elements to be removed from the Program's current configuration.

Managing Data elements

Adding new data elements:

  1. Structure (Column A): In this cell, users should select Data Elements from the provided options. Upon has been selected Data element, the subsequent columns must be highlighted in red to indicate their mandatory status:

    1. Form name

  2. Correlative (Column B): This cell should be automatically filled in once the user selecting Data Element in the structure column.

  3. Use auto Naming (Column C): The use can select between “yes” and “no”.

    1. If the user selects “Yes”, the full name, short name and code must not be entered by the user. These cells should be highlighted in gray color.

    2. If the user select “No”, the users must enter the full name, short name and code. These cells should be highlighted in red color.

  4. Form Name (Column D):The user should enter between 2 and 200 characters.

  5. Full name (Column E): The user should enter between 2 and 200 characters. If the user selected auto naming, this cell should be blocked.

  6. Short name (Column F): The user should less than 50 characters. If the user selected auto naming, this cell should be blocked.

  7. Code (Column G): The user should enter less than 50 characters. If the user selected auto naming, this cell should be blocked.

  8. Description (Column H): The user will be able to enter helper text that will be displayed to the user during data entry.

  9. Compulsory (Column I): The user should select between “Yes” and “No”.

    1. If the user selects “Yes” the data element must be answered to complete and event.

    2. If the user selects "No" the data element should be optional, this option will be the default answer.

  10. Agg Operator (Column J): The Aggregation Type is for analytical objectives, prompting users to select an option from the available choices, with "None" as the default response.

  11. Option Set (Column M): Defines the available answer that will be displayed for the current data element.

  12. Legend set (Column N): Legends that will appear to the current data element.

  13. Parent Data Element (Column O): The user must enter the correlative of the Data Element that will act as parent for the current Data Element.

  14. Answer Value (Column P): Value that will trigger the “show” rule of the Data Element.

  15. Error/Warnings/Info (Column Q): Details regarding the cell highlighting on each row.

  16. Stage ID (Column R): This cell will display the ID of the current stage, and it will remain in read-only mode.

  17. Stage Name (Column S): This cell will display the name of the current stage, and it will remain in read-only mode.

Info

Adding existing Data elements:

  • The template does not support the insertion of existing Data Elements from a DHIS2 server.

  • To add existing Data Elements, please make use of the PCA features directly.

Removing a data element:

To remove a Data Element from the current stage, simply delete the entire corresponding row. Importing this template into the Program Configuration App will interpret missing rows as elements to be removed from the Program's current configurationPour ajouter une autre section, l'utilisateur devra simplement ajouter une nouvelle ligne (il est très important de noter qu'une ligne entière doit être ajoutée) juste en dessous du dernier élément de données de la section précédente.

  • Pour une nouvelle section, l'utilisateur doit sélectionner "Section" dans la colonne Structure (A).

  • Tapez ensuite dans la colonne (D) le nom qui sera affiché pour la nouvelle section.

Suppression d'une section :

Pour supprimer une section de l'étape actuelle, il suffit de supprimer toute la ligne correspondante. L'importation de ce modèle dans l'application de configuration du programme interprétera les lignes manquantes comme des éléments à supprimer de la configuration actuelle du programme.

Gestion des éléments de données

Ajout de nouveaux éléments de données :

  1. Structure (colonne A): Dans cette cellule, les utilisateurs doivent sélectionner les éléments de données parmi les options proposées. Une fois l'élément de données sélectionné, les colonnes suivantes doivent être surlignées en rouge pour indiquer leur caractère obligatoire :

    1. Nom du formulaire

  2. Corrélatif (colonne B): Cette cellule doit être remplie automatiquement lorsque l'utilisateur sélectionne un élément de données dans la colonne structure.

  3. Utilisation de l'auto-dénomination (colonne C): L'utilisateur peut choisir entre "oui" et "non".

    1. Si l'utilisateur choisit "Oui", le nom complet, le nom abrégé et le code ne doivent pas être saisis par l'utilisateur. Ces cellules doivent être surlignées en gris.

    2. Si l'utilisateur sélectionne "Non", il doit saisir le nom complet, le nom abrégé et le code. Ces cellules doivent être surlignées en rouge.

  4. Nom du formulaire (colonne D)L'utilisateur doit saisir entre 2 et 200 caractères.

  5. Nom complet (colonne E) : L'utilisateur doit saisir entre 2 et 200 caractères. Si l'utilisateur a choisi la dénomination automatique, cette cellule doit être bloquée.

  6. Nom court (colonne F): L'utilisateur doit utiliser moins de 50 caractères. Si l'utilisateur a sélectionné le nommage automatique, cette cellule doit être bloquée.

  7. Code (colonne G) : L'utilisateur doit saisir moins de 50 caractères. Si l'utilisateur a sélectionné la dénomination automatique, cette cellule doit être bloquée.

  8. Description (colonne H) : L'utilisateur pourra saisir un texte d'aide qui sera affiché à l'utilisateur pendant la saisie des données.

  9. Obligatoire (colonne I) : L'utilisateur doit choisir entre "Oui" et "Non".

    1. Si l'utilisateur sélectionne "Oui", il doit répondre à l'élément de données pour compléter l'événement.

    2. Si l'utilisateur sélectionne "Non", l'élément de données doit être facultatif, cette option sera la réponse par défaut.

  10. Opérateur Agg (colonne J) : Le type d'agrégation est destiné aux objectifs analytiques, invitant les utilisateurs à sélectionner une option parmi les choix disponibles, "Aucune" étant la réponse par défaut.

  11. Ensemble d'options (colonne M) : Définit la réponse disponible qui sera affichée pour l'élément de données actuel.

  12. Jeu de légendes (colonne N) : Légendes qui apparaîtront sur l'élément de données actuel.

  13. Élément de données sur le parent (colonne O) : L'utilisateur doit saisir le corrélatif de l'élément de données qui servira de parent à l'élément de données actuel.

  14. Valeur de la réponse (colonne P) : Valeur qui déclenchera la règle "show" de l'élément de données.

  15. Erreurs/Avertissements/Informations (colonne Q) : Détails concernant la mise en évidence des cellules sur chaque ligne.

  16. ID de l'étape (colonne R) : Cette cellule affichera l'ID de l'étape en cours et restera en mode lecture seule.

  17. Nom du stade (colonne S) : Cette cellule affichera le nom de l'étape en cours et restera en lecture seule.

Info

Ajout d'éléments de données existants :

  • Le modèle ne permet pas d'insérer des éléments de données existants provenant d'un serveur DHIS2.

  • Pour ajouter des éléments de données existants, veuillez utiliser directement les fonctions de l'ACP.

Suppression d'un élément de données :

Pour supprimer un élément de données de l'étape actuelle, il suffit de supprimer toute la ligne correspondante. L'importation de ce modèle dans l'application de configuration du programme interprétera les lignes manquantes comme des éléments à supprimer de la configuration actuelle du programme.