Aller au contenu

Indicateurs

Les indicateurs sont les mesures de santé que votre instance FASTR suit - par exemple les taux de couverture vaccinale, les taux de complétude des rapports des établissements ou le nombre de consultations externes. Avant de pouvoir analyser des données, vous devez définir quels indicateurs sont pertinents et d’où proviennent leurs données. Cette page traite de la configuration des indicateurs pour les données HMIS et HFA.

Les indicateurs HMIS forment un dictionnaire unique. Chaque indicateur possède un type qui indique ce qui l’alimente : un élément DHIS2 est un dénombrement mensuel que l’importation DHIS2 récupère par son identifiant DHIS2, un indicateur Téléversé est un dénombrement mensuel rempli par importation CSV, une Somme est le total des indicateurs de type Élément DHIS2 ou Téléversé, additionnés par établissement et par mois, et un indicateur Calculé est une formule portant sur d’autres indicateurs et des termes de population. Les trois types de dénombrement sont ajustés par les modules de qualité des données ; un indicateur calculé est calculé à partir de la formule après l’ajustement et l’agrégation des données.

La liste des indicateurs affiche chaque indicateur avec son identifiant, son libellé, son type et ce qui le définit. Un badge Spécial marque les indicateurs que les modules d’analyse lisent par leur nom comme des dénombrements - ceux-ci sont toujours analysés et ne peuvent être qu’un Élément DHIS2, Téléversé ou une Somme.

Pour créer un indicateur, cliquez sur Créer. Donnez-lui un identifiant et un libellé, puis choisissez son type. Le type détermine les champs de définition qui s’affichent.

Pour définir l’ordre de la liste utilisé par chaque axe d’indicateurs dans chaque visualisation, cliquez sur Trier.

Pour voir ce qu’implique chaque type, cliquez sur Types d’indicateurs dans la barre d’en-tête. Pour voir les identifiants d’indicateurs spéciaux, les termes de population et les mots réservés, cliquez sur Indicateurs spéciaux et mots réservés.

Les administrateurs globaux peuvent sélectionner des lignes dans la liste et utiliser l’action groupée Supprimer pour retirer les indicateurs sélectionnés, sous réserve des vérifications de dépendances habituelles. Les indicateurs individuels peuvent également être supprimés depuis l’éditeur d’indicateurs à l’aide du bouton Supprimer dans le pied de page. Les actions groupées Inclure dans l’analyse et Exclure de l’analyse basculent l’indicateur sur les lignes sélectionnées. L’action groupée Importation de données DHIS2 ouvre l’assistant d’importation DHIS2 présélectionné avec les indicateurs choisis.

Depuis le menu de débordement de la barre d’outils, les administrateurs globaux ont également accès à deux actions de maintenance occasionnelles : Télécharger exporte le dictionnaire d’indicateurs au format CSV et Actualiser les noms DHIS2 lit le nom actuel de chaque indicateur élément DHIS2 depuis DHIS2 et le stocke avec l’indicateur. Après l’actualisation, le résultat indique combien de noms ont été actualisés, combien étaient déjà à jour, quels indicateurs pointent vers des formules DHIS2 plutôt que vers des éléments de données, et quels identifiants n’ont pas été trouvés dans DHIS2. Si des indicateurs pointent vers des formules DHIS2 ou des identifiants introuvables, contactez l’équipe FASTR pour exécuter la réparation des identifiants DHIS2, qui corrige les identifiants tout en conservant les données déjà importées.

  • Élément DHIS2 — un dénombrement mensuel récupéré de DHIS2 par un UID d’élément de données ou un opérande UID.COC. Lors de l’enregistrement d’un indicateur élément DHIS2, FASTR interroge DHIS2 pour confirmer que l’identifiant est un élément de données ou un opérande qu’Ajouter depuis DHIS2 accepterait — si DHIS2 ne peut pas confirmer l’identifiant, l’enregistrement est refusé avec une explication du motif. Lors de l’ajout d’un indicateur élément DHIS2, FASTR lit et stocke le nom actuel de l’élément depuis DHIS2 comme nom DHIS2. Le nom DHIS2 n’est pas le libellé de l’indicateur et n’est pas utilisé dans l’analyse.
  • Téléversé — un dénombrement mensuel rempli par importation CSV. FASTR lui attribue un identifiant interne. Les indicateurs de type Téléversé ne sont pas récupérés par les importations DHIS2.
  • Somme — le total de ses indicateurs membres, additionnés par établissement et par mois. Une somme ne peut pas contenir une autre somme.
  • Calculé — une formule portant sur d’autres indicateurs et des termes de population, calculée après l’ajustement et l’agrégation des données. Il n’a pas de lignes propres.

Les trois types de dénombrement sont ajustés par les modules de qualité des données. Un indicateur calculé ne l’est pas.

Un indicateur calculé est défini par une formule portant sur d’autres indicateurs, par exemple anc4 / anc1 pour un taux de couverture. Il est calculé après l’agrégation des données : un chiffre régional ou annuel est donc la formule appliquée aux valeurs additionnées, et non une moyenne de ratios.

Une formule peut utiliser +, -, *, /, des parenthèses et des nombres, des opérateurs de comparaison (==, !=, <, >, <=, >=), des opérateurs logiques (AND, OR, NOT, ou de façon équivalente &, |, !), ainsi que les fonctions abs() (valeur absolue), coalesce() (la première valeur non vide) et nullif() (vide lorsque les deux valeurs sont égales). Une formule peut faire référence à un autre indicateur calculé, dont la définition est insérée à la place de son identifiant.

Une formule peut aussi utiliser un terme de population, par exemple population_pregnancies. Les populations proviennent de la page Population de l’instance.

Pour un indicateur calculé, vous définissez également le format d’affichage (nombre, pourcentage ou taux pour 10 000), une valeur cible facultative, et si vous le souhaitez une règle de mise en forme conditionnelle. Le champ direction s’applique à chaque type d’indicateur.

La colonne Statut de la liste indique si chaque indicateur calculé peut être évalué.

Chaque indicateur possède une case à cocher Inclure dans l’analyse. Lorsqu’elle est cochée, chaque paquet de résultats analyse l’indicateur. Lorsqu’elle est décochée, l’indicateur est uniquement dans le dictionnaire. Les indicateurs spéciaux sont toujours analysés, quelle que soit cette option.

Cliquez sur Ajouter depuis DHIS2 pour ajouter des éléments de données ou des indicateurs DHIS2 depuis votre serveur. FASTR utilise la connexion DHIS2 enregistrée de l’instance ; si aucune n’est enregistrée, une alerte explique comment en définir une.

Le formulaire comporte deux phases. Dans la phase Sélectionner, recherchez par nom, code ou identifiant. Un indicateur DHIS2 est décomposé en ses opérandes et un indicateur calculé dont la formule porte sur les indicateurs que ces opérandes deviennent. Pour les lignes qui ne peuvent pas être importées, aucun bouton d’ajout n’est affiché ; la raison est affichée sous la ligne en texte discret. Sélectionnez les éléments souhaités et cliquez sur Suivant : nommer les indicateurs.

Dans la phase Nommer, chaque élément de données ou opérande devient un nouvel indicateur élément DHIS2. Le formulaire propose un identifiant d’indicateur généré à partir du nom de l’élément ; modifiez-le en ligne. Chaque indicateur DHIS2 devient un indicateur calculé dont vous définissez également l’identifiant ici. Un élément dont l’identifiant DHIS2 est déjà porté par un indicateur existant est affiché comme déjà ajouté et ne crée rien de nouveau. Cliquez sur Enregistrer pour créer les indicateurs en une seule transaction.

Ajouter des indicateurs depuis DHIS2 ne fait que les enregistrer dans le dictionnaire. Pour récupérer leurs données, lancez une importation DHIS2 depuis la vue Importations.

Pourquoi certaines lignes DHIS2 ne peuvent pas être importées

Section intitulée « Pourquoi certaines lignes DHIS2 ne peuvent pas être importées »

La plateforme n’importe que des dénombrements mensuels depuis DHIS2. Un élément de données ou un indicateur DHIS2 qui ne satisfait pas cette exigence est affiché avec une raison sous sa ligne à la place d’un bouton d’ajout. Les raisons les plus courantes sont :

  • L’élément n’est pas un dénombrement mensuel — son type d’agrégation, son type de valeur ou le type de période de son ensemble de données est incompatible.
  • La formule d’un indicateur DHIS2 utilise des fonctions ou des constantes que la plateforme ne lit pas, ou son facteur est différent de 1, 100, 1 000 ou 10 000.
  • Un indicateur DHIS2 est annualisé : DHIS2 convertit chaque mois en taux annuel, ce que la plateforme ne fait pas.
  • Un opérande référencé par la formule n’existe plus dans DHIS2.

Lorsqu’un indicateur DHIS2 est refusé uniquement parce que son dénominateur n’est pas un dénombrement mensuel, le message propose d’ajouter son numérateur comme élément de données à la place, si le numérateur est un élément unique.

Les données issues de l’évaluation des établissements de santé fonctionnent différemment des données HMIS. Les enquêtes HFA ont des structures de questions personnalisées qui varient d’une évaluation à l’autre, c’est pourquoi les indicateurs HFA nécessitent du code pour extraire les valeurs à partir des données d’enquête brutes.

Chaque indicateur HFA possède un identifiant d’indicateur attribué par la plateforme, une catégorie, une sous-catégorie, des catégories de service, un libellé court, une définition, un type de données (binaire ou numérique) et une méthode d’agrégation (somme ou moyenne).

Le champ catégories de service est facultatif et fournit une classification transversale supplémentaire, indépendante de la hiérarchie catégorie/sous-catégorie. Un indicateur peut appartenir à plusieurs catégories de service simultanément.

HFA Indicators

Le gestionnaire d’indicateurs HFA comporte une zone de recherche dans la barre d’outils. Saisissez du texte pour filtrer la liste par libellé, définition, catégorie, sous-catégorie ou catégorie de service. Le tableau prend également en charge des filtres de colonnes.

Chaque indicateur HFA nécessite un code d’indicateur spécifiant comment extraire sa valeur à partir des données d’enquête brutes. Le code s’exécute pour chaque établissement et doit évaluer à oui/non pour les indicateurs binaires, ou à un nombre pour les indicateurs numériques.

Le langage de code des indicateurs prend en charge les opérateurs de comparaison (==, !=, <, >, <=, >=), les opérateurs logiques (AND, OR, NOT, et leurs équivalents symboliques &, |, !), le test de liste x IN (1, 2, 3) (nié sous la forme x NOT IN (1, 2, 3)), l’arithmétique (+, -, *, /) et les nombres. Il n’y a pas de fonctions. Écrivez un indice ou une moyenne sous forme arithmétique, par exemple (a + b + c) / 3.

Les valeurs texte doivent être entre guillemets (p. ex. SH_03 == "c") ; les valeurs numériques s’écrivent sans guillemets (p. ex. SH_03A == 1). Comparez toujours une variable codée à son code numérique plutôt qu’à un libellé entre guillemets — q5 == 1, et non q5 == "yes". Utilisez uniquement les opérateurs pris en charge indiqués dans l’éditeur de code.

L’éditeur de code indique quelles variables d’enquête sont disponibles dans votre jeu de données à chaque point temporel. FASTR valide la syntaxe et signale les variables inconnues comme des erreurs. Il vérifie également si le type de résultat de votre code correspond au type déclaré de l’indicateur.

Les avertissements de type incohérent (affichés en orange) sont consultatifs et ne bloquent pas l’enregistrement. Les erreurs (affichées en rouge) — erreurs de syntaxe et références à des variables introuvables — bloquent l’indicateur.

Le panneau droit de l’éditeur de code liste les variables d’enquête et les autres indicateurs ; cliquez sur n’importe quelle entrée pour insérer son identifiant dans le code à la position du curseur.

Code d'un indicateur HFA

Chaque entrée de code par point temporel prend également en charge un champ de code filtre facultatif. Le code filtre restreint les établissements qui contribuent à la valeur de l’indicateur. Si vous saisissez un code filtre pour un point temporel, vous devez également fournir un code d’indicateur pour ce même point temporel.

La même règle concernant les guillemets s’applique au code filtre : testez toujours positivement pour oui (x == 1, x >= 3) plutôt qu’avec une négation, car un code « ne sait pas » conservé traité comme une valeur satisferait x != 2.

Un indicateur peut être associé à un groupe de variantes, qui définit un ensemble d’options de réponse selon lesquelles l’indicateur peut être désagrégé. Les groupes de variantes et leurs éléments sont gérés depuis l’onglet Groupes de variantes du gestionnaire d’indicateurs HFA.

Le gestionnaire d’indicateurs HFA propose un bouton Vérifier dans la barre d’outils de l’éditeur de code. La vérification soumet le code de l’indicateur au modèle et rapporte les constats — problèmes et avertissements — à côté du champ concerné dans l’éditeur. Sélectionnez un ou plusieurs indicateurs dans le tableau du gestionnaire et utilisez l’action groupée Vérifier pour contrôler un ensemble d’indicateurs à la fois ; sélectionner toutes les lignes filtrées permet également de vérifier tous les indicateurs de la liste.

Une colonne Constats dans la liste des indicateurs affiche le statut de vérification de chaque indicateur : les problèmes s’affichent en rouge, les avertissements en orange, et les indicateurs vérifiés sans constat affichent une note discrète. La colonne est triable et filtrable afin de concentrer l’attention sur les indicateurs nécessitant une intervention.

Depuis l’éditeur de code, cliquez sur Vérifier pour contrôler l’indicateur ouvert, ou sur Proposer une correction pour demander au modèle de suggérer une correction des constats ouverts. La correction proposée s’applique dans l’éditeur comme un brouillon non enregistré — vérifiez les modifications listées dans la bannière, puis cliquez sur Enregistrer pour les conserver ou sur Rejeter pour les annuler. Le bouton de correction est désactivé en présence de modifications non enregistrées, car le modèle prépare la correction à partir de la version enregistrée.

L’option Règles de vérification du menu d’actions du gestionnaire ouvre une fenêtre listant chaque règle. Les règles vérifiées par l’application (syntaxe, variables inconnues, code filtre sans code d’indicateur et problèmes structurels similaires) sont toujours appliquées. Les règles vérifiées par le modèle peuvent être désactivées individuellement — une règle désactivée masque ses constats partout où ils apparaissent ; la réactiver les restaure sans nouvelle vérification.

Les constats peuvent être écartés individuellement depuis l’éditeur de code : cliquez sur Écarter à côté d’un constat pour le masquer. Les constats écartés apparaissent sous forme d’un comptage réduit sous les constats ouverts et peuvent être rétablis via Rétablir.

Lorsqu’un indicateur s’applique à plusieurs points temporels, FASTR vérifie si le code d’extraction est cohérent. Utilisez Tout revalider après avoir effectué des modifications.

La liste des indicateurs affiche un résumé de l’état du code : prêt (aucune erreur), type incohérent (le type de résultat du code ne correspond pas au type déclaré de l’indicateur) et erreur (erreurs de syntaxe ou de variables inconnues). Les boutons Tout revalider, Vérifier les variables inutilisées, Télécharger Excel et Importer Excel sont désactivés lorsqu’aucun point temporel HFA n’est encore défini. Ajoutez un point temporel depuis HFA → Points temporels pour les activer.

Le gestionnaire d’indicateurs HFA comprend un bouton Importer les indicateurs par défaut qui récupère l’ensemble d’indicateurs HFA FASTR standard directement depuis GitHub. Vous choisissez entre Ajouter aux existants et Remplacer tous les existants.

Avant de supprimer un indicateur ou un ensemble d’indicateurs, FASTR vérifie si d’autres indicateurs font référence aux identifiants supprimés dans leur code d’indicateur ou leur code de variante. Si des références sont trouvées, la boîte de dialogue de confirmation liste les indicateurs concernés et avertit que leur code échouera à la validation après la suppression. Vous pouvez supprimer un indicateur individuel depuis son éditeur de code à l’aide du bouton Supprimer dans l’en-tête, ou depuis la boîte de dialogue de modification via le bouton Supprimer dans le pied de page. Plusieurs indicateurs peuvent être supprimés simultanément à l’aide de l’action groupée dans la liste des indicateurs.

L’assistant IA dans le gestionnaire d’indicateurs HFA peut améliorer les libellés, organiser les indicateurs en catégories et créer de nouveaux indicateurs à partir du jeu de données d’enquête. Il lit et écrit les indicateurs via un ensemble d’outils dédiés, en validant le code des indicateurs par rapport au dictionnaire de données et en affichant une boîte de dialogue de confirmation avec une vue diff côte à côte avant d’appliquer toute modification. La vue diff met en évidence exactement ce qui a changé et réduit les sections inchangées, ce qui facilite la révision d’un lot de nombreux indicateurs à la fois. Lors de l’application de mises à jour groupées, toutes les modifications sont envoyées au serveur en une seule opération transactionnelle.

L’éditeur de code possède également ses propres outils IA. Lorsque vous ouvrez l’éditeur de code d’un indicateur, l’assistant peut lire le brouillon actuel de l’éditeur et y appliquer des modifications — libellés, type et agrégation, assignations de catégories, et modifications de code par round — comme si vous les aviez effectuées vous-même. Les modifications s’appliquent dans le brouillon de l’éditeur sans être enregistrées : vous les conservez avec Enregistrer ou les annulez avec Annuler.

Cliquez sur Vérifier les variables inutilisées depuis le menu de débordement pour ouvrir une fenêtre listant les variables d’enquête qu’aucun indicateur ne référence actuellement, regroupées par point temporel. Les variables structurelles utilisées en interne par l’analyse sont exclues de cette liste.

Les catégories de service sont créées et gérées depuis l’onglet Catégories de service du gestionnaire d’indicateurs HFA. Les identifiants de catégorie de service ne peuvent pas contenir le caractère pipe (|).

Les groupes de variantes sont créés et gérés depuis l’onglet Groupes de variantes du gestionnaire d’indicateurs HFA. L’onglet affiche une disposition en deux panneaux : les groupes à gauche et les éléments du groupe sélectionné à droite.

Les indicateurs HFA prennent en charge la création par lot via un classeur Excel. Téléversez un classeur Excel (.xlsx) avec les feuilles suivantes :

  • Categories : id, label
  • Sub-categories : id, categoryId, label
  • Service categories : id, label (facultatif)
  • Variant groups : id, label (facultatif)
  • Variant items : id, groupId, label (facultatif)
  • Indicators : indicatorId (laisser vide pour un nouvel indicateur ; la plateforme en attribue un), categoryId, subCategoryId, serviceCategoryId (séparés par | pour plusieurs), shortLabel, label, type, aggregation, variantGroupId (facultatif), code__<point temporel> et filter_code__<point temporel> (facultatif) pour chaque point temporel, variant_code__<itemId>__<point temporel> (facultatif) pour chaque élément de variante et chaque point temporel

Les colonnes de texte telles que label et shortLabel peuvent également être fournies par langue à l’aide de noms de colonnes suffixés : label_en, label_fr et label_pt. Lorsque des colonnes par langue sont présentes, l’importation lit la colonne correspondant à la langue de l’instance et se rabat sur l’anglais si cette colonne est vide ou absente. Cela permet à un seul classeur de servir toutes les instances, quelle que soit leur langue configurée.

Si les feuilles Service categories, Variant groups ou Variant items sont omises, les indicateurs sont importés sans catégories de service ni assignations de variantes.

Les colonnes de code de variante utilisent le format variant_code__<itemId>__<point temporel>. Chaque colonne de code de variante doit référencer un identifiant d’élément de la feuille Variant items, et la feuille Indicators doit aussi contenir une colonne code__ pour le même point temporel. Un indicateur avec un code de variante doit également avoir un variantGroupId correspondant au groupe de l’élément. Si la feuille Indicators contient une colonne qui n’est pas décrite ci-dessus, l’importation s’arrête et le message d’erreur indique le nom de cette colonne. L’importation s’arrête aussi si une colonne filter_code__ n’a pas de colonne code__ pour le même point temporel.

Lors de l’importation, choisissez entre les modes Ajouter aux existants et Remplacer tous les existants. En mode Ajouter aux existants, les indicateurs dont les identifiants existent déjà sur la plateforme sont ignorés — seuls les nouveaux sont créés. Après l’importation, un résumé liste les indicateurs ignorés. En mode Remplacer tous les existants, tous les indicateurs, catégories, sous-catégories et catégories de service existants sont définitivement supprimés avant l’importation. Pour confirmer une importation de remplacement complet, vous devez saisir la phrase de confirmation affichée dans le champ avant que le bouton Importer devienne actif.

FASTR détecte les colonnes de points temporels intégrées dans le fichier et présente une étape de correspondance dans laquelle vous confirmez à quel point temporel de la plateforme chaque colonne doit être importée. Si les libellés des colonnes correspondent exactement à vos points temporels de plateforme, la correspondance est pré-remplie automatiquement. Chaque point temporel de la plateforme peut recevoir au plus une colonne du classeur. Lorsque le classeur n’a qu’une seule colonne de code, vous pouvez l’appliquer à tous les points temporels en choisissant Appliquer aux N points temporels, où N est le nombre de points temporels.

Si le classeur contient une colonne que l’importation ne reconnaît pas — par exemple une colonne au format ancien r_code__ — l’importation est refusée et la colonne inconnue est nommée dans le message d’erreur. Cela empêche qu’une colonne de code mal nommée importe silencieusement des indicateurs sans code.

Lorsque FASTR lit votre questionnaire XLSForm lors d’une importation HFA, il construit les libellés des variables à partir de la structure de l’enquête. Pour les variables contenues dans des groupes de questions matricielles, FASTR qualifie le libellé avec celui du groupe immédiatement englobant, séparé par « — ».

FASTR supprime également les balises HTML et normalise les espaces dans les libellés XLSForm avant de les stocker.

Choisissez des identifiants d’indicateurs courts mais descriptifs. Évitez les espaces et les caractères spéciaux - tenez-vous-en aux lettres minuscules, aux chiffres et aux tirets bas.

Vérifiez les identifiants DHIS2 dans la liste lorsque des éléments de données sont modifiés ou remplacés sur le serveur DHIS2. Utilisez Actualiser les noms DHIS2 régulièrement pour maintenir les noms DHIS2 stockés à jour. Si l’actualisation révèle des indicateurs pointant vers des formules DHIS2 ou des identifiants introuvables, contactez l’équipe FASTR pour exécuter la réparation des identifiants DHIS2. La réparation corrige les identifiants DHIS2 sous-jacents — y compris les identifiants pointant vers des formules DHIS2 plutôt que vers des éléments de données, les identifiants ne correspondant à rien dans DHIS2, et les cas où un opérande UID.COC avec une combo de catégorie par défaut duplique l’élément nu — tout en conservant les données déjà importées. Après la réparation, une importation DHIS2 de suivi récupère à nouveau les données pour les indicateurs concernés.