KoboToolbox

Si votre équipe collecte des données dans KoboToolbox, vous pouvez synchroniser ces soumissions dans un type de relevé CensusIO. Ouvrez Intégrations pour le configurer.

Who can do this

This needs the Propriétaire ou Administrateur role.

Connecter votre compte

Récupérez d’abord votre clé API depuis KoboToolbox, puis collez-la dans CensusIO.

1. Dans KoboToolbox, ouvrez la page Sécurité de votre compte sur le serveur global KoboToolbox (utilisez l’adresse de votre propre serveur si votre équipe est sur un KoboToolbox régional ou auto-hébergé). Copiez la valeur affichée sous API Key.
2. Dans CensusIO, ouvrez Intégrations, et sous Comptes connectés choisissez Connecter un compte KoboToolbox.
3. Laissez l’URL du serveur sur le serveur global KoboToolbox (modifiez-la uniquement si vous avez copié la clé depuis un serveur différent), collez la API Key dans le champ du jeton, et connectez.

CensusIO vérifie la clé, la stocke chiffrée, et ne l’affiche plus jamais. Vous connectez un compte une seule fois et pouvez l’utiliser pour de nombreux projets.

Connecter un projet

Sous Connexions de projets, choisissez Connecter un projet :

1. Choisissez le Compte et le Projet (CensusIO répertorie les projets du compte, en signalant ceux qui ne sont pas encore déployés), donnez un Nom à la connexion, et choisissez le Type de relevé cible, puis Continuer.
2. Associez les champs. Pour chaque champ Kobo, choisissez le champ du type de relevé auquel il correspond, ou (ignorer). Un champ qui fait partie d’un groupe répété développe une soumission en un enregistrement par entrée.
3. Choisissez Enregistrer la connexion.

La connexion se synchronise alors d’elle-même, et vous pouvez lancer Synchroniser maintenant à tout moment. Utilisez Modifier l’association pour changer l’association, et Activer / Désactiver ou Supprimer pour gérer la connexion.

Le formulaire doit être déployé

KoboToolbox ne fournit des données que pour un formulaire déployé. Si le formulaire est simplement enregistré, la synchronisation n’a rien à lire. Déployez-le dans KoboToolbox et collectez au moins une soumission d’abord. Assurez-vous également que les champs obligatoires du type de relevé (comme une date de relevé) peuvent être remplis à partir des champs Kobo associés, sinon ces enregistrements échoueront à la validation.

Quand une soumission échoue

Une soumission qui est récupérée mais qui ne passe pas la validation est retenue et comptée comme un problème sur la connexion. Ouvrez le panneau des problèmes pour voir l’erreur et la soumission brute, corrigez le formulaire ou l’association, et Synchroniser maintenant pour la valider. Vous pouvez Ignorer une ligne que vous n’avez pas l’intention de corriger.

Related

• How syncs work
• ArcGIS / Esri