Migrer de Jira vers Jalonio, pas à pas.

CSV ou API : quelle méthode choisir ?

• Export CSV : accessible aux chefs de projet (vers leur projet) et aux personnes autorisées à créer des projets. Pratique pour un premier essai, ou si votre Jira n’est joignable que sur votre réseau interne.
• Connexion par l’API : réservée aux administrateurs de l’organisation. Plus complète : elle reprend aussi les sprints, tous les commentaires et les pièces jointes, sans fichier à manipuler. Elle fonctionne avec Jira Cloud et Jira Data Center.

Avant de commencer

• Invitez d’abord votre équipe dans Jalonio : les personnes de Jira sont rapprochées des comptes existants par leur adresse e-mail ou leur nom.
• Notez la clé du projet Jira (par exemple PORT) : en la reprenant dans Jalonio, PORT-12 reste PORT-12.
• Pour l’API, vérifiez que le compte Jira utilisé peut parcourir le projet. La lecture seule suffit.
• Prévenez l’équipe : après l’import, c’est Jalonio qui fait foi.

Méthode 1 : importer un export CSV

1. Exportez depuis Jira. Dans les filtres de Jira, recherchez les tickets du projet, puis exportez la recherche au format CSV (tous les champs). Pour les pièces jointes, préparez si besoin une archive ZIP de vos fichiers.
2. Ouvrez l’écran d’import. Dans Jalonio : « Projets », puis « Importer depuis Jira ».
3. Fichier et projet. Déposez le fichier CSV (50 Mo au plus ; encodage et séparateur sont détectés), et l’archive ZIP des pièces jointes si vous en avez une : les fichiers sont rattachés par leur nom. Choisissez « Nouveau projet » ou « Projet existant ».
4. Correspondances. « Analyser le fichier » : Jalonio propose une correspondance pour chaque colonne, chaque statut, type et priorité, et chaque personne. Tout est modifiable. Les exports de Jira en français comme en anglais sont reconnus. Les colonnes du titre (« Summary ») et de la clé (« Issue key ») sont obligatoires.
5. Simulation. « Simuler l’import » n’écrit rien. Vérifiez les chiffres (tickets à créer, à mettre à jour, ignorés), les anomalies ligne par ligne et l’aperçu des 10 premiers tickets.
6. Import. « Lancer l’import » : l’avancement s’affiche, et vous êtes prévenu à la fin.
7. Rapport. Tickets créés, mis à jour, ignorés, pièces jointes non importées. « Télécharger le rapport détaillé (CSV) » garde une trace de la migration.

Méthode 2 : se connecter à Jira par l’API

1. Créez un jeton dans Jira. Jira Cloud : page des jetons d’API de votre compte Atlassian, « Créer un jeton d’API », avec une courte durée. Jira Data Center : votre profil, « Jetons d’accès personnels », avec une date d’expiration.
2. Choisissez la source. Dans Jalonio : « Projets », « Importer depuis Jira », puis « Connexion à Jira (API) ».
3. Testez la connexion. Choisissez Cloud ou Data Center, collez l’adresse de Jira, l’adresse e-mail du compte (Cloud) et le jeton, puis « Tester la connexion ». Une erreur est expliquée en clair : identifiants refusés, permission manquante, adresse introuvable, certificat invalide.
4. Choisissez les projets. Le projet Jira, et le projet Jalonio cible : par défaut, un nouveau projet de même nom et de même clé, pour conserver les numéros.
5. Lisez les tickets. « Lire les tickets de Jira » affiche l’avancement. Si Jira limite le nombre de requêtes, la lecture ralentit, puis reprend toute seule.
6. Terminez comme avec le CSV. Correspondances (sprints compris), simulation, import et rapport.

Le jeton est conservé chiffré le temps de l’import, puis effacé : à la fin, en cas d’échec, ou si vous cliquez sur « Annuler et effacer les identifiants ». Révoquez-le aussi dans Jira une fois l’import terminé.

Ce qui est repris, et ce qui ne l’est pas

Le temps passé n’est pas repris parce que Jalonio ne propose pas de suivi du temps. La clé Jira d’origine reste visible sur chaque fiche et se retrouve par la recherche.