Gestion des exigences dans JIRA et Confluence: première partie


Publié par
Romain BEAUVOIS

28 septembre 2016

Comprendre et gérer les exigences clients est l’objectif principal de toute entreprise développant des applications. Pour cela, les chefs de projet ont besoin d’un endroit pour réunir, affiner et suivre les exigences de manière efficace.

Dans ce blog – en deux parties – nous allons suivre le cycle de vie des exigences, depuis la collecte des besoins jusqu’à l’achèvement des travaux relatifs à une exigence spécifique, en expliquant comment gérer les exigences avec JIRA et Confluence pour assurer un produit final qui dépasse les attentes du client.

Dans cette première partie, nous allons nous focaliser sur la gestion des exigences dans Confluence.

La collecte des besoins en utilisant un modèle de page

Dans Confluence vous pouvez créer un espace pour chaque produit ou équipe de votre entreprise. Cela permet de centraliser toutes les informations concernant un produit spécifique en un seul et même endroit (c-à-d les plans de projet, les exigences du produit, les blogs et la communication interne, etc.). Les avantages sont les suivants :

 

  • La collaboration : un espace ou page unique permet de meilleures communication et collaboration entre les personnes impliquées dans le produit ou exigence. Le temps des des fichiers Word, des feuilles Excel et des chaînes d’e-mails sans fin est terminé !
  • L’Avancement : suivre l’avancement des exigences, mentionner des personnes spécifiques pour attirer leur attention et assigner des tâches.
  • L’historique de la page : revenir à une version antérieure du document et voir aisément les différences entre deux versions sélectionnées.

 

Confluence vous permet de créer des modèles de pages qui aident à normaliser le contenu dans un espace donné. Le but est donc de créer des modèles pour saisir les exigences initiales, qui seront communs à toutes les personnes impliquées dans le projet. Puis, vous pouvez affiner ces exigences initiales et les décomposer en user stories sur lesquelles s’appuieront les équipes de développement. Ceci est la première étape pour gérer les exigences du projet dans Confluence.

VOICI COMMENT PROCÉDER :

Cliquez sur le bouton Outils de l’espace, puis sur Gestion des contenus (note : vous devez être un administrateur de l’espace pour accéder à ce menu).

content_tools_part1

Dans Outils de l’espace, vous pouvez créer un modèle d’espace (disponible uniquement à un espace spécifique) ou un modèle global (disponible pour tous les espaces) dans votre Confluence.

content_tools_part2

Après avoir créé le modèle, vous pouvez utiliser la macro Créer une page à partir du modèle. Vous pouvez placer un bouton « Créer un modèle » n’importe où dans Confluence pour rendre la création de nouvelles exigences très facile à tous les utilisateurs. Dans mon cas, j’ai ajouté le bouton sur la page d’accueil de mon espace, comme ci-dessous :

product_page

Dans cet exemple, j’utilise le modèle classique de l’exigence de produit dans Confluence, mais vous pouvez créer des modèles adaptés au format de votre entreprise. Habituellement les fichiers Word ou Excel qui sont utilisés pour la collecte des exigences, font un bon point de départ pour la création d’un modèle. Il est aussi possible de modifier les modèles natifs fournis dans Confluence.

example_template

Exemple: Modèle de page des exigences produits

Comme illustré ci-dessus, le modèle fournit un texte d’instructions qui explique le contenu à inclure dans chaque section du modèle. Cette indication disparaît une fois que l’utilisateur commence à taper du texte, et deviendra invisible lorsque la page est enregistrée.

req_example

Exemple de page d’exigences

Création de tickets JIRA pour le suivi des exigences

J’ai ajouté quelques données dans le document d’exigences, comme illustré ci-dessus. Lorsque Confluence est connecté à JIRA, je peux faire ce qui suit :

  • Mettez en surbrillance le texte dans le tableau des exigences et choisissez le raccourci Créer un ticket JIRA  pour créer des user stories dans JIRA, et automatiquement les relier à une epic.

create

Création de tickets JIRA depuis la table des exigences dans Confluence.

create_issue_part1    create_issue_part3

Cette fonctionnalité vous permet de créer des user stories uniques ou multiples en quelques clics et d’avoir automatiquement un lien vers une epic présente dans la page.

(Notez que la création d’histoire d’utilisateurs multiples ne fonctionne que si vous mettez les histoires dans un tableau)

  • Une fois le projet JIRA cible choisi, je presse « Créer », et chaque colonne sera mise à jour automatiquement avec le numéro et le statut du ticket JIRA créé comme montré ci-dessous:

req_table

Maintenant, l’état de ces tickets JIRA sera automatiquement mis à jour dans la page Confluence et pourra être suivi directement dans ce document d’exigence. Cela permet aux personnes qui ont soulevé la nécessité de connaître son état actuel.

Gérer les exigences dans Confluence: quelle est la prochaine étape ?

Vous avez appris à créer un modèle de page pour le recueil des exigences dans Confluence et à créer des user stories dans JIRA automatiquement pour vous aider à gérer les exigences dans Confluence. Allez-y ! Essayez par vous-même.

Dans le prochain blog je vous montrerai comment configurer JIRA pour terminer le cycle de vie de l’exigence. En attendant, laissez moi un commentaire si vous avez des questions!