Intégration avec Jira

L’intégration avec Jira affiche les tâches Jira dans le planning de projet de FlexiProject. Chaque projet peut récupérer des tâches depuis un ou plusieurs projets Jira, et la liste des tâches récupérées est restreinte par des types de tâches ou par un filtre JQL. Les tâches Jira restent synchronisées avec Jira dans le planning ; leurs champs sont en lecture seule.

Un administrateur active l’intégration et la configure dans Paramètres du système > JIRA (voir Paramètres du système). La liaison des utilisateurs Jira avec les utilisateurs de FlexiProject permet au planning et à la charge de travail des ressources d’afficher les propriétaires des tâches Jira.

Connexion à Jira

La clé de connexion dans Jira

1. Dans Jira, cliquez sur l’avatar dans le coin supérieur droit et choisissez Gérer votre compte.
2. Passez à l’onglet Sécurité et, dans la section Jeton d’API, cliquez sur Créer et gérer des jetons d’API.
3. Cliquez sur Créer un jeton d’API, saisissez un nom (par exemple « FlexiProject ») et cliquez sur Créer.
4. Copiez la clé générée. Jira ne l’affiche qu’une seule fois.

Activer l’intégration dans FlexiProject

1. Ouvrez Paramètres du système (menu principal) et passez à la page JIRA. La carte Intégration avec JIRA s’affiche.
2. Basculez l’intégration sur Activé.
3. Saisissez l’Adresse du serveur — l’adresse à laquelle s’ouvre le Jira de votre organisation, par exemple https://name.atlassian.net.
4. Saisissez le Courriel de l’utilisateur — le même que celui avec lequel est connecté l’utilisateur qui a généré la clé.
5. Collez la clé copiée dans le champ Clé.
6. Cliquez sur Enregistrer. Avec des données correctes, le message La connexion au serveur JIRA est correcte s’affiche ; avec des données incorrectes, Échec de la connexion au serveur JIRA ou Adresse incorrecte du serveur JIRA.

Le bouton Vérifier la connexion permet de contrôler l’état de la connexion à tout moment.

Remarque : le passage de l’intégration sur Désactivé supprime tous les liens des projets avec Jira et toutes les tâches Jira des plannings. Cette opération est irréversible, et pour la réactiver il faut relier de nouveau les projets.

Liaison des utilisateurs Jira

Sous les paramètres de connexion se trouve le tableau Utilisateurs avec les colonnes Nom de Jira, ID Jira et Utilisateur (l’utilisateur FlexiProject lié). Un filtre au-dessus du tableau restreint la liste. Lorsque la connexion est active, FlexiProject essaie en continu de lier les utilisateurs Jira aux utilisateurs FlexiProject en comparant les adresses e-mail. Lorsque Jira communique une adresse e-mail et que la même adresse existe dans FlexiProject, l’avatar et le nom de l’utilisateur lié apparaissent à côté du nom Jira. Le fait que Jira communique ou non les adresses dépend de ses paramètres de sécurité globaux et des paramètres de confidentialité de l’utilisateur Jira.

Les liens créés automatiquement se mettent à jour d’eux-mêmes. Ceux ajoutés manuellement, non : après un changement de nom de famille ou d’adresse e-mail, il faut les corriger à la main.

Lier manuellement

1. Survolez une ligne sans utilisateur lié et cliquez sur le symbole des trois points.
2. Choisissez Connecter. La fenêtre Lier l’utilisateur s’ouvre.
3. Sélectionnez l’utilisateur FlexiProject et cliquez sur Enregistrer.

Supprimer un lien

1. Survolez une ligne avec un utilisateur lié et cliquez sur le symbole des trois points.
2. Choisissez Déconnecter. La question Êtes-vous sûr de vouloir supprimer le lien ? s’affiche.
3. Confirmez avec Enregistrer.

Importer la liste des utilisateurs Jira

1. Générez un fichier CSV des utilisateurs dans le panneau d’administration Atlassian (admin.atlassian.com), dans l’onglet des utilisateurs, avec la commande d’exportation. Le fichier doit contenir les champs User id, User name et email.
2. Cliquez sur Importations d’utilisateurs Jira sous l’en-tête du tableau. La fenêtre d’importation s’ouvre.
3. Sélectionnez le fichier ou faites-le glisser dans la fenêtre, puis cliquez sur Enregistrer. La liste des utilisateurs Jira est mise à jour, et les liens trouvés sont renseignés automatiquement.

Les lignes comportant des valeurs incorrectes sont ignorées, et l’application les énumère après l’importation ; un fichier incorrect se termine par un message signalant un format CSV erroné.

Tâches Jira dans le planning du projet

Lier un projet à Jira

1. Ouvrez le projet, onglet Planning.
2. Cliquez sur Paramètres et choisissez Connexion à JIRA (cet élément est visible dès que l’intégration est activée). La fenêtre Intégration avec JIRA s’ouvre.
3. Saisissez la Clé de projet Jira. Pour récupérer des tâches de plusieurs projets Jira, saisissez les clés séparées par des virgules.
4. Cliquez sur Connecter. La fenêtre Importations de JIRA s’ouvre.
5. Choisissez le mode de récupération des données dans la partie Téléchargement de données : Type de tâches (uniquement avec un seul projet Jira) ou Filtre JQL (voir Filtre JQL).
6. Pour les types de tâches : cochez les types de tâches sur les niveaux de la hiérarchie (au moins un type — sinon le message Au moins un niveau doit être marqué s’affiche), puis cliquez sur Enregistrer. Les dépendances entre les types de tâches sont converties en hiérarchie de tâches dans le planning lorsque c’est possible.

Lorsque le téléchargement réussit, les tâches Jira apparaissent dans le projet, et une icône Jira s’affiche à côté du nom du projet ; un clic dessus ouvre le projet Jira dans un nouvel onglet. Le téléchargement peut échouer, par exemple lorsque l’utilisateur indiqué dans la connexion n’a pas les permissions nécessaires ou que le JQL contient une erreur de syntaxe (Erreur dans une requête JQL). L’application affiche alors un message. Une clé qui n’existe pas ou à laquelle vous n’avez pas accès aboutit au message Clé de projet incorrecte, le projet n’existe pas ou vous n’y avez pas accès.

Modifier le mode de récupération des tâches

La même commande Connexion à JIRA ouvre la fenêtre Importations de JIRA pour un projet déjà lié, où vous modifiez les types de tâches ou la requête JQL.

Supprimer les tâches Jira d’un projet

1. Ouvrez la fenêtre Importations de JIRA avec la commande Connexion à JIRA.
2. Cliquez sur Supprimer et confirmez dans la fenêtre Suppression du lien JIRA. Le message avertit que la suppression du lien supprime tous les liens du planning et qu’elle est irréversible.

Après la suppression, les tâches Jira disparaissent du planning, et le projet n’est plus marqué comme connecté à Jira.

Filtre JQL

Le JQL (Jira Query Language) permet de récupérer dans un projet exactement les tâches Jira dont vous avez besoin, y compris depuis plusieurs projets Jira à la fois.

1. Dans Jira, préparez un filtre dans l’outil Filtres. Le code JQL est visible après avoir fait passer l’affichage du filtre du mode de base au mode JQL.
2. Copiez le code JQL.
3. Dans FlexiProject, dans la fenêtre Importations de JIRA, choisissez Filtre JQL et collez le code dans le champ de texte.
4. Cliquez sur Enregistrer.

Une requête comportant une erreur de syntaxe est rejetée avec le message Erreur dans une requête JQL. Le filtre n’influe que sur les tâches qui arrivent dans le planning ; à chaque synchronisation, les tâches qui ne figurent pas dans le résultat du filtre disparaissent du planning.

Tâches Jira dans le planning

Les tâches Jira arrivent à la fin du planning avec leur structure conservée et portent une icône Jira dans le planning. Elles se mettent à jour automatiquement lors d’une synchronisation périodique ; les champs qui proviennent de Jira — Nom, Description, Progrès, Propriétaire et la hiérarchie des tâches — sont en lecture seule. Vous ne pouvez pas modifier l’avancement ni les propriétaires d’une telle tâche (l’application affiche Il n’est pas possible de modifier le statut des tâches provenant de JIRA. et Il n’est pas possible de modifier les propriétaires des tâches provenant de JIRA.), et ces tâches ne sont pas copiées lors du clonage d’un projet. Une tâche Jira ne peut pas être la tâche parente de tâches FlexiProject. Vous pouvez réordonner les tâches sous une tâche parente Jira, et les tâches récapitulatives Jira avec leurs sous-tâches peuvent être insérées dans la structure du planning.

Pour un projet lié, le planning comporte trois colonnes supplémentaires : ID Jira (un clic ouvre la tâche dans Jira dans un nouvel onglet), Statut Jira et Type de Jira. L’avancement d’une tâche découle de la catégorie de statut dans Jira : à faire — 0 %, en cours — 50 %, terminé — 100 %.

Le propriétaire de la tâche provient de la liaison des utilisateurs (voir Liaison des utilisateurs Jira). Lorsqu’un utilisateur Jira est lié à un utilisateur FlexiProject, le planning affiche son avatar et son nom, et l’utilisateur est ajouté au projet. Sans liaison, vous voyez une icône d’avatar grise avec le nom Jira. Le planning est décrit dans Planning du projet.