Configuration des SMS¶
Ce document traite des fonctionnalités de l'application de Configuration des SMS. Pour plus d'informations sur l'intégration du service SMS, veuillez consulter le document Mobile.
La fonction de Commande SMS¶
Les commandes SMS traitent les messages SMS reçus par une instance DHIS2, en effectuant certaines actions en fonction de la commande et du contenu du message. Plusieurs commandes SMS peuvent être configurées pour traiter et gérer les données de diverses manières. Une commande SMS est un objet contenant les configurations de chaque formulaire SMS : Récupérer des données depuis des téléphones ou applications j2me, alerter les utilisateurs, enregistrer des patients ou utilisateurs, etc.
Liste des commandes disponibles¶
Pour voir toutes les commandes disponibles, accédez à la page "Commandes". Toutes les commandes seront répertoriées dans un tableau. Sur cette page, les actions suivantes sont disponibles:
- Ajouter des commandes (1)
- Modifier les commandes (2)
- Supprimer les commandes (3)
- Commandes de suppression multiple (4)
Supprimer les commandes disponibles¶
La suppression des commandes peut être effectuée en cochant individuellement les cases de chaque commande (1) qui doit être supprimée ou en sélectionnant toutes les commandes affichées en cochant la case correspondante au niveau de l'en-tête du tableau (2). Après avoir sélectionné les commandes à supprimer, cliquez sur le bouton "Supprimer la sélection" (3).
Pour éviter les suppressions involontaires, une boîte de dialogue de confirmation s'affichera.
Ajout de commandes¶
Attention
Les commandes ne sont pas actives juste après leur ajout! Il faudra d'abord les éditer afin de configurer les champs nécessaires !
Après avoir cliqué sur le bouton "Ajouter une commande" dans la page de présentation des commandes, un formulaire dynamique apparaîtra. Selon le type d'analyseur, plusieurs entrées seront affichées:
| Type d'analyseur | Groupe d’utilisateurs | Programme | Étape du programme | Ensemble de données |
|---|---|---|---|---|
| Analyseur d'alertes | ✓ | ✕ | ✕ | ✕ |
| Analyseur d'enregistrement d'événement | ✕ | ✓ | ✓ | ✕ |
| Analyseur J2ME | ✕ | ✕ | ✕ | ✓ |
| Analyseur de valeur clé | ✕ | ✕ | ✕ | ✓ |
| Analyseur de saisie de données des étapes de programme | ✕ | ✓ | ✓ | ✕ |
| Analyseur des enregistrements d'entités suivies | ✕ | ✓ | ✕ | ✕ |
| Analyseur non enregistré | ✓ | ✕ | ✕ | ✕ |
Analyseur d'enregistrement d'événements{ #sms-configuration-commands-add-eventregistration }¶
Ces commandes peuvent avoir des codes courts pour leur étape de programme associée. Seuls les programmes de type "Programme d'événement" peuvent être choisis pour cette commande. Ainsi, il n'existe qu'une seule étape de programme, qui sera sélectionnée automatiquement.
Analyseur de saisie de données des étapes de programme¶
Ces commandes peuvent avoir des codes courts pour leur étape de programme associée. Seuls les programmes de type "Programme Tracker" peuvent être choisis pour cette commande. Contrairement aux analyseurs d'"Enregistrement d'événements", une étape de programme doit être choisie pour ce type d'analyseur.
Modification des commandes¶
Lors de la modification des commandes, il n'est pas possible de modifier le type d'analyseur de même que les données supplémentaires fournies lors de l'ajout de la commande. La seule façon de le faire est de créer une nouvelle commande et de supprimer l'ancienne.
Certains paramètres sont communs à tous les types de commandes SMS. Ces paramètres ont des valeurs par défaut configurées dans le système. Si l'utilisateur fournit une valeur à ces paramètres, ces valeurs par défaut seront alors utilisées. Voici la liste de ces paramètres
Ces champs communs sont :
| Paramètre | Type | Description |
|---|---|---|
| Séparateur de champs | Chaîne | Pour fournir un séparateur de champs personnalisé. La valeur par défaut est "|" |
| Message de réponse lorsqu'aucun code n'est envoyé (seulement la commande) | Chaîne | Pour proposer un message lorsqu'aucun code n'est trouvé dans le texte du SMS. La valeur par défaut est "Paramètre manquant" |
| Message au format incorrect | Chaîne | Pour proposer un message lorsque la commande n'est pas correctement formatée. La commande doit être formatée selon le séparateur de valeur de code. Ce message sera également renvoyé si un paramètre obligatoire manque. |
| Aucun message d'utilisateur | Chaîne | Pour proposer un message lorsque le numéro de téléphone qui sert à l'envoi n'est pas enregistré dans DHIS2. |
| Utilisateur associé à plus d'un message d'unité d'organisation | Chaîne | Certains types de commandes SMS exigent que l'utilisateur (sans le numéro de téléphone d'envoi) ne soit associé qu'à une seule unité d'organisation. Ce message peut être configuré pour un renvoi si cette exigence n'est pas respectée. |
| Message de confirmation | Chaîne | Pour proposer un message qui sera envoyé une fois le processus terminé avec succès. |
Certaines commandes ont la possibilité d'ajouter des codes courts, qui sont expliqués dans les sections individuelles dédiées à chacun des types d'analyseurs ci-dessous.
Modification des commandes de l'analyseur d'alertes¶
Lors de la modification d'une commande d'analyseur d'alerte, seuls deux champs sont modifiables. Les champs partagés entre la plupart des types d'analyseur ne sont pas disponibles:
- Nom (obligatoire)
- Confirmer le message
Les deux sont des champs de texte.
Modification des commandes de l'analyseur des enregistrements d'événements{ #sms-configuration-commands-edit-eventregistration }¶
Les commandes de ce type d'analyseur ont tous les champs partagés. De plus, des codes courts peuvent être définis. Un code court peut être ajouté pour chaque élément de données connecté à l'étape de programme qui a été sélectionnée lors de l'ajout de la commande:
Modification des commandes d'analyseur J2ME¶
Les commandes de ce type d'analyseur ont tous les champs partagés. La commande SMS aura un ensemble de données car ils sont utilisés pour les données de rapport. Si les données sont signalées pour une période déjà approuvée, une réponse par SMS contenant des informations sur le statut d'approbation de la période, sera renvoyée. De plus, des codes courts peuvent être définis. Chaque commande est connectée à un ensemble de données. L'ensemble de données contient des éléments de données, qui ont des combinaisons de catégories, lesquelles ont au moins une combinaison d'options de catégorie. Pour chaque combinaison "élément de données - option de catégorie" existante, un code court peut être fourni.
Remarque sur les valeurs requises. Assurez-vous qu'au moins un code court pour SMS soit fourni lorsque la méthode intégrale "Recevoir au moins une valeur de données" est choisie. Dans le cas contraire, les messages reçus ne seront pas traités.
Formules de codes courts{ #sms-configuration-commands-edit-j2me-shortcodeformulas }¶
Chaque code court peut avoir une formule facultative. En fournissant une formule, la valeur d'un élément de données différent peut être ajoutée ou soustraite.
Cela peut être fait en cliquant sur le bouton "Ajouter une formule" /"Modifier la formule" sous le champ de saisie du code court:
Lorsque vous cliquez sur le bouton, une fenêtre modale apparaît en proposant une liste déroulante pour sélectionner un élément de données, et l'opérateur de formule, qui peut être "+" ou "-":
En cliquant sur "Sauvegarder", la formule sera ajoutée au formulaire de modification principal. Elle n'est pas automatiquement enregistrée dans la commande! Pour sauvegarder une formule modifiée, vous devez soumettre tout le formulaire.
Suppression d'une formule de code court¶
Si un code court a une formule, celle-ci peut être supprimée en cliquant sur le bouton "Modifier la formule". La fenêtre modale qui apparaîtra, a un bouton "Supprimer". En cliquant sur ce bouton, la formule sera supprimée du code court dans le formulaire principal et la fenêtre modale se fermera. La suppression n'est pas automatiquement enregistrée dans la commande! Afin de l'enregistrer , vous devez soumettre tout le formulaire.
Modification des commandes de l'analyseur de valeurs clés¶
Ce type de commande fonctionne de la même manière que les commandes de l'analyseur J2ME. Veuillez consulter la documentation ci-dessus.
Modification des commandes de l'analyseur de saisie de données de l'étape du programme¶
Les commandes de ce type d'analyseur ont tous les champs partagés. De plus, des codes courts peuvent être définis. Un code court peut être ajouté pour chaque élément de données connecté à l'étape de programme qui a été sélectionnée lors de l'ajout de la commande:
Modification des commandes de l'analyseur des enregistrements d'entités suivies¶
Les commandes de ce type d'analyseur ont tous les champs partagés. De plus, des codes courts peuvent être définis. Un code court peut être ajouté pour chaque attribut d'entité suivie connecté à l'étape de programme qui a été sélectionnée lors de l'ajout de la commande:
Modification des commandes d'analyseur non enregistrées¶
Ce type de commande fonctionne de la même manière que les commandes de l'analyseur d'alertes. Veuillez consulter la documentation ci-dessus.
Passerelles SMS¶
Une passerelle SMS permet à une instance DHIS2 d'envoyer et de recevoir des messages SMS. Différents types de passerelles peuvent être ajoutés et configurés. Au moins une passerelle est nécessaire pour envoyer et recevoir des messages SMS. L'équilibrage de charge utilisera toutes les passerelles si plusieurs sont disponibles.
Il existe quatre types de passerelles prises en charge par le service SMS : * Passerelles génériques * Passerelles BulkSMS * Passerelles Clickatell * Passerelles SMPP
Liste des passerelles¶
Pour voir toutes les commandes disponibles, accédez à la page de "Configuration des passerelles". Toutes les commandes seront répertoriées dans un tableau. Sur cette page, les actions suivantes sont disponibles:
- Ajouter des passerelles (1)
- Modifier les passerelles (2)
- Supprimer les passerelles (3)
- Passerelles de suppression multiple (4)
- Définir la passerelle par défaut (5)
Ajout de passerelles¶
Après avoir cliqué sur le bouton "Ajouter une passerelle" sur la page de présentation des configurations de la passerelle, un formulaire dynamique apparaîtra. Il est divisé en deux sections:
- Le type de passerelle (1)
- La configuration de la passerelle dépend du type de passerelle (2)
Pour plus de détails sur la configuration des passerelles, veuillez vous référer à la section Configurations des passerelles de la documentation de maintenance "Mobile".
Modification des passerelles¶
La modification est similaire à l'ajout de passerelles, sauf que le type de passerelle ne peut pas être modifié. Si une passerelle a un type inadéquat, elle doit être supprimée et ajoutée à nouveau. Pour plus d'informations sur la modification des passerelles, veuillez vous référer à la section "Ajout de passerelles" ci-dessus.
Afficher les SMS entrants¶
Pour voir tous les sms entrants, accédez à la page "Reçus". Tous les sms reçus seront répertoriés dans un tableau paginé. Sur cette page, les actions suivantes sont disponibles :
- Filtrage des SMS entrants (1)
- Suppression de SMS (2)
- Suppression multiple de SMS (3)
Filtrage¶
Réinitialisation des filtres¶
Tous les filtres définis peuvent être réinitialisés en cliquant sur le bouton "Réinitialiser le filtre".
Filtrage par statut¶
La liste des SMS entrants peut être filtrée selon les statuts suivants :
- Tous
- Échec
- Entrants
- Traités
- Traitement
- Envoyés
- Non gérés
Filtrage par numéro de téléphone¶
En saisissant un numéro de téléphone dans le champ de saisie situé au-dessus du tableau contenant les SMS, le tableau peut être filtré en prenant en compte ce numéro de téléphone.
Afficher les SMS sortants¶
Cette section est identique à la section SMS "Entrants"/"Reçus", à une seule différence près : La liste ne peut pas être filtrée par un numéro de téléphone. Veuillez vous référer à la section "Afficher les SMS entrants".