Versions Compared

Key

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

The content of this page describes the steps that must be followed to enable data capture in converted H1 Programs. To proceed with this guide, ensure that you’ve already converted an H1 Program to H2 using the Metadata Conversion guide.

Please Note:

The steps described in this guide can be followed before or after the Data Transfer process, you’re not required to Set Up the H2 Program logic to transfer old Assessments Data.

After Converting the Metadata from the original H1 Program to the new H2 version, some changes may be required before being able to generate the Checklist Program Rules and Analytical Objects. Some Checklists may not require any additional tweaking, but this won’t always be the case.

Checking the Assessment Structure

In some cases you may want to change the order of the Sections generated by the Conversion, this can be done by simply dragging and dropping any Section in the Assessment Stage.

In some other cases you may want to remove completely one specific Section, you can also do that by clicking the three-dot menu at the far-right of every Section and the selecting Delete This Section (see Image 1).

...

Please Note:

Every tool from the PCA is available to be used in any converted H1 Program, there’s no distinction between native H2 Programs and converted H1 Programs.

Fixing Conversion Issues

...

Le contenu de cette page décrit les étapes à suivre pour activer la capture de données dans les programmes H1 convertis. Pour continuer avec ce guide, assurez-vous que vous avez déjà converti un programme H1 en programme H2 à l'aide de la fonction Guide de conversion des métadonnées.

A noter :

Les étapes décrites dans ce guide peuvent être suivies avant ou après le processus de transfert des données. Il n'est pas nécessaire de configurer la logique du programme H2 pour transférer d'anciennes données d'évaluation.

Après avoir converti les métadonnées du programme H1 d'origine dans la nouvelle version H2, certaines modifications peuvent être nécessaires avant de pouvoir générer les règles du programme de listes de contrôle et les objets analytiques. Certaines listes de contrôle peuvent ne pas nécessiter de modifications supplémentaires, mais ce n'est pas toujours le cas.

Vérification de la structure de l'évaluation

Dans certains cas, vous pouvez souhaiter modifier l'ordre des sections générées par la conversion. Pour ce faire, il vous suffit de glisser-déposer n'importe quelle section dans la phase d'évaluation.

Dans d'autres cas, vous souhaiterez peut-être supprimer complètement une section spécifique. Pour ce faire, cliquez sur le menu à trois points situé à l'extrême droite de chaque section et sélectionnez Supprimer cette section (voir image 1).

...

A noter :

Tous les outils de l'APC peuvent être utilisés dans n'importe quel programme H1 converti. Il n'y a pas de distinction entre les programmes H2 natifs et les programmes H1 convertis.

Corriger les problèmes de conversion

Presque tous les problèmes surviennent au cours du processus de validation dans la phase d'évaluation du programme H2. La plupart des problèmes sont liés à la longueur des questions ou à des lacunes dans l'ordre du feedback (voir image 2).

...

Info

In H1, the equivalent to the Feedback Order is the Compositive Indicator.

...

En H1, l'équivalent de l'ordre de rétroaction est l'indicateur composite.

La résolution des erreurs est relativement simple : lisez d'abord l'erreur, puis résolvez-la. Dans certains cas, l'erreur peut être résolue en reformulant les questions afin de réduire la longueur du texte. Dans d'autres cas, l'erreur nécessite de modifier tous les ordres de rétroaction d'un ensemble de questions afin de supprimer les lacunes dans l'ordre de rétroaction. La section Erreurs de validation peut être développée en cliquant sur le bouton icône de flèche à l'extrême droite pour afficher les détails de l'erreur (voir image 3).

...

Tip

Errors related to Feedback Order gaps are easier to fix by using the Excel Template of the Program.

The program depicted in Image 3 contains a Feedback Order gap, as shown in the Metadata Conversion step (see Image 4). Fixing that gap will generate more gaps that will also need to be fixed, this is a common issue when converting H1 Programs to H2.

...

Most of the errors can be fixed by editing the Data Elements in the checklist using all the available features of the PCA. The fastest way to change Data Elements in bulk is by using the Excel Template.

The Feedback Order Gap must be fixed in the Score Data Element, and then all the Data Elements that contributed to that Score must be remapped (see Images 5 and 6).

...

This process has to be repeated until no more Feedback Order gaps are present in the Checklist.

...

Other Unusual Conversion Issues

  • In some older programs, Non-Critical questions do not have scores, legend, and parent questions assigned (compare with the H1 program to know if any parent questions are missing).

  • Labels are sometimes marked as Critical Questions and Compulsory. Check those fields are marked as ‘No’ and the Value Type is defined as ‘LONG_TEXT’. Also, check they do not have an Option Set assigned.

  • If the tab header text in the H1 is too long, this can cause errors when converting because the PCA appends the header text with the section name. The error will appear if the resulting text length is more or equal to 200 characters.

Building Program

After fixing any Validation Errors that may have occurred, you can proceed with the Validation and Setup steps (see Image 7).

...

Les erreurs liées aux écarts de l'ordre de retour d'information sont plus faciles à corriger en utilisant la fonction Modèle Excel du programme.

Le programme illustré dans l'image 3 contient une lacune dans l'ordre de retour d'information, comme le montre l'étape de conversion des métadonnées (voir l'image 4). La correction de cette lacune entraînera d'autres lacunes qui devront également être corrigées. Il s'agit d'un problème courant lors de la conversion de programmes H1 en programmes H2.

...

La plupart des erreurs peuvent être corrigées en modifiant les éléments de données de la liste de contrôle à l'aide de toutes les fonctionnalités disponibles de l'ACP. Le moyen le plus rapide de modifier les éléments de données en masse est d'utiliser le modèle Excel.

L'écart de l'ordre de rétroaction doit être corrigé dans l'élément de données du score, puis tous les éléments de données qui ont contribué à ce score doivent être remappés (voir les images 5 et 6).

...

Ce processus doit être répété jusqu'à ce qu'il n'y ait plus de lacunes dans la liste de contrôle.

Après avoir corrigé toutes les autres erreurs de validation (en utilisant l'ACP, l'application de maintenance ou en important un modèle Excel), Valider et sauvegarder vos modifications pour activer le Programme de mise en placebouton.

Autres problèmes de conversion inhabituels

  • Dans certains programmes plus anciens, les questions non critiques ne sont pas assorties de scores, de légendes et de questions aux parents (comparez avec le programme H1 pour savoir s'il manque des questions aux parents).

  • Les étiquettes sont parfois marquées comme questions critiques et obligatoires. Vérifiez que ces champs sont marqués comme "Non" et que le type de valeur est défini comme "LONG_TEXT". Vérifiez également qu'aucun jeu d'options ne leur est attribué.

  • Si le texte de l'en-tête de tabulation dans le H1 est trop long, cela peut entraîner des erreurs lors de la conversion, car l'APC ajoute le texte de l'en-tête au nom de la section. L'erreur apparaîtra si la longueur du texte résultant est supérieure ou égale à 200 caractères.

Programme de construction

Après avoir corrigé les éventuelles erreurs de validation, vous pouvez passer aux étapes de validation et de configuration (voir image 7).

...

Si la procédure de configuration est réussie (voir image 8), le programme est maintenant prêt à être utilisé dans l'application de capture du traceur DHIS2 et dans l'application de capture Android.

...