Metadata Conversion is the process of creating a new H2 Program by using the configurations of an existing H1 Program as a base. This new H2 Program will re-use as many of the original components as possible, including: Data Elements for Questions and Scores, Sharing Settings, Organisation Units access and the structure of the Assessment.
However, as H2 is designed differently, there will be some additional changes that need to be performed to the converted Program in order to ensure that it works as expected when used by the supervisors.
| Info |
|---|
This is a conversion guide, follow the steps described below to convert any H1 Program to H2. Refer to this guide if you encountered any problems during this process. |
Locating the Metadata Conversion Feature
This feature can only be found in the homepage (Programs List page) of the PCA. You can access it by clicking the three-dot menu at the far-right of any HNQIS 1.X Program displayed on the list (see Image 1).
...
Please Note:
...
La conversion des métadonnées est le processus de création d'un nouveau programme H2 en utilisant les configurations d'un programme H1 existant comme base. Ce nouveau programme H2 réutilisera autant de composants originaux que possible, y compris : les éléments de données pour les questions et les scores, les paramètres de partage, l'accès aux unités d'organisation et la structure de l'évaluation.
Cependant, comme le programme H2 est conçu différemment, des modifications supplémentaires devront être apportées au programme converti afin de s'assurer qu'il fonctionne comme prévu lorsqu'il est utilisé par les superviseurs.
| Info |
|---|
Il s'agit d'un guide de conversion. Suivez les étapes décrites ci-dessous pour convertir n'importe quel programme H1 en programme H2. Reportez-vous à ce guide si vous rencontrez des problèmes au cours de ce processus. |
Localisation de la fonction de conversion des métadonnées
Cette fonction n'est disponible que sur la page d'accueil (page de la liste des programmes) de l'APC. Vous pouvez y accéder en cliquant sur le menu à trois points situé à l'extrême droite de n'importe quel programme HNQIS 1.X affiché dans la liste (voir image 1).
...
A noter :
Cette option n'est disponible que pour les programmes étiquetés comme HNQIS 1.XLe menu à trois points de tous les autres programmes affichera des options différentes de celles présentées dans l'image 1.
| Note |
|---|
Important : The conversion process can only be performed once per H1 Program, make sure that the Program you’re converting is in its latest version available. |
Converting a H1 Program
After clicking the Convert to HNQIS 2.0 Program option from any H1 Program, a new window will appear displaying the HNQIS 2.0 Settings and a preview of the new Program that will be created (see Image 2).
...
This window displays the name of the selected Program at the top, followed by the HNQIS 2.0 Settings section, which can be expanded by clicking the arrow icon located at the far-right (see Image 3) to display the following fields:
An Organisation Unit Selector to specify the owner Country (Organisation Unit Root) of the Checklist (Required).
A switch to enable/disable the usage of User Organisation Units to create the H2 Program Analytics.
Two dropdowns to select the Organisation Unit Levels for Visualizations and Maps in the H2 Program Dashboard (Required).
A switch for enabling/disabling Competency Classes in the Program.
A dropdown for selecting the Health Area of the Program (Required).
| Info |
|---|
All of the settings above can be changed later by editing the Program if needed. |
...
Additional to the mentioned settings, a preview of the converted checklist is displayed. Every block represents a Section in the Assessment, displaying the Section name and the amount of Data Elements contained in the section. Clicking on the arrow icon located at the far-right will expand the section, displaying its contents (see Image 5).
...
Please Note:
H2 Programs aren’t able to emulate H1 Tabs, meaning that a section is created for every Assessment header (from the original H1 program). Each Section is named using the following format: Tab name - Header Name.
There’s also a special Section at the bottom of the Assessment Sections in the preview, which contains all the Score Data Elements of the Checklist (see Image 6).
...
Clicking the arrow icon on the far-right will expand the section displaying the Scores structure (see Image 6).
...
Le processus de conversion ne peut être effectué qu'une seule fois par programme H1, assurez-vous que le programme que vous convertissez est dans sa dernière version disponible. |
Conversion d'un programme H1
Après avoir cliqué sur le bouton Conversion au programme HNQIS 2.0 à partir de n'importe quel programme H1, une nouvelle fenêtre s'ouvrira, affichant l'option HNQIS 2.0 Paramètres et un aperçu du nouveau programme qui sera créé (voir image 2).
...
Cette fenêtre affiche le nom du programme sélectionné en haut, suivi de la section Paramètres HNQIS 2.0, qui peut être développée en cliquant sur le bouton icône de flèche situé à l'extrême droite (voir image 3) pour afficher les champs suivants :
Un Sélecteur d'unité d'organisation pour spécifier le pays propriétaire (unité d'organisation racine) de la liste de contrôle (Obligatoire).
A interrupteur pour activer/désactiver l'utilisation des unités d'organisation d'utilisateurs pour créer le programme d'analyse H2.
Deux listes déroulantes pour sélectionner les niveaux d'unité d'organisation pour les visualisations et les cartes dans le tableau de bord du programme H2 (Obligatoire).
A interrupteur pour l'activation ou la désactivation des classes de compétences dans le cadre du programme.
A liste déroulante pour la sélection du domaine de santé du programme (Obligatoire).
| Info |
|---|
Tous les paramètres ci-dessus peuvent être modifiés ultérieurement en éditant le programme si nécessaire. |
...
En plus des paramètres mentionnés, un aperçu de la liste de contrôle convertie est affiché. Chaque bloc représente une section de l'évaluation et affiche le nom de la section et le nombre d'éléments de données qu'elle contient. En cliquant sur le bloc icône de flèche située à l'extrême droite permet de développer la section et d'en afficher le contenu (voir image 5).
...
A noter :
Les programmes H2 ne sont pas en mesure d'émuler les onglets H1, ce qui signifie qu'une section est créée pour chaque en-tête d'évaluation (à partir du programme H1 original). Chaque section est nommée selon le format suivant : Nom de l'onglet - Nom de l'en-tête.
Il existe également une section spéciale au bas des sections d'évaluation dans l'aperçu, qui contient tous les éléments de données de score de la liste de contrôle (voir image 6).
...
En cliquant sur le bouton icône de flèche à l'extrême droite permet de développer la section affichant la structure des partitions (voir image 6).
...
Dans certaines listes de contrôle, vous pouvez remarquer que les scores suivent une séquence comme [ ..., 1.8, 1.9, 1.11, 1.12, … ... ], skipping the number ten (see Image 8). This is due to the way Compositive Indicators (the score number) were used by the original HNQIS App and it won’t represent any issues when converting. However, this will represent an issue later and will require additional changes to the converted Program in order to fix it, this process is detailed in the Steps After Converting a H1 Program page.
...
After checking the result, the Program can be converted by clicking the Convert to HNQIS 2.0 button (see Image 9). This will display a small window with some warnings and specifying that the new Program will keep as many components from the original Program as possible (see Image en sautant le chiffre dix (voir image 8). Ceci est dû à la façon dont les indicateurs composites (le numéro de score) ont été utilisés par l'application HNQIS originale et ne posera pas de problème lors de la conversion. Cependant, cette volonté représente un problème ultérieur et nécessitera des modifications supplémentaires du programme converti afin de le résoudre, ce processus est détaillé dans le document Étapes après la conversion d'un programme H1 page.
...
Après avoir vérifié le résultat, le programme peut être converti en cliquant sur le bouton Convertir en HNQIS 2.0 (voir image 9). Une petite fenêtre s'affiche alors, contenant quelques avertissements et précisant que le nouveau programme conservera autant de composants que possible du programme d'origine (voir image 10).
...
Clicking the Yes, continue button will start the conversion process, indicated by a loading bar (see Image En cliquant sur le bouton Oui, continuer lance le processus de conversion, indiqué par une barre de chargement (voir image 11).
...
Once the process is finished, a notification is displayed and the Programs List is filtered to show both the original and the new versions of the checklist (see Image Une fois le processus terminé, une notification s'affiche et la liste des programmes est filtrée pour afficher la version originale et la nouvelle version de la liste de contrôle (voir image 12). A [HNQIS2] tag will be appended at the beginning of the new Program’s name.
Please Note:
If the process results in an error, the window will display a list of the errors encountered. This will help you fix any errors to retry the process.
...
Please Note:
The new H2 Program will share as many configurations from the original H1 Program as possible, this includes: Organisation Units, Sharing Settings, Program Name, Program Short Name, Program Code, Color and Icon.
A Notification is displayed in the new Program to indicate that the program still hasn’t been built for new data capture, to display the content of the Notification you can place the cursor over the icon (see Image 13).
...
After the process is completed, the option for Convert to HNQIS 2.0 Program will be disabled, indicating that the program has already been converted (see Image 14). This will also enable the Transfer Assessment Data to sera ajoutée au début du nom du nouveau programme.
A noter :
Si le processus aboutit à une erreur, la fenêtre affiche une liste des erreurs rencontrées. Cela vous aidera à corriger les erreurs éventuelles et à réessayer le processus.
...
A noter :
Le nouveau programme H2 partagera autant de configurations que possible avec le programme H1 d'origine : Unités d'organisation, Paramètres de partage, Nom du programme, Nom abrégé du programme, Code du programme, Couleur et Icône.
Une notification est affichée dans le nouveau programme pour indiquer que le programme n'a pas encore été construit pour la saisie de nouvelles données. Pour afficher le contenu de la notification, vous pouvez placer le curseur sur l'icône (voir image 13).
...
À l'issue de la procédure, l'option Conversion au programme HNQIS 2.0 sera désactivée, indiquant que le programme a déjà été converti (voir image 14). Cela permettra également à l'option Transfert des données d'évaluation vers HNQIS 2.0 option.
...
Please NoteA noter :
The H1 Program has been converted to H2, but it still isn’t prepared for new data capture. To enable data capture for the new H2 Programs check Steps After Converting a H1 ProgramLe programme H1 a été converti en programme H2, mais il n'est pas encore prêt pour la nouvelle capture de données. Pour activer la capture de données pour les nouveaux programmes H2, vérifiez les points suivants Étapes après la conversion d'un programme H1.