Intégration Collecte de Données
Bemba reçoit les données de terrain de deux plateformes de collecte : KoboToolbox et Survey Solutions. Un fichier Excel peut aussi servir de source.
Vue d'ensemble
| Outil | Description | Usages dans Bemba |
|---|---|---|
| KoboToolbox | Plateforme open source de collecte mobile | Recensement des ménages, plaintes, code de conduite, réunions |
| Survey Solutions | Solution de la Banque mondiale | Enquêtes ménages, mise à jour des bénéficiaires, plaintes |
| Excel / CSV | Fichier préparé à partir du modèle | Reprise de données existantes |
Deux serveurs KoboToolbox sont utilisables : le service en ligne de Kobo et le serveur KoboToolbox auto-hébergé du projet. Le choix se fait par l'URL de l'API, projet par projet. L'installation du serveur auto-hébergé est décrite dans KoboToolbox auto-hébergé.
Où se trouvent les écrans
Il n'existe pas de menu KoboToolbox ni de menu Survey Solutions. Chaque usage a son écran :
| Besoin | Écran |
|---|---|
| Importer des ménages (Kobo, Survey Solutions ou Excel) | Collecte → Collecte, onglet Ménages, bouton Importer |
| Donner un compte de collecte à un projet | Administration → Projets, bouton Synchronisation de la collecte ⟳ sur la ligne du projet |
| Compte global KoboToolbox | Administration → Paramètres, onglet Paramètres, section Intégrations |
| Compte global et questionnaires Survey Solutions | Même section, bouton Ouvrir la configuration Survey Solutions |
| Plaintes collectées avec Kobo | Plaintes (MGP) → Kobo - Plaintes |
| Plaintes collectées avec Survey Solutions | Plaintes (MGP) → Survey Solutions - Plaintes |
| Formulaire public du code de conduite | Services Sociaux → Code de conduite, bouton Synchroniser Kobo |
Compte par projet
Chaque projet collecte avec son propre outil et son propre compte. La configuration se fait projet par projet.
Menu : Administration → Projets → bouton Synchronisation de la collecte ⟳ sur la ligne du projet
| Outil | Champs |
|---|---|
| KoboToolbox | URL de l'API, jeton API |
| Survey Solutions | URL du serveur, utilisateur API, mot de passe API, espace de travail |
Chaque bloc a son bouton Tester la connexion enregistrée. Il interroge l'outil avec le compte tel qu'il est enregistré.
Repli sur le compte global
Un projet sans compte à lui utilise le compte global du SIG. Pour Kobo, c'est le jeton de la section Intégrations des paramètres. Pour Survey Solutions, c'est la configuration ouverte depuis cette même section. L'écran de synchronisation le signale par l'étiquette compte global utilisé.
Secrets
Le jeton Kobo et le mot de passe Survey Solutions ne sont jamais réaffichés. L'écran indique seulement qu'ils sont renseignés. Laisser le champ vide à l'enregistrement conserve la valeur en place.
Effet sur l'import
Dans l'assistant d'import, le projet se choisit dès la première étape, avec l'institution de collecte. Les questionnaires proposés sont ceux du compte de ce projet.
Synchronisation planifiée
Le serveur synchronise périodiquement les questionnaires Survey Solutions de chaque configuration active : celle de chaque projet et la globale. Un administrateur peut aussi lancer une synchronisation limitée à un projet :
php bin/console app:survey-solutions:sync --projet=CODE_PROJET
php bin/console app:kobo:sync <identifiant_formulaire> --projet=CODE_PROJET
La commande Kobo lit le formulaire avec le compte du projet. Un projet sans compte à lui est refusé, au lieu d'être synchronisé en silence avec le compte global.
Flux de travail général
- Collecte terrain : les enquêteurs remplissent les formulaires sur tablette ou téléphone.
- Envoi au serveur : les soumissions arrivent sur KoboToolbox ou Survey Solutions.
- Contrôle sur la plateforme : les superviseurs approuvent ou rejettent les soumissions.
- Import dans Bemba : les ménages importés arrivent en pré-collecte.
- Validation : ils sont contrôlés, validés puis intégrés au registre social. Voir Pré-collecte.
Aucun ménage importé n'entre directement au registre. C'est la validation en pré-collecte qui lui attribue son identifiant.
Types de formulaires
Formulaires KoboToolbox
| Type | Usage |
|---|---|
| PMT - Collecte ménages | Données socio-économiques pour le calcul du score PMT |
| Validation communautaire | Validation par les comités locaux |
| Suivi des bénéficiaires | Visites de suivi |
| Plainte | Enregistrement des plaintes sur le terrain |
Questionnaires Survey Solutions
| Type | Usage |
|---|---|
| Ménage | Import dans le registre social, via la pré-collecte |
| Mise à jour | Mise à jour des bénéficiaires existants (principal, substitut, téléphone, documents) |
| Plainte | Import dans le mécanisme de gestion des plaintes |
Principes de l'import
Statut de validation
- Survey Solutions : l'option Importer uniquement les interviews approuvées de la configuration limite la synchronisation aux interviews approuvées.
- KoboToolbox : l'assistant d'import lit toutes les soumissions du formulaire, quel que soit leur statut. La synchronisation automatique conserve le statut posé dans Kobo : approuvé, rejeté ou en attente.
Doublons
Une soumission déjà importée met à jour la collecte existante au lieu d'en créer une seconde. Le résultat de l'import distingue les collectes déposées et les collectes mises à jour. Les rapprochements avec les ménages du registre sont contrôlés à la validation.
Bonnes pratiques
- Testez la connexion du projet avant le premier import.
- Importez d'abord un petit échantillon et vérifiez le mapping.
- Après l'import, traitez les ménages en pré-collecte sans attendre.
- Signalez à l'équipe de terrain les soumissions rejetées.
Prérequis techniques
KoboToolbox
- Un compte KoboToolbox avec accès API, sur le service en ligne ou sur le serveur du projet
- Un jeton API
- Des formulaires déployés
Survey Solutions
- Un serveur Survey Solutions accessible
- Un espace de travail
- Un utilisateur API et son mot de passe