D.2.2.4 — Phase 3 — Configuration du projet PIGBF via QR Code

2.4 Phase 3 — Configuration du projet PIGBF via QR Code

C'est l'étape qui connecte l'application ODK Collect à l'enquêteur et au serveur ODK Central du programme PIGBF. Elle repose sur le QR Code personnalisé généré depuis la fiche de l'enquêteur dans la plateforme web.

2.4.1 Obtenir le QR Code de l'enquêteur

Le QR Code est généré par l'Admin IT ONG depuis l'interface web PIGBF :

1. Se connecter à https://pigbf.org avec un compte Admin IT ONG ou Admin ONG
2. Menu latéral → Enquêteurs
3. Cliquer sur l'icône Voir (œil) sur la ligne de l'enquêteur concerné
4. Dans la fiche de l'enquêteur, localiser la section QR Code ODK
5. Le QR Code s'affiche à l'écran — il peut être imprimé ou téléchargé en PNG

📸 Capture d'écran à insérer : Fiche enquêteur dans l'interface web PIGBF, section "QR Code ODK" : carré QR code affiché en grand format, bouton "Imprimer le QR code" et bouton "Télécharger le QR code (PNG)" visibles en dessous du code. Note explicative : "Ce QR Code est unique pour cet enquêteur. Il encode les paramètres de connexion ODK Central."

ℹ️ Note sur la confidentialité du QR Code : Le QR Code encode les identifiants de connexion ODK Central personnels de l'enquêteur (URL du serveur, email et mot de passe ODK). Ne jamais le partager par voie non sécurisée (groupes WhatsApp publics, emails non chiffrés). Le remettre directement en main propre à l'enquêteur ou l'envoyer par un canal professionnel de confiance.

2.4.2 Scanner le QR Code sur la tablette

Une fois le QR Code disponible (imprimé ou affiché sur un autre écran), procédez à la configuration de la tablette :

1. Ouvrez l'application ODK Collect sur la tablette.
2. Sur l'écran d'accueil de l'application, appuyez sur l'icône menu (trois points verticaux ⋮) en haut à droite de l'écran, puis appuyez sur Configure via QR code.

Alternative : Sur certaines versions, un bouton dédié "Configurer par QR code" peut apparaître directement sur l'écran d'accueil si l'application n'est pas encore configurée.

📸 Capture d'écran à insérer : Écran d'accueil ODK Collect sans projet configuré : message d'invitation à configurer l'application visible, bouton ou option "Configure via QR code" mis en évidence

3. L'application demande l'autorisation d'utiliser la caméra si ce n'est pas déjà accordé. Appuyez sur Autoriser.
4. Le scanner de QR Code s'ouvre : un cadre de visée apparaît au centre de l'écran.

📸 Capture d'écran à insérer : Écran scanner QR Code dans ODK Collect : cadre de visée carré au centre, fond de caméra actif, instructions textuelles en bas de l'écran invitant à aligner le QR Code dans le cadre

5. Présentez le QR Code devant la caméra de la tablette. Centrez-le dans le cadre de visée en maintenant la tablette stable.
6. ODK Collect lit automatiquement le QR Code dès qu'il est correctement positionné dans le cadre. Ne pas appuyer sur aucun bouton — la lecture est automatique.
7. Une fois le QR Code reconnu, l'application affiche un message de confirmation et la liste des formulaires assignés à l'enquêteur se charge automatiquement.

📸 Capture d'écran à insérer : Tablette Android après scan réussi du QR Code : message de confirmation "Projet configuré avec succès" (ou équivalent), nom du projet "Plateforme Informatique de Gestion..." affiché en en-tête, liste des formulaires disponibles commençant à s'afficher

2.4.3 Vérifier la configuration

Après le scan réussi, vérifiez que la configuration est correcte :

1. L'écran d'accueil doit afficher le nom du projet PIGBF dans la barre du haut : "Plateforme Informatique de Gest..."
2. Appuyez sur + Start new form — la liste des formulaires assignés à l'enquêteur doit s'afficher.
3. Vérifiez que les formulaires correspondant à la mission de l'enquêteur sont bien présents.

📸 Capture d'écran à insérer : Écran "Start new form" après configuration réussie : liste complète des formulaires assignés à l'enquêteur, chacun avec son titre, son numéro de version, son ID et sa date de dernière synchronisation. La présence de l'icône de géolocalisation sur certains formulaires est visible

⚠️ Si aucun formulaire n'apparaît : Cela signifie que l'Admin IT ONG n'a pas assigné de formulaires à l'enquêteur, ou que la synchronisation initiale n'a pas abouti (problème de connexion réseau). Vérifiez la connexion internet de la tablette et contactez l'Admin IT ONG pour vérifier l'assignation des formulaires (cf. Section B, chapitre B.3).

2.4.4 Synchroniser les formulaires

Après la configuration initiale, il est recommandé de procéder à une synchronisation manuelle pour s'assurer que les formulaires sont à leur version la plus récente :

1. Depuis l'écran d'accueil ODK Collect, appuyez sur + Start new form.
2. Dans la liste des formulaires, appuyez sur l'icône de rafraîchissement (↺) en haut à droite de l'écran.
3. ODK Collect se connecte au serveur ODK Central et télécharge les versions les plus récentes des formulaires.
4. Une barre de progression indique l'avancement du téléchargement.
5. Une fois terminé, la liste est mise à jour avec les nouvelles versions.

📸 Capture d'écran à insérer : Écran de synchronisation des formulaires dans ODK Collect : barre de progression visible, liste des formulaires en cours de mise à jour, indicateur de connexion réseau