Jira Server

Aperçu

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) et d'assurer le suivi de leur travail. 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 des éléments suivants pour les premières étapes de l'installation :

  • Disposer d'un compte Asana
  • Une formule payante

Vous cherchez des solutions pour mieux gérer votre travail ? Démarrez en profitant d'un essai gratuit de 30 jours sur Asana. Essayez gratuitement.

Exigences
Jira :

Les instances de Jira Software Server ou de Data Center sont prises en charge et configurées selon les exigences indiquées en lien ci-dessous. Pour une prise en charge spécifique des versions, consultez la fiche 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 pour l'administrateur Jira :

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 que vous voyez une confirmation dans JIRA, les étapes nécessaires à partir du serveur sont terminées, et le reste peut être complété par les utilisateurs sur Asana

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.
     
add apps

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.


Jira server

Une fois terminée, l'application sera ajoutée au projet, et les utilisateurs doivent voir un champ Jira Server sur les tâches où ils peuvent ajouter des tickets Jira existants ou créer de nouveaux tickets Jira à partir d'Asana.

Jira Server field

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 les tickets à des tâches du projet concerné.


OAuth 2.0 pour Jira Server et Jira Data Center

OAuth 2.0 est pris en charge pour Jira Server et Jira Data Center à partir de la version 8.22 et supérieure.

Il existe deux façons d'installer une intégration pour Jira Server et Jira Data Center. Avec le processus d'installation d'OAuth 1.0, les clients sont tenus d'installer l'extension Asana pour Jira Server à partir d'Atlassian Marketplace.

L'utilisation d'OAuth 2.0 ne nécessite pas cette étape pour activer le processus d'installation, ce qui signifie qu'un administrateur Jira peut effectuer l'ensemble du processus d'installation directement à partir de son instance Jira.


Instructions d'installation pas à pas

Ce processus peut uniquement être effectué par les administrateurs JIRA.

  1. Générer les informations d'identification du lien d'application :
  • Pour ouvrir le menu déroulant Applications, cliquez sur l'icône d'engrenage
  • Ouvrez les liens de l'application dans le menu déroulant
  • Créer un nouveau lien d'application entrante avec les paramètres suivants :
  1. Après avoir cliqué sur Enregistrer, la page résultante vous fournit les informations d'identification : ID client et secret client. Gardez cette page ouverte car vous aurez besoin de ces informations à l'étape 5.
  2. Ouvrez la page de configuration en saisissant https://jira-api.integrations.asana.plus/setup dans un onglet distinct de votre navigateur.
  3. Connectez-vous à votre compte Asana et confirmez votre autorisation à accorder des autorisations en cliquant sur Autoriser. Après une connexion réussie, sélectionnez un espace de travail Asana avec lequel vous souhaitez intégrer votre instance Jira.
  4. Vous êtes invité à saisir les informations suivantes :
  • Domaine Jira : le domaine Jira auquel vous souhaitez vous connecter. Votre instance Jira doit être accessible depuis l'Internet public ; si votre instance Jira n'est accessible que via votre réseau d'entreprise ou un VPN, cela ne fonctionnera pas.
  • ID client : à partir de l'étape 2.
  • Secret du client : à partir de l'étape 2
  • Cliquez sur Enregistrer
  1. Vous êtes ensuite invité à autoriser Asana à accéder à votre domaine Jira. Cliquez sur 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.

Reliez des tâches Asana à des tickets existants

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

add field

Ensuite, il vous suffit de saisir l'URL du ticket Jira ou le nom du ticket dans le champ de texte.

url

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


Créer un ticket Jira depuis une tâche Asana

Dans le champ Jira Server de la tâche, sélectionnez Créer un ticket sur Asana.

create issue

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

create issue

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.

asana changes


Toutes les modifications apportées à un ticket sur Jira se répercuteront 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. Découvrez comment procéder.

Adding rules jira

Depuis la fenêtre contextuelle Ajouter une règle :

  1. Cliquez sur Créer un ticket sous Jira Server
  2. Remplissez tous les champs de la zone Créer un ticket 
  3. Cliquez sur Créer une règle pour automatiser la création des tickets Jira Server
  • 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.

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

  • 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 de lier 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 votre URL a cette structure : « .atlassian.net », vous utilisez en effet Jira Cloud et pouvez bénéficier de l'intégration Server. Vous devez vous servir de la version Cloud.

  • Si l'adresse URL ne suit pas le modèle ci-dessus, vous utilisez 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 ajouter des 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 la seule occasion au cours de laquelle 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 reliez un ticket Jira existant à une tâche Asana.

Comment fonctionne 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 dans 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.

  • 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 :

  • S'ils ont autorisé l'accès à leur compte Jira

  • 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. 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 l'accès d'Asana sur Jira.

  1. Pour ce faire, rendez-vous dans « Account Settings > Connected Apps > click Revoke Access » (Paramètres de compte > Applications

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.