Guide Utilisateur

Tout ce qu’il faut savoir pour demander un accès, créer un transfert ou une synchronisation, et suivre vos tâches sur Kobo Transfer.

Sommaire

  1. 1. Accéder à la plateforme
  2. 2. Prérequis KoboToolbox
  3. 3. Transfert vs Synchronisation
  4. 4. Créer une tâche
  5. 5. Fréquence (synchronisation)
  6. 6. Suivi, exécution et logs
  7. 7. Dépannage

1 Accéder à la plateforme

L’accès se fait sur https://kobotransfert.com.

Nouveau utilisateur

  1. Cliquez sur Demander un compte
  2. Remplissez le formulaire (nom, identifiant, e-mail, mot de passe)
  3. Attendez l’approbation d’un administrateur
  4. Connectez-vous une fois le compte activé

Déjà un compte

  1. Cliquez sur Connexion
  2. Saisissez votre nom d’utilisateur et mot de passe
  3. Vous accédez à la page Mes Tâches
Note : tant que votre demande n’est pas approuvée, la connexion affiche un message indiquant que le compte est en attente.

2 Prérequis KoboToolbox

Avant de créer une tâche, préparez :

  • Un compte sur le serveur source et sur le serveur destination
  • Un Token API pour chaque serveur (Paramètres du compte Kobo → API Tokens)
  • L’Asset UID du projet source (visible dans l’URL du projet, ex. aXXXX...)
  • Pour une synchronisation : l’Asset UID du projet destination déjà existant

Exemples d’URL serveur

Serveur Global
https://kc.kobotoolbox.org
Serveur EU
https://kc-eu.kobotoolbox.org

Vous pouvez aussi utiliser l’URL KC de votre propre instance Kobo.

3 Transfert vs Synchronisation

À la création d’une tâche, vous devez choisir un seul type :

Transfert

Transfert de projet

  • • Crée un nouveau projet en destination
  • • L’UID destination ne doit pas être renseigné
  • • S’exécute une seule fois dès la création
  • • Pas de fréquence / pas de cron

Idéal pour migrer un projet vers un autre serveur.

Synchronisation

Synchronisation de projet

  • • Utilise un projet destination existant
  • • UID source et UID destination obligatoires
  • • Une fréquence est obligatoire
  • • Tourne de façon récurrente (cron)

Idéal pour garder deux projets alignés dans le temps.

4 Créer une tâche

  1. Connectez-vous puis allez sur Mes Tâches
  2. Donnez un nom clair à la tâche
  3. Cochez Transfert de projet ou Synchronisation de projet
  4. Renseignez la section Source : URL serveur, Asset UID, Token API
  5. Renseignez la section Destination :
    • Transfert : URL + Token seulement (pas d’UID destination)
    • Synchronisation : URL + UID destination + Token
  6. Pour une synchronisation, définissez la fréquence
  7. Cliquez sur Créer la Tâche
Après création, la tâche apparaît dans la liste à droite avec son type (Transfert / Synchronisation) et son planning.

5 Fréquence (synchronisation uniquement)

La section fréquence n’apparaît que si vous choisissez Synchronisation de projet.

Mode simple

  • • Quotidien (avec heure)
  • • Toutes les heures
  • • Hebdomadaire

Mode expert (Cron)

  • */15 * * * * → toutes les 15 min
  • 0 */2 * * * → toutes les 2 h
  • 0 9 * * 1 → lundi à 9 h

6 Suivi, exécution et logs

Exécuter

Relance manuellement une tâche sans attendre le planning.

Détails

Affiche la config, le type, le planning et les logs récents.

Supprimer

Supprime la tâche, sa config et son éventuel cron.

=== TÂCHE 212fdce6 - Wed Aug 06 12:15:01 UTC 2026 ===
📋 Transferring asset, versions and form media
✅ Transfert réussi
=== FIN TÂCHE 212fdce6 - Wed Aug 06 12:15:45 UTC 2026 ===

7 Dépannage

Erreur 401 (Unauthorized)

Token API invalide ou expiré. Régénérez le token dans KoboToolbox et recréez / mettez à jour la tâche.

Compte en attente d’approbation

Votre demande a bien été envoyée. Contactez l’administrateur pour qu’il l’approuve depuis la page Demandes.

La synchronisation ne tourne pas

Vérifiez que :

  • le type de tâche est bien Synchronisation
  • la fréquence est correctement définie
  • l’UID destination est renseigné
  • les logs de la page Détails ne montrent pas d’erreur

Besoin d’aide ?

Contactez Pape NDIAYE : pape.ndiaye@elevage.gouv.sn

Prêt à démarrer ?

Créez votre compte ou lancez votre première tâche.

Demander un compte Se connecter