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 |
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 |
| Plainte | Questionnaire de collecte de plaintes |
- Activez ou désactivez selon besoin
- Cliquez sur Enregistrer
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
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
Processus
- Sélection : Choisissez le questionnaire à importer
- Prévisualisation :
- Nombre d'interviews disponibles
- Interviews déjà importées
- Nouvelles interviews
- Options :
- Forcer la réimportation (pour mettre à jour)
- Import : Cliquez sur Lancer l'import
Correspondance des champs
Le système fait correspondre automatiquement les champs Survey Solutions avec les entités PCH-SIG :
| Champ Survey Solutions | Entité PCH-SIG |
|---|---|
| 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é PCH-SIG |
|---|---|
| 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 |
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 |
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
Permissions
| Action | Permission requise |
|---|---|
| Voir Survey Solutions | collecte.survey_solutions_view |
| Configurer | collecte.survey_solutions_edit |
| Importer | collecte.survey_solutions_import |