Survey Solutions
La page Survey Solutions permet de configurer la connexion au serveur Survey Solutions et d'importer les questionnaires ménages et plaintes.
Accès
Menu : Collecte → Survey Solutions
Vue d'ensemble
Page principale (Sync)
La page affiche :
- Statistiques : Compteurs des questionnaires et imports
- Actions rapides : Boutons d'import direct
- Liste des questionnaires : Questionnaires configurés
Statistiques affichées
| Indicateur | Description |
|---|---|
| Questionnaires | Nombre total de questionnaires configurés |
| Ménages | Questionnaires de type "ménage" |
| Plaintes | Questionnaires de type "plainte" |
| Statut | État de la connexion au serveur |
Actions rapides
Import Ménages
Cliquez sur Import Ménages pour :
- Accéder à la page d'import des questionnaires ménages
- Sélectionner le questionnaire à importer
- Prévisualiser les données
- Lancer l'import
Import Plaintes
Cliquez sur Import Plaintes pour :
- Accéder à la page d'import des plaintes
- Sélectionner le questionnaire plaintes
- Prévisualiser les données
- Lancer l'import
Configuration
Accès
Menu : Collecte → Survey Solutions → Configuration
Ou cliquez sur l'icône Paramètres depuis la page principale.
Paramètres de connexion
| Champ | Type | Description |
|---|---|---|
| URL du serveur | Texte | Adresse du serveur Survey Solutions |
| Workspace | Texte | Nom du workspace à utiliser |
| Utilisateur API | Texte | Nom d'utilisateur pour l'API |
| Mot de passe API | Mot de passe | Mot de passe de l'utilisateur API |
Exemple de configuration
URL du serveur : https://demo.mysurvey.solutions
Workspace : pch_guinee
Utilisateur API : api_user
Mot de passe API : ********
Paramètres de synchronisation
| Paramètre | Options | Description |
|---|---|---|
| Intervalle de sync | 1h, 3h, 6h, 12h, 24h | Fréquence de vérification automatique |
| Importer uniquement approuvés | Oui/Non | Filtre les questionnaires non validés |
:::warning Important Il est fortement recommandé d'activer Importer uniquement les approuvés pour garantir la qualité des données. :::
Tester la connexion
- Remplissez les paramètres de connexion
- Cliquez sur Tester la connexion
- Vérifiez le message de confirmation
- Cliquez sur Enregistrer si le test réussit
Gestion des questionnaires
Liste des questionnaires
| Colonne | Description |
|---|---|
| Nom | Nom du questionnaire Survey Solutions |
| Type | Ménage ou Plainte |
| Actif | Questionnaire activé pour l'import |
| Actions | Modifier, Supprimer |
Ajouter un questionnaire
- Cliquez sur Ajouter un questionnaire
- Sélectionnez le questionnaire depuis Survey Solutions
- Choisissez le type :
| Type | Description |
|---|---|
| Ménage | Questionnaire d'enquête ménage → Import dans le registre social |
| Plainte | Questionnaire de collecte de plaintes → Import dans le MGP |
- Pour les questionnaires de type Ménage, configurez les valeurs par défaut (optionnel) :
| Champ | Description |
|---|---|
| Campagne par défaut | Campagne de collecte à utiliser si non trouvée dans les données |
| Région par défaut | Région à utiliser si non trouvée dans les données |
:::info Mapping automatique Les champs (région, secteur, campagne, enquêteur, etc.) sont détectés automatiquement dans les données du questionnaire. Les valeurs par défaut ne sont utilisées que si les données ne sont pas trouvées. :::
- Cliquez sur Ajouter
Modifier un questionnaire
- Cliquez sur l'icône Modifier (crayon)
- Modifiez le type ou le statut actif
- Cliquez sur Enregistrer
Supprimer un questionnaire
- Cliquez sur l'icône Supprimer (corbeille)
- Confirmez la suppression
:::info Note Supprimer un questionnaire ne supprime pas les données déjà importées. :::
Import des données
Import des ménages
Accès
Menu : Collecte → Survey Solutions → Import Ménages
Statistiques affichées
En haut de la page, des cartes affichent les indicateurs clés :
| Indicateur | Icône | Description |
|---|---|---|
| Total importés | Utilisateurs | Nombre total de ménages importés |
| Importés aujourd'hui | Check | Ménages importés dans la journée |
| Doublons détectés | Documents | Ménages déjà existants ignorés |
| Dernière sync | Calendrier | Date et heure de la dernière synchronisation |
Processus
- Sélection : Choisissez le questionnaire à importer (ou "Tous les questionnaires")
- Synchronisation : Cliquez sur Lancer la synchronisation
- Résultats : Le système affiche :
- Nombre de ménages importés avec succès
- Nombre de doublons ignorés
- Nombre d'erreurs rencontrées
- Détail par questionnaire : Si plusieurs questionnaires, les résultats sont affichés séparément
Correspondance des champs
Le système fait correspondre automatiquement les champs Survey Solutions avec les entités Bemba :
| Champ Survey Solutions | Entité Bemba |
|---|---|
| Informations ménage | Menage |
| Chef de ménage | ChefMenage |
| Membres | Membre |
| Logement | Logement |
| Localisation GPS | Coordonnées GPS |
Import des plaintes
Accès
Menu : Collecte → Survey Solutions → Import Plaintes
Processus
- Sélection : Choisissez le questionnaire plaintes
- Prévisualisation :
- Plaintes disponibles
- Plaintes déjà importées
- Nouvelles plaintes
- Import : Cliquez sur Lancer l'import
Correspondance des champs
| Champ Survey Solutions | Entité Bemba |
|---|---|
| Description | Plainte.description |
| Plaignant | Plainte.plaignant |
| Contact | Plainte.telephone |
| Catégorie | Plainte.categorie |
| Date | Plainte.dateCreation |
Statuts des interviews
Survey Solutions utilise des statuts spécifiques :
| Statut | Code | Importable |
|---|---|---|
| Superviseur Assigné | SupervisorAssigned | Non |
| Rejeté par Superviseur | RejectedBySupervisor | Non |
| Approuvé par Superviseur | ApprovedBySupervisor | Oui (si option active) |
| Rejeté par QA | RejectedByHeadquarters | Non |
| Approuvé par QA | ApprovedByHeadquarters | Oui |
:::tip Conseil Avec l'option Importer uniquement approuvés, seuls les statuts "ApprovedBySupervisor" et "ApprovedByHeadquarters" sont importés. :::
Synchronisation automatique
Configuration
- Accédez à la Configuration
- Définissez l'Intervalle de synchronisation :
| Intervalle | Usage |
|---|---|
| 1 heure | Suivi en temps quasi-réel |
| 3 heures | Usage standard |
| 6 heures | Usage modéré |
| 12 heures | Vérification bi-quotidienne |
| 24 heures | Vérification quotidienne |
- Enregistrez les paramètres
Fonctionnement
- Le système vérifie automatiquement les nouvelles interviews
- Les interviews approuvées sont importées automatiquement
- Une notification est envoyée en cas d'erreur
Cas d'utilisation
Configuration initiale
- Accédez à Survey Solutions → Configuration
- Renseignez les paramètres de connexion
- Testez la connexion
- Enregistrez
- Ajoutez les questionnaires à importer
- Définissez le type de chaque questionnaire
- Activez la synchronisation automatique
Import manuel quotidien
- Accédez à Survey Solutions
- Vérifiez les statistiques
- Cliquez sur Import Ménages ou Import Plaintes
- Prévisualisez les données
- Lancez l'import
- Vérifiez les données importées
Réimporter après correction
Si des données ont été corrigées dans Survey Solutions :
- Accédez à la page d'import correspondante
- Cochez Forcer la réimportation
- Sélectionnez les interviews à réimporter
- Lancez l'import
Dépannage
Erreur de connexion
| Erreur | Cause | Solution |
|---|---|---|
| Connexion refusée | URL incorrecte | Vérifiez l'URL du serveur |
| Non autorisé | Identifiants incorrects | Vérifiez utilisateur/mot de passe |
| Workspace introuvable | Nom incorrect | Vérifiez le nom du workspace |
Aucun questionnaire trouvé
- Vérifiez que les questionnaires sont déployés
- Vérifiez les permissions de l'utilisateur API
- Vérifiez le workspace sélectionné
Données manquantes après import
| Problème | Cause | Solution |
|---|---|---|
| Champs vides | Non renseignés dans SS | Vérifier les données source |
| Ménage non créé | Interview non approuvée | Approuver l'interview |
| Erreur de mapping | Champ non reconnu | Vérifier la configuration |
Mise à jour des ménages
Le service de mise à jour permet de synchroniser les modifications depuis Survey Solutions.
Cas d'utilisation
- Corrections apportées dans Survey Solutions après import
- Mise à jour des coordonnées GPS
- Ajout de membres supplémentaires
- Correction des informations du chef de ménage
Processus
- Accédez à Import Ménages
- Lancez une nouvelle synchronisation
- Le système détecte automatiquement les interviews déjà importées
- Les ménages existants sont mis à jour avec les nouvelles données
Champs mis à jour
| Catégorie | Champs |
|---|---|
| Chef de ménage | Nom, téléphone, document identité |
| Membres | Liste complète remplacée |
| Logement | Caractéristiques du logement |
| GPS | Latitude, longitude, précision |
:::warning Attention La mise à jour remplace les données existantes. Les modifications manuelles effectuées dans Bemba seront écrasées. :::
Bonnes pratiques
Configuration
- Utilisez un compte API dédié
- Activez l'import des approuvés uniquement
- Testez la connexion régulièrement
Import
- Prévisualisez toujours avant d'importer
- Vérifiez les statistiques post-import
- Documentez les erreurs rencontrées
Maintenance
- Surveillez les logs de synchronisation
- Mettez à jour les questionnaires si nécessaire
- Archivez les imports complétés