Comment échanger avec Jira et Azure DevOps

Guide d’usage Gestion de projet

À quoi ça sert : Vous envoyez votre backlog, vos risques ou vos actions vers Jira ou Azure DevOps. Vous pouvez aussi faire venir un backlog ou un sprint qui existe déjà dans Jira ou Azure DevOps. Vous gardez l'état des stories à jour, et vous reliez vos notes aux tickets.

Important : Borealmap ne se connecte pas à Jira ni à Azure DevOps. Il n'y a aucune synchronisation. L'échange passe par des fichiers CSV.

Avant de commencer : Passez en mode Édition. Ouvrez « Projet et rituels ».

Exporter le backlog

  1. Cliquez l'onglet « Backlog ».
  2. Ouvrez « Exporter vers Jira / Azure ». Ce menu apparaît quand le backlog a des éléments.
  3. Choisissez le « Séparateur » : « ; (Excel en français) » ou « , (standard) ».
  4. Cliquez « Jira (CSV) » ou « Azure DevOps (CSV) ».
  5. Importez le fichier dans Jira ou Azure DevOps, avec leur outil d'import.

L'onglet « Backlog » avec le menu « Exporter vers Jira / Azure » ouvert : « Séparateur » et les deux boutons CSV.

L'onglet « Risques » a les mêmes boutons, pour les risques ouverts.

Ce que contient le fichier

  • Une feature devient une Epic dans Jira, et une Feature dans Azure DevOps.
  • Un epic de Borealmap (le niveau au-dessus des features, s'il y en a) devient une Epic dans Azure DevOps.
  • Jira n'a pas ce niveau : un epic de Borealmap n'est pas un ticket. Son titre est écrit dans la colonne « Labels » de chacune de ses features (sans accents, avec des tirets à la place des espaces) et sur la ligne « Epic : » de leur description.
  • Une story devient une Story dans Jira, et une User Story dans Azure DevOps.
  • Une tâche sous une story devient une Sub-task dans le CSV de Jira.
  • Azure DevOps ne crée pas le lien au parent. Le titre du parent va dans la description.
  • Une tâche peut avoir une « Activité » et un « Travail restant (h) ». Ils vont dans les colonnes « Activity » et « Remaining Work » du CSV d'Azure DevOps.
  • Si aucune tâche les remplit, la colonne n'est pas écrite.
  • Le CSV de Jira ne les reprend pas.

Importer un backlog ou un sprint

Le backlog existe déjà dans Jira ou Azure DevOps ? Faites-le venir dans Borealmap. Les rituels s'en servent tout de suite : roadmap, sprints, revue.

  1. Exportez les tickets en CSV. Dans Jira : « Exporter » › « CSV ». Dans Azure DevOps : une requête, puis « Exporter en CSV ».
  2. Gardez au moins le type, le titre, l'état, le parent et le sprint. Les points, la priorité, la description et les critères d'acceptation sont repris aussi.
  3. Dans Borealmap, ouvrez l'onglet « Backlog ».
  4. Cliquez « Importer depuis Jira / Azure ». Sur un backlog vide, c'est une carte. Sinon, c'est un bouton de la barre.
  5. Choisissez le fichier. Lisez la colonne « Ce qui se passera » : « Ajoutée », « Mise à jour » ou « Ignorée ».
  6. Cliquez « Importer ».
  7. Envie de voir le tout en schéma ? Cliquez « Dessiner le schéma ». Un backlog importé de Jira devient un schéma brouillon.

L'aperçu « Importer un backlog Jira / Azure DevOps » : chaque ligne avec son type, son parent, son sprint, ses points, son état et ce qui se passera.

Comment les tickets deviennent des éléments du backlog :

  • Une Feature devient une feature. Une Epic devient une feature, ou un epic si le fichier a aussi des Features.
  • Une Story, une User Story, un Product Backlog Item ou un Bug devient une story.
  • Une Task ou une Sub-task devient une tâche.
  • Si le fichier a des Epics et des Features (Azure DevOps), les Epics deviennent des epics de Borealmap et les Features des features. Le niveau « Epic » apparaît dans le backlog.
  • Si le fichier a des Epics et des Stories, sans Feature (Jira), les Epics deviennent des features.
  • Un élément déjà dans le backlog, avec la même clé, est mis à jour. Il n'est jamais copié deux fois. Son état, son sprint et ses points changent. Son titre et sa place restent ceux de Borealmap.

Mettre à jour l'état des stories

Après l'export, Jira ou Azure DevOps garde l'état des stories. Borealmap le reprend sans saisie.

  1. Dans l'onglet « Backlog », cliquez « Mettre à jour l'état ».
  2. Le plus simple : copiez la phrase proposée et donnez-la à votre IA. Elle dépose un fichier pour Borealmap.
  3. Cliquez « Importer ». Choisissez le fichier de l'IA, ou un export CSV de Jira ou d'Azure DevOps.
  4. Lisez ce qui va changer. Cliquez « Appliquer ».

L'état sert à la revue de sprint et au roadmap.

Importer l'état des tickets sur les notes

Cette étape relie des notes à des tickets. Elle peut marquer des actions « Faite ».

  1. Sur chaque note, collez l'adresse du ticket dans « Lien Jira / Azure DevOps ». Borealmap garde la clé.
  2. Exportez vos tickets en CSV depuis Jira ou Azure DevOps.
  3. Dans Borealmap, cliquez dans le vide. Ouvrez « Propriétés ».
  4. Dans « Notes : rituels d'équipe », cliquez « Importer un export Jira / Azure (CSV) ».
  5. Lisez la colonne « Ce qui se passera ». Une ligne se lie à la note qui a la même clé.
  6. Sans note, choisissez « Aucune note (ignorer) » ou « Créer une note sur » une étape.
  7. Cliquez « Appliquer ».

L'aperçu « Importer un export Jira / Azure DevOps » : deux lignes liées à une note et une ligne qui crée une note.

Bon à savoir

  • L'import sur les notes ne crée ni stories ni risques. Pour des stories, utilisez « Importer depuis Jira / Azure » dans le « Backlog ».
  • L'import d'un backlog ne crée pas de risques.
  • Ctrl+Z annule tout un import d'un coup.

Si ça ne marche pas

  • « Aucune colonne reconnue » : exportez les tickets en CSV depuis Jira ou Azure DevOps.
  • « Ce fichier n'a pas de colonne de titre » : le fichier n'est pas un export de Jira ou d'Azure DevOps.
  • Une ligne « Ignorée » avec « Type inconnu de Borealmap » : par exemple un cas de test. Borealmap ne garde que les features, stories, bugs et tâches.
  • « placée au premier niveau » : son parent n'est pas dans le fichier. Glissez-la ensuite sur sa feature.
  • Pas de bouton d'import : il faut au moins une note.
  • « Appliquer » est grisé : aucune ligne ne sera liée ni créée.

Voir aussi