Jira Server

Présentation

L’intégration Asana pour Jira Server renforce la collaboration et la visibilité pour les équipes qui travaillent sur Asana et Jira.

Cette intégration propose des fonctionnalités proches de celles de l’intégration Jira Cloud aux utilisateurs de Jira Server.

Elles permet aux équipes commerciales et aux équipes produit (qui passent la plupart de leur temps à planifier et traiter leur travail sur Asana) de collaborer avec les équipes d’ingénierie (qui planifient leur travail et l’accomplissent sur Jira) à la réalisation de différentes tâches, et d’assurer le suivi de ces dernières. Elle a pour but d’optimiser la programmation grâce au suivi des sprints et au final d’apporter plus de visibilité aux utilisateurs Asana concernant l’étape de développement sur Jira.

Asana pour Jira Server fait le lien entre les étapes de planification sur Asana et les phases de développement sur Jira, de l’exécution à la livraison.

Elle vous permet de créer et suivre le statut des tickets Jira dans des tâches Asana.

Conditions d’installation

Exigences Asana :

L’intégration Asana pour Jira Server est disponible pour tous les clients Premium, Business et Enterprise.

L’administrateur Jira doit :

• Disposer d’un compte Asana
• Avoir souscrit une formule payante
• Être en mesure de réaliser les premières étapes de l’installation

Exigences Jira :

Les instances Server et Data Center de Jira Software sont prises en charge. Vous devez configurer celle de votre choix selon les exigences indiquées en lien ci-dessous. Pour la prise en charge d’une version précise, veuillez consulter la liste Jira Marketplace.

Si vous utilisez Jira Cloud, choisissez l’intégration Asana pour Jira Cloud

Procédure d’installation

L’administrateur Jira doit créer le lien d’application en installant un fichier plug-in accessible sur le Jira Server Marketplace, puis compléter les premières étapes. Les utilisateurs finaux d’Asana pourront ensuite ajouter l’intégration à tous les projets auxquels ils ont accès.

Installation par l’administrateur Jira :

• Rendez-vous dans le répertoire GitHub, qui contient des détails sur les configurations de Jira Server autorisant les connexions externes.
• Après avoir configuré votre instance Server en conséquence, accédez à l’entrée du catalogue Jira Server Marketplace dédiée à Asana pour Jira Server et procédez à son installation.

L’administrateur Jira doit ensuite authentifier l’application en cliquant sur « Connect to Asana » (Connecter à Asana).

• Vous serez alors invité à vous authentifier sur Asana.
• Une fois cela fait, veuillez choisir le domaine Asana concerné pour le connecter à la nouvelle intégration.
• Une fois la confirmation reçue sur Jira, vous en avez terminé avec les étapes à suivre pour le serveur. C’est alors aux utilisateurs Asana de prendre le relai pour la suite.

Utilisateurs Asana :

1. Sur Asana, rendez-vous dans le projet que vous souhaitez ajouter à l’intégration.
2. Cliquez sur Personnaliser en haut à droite de votre écran, faites défiler le menu vers le bas, puis cliquez sur Ajouter une application.

Au cours de l’authentification, si vous recevez un message vous indiquant que « Votre instance d’Asana n’a pas été ajoutée sur Jira Server », revenez à l’étape d’installation réalisée par l’administrateur Jira et assurez-vous que l’organisation Asana est authentifiée, que le bon espace de travail est sélectionné et qu’il s’affiche dans Administration sur Jira Server.

Une fois le processus terminé, l’application est ajoutée au projet. Les utilisateurs devraient voir s’afficher un champ Jira Server sur les tâches auxquelles ils peuvent ajouter des tickets Jira ou qui leur permettent d’en créer de nouveaux sur Asana.

Si vous essayez d’ajouter l’application à un projet pour la première fois, vous devrez passer par plusieurs processus d’authentification Jira et Asana. Vous pourrez ensuite relier des tickets à des tâches du projet concerné.

OAuth 2.0 pour Jira Server et Jira Data Center

Jira Server et Jira Data Center intègrent OAuth 2.0 dans la version 8.22 et supérieures.

Il existe deux façons d’installer une intégration pour Jira Server et Jira Data Center. Le processus d’installation OAuth 1.0 requiert d’installer en amont l’extension Asana pour Jira Server à partir d’Atlassian Marketplace.

Cette étape n’est pas nécessaire pour démarrer le processus avec OAuth 2.0. Ainsi, un administrateur Jira pourra réaliser l’intégralité de l’installation directement depuis son instance Jira.

Procédure d’installation pas à pas

Cette procédure est réservée aux administrateurs Jira.

1. Générez les identifiants du lien de l’application :

• Déroulez le menu Applications en cliquant sur l’icône en forme d’engrenage
• Sélectionnez Application links (Liens d’application)
• Créez un nouveau lien d’application entrant qui présente les paramètres suivants :
  • Application type: External application (Type d’application : application externe)
  • Direction: Incoming (Sens : entrant)
  • Redirect URL: https://jira-api.integrations.asana.plus/setup/callback/jira (URL de redirection)
  • Permission: Write (Autorisation : écriture)

2. Après avoir cliqué sur Save (Enregistrer), la page sur laquelle vous êtes redirigé affiche les identifiants : Client ID (Identifiant du client) et Client secret (Secret du client). Gardez-la ouverte, car vous en aurez besoin à l’étape 5.
3. Ouvrez la page d’installation en saisissant l’adresse https://jira-api.integrations.asana.plus/setup dans un nouvel onglet de votre navigateur.
4. Connectez-vous avec votre compte Asana et confirmez que vous accordez bien l’autorisation en cliquant sur Allow (Autoriser). Si cette connexion fonctionne, sélectionnez l’espace de travail que vous souhaitez intégrer à votre instance Jira.
5. Il vous est demandé de saisir les informations suivantes :

• Domaine Jira : le domaine Jira que vous aimeriez associer. Votre instance Jira doit être accessible depuis un réseau public. La procédure échouera si l’instance n’est accessible que par intranet ou un VPN.
• Client ID (Identifiant du client) : voir étape 2
• Client secret (Secret du client) : voir étape 2
• Cliquez sur Save (Enregistrer)

6. Il vous est ensuite demandé d’accorder l’accès à votre domaine Jira. Cliquez sur Allow (Autoriser) si vous souhaitez continuer.

Fonctionnalités

Vous pouvez utiliser cette intégration pour relier des tâches Asana à des tickets existants ou pour créer de nouveaux tickets.

Relier des tâches Asana à des tickets existants

Pour ajouter un nouveau ticket existant, ouvrez le menu déroulant du champ Jira Server.

Il vous suffit ensuite de saisir l’URL du ticket Jira ou le nom du ticket dans le champ de texte.

Ici, vous pouvez ouvrir un ticket Jira, donner votre avis et retirer un ticket d’une tâche.

Créer des tickets Jira depuis une tâche Asana

Dans le champ Jira Server d’une tâche Asana, sélectionnez Créer un ticket.

Une nouvelle fenêtre contextuelle s’affiche alors. Essayez de remplir tous les champs dans la mesure du possible (en particulier les types de projet et de ticket). Vous pouvez également ajouter les fichiers en pièce jointe de la tâche Asana.

Cliquez sur Créer un ticket.

Asana créera le ticket en se basant sur les informations concernées se trouvant dans les champs que vous avez remplis.

Après avoir créé ou ajouté un ticket, vous verrez s’afficher les informations de ticket mises à jour dans la tâche Asana. Vous ne pouvez ajouter qu’un seul ticket Jira à chaque tâche Asana.

Une fois le ticket Jira créé, un widget Jira synchronisé en temps réel vous donne des informations sur le statut, la priorité et le responsable du ticket. Vous pouvez cliquer dessus pour en savoir plus.

Toutes les modifications apportées à un ticket sur Jira se répercutent sur Asana au prochain chargement de page.

Fonctionnalité principale

• Relier l’étape de planification à celle de transfert : les chefs de projet peuvent aisément créer un ticket Jira directement sur Asana dès que les tâches sont prêtes pour les ingénieurs. Toute la planification a déjà été gérée sur Asana, et le chef de produit est prêt à procéder au transfert vers le service d’ingénierie et à planifier le sprint sur Asana, en toute simplicité. Cette intégration vous permet de gagner du temps et d’éviter les incohérences dans les données.

• Automatisez la création des tickets Jira grâce aux Règles Asana pour gagner du temps et optimiser le travail de votre équipe. En savoir plus.

• Apporter plus de transparence aux activités de développement sur Jira : les utilisateurs Asana ont une parfaite visibilité sur les activités qui se déroulent sur Jira. Tous les acteurs concernés et les clients importants sont donc tenus au courant des dates de sortie, corrections de bugs, etc. De la même manière, le chef de produit a également la possibilité de suivre, planifier et accomplir des tâches Jira sur Asana. Tout le monde y gagne.

Questions fréquentes sur l’intégration Jira Server

Retrouvez ci-dessous les questions les plus fréquentes concernant l’intégration Asana pour Jira Server.

Comment fonctionne le modèle d’autorisation ?

• L’intégration utilise OAuth comme norme d’autorisation. Les utilisateurs resteront authentifiés jusqu’à expiration du jeton OAuth ou jusqu’à ce que quelqu’un le révoque.

• Afin d’associer des tickets Jira existants à des tâches Asana ou de créer de nouveaux tickets à partir d’Asana, vous devez disposer des autorisations nécessaires dans votre compte Jira.

Comment confirmer que vous utilisez Jira Server ?

• Accédez à la page de connexion de votre compte Jira.

• Si l’adresse URL suit le modèle « .atlassian.net », vous utilisez Jira Cloud et ne pouvez pas bénéficier de l’intégration Server. Vous devrez vous servir de la version Cloud.

• Si l’adresse URL ne suit PAS le modèle ci-dessus, vous utilisez bien Jira Server et pouvez bénéficier de cette intégration.

Qui doit mettre en place l’intégration Jira initiale ?

Un administrateur Jira doit créer un lien d’application pour que votre instance Server puisse se connecter à Asana. Vous n’aurez à réaliser cette opération qu’une seule fois. Les utilisateurs pourront alors s’authentifier individuellement sur Asana pour faire des ajouts aux projets.

L’intégration est-elle unidirectionnelle ou bidirectionnelle ?

• Lorsqu’un utilisateur crée un nouveau ticket Jira ou une association vers un ticket existant depuis Asana, l’intégration reporte les éléments Asana suivants dans Jira :

1. Nom de la tâche
2. Description
3. Pièces jointes

• Ces données sont ajoutées au nouveau ticket Jira. Toutefois, ce transfert de données Asana > Jira constitue l’unique envoi de données à la création d’un nouveau ticket Jira ; c’est également le seul moment au cours duquel des données sont envoyées d’Asana vers Jira.

• Une fois le ticket Jira créé, le widget Jira affiche des données en lecture seule provenant du ticket Jira associé. Techniquement, le widget synchronise simplement les données directement depuis Jira vers Asana. Le fonctionnement est le même lorsque vous associez un ticket Jira existant à une tâche Asana.

Comment fonctionnent les autorisations ?

• Lors de la création d’un nouveau ticket Jira à partir d’Asana, l’intégration suit le modèle d’autorisation de Jira. Ainsi, un utilisateur ne peut créer un ticket Jira que s’il est autorisé à le faire depuis Jira. C’est la seule façon pour un utilisateur d’écrire des données dans Jira (afin d’y créer un nouveau ticket). De même, c’est également le seul scénario dans lequel l’intégration peut lire les données d’Asana.

1. L’intégration lit les données Asana et crée un nouveau ticket Jira en reportant (facultatif) les données de la tâche Asana (nom de la tâche, description et pièces jointes) dans les champs du nouveau ticket Jira (nom du ticket, etc.).

• De la même manière, les utilisateurs ne peuvent associer des tickets Jira existants à une tâche Asana que s’ils remplissent les conditions suivantes :

1. S’ils ont autorisé l’accès à leur compte Jira.

2. S’ils ont accès aux tickets concernés sur Jira.

• Lorsqu’un ticket est associé à une tâche Asana, les autorisations de lecture correspondent au modèle d’autorisation d’Asana. Par exemple, si un utilisateur associe un ticket Jira à la tâche XYZ, les utilisateurs d’Asana ayant accès à la tâche XYZ peuvent uniquement consulter (en lecture seule) les données du ticket Jira associé. Si vous souhaitez restreindre l’accès aux données Jira depuis Asana, vous pouvez rendre vos projets ou tâches privés.

Est-il possible de créer ou associer des tâches Asana à des tickets Jira depuis Jira ?

Non, c’est impossible.

Pour utiliser l’intégration, vous devez créer une tâche sur Asana et l’associer à un ticket Jira existant.

Comment retirer l’autorisation de l’intégration ou changer de compte Jira ?

Les utilisateurs peuvent retirer l’autorisation de l’intégration Asana pour Jira Server en révoquant son accès sur Jira.

1. Pour ce faire, rendez-vous dans « Account Settings > Connected Apps » (Paramètres de compte > Applications associées) et cliquez sur « Revoke Access » (Révoquer l’accès).

La prochaine fois que l’utilisateur souhaitera ajouter ou créer un nouveau ticket Jira, il lui sera demandé de renouveler l’autorisation.

Pour associer une autre instance Jira Server à votre espace de travail Asana, veuillez contacter le service client d’Asana.