| Table of Contents |
|---|
Packages content
...
Contenu des paquets
Les métadonnées sont réparties dans trois fichiers json :
1. Attributs du serveur RDQA
...
This is the first file to import into the server. This package contains attributes objects, which works as additional fields of information to most of the metadata objects. These attributes are fully compatible with any of the server versions mentioned above.
It is necessary to import this package since some of the objects in RDQA Program package refer to the attributes.
Learn more about RDQA Server Attributes in the Technical Manual.
2. RDQA Program
This file contains all the objects related to the program: Data elements, Tracked Entity Attributes, Option sets, Option Groups, Program, Program stages, program rules, Program indicators and legends.
...
Il s'agit du premier fichier à importer dans le serveur. Ce paquet contient des objets d'attributs, qui fonctionnent comme des champs d'information supplémentaires pour la plupart des objets de métadonnées. Ces attributs sont entièrement compatibles avec toutes les versions du serveur mentionnées ci-dessus.
Il est nécessaire d'importer ce paquet car certains objets du paquet RDQA Program font référence aux attributs.
Pour en savoir plus sur les attributs du serveur RDQA, consultez la section Manuel technique.
2. Programme RDQA
Ce fichier contient tous les objets liés au programme : Éléments de données, Attributs des entités suivies, Jeux d'options, Groupes d'options, Programme, Étapes du programme, Règles du programme, Indicateurs et légendes du programme.
Pour en savoir plus sur le programme RDQA manuel technique.
3. RDQA Analytics
The Analytics file contains two dashboards:
Basic Dashboard: Displays four event reports and one pivot table indicating information such as number of assessments in a given period of time, main scores per health area and per donor and indicator.
RDQA Data Quality Score, Data Verification & M&E Systems Assessment: Displays a pivot table per health with the 3 scores (Overall Data Quality score, Assessment Score and Data verification score). It also displays an event report with the data verification score per dimension per indicator.
Learn more about RDQA Analytics in the technical manual.
Metadata packages location
The three packages are located in the Metadata folder in this repository. Click here to open the folder.
Requirements for installation: User
The minimum roles for a user to import the metadata packages are summarized in the tables below:
For RDQA Server Attributes json file:
...
Metadata
...
Apps
...
Tracker
...
Import-Export
...
System
...
Add/Update Private
Attribute
...
Maintenance App
Import-Export app
Browser Cache Cleaner app
Dashboard App
...
NA
...
Export metadata
Import metadata
...
NA
2. For RDQA Program json file:
...
Metadata
...
Apps
...
Tracker
...
Import-Export
...
System
...
Add/Update Private
Category
Category option
Data Element
Data Element Groups
Option Group
Legend Set
Option Set
Program
Tracked Entity Attribute
Add/Update Public
Program Rule
Program Stage
...
Maintenance App
Import-Export app
Browser Cache Cleaner app
Dashboard App
...
Manage Program Rule
...
Export metadata
Import metadata
...
NA
3. For RDQA Program json file:
...
Metadata
...
Apps
...
Tracker
...
Import-Export
...
System
...
Add/Update Private
Legend Set
Program Indicator
Category Combo
Add/Update Public
Indicator
Indicator Group
Indicator Type
...
Maintenance App
Import-Export app
Browser Cache Cleaner app
Pivot Table app
Event Reports app
Dashboard App
...
Manage Program Rule
...
Export metadata
Import metadata
...
NA
| Note |
|---|
Also, data entry users can't have more than 30 organisation units. Having too many OUs can lead to performance issues using the Android App. |
Installation
Download Packages
Open the Metadata folder located in this repository.
...
2. Click on the file and then click on the context menu (three dots).
...
3. Click on Download option
...
Importing packages
The same process applies to the three json files but it is important to upload the files in the following order:
RDQA Server Attributes
RDQA Program
RDQA Analytics - This package is optional. It does no affect the data capture behavior.
To import any file:
1. Open the Import/Export App
...
2. Select the Metadata Import button on the left side menu.
3. Select the correspondent json file.
4. Select JSON as the format.
...
5. Do a dry run before importing the file - This step will provide information if there is any incompatibility between your server and the file.
6. If the dry run is successful, start the import process.
...
7. Repeat the process for the next file.
Organisation unit assignment
Now that you have imported the files, it is necessary to add organisation units to the program to be able to capture data.
Open maintenance app
...
2. Open program and select the RDQA Program
...
3. In the Access Menu, select the capture org units
...
Sharing
All the packages are configured to have public access to the metadata but to be able to capture information:
Open the maintenance app.
...
2. Open program and select the RDQA Program.
...
3. Go to Access.
4. In the Roles and access section, click on the program’s name.
...
5. Click on Public access and change the DATA sharing to “Can capture and view” or add the users/user groups and change the data sharing to them.
...
6. Click on "Apply" and then click on "Apply to selected stages" to copy the sharing settings to all the stages.
...
7. Click on the save button to finish the process
Instead of having all the metadata public, it is highly recommended to create two user groups: The RDQA-Admin, which should have access to change metadata and the RDQA-User group, which will include all users that capture data.
To create a user group:
...
Open the user app
...
Select User group on the left side menu
...
Click in the "+" button
...
Le fichier Analytics contient deux tableaux de bord :
Tableau de bord de base: Affiche quatre rapports d'événements et un tableau croisé dynamique indiquant des informations telles que le nombre d'évaluations au cours d'une période donnée, les principaux scores par domaine de santé, par donateur et par indicateur.
RDQA Score de qualité des données, vérification des données et évaluation des systèmes de S&E: Affiche un tableau croisé dynamique par santé avec les 3 scores (score de qualité globale des données, score d'évaluation et score de vérification des données). Il affiche également un rapport d'événement avec le score de vérification des données par dimension et par indicateur.
Pour en savoir plus sur RDQA Analytics, consultez la rubrique manuel technique.
...
Emplacement des paquets de métadonnées
Les trois paquets sont situés dans le dossier Metadata de ce référentiel. Cliquez ici pour ouvrir le dossier.
...
Exigences pour l'installation : Utilisateur
Les rôles minimums pour qu'un utilisateur puisse importer les paquets de métadonnées sont résumés dans les tableaux ci-dessous :
Pour le fichier json des attributs du serveur RDQA :
Métadonnées | Applications | Traceur | Import-Export | Système |
|---|---|---|---|---|
Ajouter/mettre à jour le privé | Application de maintenance | NA | Exporter les métadonnées | NA |
2. Pour le fichier json du programme RDQA :
Métadonnées | Applications | Traceur | Import-Export | Système |
|---|---|---|---|---|
Ajouter/mettre à jour le privé Ajouter/mettre à jour le public | Application de maintenance | Gérer les règles du programme | Exporter les métadonnées | NA |
3. Pour le fichier json du programme RDQA :
Métadonnées | Applications | Traceur | Import-Export | Système |
|---|---|---|---|---|
Ajouter/mettre à jour le privé Ajouter/mettre à jour le public | Application de maintenance | Gérer les règles du programme | Exporter les métadonnées | NA |
| Note |
|---|
En outre, les utilisateurs chargés de la saisie des données ne peuvent pas avoir plus de 30 unités d'organisation. Un trop grand nombre d'unités d'organisation peut entraîner des problèmes de performance lors de l'utilisation de l'application Android. |
...
Installation
Télécharger les paquets
Ouvrez le dossier Metadata situé dans ce dossier dépôt.
...
2. Cliquez sur le fichier, puis sur le menu contextuel (trois points).
...
3. Cliquez sur l'option Télécharger
...
Importation de paquets
Le même processus s'applique aux trois fichiers json, mais il est important de télécharger les fichiers dans l'ordre suivant :
Attributs du serveur RDQA
Programme RDQA
RDQA Analytics - Ce paquet est facultatif. Il n'affecte pas le comportement de la capture des données.
Pour importer n'importe quel fichier :
1. Ouvrir l'application Import/Export
...
2. Sélectionnez le bouton Importation de métadonnées dans le menu de gauche.
3. Sélectionnez le fichier json correspondant.
4. Sélectionnez JSON comme format.
...
5. Effectuer un essai avant d'importer le fichier - Cette étape permet d'obtenir des informations en cas d'incompatibilité entre votre serveur et le fichier.
6. Si l'essai est concluant, lancez le processus d'importation.
...
7. Répétez l'opération pour le fichier suivant.
Affectation de l'unité d'organisation
Maintenant que vous avez importé les fichiers, il est nécessaire d'ajouter des unités d'organisation au programme pour pouvoir capturer des données.
Ouvrir l'application de maintenance
...
2. Ouvrez le programme et sélectionnez le programme RDQA
...
3. Dans le menu d'accès, sélectionnez les unités de capture org
...
Partage
Tous les paquets sont configurés de manière à ce que le public ait accès aux métadonnées, mais qu'il soit en mesure de capturer des informations :
Ouvrez l'application de maintenance.
...
2. Ouvrez le programme et sélectionnez le programme RDQA.
...
3. Allez dans Accès.
4. Dans la section Rôles et accès, cliquez sur le nom du programme.
...
5. Cliquez sur Accès public et modifiez le partage des données en "Peut capturer et visualiser" ou ajoutez les utilisateurs/groupes d'utilisateurs et modifiez le partage des données en leur faveur.
...
6. Cliquez sur "Appliquer", puis sur "Appliquer aux étapes sélectionnées" pour copier les paramètres de partage dans toutes les étapes.
...
7. Cliquez sur le bouton d'enregistrement pour terminer le processus
Au lieu de rendre toutes les métadonnées publiques, il est fortement recommandé de créer deux groupes d'utilisateurs : Le groupe RDQA-Admin, qui doit avoir accès aux modifications des métadonnées, et le groupe RDQA-User, qui comprendra tous les utilisateurs qui capturent des données.
Pour créer un groupe d'utilisateurs :
Ouvrir l'application utilisateur
Sélectionnez Groupe d'utilisateurs dans le menu de gauche
Cliquez sur le bouton "+".
Inscrivez le nom du groupe et ajoutez tous les utilisateurs dont vous avez besoin.