Le circuit des données

Toutes les valeurs d'indicateurs de la PNISAN suivent le même circuit, quelle que soit leur voie d'entrée : aucune interface n'écrit directement dans la table des valeurs publiées. Cette page décrit les canaux d'entrée, la zone de transit, les contrôles appliqués, la validation à plusieurs niveaux et les règles de publication. Elle aide chacun à comprendre pourquoi une valeur saisie ou importée n'apparaît pas tout de suite sur le portail.

Vue d'ensemble #

Les canaux d'entrée #

La console d'ingestion distingue six canaux, avec ces libellés exacts.

Saisie web et mobile hors ligne #

Le saisisseur ouvre un formulaire publié, l'enregistre en brouillon (Enregistrer le brouillon) ou le soumet (Soumettre pour validation). Sans réseau, la saisie reste sur l'appareil, dans la Boîte d'envoi, et part automatiquement au retour de la connexion. Si une soumission existe déjà pour le même formulaire, le même territoire et la même période, l'appareil signale un Conflit à examiner et propose de comparer avant de renvoyer.

Import de fichiers #

L'assistant d'import compte quatre étapes : choix du fichier, correspondance des colonnes, rapport de vérification, confirmation. Le point focal provincial passe par Mes dépôts, où il télécharge un modèle pré-rempli pour sa province et son année : seules les colonnes valeur et effectif sont à remplir. Au-delà de 500 lignes, le traitement part en file d'attente et une notification prévient de la fin.

API entrante HMAC #

Un système sectoriel reçoit une clé (identifiant public et secret) émise dans la console, écran Clés d'accès applicatif. Chaque requête est signée ; un lot compte 500 valeurs au plus. Le détail figure dans Interface de programmation.

Connecteur DHIS2 #

Le connecteur interroge l'instance DHIS2 nationale pour les éléments de données et les unités d'organisation mis en correspondance avec les indicateurs et les provinces. Il fonctionne en mode Simulation tant qu'aucune instance réelle n'est configurée : un jeu de démonstration parcourt alors le circuit jusqu'à la zone de transit.

Sources ouvertes vérifiées #

Les séries nationales publiées par des sources internationales vérifiées sont collectées automatiquement si le paramètre de collecte programmée est actif (désactivé par défaut). Une seule série est active par indicateur ; les valeurs d'enquêtes nationales (ENSNMB, EDS) diffusées par l'UNICEF priment sur les estimations modélisées.

La zone de transit #

Chaque envoi, quel que soit son canal, crée d'abord une ingestion dans la zone de transit (staging). Elle conserve la charge brute reçue, le canal, l'auteur ou la clé émettrice, l'empreinte du fichier, les correspondances de colonnes, le nombre de lignes reçues, valides, en erreur et signalées.

Un fichier déjà déposé est reconnu à son empreinte : l'assistant l'annonce (Ce fichier a déjà été déposé sur la plateforme.) avec la date et l'auteur du dépôt précédent.

Normalisation #

• Indicateur : reconnu par son code du référentiel (par exemple NUT-01), sans tenir compte de la casse. Aucun rapprochement approximatif n'est tenté.
• Territoire : reconnu par code d'abord (code d'ancienne province comme BI-GI, P-code d'une nouvelle province ou d'une commune, code ISIBU), puis par nom sans accents ni casse. Un nom d'ancienne province désigne l'ancienne province. Les mots national, burundi, BDI ou une cellule vide donnent une valeur nationale.
• Période : la date de début est obligatoire ; sans date de fin, la fin du mois de début est retenue.
• Nombres : point ou virgule décimale acceptés ; encodages Windows-1252 et ISO-8859-1 convertis en UTF-8.

Contrôles qualité et score #

L'import est toujours partiel : les lignes valides passent, les autres sont conservées dans un Rapport d'erreurs téléchargeable. Le Score de qualité d'une ingestion est la part de lignes exploitables, en pourcentage : 18 lignes valides sur 20 donnent 90.

Arbitrage des sources #

Si une valeur existe déjà pour la même série (même indicateur, territoire, période et désagrégation), la plateforme décide en un seul endroit :

• une valeur rejetée peut toujours être remplacée ;
• une valeur validée au niveau national ne cède qu'à une confirmation explicite et motivée ;
• une valeur validée au niveau provincial ne cède pas à une source moins bien classée ;
• entre valeurs non validées, la source la mieux classée l'emporte, et à rang égal la plus récente.

Le classement par défaut est : saisie manuelle, collecte de terrain, import de fichier, DHIS2, interface applicative, source ouverte. Un indicateur peut déclarer une source faisant autorité, qui passe alors en tête. Les écritures refusées sont consignées dans l'écran Conflits de source de la console.

Validation multi-niveaux #

Un rejet exige un motif, transmis à l'auteur et conservé dans la piste d'audit. Une valeur nationale (non rattachée à une province) passe directement à la validation nationale. Le paramètre Validation à deux niveaux peut être désactivé par un administrateur : une approbation provinciale vaut alors validation finale.

Publication et seuil de masquage #

Seules les valeurs au statut « Validé au niveau national » alimentent le portail public, les fichiers CSV publics, les exports et les bulletins. Le seuil de masquage des petits effectifs, 25 par défaut, s'applique à tout ce qui sort de la plateforme :

• sur le portail, une valeur dont l'effectif est inférieur au seuil s'affiche comme Valeur masquée (petit effectif) ;
• dans les exports de valeurs, la ligne reste, la cellule de valeur est vide et une colonne d'observation porte le motif ;
• une valeur sans effectif déclaré reste diffusable, mais elle n'entre dans aucune moyenne pondérée.

Le seuil ne s'applique jamais aux écrans de l'espace de travail ni à la console : les agents autorisés voient la donnée entière.

Pour aller plus loin #

• Sources par valeur et copies hébergées
• Notions clés à connaître
• Ingestion et import de fichiers
• Circuit de validation