JIRA

C’est quoi ?

JIRA est un logiciel de gestion de projets développé par la société Atlassian. Il est conçu pour aider les équipes de développement à suivre et à gérer les tâches, les bugs et les demandes de fonctionnalités de manière efficace.

A quoi ça sert ?

Il offre de nombreuses fonctionnalités pour aider les équipes à planifier, suivre et délivrer des projets de manière organisée. Il permet de créer des tickets de travail, de les assigner à des membres de l’équipe, de suivre leur avancement et de communiquer sur leur statut. JIRA prend en charge de nombreux types de projets, tels que les projets de développement logiciel, de marketing, de gestion de portefeuille, etc.

JIRA est disponible sous forme d’application cloud hébergée par Atlassian ou en tant qu’application autonome que vous pouvez déployer sur votre propre serveur. Il est largement utilisé par de nombreuses équipes de développement et de gestion de projets dans le monde entier.

Comment l’utiliser avec SpringBoot ?

Il existe plusieurs façons d’intégrer JIRA avec une application Spring Boot :

• En utilisant l’API REST de JIRA : JIRA expose une API REST qui permet de manipuler les tickets de travail, les projets, etc. depuis n’importe quelle application. Vous pouvez utiliser l’API REST de JIRA avec Spring Boot en utilisant une bibliothèque client REST, telle que Apache HttpClient ou Spring RestTemplate.

• En utilisant l’API Java de JIRA : JIRA expose également une API Java qui permet de manipuler les tickets de travail, les projets, etc. depuis une application Java. Vous pouvez utiliser l’API Java de JIRA avec Spring Boot en ajoutant la dépendance Maven com.atlassian.jira:jira-rest-java-client à votre projet.

• En utilisant un plugin JIRA : JIRA offre également un mécanisme de plugins qui permet d’étendre ses fonctionnalités et de personnaliser son comportement. Vous pouvez développer un plugin JIRA qui s’intègre à votre application Spring Boot et qui utilise les fonctionnalités de JIRA de manière transparente.

Voici quelques exemples de ce que vous pouvez faire en utilisant JIRA avec Spring Boot :

• Créer et mettre à jour des tickets de travail dans JIRA depuis votre application Spring Boot.
• Récupérer la liste des projets et des tickets de travail dans JIRA et les afficher dans votre application.
• Ajouter des commentaires et des pièces jointes à des tickets de travail dans JIRA depuis votre application.
• Déclencher des événements dans votre application lorsque des tickets de travail sont créés

Exemple de gestion d’un ticket de travail

Comment utiliser l’API Java de JIRA avec Spring Boot pour créer un nouveau ticket de travail ?

Avant, il est bien de définir ce qu’est un Ticket de travail :

Un ticket de travail est une fiche qui décrit une tâche à effectuer, un problème à résoudre ou une demande de fonctionnalité. En général, un ticket de travail est utilisé dans un système de gestion de projets pour suivre et gérer les tâches et les problèmes de manière organisée.

Un ticket de travail peut contenir plusieurs informations, telles que :

• Un titre ou un résumé qui décrit brièvement le contenu du ticket.
• Une description détaillée qui explique les détails du ticket et les étapes à suivre pour le résoudre.
• Des informations de priorisation, comme l’importance et l’urgence du ticket.
• Des informations de suivi, telles que l’état du ticket (ouvert, en cours, résolu, etc.), le responsable du traitement du ticket et la date de résolution prévue.
• Des pièces jointes, telles que des captures d’écran ou des fichiers de log.

Un ticket de travail est généralement créé par une personne qui constate un problème ou une demande de fonctionnalité, et est assigné à une personne ou une équipe qui s’occupera de le résoudre.

Le suivi et l’avancement du ticket de travail sont gérés dans le système de gestion de projets, de manière à ce que tous les membres de l’équipe soient informés de l’état du ticket.

@Autowired
private JiraRestClient jiraClient;

public void createIssue(String summary, String description) {
    IssueInputBuilder issueInputBuilder = new IssueInputBuilder();
    issueInputBuilder.setSummary(summary);
    issueInputBuilder.setDescription(description);
    issueInputBuilder.setIssueType(new IssueType("Bug", "bug"));
    IssueInput issueInput = issueInputBuilder.build();
    BasicIssue issue = jiraClient.getIssueClient().createIssue(issueInput).claim();
    System.out.println("Created issue: " + issue.getKey());
}

Ce code utilise l’objet JiraRestClient fourni par l’API Java de JIRA pour se connecter à l’instance JIRA et créer un nouveau ticket de travail avec un résumé et une description spécifiés.

Il existe de nombreuses autres possibilités d’intégration entre JIRA et une application Spring Boot. Vous pouvez par exemple utiliser l’API REST de JIRA pour récupérer des données de JIRA et les afficher dans votre application, ou développer un plugin JIRA pour ajouter de nouvelles fonctionnalités à JIRA depuis votre application.

Utilisation de notre Ticket de travail

Pour utiliser la méthode createIssue() définie précédent, vous devez d’abord vous assurer que l’objet JiraRestClient est correctement injecté dans votre classe en utilisant l’annotation @Autowired.

Voici comment procéder :

• Ajoutez la dépendance Maven com.atlassian.jira:jira-rest-java-client à votre projet pour inclure l’API Java de JIRA.
• Dans votre classe, déclarez une variable d’instance jiraClient de type JiraRestClient et injectez-la en utilisant l’annotation @Autowired.

@Autowired
private JiraRestClient jiraClient;

• Appelez la méthode createIssue() en lui passant les arguments appropriés.

createIssue("Problème de login", "Impossible de se connecter au site avec l'identifiant : toto");

Cette méthode créera un nouveau ticket de travail dans JIRA avec un résumé "Problème de login" et une description "Impossible de se connecter au site avec l'identifiant : toto".

Notez que vous devez également configurer votre application pour qu’elle se connecte à votre instance JIRA avant d’appeler la méthode createIssue().

Pour cela, vous pouvez utiliser la classe JiraRestClientFactory fournie par l’API Java de JIRA pour créer un objet JiraRestClient en lui passant les informations de connexion à votre instance JIRA.

JiraRestClientFactory factory = new AsynchronousJiraRestClientFactory();
URI jiraServerUri = URI.create("http://localhost:8080");
JiraRestClient restClient = factory.createWithBasicHttpAuthentication(jiraServerUri, "username", "password");

Conclusion

Voilà, vous savez maintenant comment utiliser la méthode createIssue() de notre exemple pour créer un nouveau ticket de travail dans JIRA avec Spring Boot.