Intégrer Jira

Aide : bannière Jira
Dans cet article

Connectez Jira à Notion pour une expérience fluide qui permet à votre équipe de rester à jour 🔗


L’intégration de Notion avec Jira vous permet de réaliser un large éventail de choses. Vous pouvez insérer des liens Jira dans les pages Notion pour y accéder rapidement ou les prévisualiser, ou vous pouvez synchroniser vos projets et tickets Jira dans les bases de données Notion, afin de suivre l’ensemble de votre travail depuis un unique endroit. Poursuivez votre lecture pour découvrir les différentes formes d’intégration et la manière de les configurer.

Note : pour le moment, l’intégration Jira de Notion ne prend pas en charge Jira sur site.

  1. Cliquez sur Paramètres dans la barre latérale.

  2. Cliquez sur Importer et cherchez Jira (pour les aperçus visuels et les mentions de liens).

    • L’intégration Jira est utilisée pour les prévisualisations et les mentions de liens.

    • Vous pouvez également sélectionner Synchronisation Jira, une autre intégration qui synchronise les projets et les tickets Jira dans Notion. Cliquez ici pour plus d’informations sur la synchronisation Jira.

  3. Cliquez sur Connecter et suivez le processus d’authentification.

Note : les aperçus visuels de liens ne fonctionnent qu’avec Jira Software.

  1. Collez un lien Jira dans Notion.

  2. Sélectionnez « Aperçu » dans le menu qui s’affiche pour obtenir un aperçu en temps réel du projet ou du ticket.

    • Si vous n’avez pas encore connecté Jira à Notion, vous aurez l’opportunité de le faire lorsque vous collerez votre lien Jira dans Notion. Pour en savoir plus sur les aperçus visuels de liens, consultez cet article →

Note : les mentions de liens fonctionnent avec tous les produits Jira Cloud.

  1. Collez un lien Jira dans Notion.

  2. Sélectionnez « Mention » dans le menu qui s’affiche pour faciliter le référencement d’un projet ou d’un ticket dans vos documents.

    • Si vous n’avez pas encore connecté Jira à Notion, vous aurez l’opportunité de le faire lorsque vous collerez votre lien Jira dans Notion. Pour en savoir plus sur les mentions de liens, consultez cet article →

La synchronisation Jira connecte vos projets Jira à Notion en utilisant un jeton administrateur API (plutôt qu’un jeton utilisateur), ce qui offre une expérience plus unifiée.

Vous pouvez désormais tirer pleinement parti des fonctionnalités de Notion, y compris les automatisations, les rollups et l’IA de Notion. Utilisez l’IA de Notion pour répondre rapidement aux questions sur les projets Jira.

Remarque :

  • Un propriétaire d’espace de travail doit d’abord configurer Jira, afin que tous les membres puissent l’utiliser.

  • Vous pouvez créer un compte de service Jira pour configurer la synchronisation Jira — vérifiez simplement à l’avance que le compte de service a accès à tous les projets que vous souhaitez synchroniser avec Notion.

  • Les bases de données synchronisées fonctionnent avec les produits Jira Cloud (Jira Software, Jira Product Discovery, Jira Work Management et Jira Service Management), avec un service client pour Jira Server bientôt disponible !

La synchronisation Jira affiche vos projets et tickets Jira en tant que bases de données Projets et Tickets Notion. Cette configuration vous permet d’afficher et de suivre de multiples projets à l’aide d’une variété de vues, de filtres et de tris utiles.

Vous pouvez même utiliser le mappage d’identité pour connecter les identités Jira aux profils Notion afin d’afficher la répartition des tâches dans les bases de données Notion.

🟡 Note : seuls les propriétaires d’espace de travail peuvent configurer la synchronisation Jira, en utilisant un jeton administrateur Jira. Ensuite, tous les membres peuvent utiliser la connexion.

Configurer la synchronisation Jira

Même si tous les membres peuvent créer des synchronisations, seul un propriétaire d’espace de travail peut configurer la synchronisation Jira initialement.

  1. Cliquez sur Paramètres dans la barre latérale → ImporterSynchronisation Jira.

    • Vous pouvez également coller un lien vers une base de données Jira ou utiliser la slash-commande /synchronisation jira.

    • Si vous avez déjà créé une base de données synchronisée Jira dans Notion, ouvrez-la et sélectionnez Améliorer votre synchronisation Jira en haut.

  2. Dans la fenêtre qui s’ouvre, sélectionner Premiers pas.

  3. Renseignez votre adresse e-mail administrateur Jira, l’URL du site Jira et le jeton API, puis sélectionnez Suivant.

Ajouter une nouvelle synchronisation

Note : les membres doivent s’authentifier sur Jira pour ajouter ou supprimer des projets. Ils ne peuvent ajouter que les projets auxquels ils ont accès dans Jira.

  1. Cliquez sur Paramètres dans la barre latérale → ImporterSynchronisation Jira.

    • Vous pouvez également coller un lien vers une base de données Jira ou utiliser la slash-commande /synchronisation jira.

  2. Dans la fenêtre qui s’ouvre, sélectionner Premiers pas.

  3. Sélectionner le site Jira à partir duquel vous souhaitez effectuer la synchronisation.

  4. Sélectionner Créer une nouvelle synchronisation ou sélectionner une synchronisation existante dans le menu déroulant. Si vous choisissez une synchronisation existante, vos projets seront ajoutés à vos bases de données synchronisées Projets et Tickets existantes.

  5. Dans la base de données qui s’ouvre, connecter votre compte Jira (sauf si vous êtes le propriétaire de l’espace de travail qui a configuré l’intégration). À partir de là, sélectionnez les données à synchroniser dans Notion. Cliquez d’abord sur Sélectionner les projets à synchroniser, puis sur Sélectionner les propriétés à synchroniser.

Répétez les étapes ci-dessus si vous souhaitez configurer une autre synchronisation Jira pour un autre site, espace d’équipe ou espace de travail. Les commentaires et les pièces jointes (maximum cinq fichiers par ticket, n’excédant pas 1 Mo) seront également synchronisés.

Vous pouvez appliquer des autorisations à la page de base de données pour rendre les bases de données synchronisées accessibles à vos collaborateurs.

Note : Les autorisations Notion sont transmises aux bases de données synchronisées Jira. Les membres peuvent accéder aux bases de données synchronisées sur toutes les pages qu’ils sont autorisés à consulter.

Si un membre ajoute un projet Jira privé à une page Notion, toute personne ayant accès à la page Notion peut le voir.

Propriété « Personnes » dans une base de données synchronisée

Les bases de données synchronisées permettent d’utiliser la propriété « Personnes » ! Vous pouvez désormais relier les profils GitHub et JIRA de votre équipe à leurs comptes Notion. Pour ce faire :

  1. Vérifiez que vous avez implémenté Jira Cloud.

  2. Si vous êtes administrateur, accédez à Jira, cliquez sur Paramètres du système Jira et modifiez la visibilité des e-mails des utilisateurs de Masqué à Public au sein de votre organisation. Si vous êtes un utilisateur individuel, vous aurez besoin de modifier manuellement les paramètres en changeant l’option de visibilité des e-mails. Suivez les instructions ici →

Modifier ou supprimer une base de données synchronisée

Pour modifier les propriétés des projets et tickets Jira qui ont été synchronisés dans votre base de données Notion, sélectionnez ••• en haut de votre base de données synchronisée → Source.

Pour supprimer une base de données synchronisée Jira, sélectionnez ••• en haut de votre base de données synchronisée → Supprimer la table.

Base de données Projets

Vos projets Jira seront synchronisés dans une base de données Projets de Notion. Vos projets seront intelligemment mappés aux tickets Jira correspondants dans une base de données Tickets associée et synchronisée dans Notion. Des vues de base de données par défaut seront pré-remplies, afin de vous aider à démarrer plus rapidement :

  • Actif (vue de table) : cette vue affiche les projets que vous avez synchronisés dont l'état est en cours. En d’autres termes, cette vue n’affiche pas les projets déjà terminés. Il existe également des filtres prédéfinis pour le propriétaire et la date afin de simplifier la recherche.

  • Vue chronologie : cette vue affiche le nom, l’état, le propriétaire et le taux d’achèvement du projet. Il existe également des filtres prédéfinis pour l’état, le propriétaire et la date afin de simplifier la recherche.

  • Vue tableau kanban : cette vue affiche vos projets regroupés par état (Planification, En cours). Vous pouvez personnaliser les états qui s’affichent dans la vue dans le menu •••. Les projets sont triés par ordre de priorité décroissant.

  • Tout (vue de table) : cette vue affiche tous vos projets synchronisés. Il existe des filtres prédéfinis pour l’état, le propriétaire et la date afin de simplifier la recherche.

Base de données Tickets

Vos tickets Jira (épopée, bug, tâche, sous-tâche, histoire) seront synchronisés dans une base de données Tickets de Notion, qui équivaut à une base de données Tâches de Notion. Comme pour les bases de données de projets synchronisés, des vues de base de données par défaut seront créées afin de vous aider à démarrer plus rapidement :

  • Par projet (vue de table) : cette vue affiche toutes les tâches, regroupées par projet. Il existe des filtres prédéfinis pour l’état, le responsable et la date afin de simplifier la recherche.

  • Par épopée (vue de table) : cette vue affiche vos histoires, tâches et bugs Jira regroupés par épopée.

  • Vue tableau kanban : cette vue est regroupée par état et triée par ordre de priorité décroissant. Les propriétés prédéfinies qui s’affichent sont le responsable, le projet, la priorité et les sous-tâches.

  • Toutes les tâches (vue de table) : cette vue affiche toutes les tâches que vous avez synchronisées. Les propriétés prédéfinies qui s’affichent sont le nom de la tâche, l’état, le responsable, la date, la priorité, les étiquettes et le projet.

  • Mes tâches (vue de table) : cette vue est filtrée de manière à afficher uniquement les tâches qui vous sont attribuées. Il existe des filtres prédéfinis pour l’état, la date et le projet.

La synchronisation Jira prend en charge la plupart des propriétés Jira, mais pas toutes. Voici la liste des propriétés Jira non prises en charge :

Suivi du temps

Résolution

Niveau de sécurité

Σ progrès

Progrès

Restreindre à

Catégorie d’état

Rang

Même si Notion ne prend pas en charge certaines propriétés personnalisées Jira, toutes les propriétés personnalisées primitives de Jira, telles que chaîne, nombre, sélection, personne et date, sont prises en charge.

  • La synchronisation initiale ne devrait prendre que quelques minutes. Toutefois, en fonction de la taille de vos projets et tickets Jira, cela peut prendre jusqu’à quelques heures.

  • Certains champs de tickets ou propriétés peuvent ne pas être synchronisés, comme du texte enrichi dans des propriétés ou des sélections multiples imbriquées.

  • Une fois la synchronisation initiale configurée, les mises à jour des propriétés devraient être reflétées dans Notion en temps réel. Si vous créez de nouvelles propriétés, la synchronisation de ces modifications peut prendre jusqu’à 12 heures.

  • Il est impossible de synchroniser manuellement Jira avec Notion — les synchronisations s’effectuent en réponse aux mises à jour apportées dans Jira.

  • Pour l’instant, seules les mises à jour de Jira seront synchronisées dans votre base de données Notion en temps réel — et non l’inverse. Les modifications apportées à votre base de données Notion ne seront pas synchronisées avec Jira.

  • La dernière synchronisation de Notion avec Jira s’affiche avec un badge bleu tout en haut de votre base de données. Si, à la place, vous voyez un badge jaune indiquant Échec de la synchronisation ou Arrêt de la synchronisation, il vous faut suivre les étapes ci-dessous pour reconnecter Jira.

  • Assurez-vous d’avoir modifié l’accès ou l’accès complet aux bases de données synchronisées si vous souhaitez ajouter ou supprimer des projets ou des propriétés.

  • Si vous ne voyez pas les mises à jour dans Notion, essayez de rafraîchir la page.

  • La synchronisation de la propriété Watcher peut prendre jusqu’à 12 heures.

Note : si vous supprimez une propriété dans Jira, l’élément de base de données associé à votre base de données synchronisée sera également supprimé.

En cas d’échec de l’enregistrement de votre webhook ou de la synchronisation de votre projet, Échec de la synchronisation s’affiche en haut de votre base de données. Pour résoudre ce problème, relancez la synchronisation avec un autre ensemble de projets. Assurez-vous également que vos projets ne rencontrent aucun problème dans Jira.

Si votre jeton Jira n’est plus valide ou que Jira a été déconnecté de Notion, Arrêt de la synchronisation s’affiche en haut de la base de données. Pour résoudre ce problème, sélectionnez S’authentifier à nouveau à côté de Arrêt de la synchronisation. Vous devez être propriétaire de l’espace de travail pour réaliser ce processus.

Une fois votre instance Jira reconnectée à Notion, les bases de données Projets et Tickets ne sont pas recréées ; à la place, vous continuez d’utiliser les bases de données Projets et Tickets dont vous disposiez auparavant.

Si vous souhaitez déconnecter complètement Jira de Notion :

  1. Cliquez sur Paramètres dans la barre latérale → Importer.

  2. Sélectionnez ••• à côté de Jira → Supprimer.

Voici à quoi ressemblent les bases de données antérieures. Si vous disposez d’une base de données synchronisée antérieure, vous pouvez suivre les étapes ci-dessous pour recréer vos bases de données Projets et Tickets dans Notion en utilisant la nouvelle version améliorée de la synchronisation Jira.


Donner votre avis

Cette ressource vous a-t-elle été utile ?