Custom Program Rules

The PCA currently does not support In-app creation of custom Program Rules, meaning that the standard Program Rules management in the DHIS2 Maintenance App is required for this. However, the custom Program Rules are displayed in the PCA as described in the Checking Existing Program Rules page.

H2 Program Rules Generated by the PCA

If the HNQIS2 Metadata Package has been installed in the server, the PCA will enable the H2 features. These features allow the creation and modification of H2 Programs, enabling access to other features like the Import/Export of Excel Templates, and the Set Up of H2 Logic and Analytics (see Image 1).

...

The Excel Template is the main way to define Program Logic in H2 Assessments, allowing for easy configuration of Parent Questions (Hide/Show logic), label creation, scoring calculations, and
much more (see Image 2). You can check how to use the Excel Template here.

...

After importing the Excel Template with the desired changes, the Program Rules can be generated by using the Set Up Program button.

Parent Logic - Hide/Show Rules

A Parent Question displays more questions if a specific answer is given, this means that some questions can be hidden from the Assessment until the Parent Question has one specific value. This is useful for displaying questions related to another question, for example:

• Is the test result positive? (Parent Question - Yes/No)

  • If yes, Was the necessary medication administered? (Show if answer is Yes)

  • If no, Are the test results recent? (Show if answer is No)

...

Règles du programme personnalisé

Actuellement, l'ACP ne prend pas en charge la création de règles de programme personnalisées dans l'application, ce qui signifie que la gestion standard des règles de programme dans l'application de maintenance DHIS2 est nécessaire pour cela. Cependant, les règles de programme personnalisées sont affichées dans l'ACP comme décrit dans la section Vérification des règles de programme existantes page.

Règles du programme H2 générées par l'APC

Si le Paquet de métadonnées HNQIS2 a été installé sur le serveur, l'APC activera les fonctions H2. Ces fonctions permettent de créer et de modifier des programmes H2, d'accéder à d'autres fonctions telles que l'importation/exportation de modèles Excel et la configuration de la logique et de l'analyse H2 (voir l'image 1).

...

Le modèle Excel est le principal moyen de définir la logique du programme dans les évaluations H2. Il permet de configurer facilement les questions destinées aux parents (logique de masquage/affichage), de créer des étiquettes, de calculer les scores et d'effectuer des calculs.
bien d'autres choses encore (voir image 2). Vous pouvez vérifier comment utiliser le modèle Excel ici.

...

Après avoir importé le modèle Excel avec les modifications souhaitées, les règles du programme peuvent être générées à l'aide de la fonction Programme de mise en place bouton.

...

Logique parentale - Cacher/montrer les règles

Une question parentale affiche d'autres questions si une réponse spécifique est donnée, ce qui signifie que certaines questions peuvent être cachées de l'évaluation jusqu'à ce que la question parentale ait une valeur spécifique. Ceci est utile pour afficher des questions liées à une autre question, par exemple :

• Le résultat du test est-il positif ? (Question des parents - Oui/Non)

  • Si oui, les médicaments nécessaires ont-ils été administrés ? (Montrer si la réponse est oui)

  • Si non, les résultats des tests sont-ils récents ? (Montrer si la réponse est non)

Les règles de masquage sont générées par l'APC lorsque les règles de masquage sont appliquées. Question des parents et Valeur de la réponse sont configurées (voir image 2). Cela se traduit par des règles de programme nommées selon la structure suivante :

...

Les règles de programme qui en résultent dans DHIS2 suivront la convention de dénomination précédente (voir image 3). Les règles générées par l'ACP sont étiquetées comme suit Scénarisé dans les configurations afin que l'application puisse différencier les règles de programme personnalisées et automatisées (voir image 4).

...

...

La logique de ces règles de programme est "inversée" car le DHIS2 ne peut que Cacher Questions. Cela signifie que si la règle est "Afficher les questions lorsque la réponse est 1", la logique sera la suivante : ".Cacher Questions dont la réponse est pas 1" (voir images 5 et 6).

...

...

Cas particulier :

...

Questions obligatoires sur les enfants

Mandatory Les questions in DHIS2 represent a problem when these are hidden by a Parent Question. DHIS2 always displays mandatory questions, this means that a Child Question cannot be mandatory directly, or else the question will be shown even if the Parent hasn’t been answered.To circumvent this issue, Mandatory Child Questions aren’t mandatory by default, that is why the PCA also generates Program Rules for making questions mandatory (see Image 7). These rules are named following the obligatoires dans DHIS2 posent un problème lorsqu'elles sont masquées par une question parentale. DHIS2 affiche toujours les questions obligatoires, ce qui signifie qu'une question enfant ne peut pas être directement obligatoire, sinon la question sera affichée même si le parent n'a pas répondu.

Pour contourner ce problème, les questions obligatoires pour les enfants ne sont pas obligatoires par défaut, c'est pourquoi l'APC génère également des règles de programme pour rendre les questions obligatoires (voir l'image 7). Ces règles sont nommées en suivant la structure :

...

The configuration is mostly the same as the Hide/Show Program Rules, basically only changing the Program Rule Name and the Program Rule Actions (see Images 8 and La configuration est essentiellement la même que pour les règles de programme Cacher/Afficher, il suffit de modifier le nom et les actions de la règle de programme (voir images 8 et 9).

...

Also De même, the condition would be the same as the Hide/Show rules without inverting the logic (see Image la condition serait la même que pour les règles Cacher/Afficher sans inverser la logique (voir image 10).

...

With that new set of Program Rules, Mandatory Child Questions are no longer an issue.

H2 Scoring Program Rules

In H2, any numeric type question can contribute to the scoring process of an Assessment. By numeric question we refer to any question with a DHIS2 Value Type of Number, Integer, Positive Integer, etc. This includes questions limited to the options contained in an Option Set (requiring the Option Set to be of numeric type).

A numeric question can contribute to a score if the question Numerator, Denominator and Feedback Order are defined (see Images 11 and 12). Lacking any of the previous configurations means that the question doesn’t contribute to any Avec ce nouvel ensemble de règles de programme, les questions obligatoires sur les enfants ne sont plus un problème.

...

Règlement du programme de notation H2

Dans H2, toute question de type numérique peut contribuer au processus de notation d'une évaluation. Par question numérique, nous entendons toute question dont le type de valeur DHIS2 est un nombre, un entier, un entier positif, etc. Cela inclut les questions limitées aux options contenues dans un ensemble d'options (exigeant que l'ensemble d'options soit de type numérique).

Une question numérique peut contribuer à un score si le numérateur, le dénominateur et l'ordre de rétroaction de la question sont définis (voir images 11 et 12). L'absence de l'une des configurations précédentes signifie que la question ne contribue à aucun score.

...

Critical Score

The Critical Score is calculated by using all the Critical Questions answered in the Assessment. This means that if a question has been left unanswered, it won’t be taken into account for the Critical Score Calculation.

The PCA generates a Program Rule named PR - Calculated - Critical Questions that operates the Numerator, Denominator and Answer Value of all the answered Critical Questions in the Assessment (see Image 13).

...

Then, it generates another Program Rule named PR - Score - Critical Questions (%) that stores the value into a Data Element named Critical Steps located in the Critical Steps Calculations section (see Image 14).

...

Score critique

La note critique est calculée en utilisant toutes les questions critiques auxquelles l'évaluation a répondu. Cela signifie que si une question est restée sans réponse, elle ne sera pas prise en compte dans le calcul de la note critique.

L'APC génère une règle de programme nommée PR - Calculée - Questions critiques qui exploite le numérateur, le dénominateur et la valeur de réponse de toutes les questions critiques auxquelles il a été répondu dans l'évaluation (voir image 13).

...

Il génère ensuite une autre règle de programme nommée PR - Score - Questions critiques (%) qui stocke la valeur dans un élément de données nommé Étapes critiques situé dans le Calculs des étapes critiques (voir image 14).

...

Cela signifie que deux règles de programme sont utilisées pour ce processus :

The first one being used for calculating and debugging, and the second one being used to present the result to the supervisor during the Assessment.

Non-critical Score

Similarily the Non-critical Score is calculated by using all the Non-critical Questions answered in the Assessment.

The PCA generates a Program Rule named PR - Calculated - Non-Critical Questions that operates the Numerator, Denominator and Answer Value of all the answered Non-critical Questions in the Assessment (see Image 15).

...

Then, it generates another Program Rule named PR - Score - Non-Critical Questions (%) that stores the value into a Data Element named Non-critical Steps located in the Critical Steps Calculations section (see Image 16).

...

Meaning that two Program Rules are used for this processLe premier est utilisé pour le calcul et le débogage, et le second pour présenter le résultat au superviseur lors de l'évaluation.

Score non critique

De même, le score non critique est calculé en utilisant toutes les questions non critiques auxquelles il a été répondu dans l'évaluation.

L'APC génère une règle de programme nommée PR - Calculée - Questions non critiques qui exploite le numérateur, le dénominateur et la valeur de réponse de toutes les questions non critiques auxquelles il a été répondu dans l'évaluation (voir image 15).

...

Il génère ensuite une autre règle de programme nommée PR - Score - Questions non critiques (%) qui stocke la valeur dans un élément de données nommé Étapes non critiques situé dans le Calculs des étapes critiques (voir image 16).

...

Cela signifie que deux règles de programme sont utilisées pour ce processus :

The first one being used for calculating and debugging, and the second one being used to present the result to the supervisor during the Assessment.

Competency Class

If a H2 Program has been configured to include Competency Classes, the PCA will also generate five additional Program Rules to handle the Competency Class definition and assignment (see Image 17).

...

Three of the rules are used to define the Competency Class and assign it to the Competency Class Data Element located in the Critical Steps Calculations section. The rules are named as followsLe premier est utilisé pour le calcul et le débogage, et le second pour présenter le résultat au superviseur lors de l'évaluation.

Classe de compétence

Si un programme H2 a été configuré pour inclure des classes de compétences, l'APC génère également cinq règles de programme supplémentaires pour gérer la définition et l'affectation des classes de compétences (voir image 17).

...

Trois de ces règles sont utilisées pour définir la classe de compétence et l'attribuer au Classe de compétence Élément de données situé dans le Calculs des étapes critiques section. Les règles sont nommées comme suit :

To learn more about the contents of these Program Rules please refer to the H2 Competency Classes page.

Another Program Rule is generated to assign the value stored in the Competency Class Data Element into the Competency Class Attribute of the Tracked Entity Instance (see Image 18).

...

Pour en savoir plus sur le contenu des règles du programme, veuillez vous référer à la page Classes de compétence H2 page.

Une autre règle de programme est générée pour affecter la valeur stockée dans l'élément de données de la classe de compétence à l'élément de données de la classe de compétence. Classe de compétence Attribut de l'instance d'entité suivie (voir image 18).

...

La règle est nommée comme suit :

...

Ensuite, l'ACP génère une autre règle de programme pour masquer la note globale et les attributs de classe de compétence de l'instance d'entité suivie si les notes critiques et non critiques ne sont pas définies. La règle est nommée comme suit :

If a H2 Program hasn’t been configured to use Competency Classes, the previous Program Rule will be generated to hide only the Global Score Attribute, and will be named as followsSi un programme H2 n'a pas été configuré pour utiliser des classes de compétences, la règle de programme précédente sera générée pour masquer uniquement l'attribut de score global et sera nommée comme suit :

Overall Score

The Overall Score isn’t a calculation like the Critical and Non-critical Scores, it is basically a copy of the value contained in the Critical Steps or Non-critical Steps.

Basically, if the Assessment contains Critical Questions, the Overall Score is the same as the Critical Score. On the other hand, If the Assessment doesn’t have a single Critical Question, the Overall Score is the same as the Non-critical Score instead.

...

Note globale

La note globale n'est pas un calcul comme les notes critiques et non critiques, mais une copie de la valeur contenue dans les étapes critiques ou non critiques.

En principe, si l'évaluation contient des questions critiques, la note globale est la même que la note critique. En revanche, si l'évaluation ne comporte aucune question critique, la note globale est la même que la note non critique.

La règle de programme générée par l'ACP est nommée comme suit :

...

Cette règle affecte la valeur des étapes critiques ou des étapes non critiques à l'attribut Global Score de l'instance d'entité suivie (voir image 19).

...

...

Score

...

The Compositive Scores are scores that group questions by using the Feedback Order, for example, Compositive Score 1 is calculated using every question or Sub-score derived from the Score 1, which means that:

...

composite

Les scores composites sont des scores qui regroupent les questions en utilisant l'ordre de rétroaction. Par exemple, le score composite 1 est calculé en utilisant chaque question ou sous-score dérivé du score 1, ce qui signifie que

1. S'il existe d'autres sous-scores comme 1.1, 1.2, 1.3

...

1. et ainsi de suite, les questions contenues dans ces scores seront utilisées pour calculer le score 1.

2. S'il n'y a que des questions avec un ordre de rétroaction 1.1, 1.2, 1.3

...

1. et ainsi de suite, elles sont utilisées pour calculer directement le score 1.

2. Une note partielle ne peut pas être groupée avec d'autres questions du même niveau, par exemple : il ne peut pas y avoir une note partielle 1.1 et les questions 1.2, 1.3, 1.4

...

1. , etc. En revanche, une note partielle 1.1

...

1. peut contenir les questions 1.1.1, 1.1.2, 1.1.3

...

1. , etc.

The PCA will generate all the necessary Score Calculations Program Rules by using the Feedback Order, Score Numerator and Denominator and Answer Value of each answered question (see Images 20 and 21). This means that if a question has been left unanswered, it won’t be taken into account for the Score Calculation.

...

L'APC génère toutes les règles du programme de calcul des scores nécessaires en utilisant l'ordre des réponses, le numérateur et le dénominateur du score et la valeur de la réponse de chaque question à laquelle il a été répondu (voir images 20 et 21). Cela signifie que si une question est restée sans réponse, elle ne sera pas prise en compte dans le calcul du score.

...

Ces règles de calcul sont nommées comme suit :

...

Ensuite, une autre règle de programme est générée pour chaque score, utilisée pour arrondir le score calculé et le stocker dans un élément de données présent dans l'évaluation (voir images 22 et 23).

...

These rules are named as followingCes règles sont nommées comme suit :

You will notice that most of the Program Rules generated by the PCA are Score related, this is due to the fact that each Score needs two rules (one to perform the calculation and another to round and display).

Program Rule Variables

The PCA uses Program Rule Variables to reference Data Elements contained in the Assessment, and also to store temporary Calculated Values such as Scores (see Image 24).

...

Similarily to the Program Rules, the variables are identified as scripted when the variable name starts with a underscore (_). The Variables follow some naming conventions:

• Calculated Values

...

Vous remarquerez que la plupart des règles de programme générées par l'ACP sont liées au score, ce qui est dû au fait que chaque score nécessite deux règles (une pour effectuer le calcul et une autre pour l'arrondir et l'afficher).

...

Variables de la règle de programme

L'ACP utilise des variables de règles de programme pour référencer les éléments de données contenus dans l'évaluation et pour stocker des valeurs calculées temporaires telles que les scores (voir image 24).

...

Comme pour les règles du programme, les variables sont identifiées comme suit scénarisé lorsque le nom de la variable commence par un trait de soulignement (_). Les variables suivent certaines conventions d'appellation :

• Valeurs calculées

• Scores composites (variation des valeurs calculées)

...

• Questions de l'évaluation

...

• Compétence

• Critical Score critique

• Non-critical Score non critique