Survey Solutions
Survey Solutions, l'outil d'enquête de la Banque mondiale, alimente Bemba de trois façons : import de ménages, mise à jour des bénéficiaires et import de plaintes.
Accès
Il n'existe pas de menu Survey Solutions. Les écrans s'ouvrent ainsi :
| Écran | Chemin |
|---|---|
| Configuration Survey Solutions | Administration → Paramètres → onglet Paramètres → section Intégrations → Ouvrir la configuration Survey Solutions |
| Page Survey Solutions (vue d'ensemble) | Bouton Retour de l'écran de configuration |
| Import de ménages | Collecte → Collecte → onglet Ménages → Importer, source Survey Solutions |
| Mise à jour des ménages | Page Survey Solutions → Mise à jour Ménages |
| Import de plaintes | Plaintes (MGP) → Survey Solutions - Plaintes |
| Compte d'un projet | Administration → Projets → bouton Synchronisation de la collecte ⟳ |
Page Survey Solutions
La page affiche l'état de la connexion, les compteurs de questionnaires et trois actions :
| Action | Effet |
|---|---|
| Import Ménages | Ouvre l'assistant d'import de la collecte |
| Mise à jour Ménages | Met à jour les bénéficiaires existants (principal, substitut) |
| Import Plaintes | Importe et catégorise les plaintes collectées |
Elle liste aussi les questionnaires configurés, avec leur type, leur nombre de soumissions et leur dernière synchronisation.
Configuration
Chaque projet peut collecter avec son propre serveur et son propre compte. La configuration décrite ici est le compte global du SIG, utilisé par les projets qui n'ont pas le leur. Pour donner son compte à un projet, voir Compte par projet.
Paramètres de connexion
| Champ | Description |
|---|---|
| URL du serveur | Adresse du serveur, par exemple https://votre-instance.mysurvey.solutions |
| Workspace | Espace de travail ; laissez vide pour l'espace par défaut |
| Utilisateur API | Compte API créé dans Survey Solutions |
| Mot de passe API | Mot de passe de ce compte |
Paramètres de synchronisation
| Paramètre | Options | Description |
|---|---|---|
| Intervalle de synchronisation | 1, 3, 6, 12 ou 24 heures | Fréquence de la synchronisation planifiée |
| Importer uniquement les interviews approuvées | Oui / Non | Limite la synchronisation aux interviews approuvées par le siège |
Tester et enregistrer
- Remplissez les paramètres de connexion.
- Cliquez sur Tester la connexion.
- Si le test réussit, cliquez sur Enregistrer.
Gestion des questionnaires
Ajouter un questionnaire
- Dans la configuration, cliquez sur Ajouter un questionnaire.
- Sélectionnez le questionnaire publié sur le serveur.
- Choisissez le Type de données :
| Type | Destination |
|---|---|
| Ménage | Registre social, via la pré-collecte |
| Mise à jour | Mise à jour des bénéficiaires existants |
| Plainte | Mécanisme de gestion des plaintes |
- Pour un questionnaire Ménage, indiquez si besoin une Région par défaut. Elle ne sert que si la donnée manque dans l'interview.
- Cliquez sur Ajouter.
Les champs région, secteur, enquêteur et autres sont détectés automatiquement dans le questionnaire.
Supprimer un questionnaire de la liste ne supprime pas les données déjà importées.
Import des ménages
Les ménages Survey Solutions s'importent avec l'assistant commun à toutes les sources.
Menu : Collecte → Collecte → onglet Ménages → Importer
- Source : choisissez Survey Solutions, puis l'institution de collecte, le projet et, si besoin, le programme.
- Questionnaire : choisissez le questionnaire.
- Mapping : aucun mapping manuel n'est nécessaire pour cette source. Le questionnaire est lu selon sa propre structure :
- les membres viennent du roster, et la taille du ménage est leur nombre ;
- le chef de ménage est le membre dont le lien de parenté est « chef » ;
- région, secteur et localité sont traduits depuis les codes du questionnaire, le GPS depuis la question de coordonnées.
- Aperçu, puis Lancer l'import.
Les ménages arrivent en pré-collecte, rattachés au projet et à l'institution choisis. Ils n'entrent au registre qu'après validation. Voir Pré-collecte.
Mise à jour des ménages
Accès : page Survey Solutions → Mise à jour Ménages
Ce module met à jour les bénéficiaires déjà enregistrés à partir d'un questionnaire de type Mise à jour.
| Catégorie | Données mises à jour |
|---|---|
| Bénéficiaire | Sélection du principal et du substitut, nom |
| Contact et paiement | Téléphone MTN, compte Mobile Money, signature du contrat |
| Documents | BI Antigo, BI CEDEAO, carte d'électeur, autres documents |
| Localisation | Coordonnées GPS, date de mise à jour |
- Choisissez un questionnaire, ou laissez Tous les questionnaires.
- Cliquez sur Lancer la synchronisation.
- Lisez le résultat : bénéficiaires mis à jour, non trouvés, erreurs.
La mise à jour remplace les valeurs existantes. Une correction faite à la main dans Bemba est écrasée par la donnée du questionnaire.
Import des plaintes
Menu : Plaintes (MGP) → Survey Solutions - Plaintes
- Choisissez un questionnaire de type Plainte, ou Tous les questionnaires.
- Cliquez sur Lancer la synchronisation. Le résultat compte les plaintes importées, les doublons et les erreurs.
- Dans Plaintes en attente de catégorisation, cliquez sur Catégoriser.
- Choisissez la catégorie, la priorité et le type.
- Cochez Envoyer un accusé de réception par SMS si besoin.
- Cliquez sur Valider.
Statuts des interviews
| Statut Survey Solutions | Signification |
|---|---|
| SupervisorAssigned | Assignée au superviseur |
| Completed | Terminée par l'enquêteur |
| RejectedBySupervisor | Rejetée par le superviseur |
| ApprovedBySupervisor | Approuvée par le superviseur |
| RejectedByHeadquarters | Rejetée par le siège |
| ApprovedByHeadquarters | Approuvée par le siège |
Avec l'option Importer uniquement les interviews approuvées, la synchronisation planifiée ne retient que les interviews approuvées par le siège.
Synchronisation planifiée
Le serveur synchronise les questionnaires de chaque configuration active, celle de chaque projet et la globale, selon l'intervalle choisi. Un administrateur peut lancer la synchronisation d'un seul projet :
php bin/console app:survey-solutions:sync --projet=CODE_PROJET
Dépannage
| Erreur | Cause | Solution |
|---|---|---|
| Connexion échouée | URL incorrecte | Vérifiez l'URL du serveur |
| Non autorisé | Identifiants incorrects | Vérifiez l'utilisateur et le mot de passe API |
| Aucun questionnaire | Workspace incorrect ou questionnaire non publié | Vérifiez l'espace de travail et les droits du compte API |
| Bénéficiaires « non trouvés » à la mise à jour | Le ménage n'existe pas dans Bemba | Importez d'abord le ménage |