Messages structurés (paludisme)
Lire des messages comme NTF TRG.MA.NC.5 avec une échelle de motifs.
La plupart des signaux Impuruza sont un code unique, comme MS03. Les signalements de paludisme sont différents : un SMS porte un déclencheur et parfois un nombre, comme NTF TRG.MA.NC.5 (cinq cas de paludisme), NTF TRG.SO (rupture de stock) ou NTF TRG.RSO (risque de rupture). Un flux les lit avec la grammaire Échelle de motifs (Pattern ladder).
Comment un message est lu
Le message est vérifié partie par partie, comme on monte une échelle :
- le premier mot (
NTF) ; - la section (
TRG), reliée au reste par le séparateur (.) ; - le déclencheur (
MA,SO,RSO) ; - les paramètres du déclencheur, dans l'ordre : un mot et un nombre entier d'au moins 1 (
NC.5) ; - rien de plus.
La première partie qui échoue décide de la réponse : un rapporteur qui oublie NC reçoit exactement ce message, et celui qui ajoute NC à SO apprend que SO n'en prend pas. Les majuscules, minuscules et espaces en trop n'ont pas d'importance.
Configuration
À l'étape Grammaire, choisissez Échelle de motifs, puis :
- gardez le premier mot, la section et le séparateur (
NTF,TRG,.) sauf si le format change ; - choisissez l'ensemble d'options des déclencheurs — en production, Event trigger ;
- ajoutez un déclencheur par type de signalement et choisissez son option DHIS2. Le nom de l'option est ce que le rapporteur tape (
MA) ; son code est ce que DHIS2 enregistre (Malaria). Les deux sont gardés sur le flux ; - donnez à
MAun paramètre obligatoire : motNC, nom de valeurcases.
L'aperçu sous l'éditeur envoie l'exemple à l'analyseur du backend lui-même : ce qu'il affiche est exactement ce que recevra un SMS. Chaque déclencheur a un bouton d'exemple prêt à l'emploi.
Correspondances et réponses
À l'étape Correspondances, un flux en échelle propose deux sources de plus : Code d'option du déclencheur (pour le champ du déclencheur : Malaria, Stock_out, Risk_stock_out) et cases capturé (pour le nombre de cas). Une valeur absente du message — SO n'a pas de nombre — est simplement omise de l'événement. Le numéro de référence garde le déclencheur court, comme MA26123456.
L'étape Réponses liste une réponse pour chaque façon de mal écrire un message. Celles laissées vides reprennent la réponse générale Code inconnu.
Vérifier avant de publier
À l'étape Publication, Vérifier avec DHIS2 lit le programme, l'étape, les champs, les options des déclencheurs, les règles et les groupes d'utilisateurs du flux, et liste ce que DHIS2 rejetterait. La publication lance la même vérification et refuse un flux qui échoue. La vérification ne modifie rien dans DHIS2.