Guide Utilisateur

Apprenez à utiliser Kobo Transfer pour transférer vos projets et données

Table des matières

1. Prérequis
2. Configuration
3. Création d'une tâche
4. Planification automatique
5. Exécution manuelle
6. Surveillance et logs
7. Dépannage

1 Prérequis

Avant de commencer, assurez-vous d'avoir :

Un compte sur les serveurs KoboToolbox source et destination
Des tokens API pour chaque serveur
L'Asset UID du projet à transférer (visible dans l'URL du projet)
Un accès à cette interface web

💡 Astuce : Les tokens API se trouvent dans les paramètres de votre compte KoboToolbox, section "API Tokens".

2 Configuration des Serveurs

Le système supporte tous les serveurs KoboToolbox dont les deux ci-dessous:

Serveur Global

KC URL: https://kc.kobotoolbox.org
KF URL: https://kf.kobotoolbox.org

Serveur EU

KC URL: https://kc-eu.kobotoolbox.org
KF URL: https://eu.kobotoolbox.org

3 Création d'une Tâche de Transfert

Pour créer une nouvelle tâche de transfert :

Connectez-vous à l'interface web (bouton "Connexion" en haut à droite)
Remplissez le formulaire avec les informations suivantes :
- Nom de la tâche : Un nom descriptif pour identifier votre tâche
- Source : Serveur URL, Asset UID et Token API du projet source
- Destination : Serveur URL, Asset UID (optionnel) et Token API du projet destination
- Fréquence : Planification de l'exécution automatique
Cliquez sur "Créer la Tâche"

⚠️ Important : Si vous laissez l'Asset UID de destination vide, un nouveau projet sera créé automatiquement sur le serveur de destination.

4 Planification Automatique

Vous pouvez choisir entre deux modes de planification :

Mode Simple

Quotidien : Tous les jours à une heure spécifiée
Toutes les heures : À chaque heure (ex: 14:00, 15:00, 16:00...)
Hebdomadaire : Une fois par semaine (dimanche par défaut)

Mode Expert (Cron)

Pour des planifications avancées, utilisez une expression Cron :

*/15 * * * * : Toutes les 15 minutes
0 */2 * * * : Toutes les 2 heures
0 9 * * 1 : Tous les lundis à 9h

5 Exécution Manuelle

Vous pouvez exécuter une tâche manuellement à tout moment :

Accédez à la liste de vos tâches
Cliquez sur le bouton Exécuter
Ou cliquez sur "Détails" puis sur le bouton "Exécuter" dans la page de détails

💡 Note : L'exécution manuelle n'affecte pas la planification automatique. La tâche continuera de s'exécuter selon son planning.

6 Surveillance et Logs

Pour surveiller l'exécution de vos tâches :

Page de détails : Cliquez sur "Détails" pour voir les logs d'exécution de chaque tâche
Logs en temps réel : Les logs affichent les 100 dernières lignes pertinentes
Actualisation : Utilisez le bouton "Actualiser" pour mettre à jour les logs

=== TÂCHE 212fdce6 - Wed Dec 31 13:15:01 UTC 2025 ===
📋 Transferring asset, versions and form media
✅ Transfert réussi
=== FIN TÂCHE 212fdce6 - Wed Dec 31 13:15:45 UTC 2025 ===

7 Dépannage

Erreur 401 (Unauthorized)

Votre token API est invalide ou a expiré. Vérifiez vos tokens dans les paramètres de votre compte KoboToolbox et mettez à jour la tâche.

La tâche ne s'exécute pas

Vérifiez que :

Le service cron est actif : dans les détails de la tâche
La tâche est activée (statut "Actif" dans l'interface)
Le planning est correct

Besoin d'aide ?

Pour toute question ou problème, contactez Pape NDIAYE à pape.ndiaye@elevage.gouv.sn.