Comment synchroniser les points d'histoire avec Jira

Vous pouvez faire du planning poker directement à partir de votre backlog Jira : importez les tickets dans une salle, estimez-les en équipe, puis faites automatiquement inscrire les points d'histoire validés sur chaque ticket, sans aucune saisie manuelle. Vous éliminez ainsi l'étape lente et sujette aux erreurs qui clôt la plupart des séances d'estimation, lorsque quelqu'un reporte les chiffres sur les tickets un par un. Voici comment connecter Jira, importer les tickets, les estimer et renvoyer les points, ainsi que quelques conseils pour bien estimer une fois la configuration terminée.

Vous cherchez encore un outil ? Découvrez pourquoi les équipes utilisent le planning poker pour Jira sans installer d'application Marketplace.

Ce qu'il vous faut

• Un site Jira Cloud. (Jira Data Center n'est pas pris en charge.)
• Un compte Jira qui peut consulter le projet (pour importer les tickets) et modifier les tickets (pour y inscrire les estimations). Un compte partagé créé à cette fin, comme [email protected], est préférable au compte personnel d'un membre de l'équipe, car son jeton cesse de fonctionner lorsque cette personne quitte l'entreprise.
• L'autorisation de gérer Planning Poker dans votre organisation pour connecter Jira. Les propriétaires la possèdent par défaut.

Étape 1 : connecter Jira

1. Ouvrez Paramètres → Intégrations, choisissez Jira, puis Connecter.
2. Choisissez la méthode qui vous convient :

• OAuth : vous êtes redirigé vers Atlassian, vous autorisez l'accès, puis vous revenez. Rien à copier. Cette option s'affiche lorsqu'elle a été configurée pour votre espace de travail.
• Jeton d'API : une clé d'accès personnelle. Renseignez trois champs : votre site Jira (par exemple https://votre-equipe.atlassian.net), l'adresse e-mail de votre compte et le jeton d'API. Créez le jeton sur le site d'Atlassian : id.atlassian.com → Security → API tokens → Create API token (le jeton standard, et non celui « with scopes »). Le jeton dispose des mêmes autorisations que le compte qui l'a créé. Consultez les instructions détaillées et les vérifications à effectuer en cas de problème : connecter Jira avec un jeton d'API.

1. Cliquez sur Tester pour vérifier la connexion. Votre clé est stockée de manière sécurisée et ne sera plus jamais affichée.

Étape 2 : choisir la destination de l'estimation

Juste après la connexion, l'étape Configurer vous demande si l'estimation validée doit être renvoyée à Jira et dans quel champ.

• Activez Renvoyer l'estimation validée.
• Choisissez le champ Jira où sont enregistrées vos estimations. La liste affiche les champs numériques de votre site et Story point estimate est déjà sélectionné s'il existe.
• Vous pourrez modifier ce réglage plus tard dans Paramètres d'estimation.

Vous ne savez pas lequel des deux champs d'estimation Jira choisir ? La section suivante vous explique la différence.

Story Points ou Story point estimate ? Quel champ choisir ?

Jira comporte deux champs d'estimation qui se ressemblent. Choisir le mauvais est la raison la plus fréquente pour laquelle une estimation n'apparaît pas sur le tableau. Le champ à utiliser dépend du type de projet :

Deux points à surveiller :

• Les tableaux personnalisés fonctionnent comme ceux des projets gérés par l'entreprise. Sur un tableau personnalisé, seul Story Points est disponible comme statistique d'estimation, même si le projet est géré par l'équipe. Atlassian recommande d'utiliser le tableau créé avec le projet géré par l'équipe.
• La migration d'un projet vers un autre type peut faire perdre les estimations. Lorsque vous migrez un projet géré par l'équipe vers un projet géré par l'entreprise, laissez l'option « Retain » cochée pour conserver vos points d'histoire.

Quel que soit le champ choisi, vérifiez qu'il figure sur l'écran du ticket dans ce projet ; sinon, Jira refusera la mise à jour.

Étape 3 : importer les tickets dans une salle

1. Créez une salle (ou ouvrez-en une existante), puis choisissez Importer dans le panneau des tâches.
2. Choisissez Jira, puis votre projet.
3. Affinez la liste à l'aide des filtres : sprint, epic, type de ticket et statut. Vous pouvez aussi faire une recherche textuelle.
4. Sélectionnez les tickets souhaités, ou tous les tickets, puis importez-les.

Les tickets déjà présents dans la salle sont signalés, afin d'éviter les doublons. Chaque tâche conserve sa clé Jira (comme PROJ-142), un lien vers le ticket et les premières lignes de sa description.

Étape 4 : estimer

Animez la séance comme d'habitude : ouvrez une tâche, faites voter tout le monde, révélez les votes, discutez des écarts et validez l'estimation. Si cette pratique est nouvelle pour vous, notre guide pas à pas du planning poker détaille chaque étape. Lorsque vous validez l'estimation, le nombre est inscrit sur le ticket Jira en quelques instants, sans faire attendre la salle. L'historique de la salle indique alors Estimation envoyée, ou précise pourquoi elle n'a pas pu l'être.

Ce qui est envoyé ou non

• Les nombres sont envoyés. Les demi-points fonctionnent aussi, car le champ Jira est numérique.
• Les cartes ? et ☕ ainsi que les tailles de tee-shirt ne sont pas envoyées, car ce ne sont pas des nombres. Elles sont conservées dans l'historique avec la mention « non envoyé ».

Si votre équipe estime avec des tailles de tee-shirt, continuez à les utiliser dans la salle et saisissez les points d'histoire manuellement dans Jira, ou convenez d'utiliser un jeu de cartes numérique pour les séances liées à Jira.

Bien estimer, avec ou sans Jira

• Estimez avant le sprint, pas pendant. Examinez les éléments du backlog qui seront bientôt traités, afin que le sprint commence avec des chiffres dont l'équipe a déjà discuté.
• Choisissez une seule échelle et gardez-la. Alterner entre Fibonacci et les tailles d'une séance à l'autre rend votre historique impossible à comparer.
• Les points mesurent l'effort et l'incertitude, pas le temps. Évitez de les convertir en heures. La vélocité des sprints précédents vous indiquera combien de points peuvent tenir dans le suivant. Pour comprendre ce que sont réellement les points, et ce qu'ils ne sont pas, consultez que sont les points d'histoire ?.
• Réestimez si le périmètre change. Une tâche qui s'est étoffée après la discussion mérite un nouveau vote.

Le planning poker est l'une des techniques d'estimation agile ; c'est celle qui se prête le mieux à l'inscription d'un nombre convenu dans un outil de suivi comme Jira.

Si une estimation n'a pas été envoyée

• « Le champ n'est pas sur l'écran » ou erreur d'autorisation : vérifiez que le champ figure sur l'écran du ticket dans ce projet et que le compte connecté peut le modifier.
• La connexion ne fonctionne plus : le jeton a peut-être été révoqué ou a expiré. Utilisez Tester dans la page Intégrations, puis Reconnecter au besoin.
• La valeur n'est pas un nombre : la carte ?, ☕ ou une taille de tee-shirt. C'est normal.

La connexion ne prend que quelques minutes. Ensuite, les résultats de vos séances sont envoyés au bon endroit, sans que personne ait à les recopier.

Foire aux questions

Peut-on faire du planning poker dans Jira ?

Vous faites votre planning poker dans une salle connectée à Jira : importez les tickets, estimez-les en équipe, puis les points d'histoire validés sont automatiquement inscrits sur chaque ticket Jira. Aucune copie manuelle n'est nécessaire.

Dans quel champ Jira les points d'histoire sont-ils enregistrés ?

Dans le champ numérique que vous choisissez lors de la connexion, généralement Story point estimate. Notez que Jira comporte deux champs similaires, Story points et Story point estimate : choisissez celui que votre tableau affiche et vérifiez qu'il figure sur l'écran du ticket.

Est-ce compatible avec Jira Data Center ou Server ?

Non. L'intégration prend uniquement en charge Jira Cloud.

Me faut-il un jeton d'API ou puis-je utiliser OAuth ?

Les deux sont possibles. OAuth permet d'autoriser la connexion en un clic, à condition que l'option soit configurée pour votre espace de travail. Le jeton d'API est une clé personnelle que vous créez sur Atlassian et saisissez dans trois champs. Une fois connectées, les deux méthodes fonctionnent de la même manière.

Que deviennent les votes non numériques comme « ? » ou les tailles de tee-shirt ?

Ils ne sont pas envoyés à Jira, car le champ est numérique. Ils restent dans l'historique de la salle avec la mention « non envoyé ». Si vous estimez avec des tailles de tee-shirt, saisissez les points dans Jira manuellement ou utilisez un jeu de cartes numérique pour les séances liées à Jira.

Toute l'équipe peut-elle estimer sans compte Jira ?

Oui. Seule la connexion utilise un compte Jira. Les membres de l'équipe rejoignent la salle à partir d'un lien, sans compte, et seule l'estimation validée est inscrite dans Jira.