Intégrer Jira

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.

Notion propose deux intégrations Jira : Jira et Jira Sync. La première est une version allégée, tandis que la seconde offre toutes les fonctionnalités.

Si vous souhaitez simplement effectuer une synchronisation unique entre un projet Jira et une base de données Notion, et que vous ne prévoyez pas de configurer des synchronisations supplémentaires, l’intégration Jira originale devrait suffire.

Gardez simplement à l’esprit que cette intégration utilise des jetons utilisateur, qui ont tendance à être moins fiables que les jetons administrateur utilisés par Jira Sync.

Pour une synchronisation continue et flexible entre plusieurs projets et bases de données, Jira Sync est l’option la plus récente et la plus puissante. Notez simplement que sa configuration nécessite un administrateur Jira.

Jira :

1. Cliquez sur ce lien vers la page d’intégration Jira, puis sur Ajouter à Notion.

   • Vous pouvez également trouver cette page en accédant à Paramètres → Connexions → Parcourir les connexions dans la galerie.

Jira Sync :

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

2. Cliquez sur Importer et cherchez Jira Sync.

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

Pour prévisualiser les liens de Jira :

1. Accédez à Paramètres → Connexions.

2. Si vous utilisez Jira Cloud, trouvez la vignette Jira. Si vous utilisez Jira Data Center ou Jira Server, trouvez la vignette d’aperçu Jira (Data Center). Vous devrez peut-être faire défiler légèrement vers le bas pour trouver la vignette du centre de données. Ensuite, sélectionnez Connecter sous la vignette.

3. Dans la fenêtre qui s’ouvre, sélectionnez votre version de Jira. Ensuite, saisissez l’URL, le nom d’utilisateur et le mot de passe de votre site, puis cliquez sur Authentifier.

Une fois l’authentification effectuée, vous verrez Jira ou Aperçu Jira (Data center) en haut de votre liste de connexions. Tout lien Jira collé dans Notion devrait automatiquement apparaître sous forme d’aperçu visuel de lien.

Vous pouvez également configurer des aperçus de liens directement à partir d'une page Notion. Pour ce faire :

1. Dans une page Notion, collez une URL Jira.

2. Dans la fenêtre qui s’ouvre, sélectionnez votre version de Jira si besoin. Ensuite, saisissez l’URL, le nom d’utilisateur et le mot de passe de votre site, puis cliquez sur Authentifier.

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 agrégations et l’IA de Notion. Utilisez l’IA de Notion pour répondre rapidement aux questions sur les projets Jira.

La synchronisation Jira affiche vos projets et tickets Jira sous forme de bases de données de projets et de 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.

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. Dans la barre latérale, cliquez sur Paramètres → Importer → Synchronisation 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.

1. Dans la barre latérale, cliquez sur Paramètres → Importer → Synchronisation 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.

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. Confirmez que votre nom et votre adresse e-mail sont les mêmes dans Notion que dans Jira.

3. Suivez les instructions ici pour ajuster votre visibilité sur Tout le monde.

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.

Après l’importation initiale, vos projets synchronisés avec Jira sont tenus à jour de deux manières :

• Webhooks : les mises à jour apportées dans Jira sont envoyées à Notion en temps réel via des webhooks.

  • Ces modifications apparaissent généralement en quelques minutes, mais des retards occasionnels ou des mises à jour manquées peuvent survenir en raison de problèmes de réseau ou de système.

  • La configuration du webhook se fait automatiquement lors de la première synchronisation.

• Resynchronisation : si une mise à jour de webhook est manquée, notre mécanisme de resynchronisation synchronisera à nouveau votre collection avec Jira pour s’assurer qu’elle est à jour :

  • La resynchronisation ne s’exécute que lorsque la collection est activement consultée et peut prendre du temps, en particulier pour les grandes collections.

  • Elle s’exécutera au maximum une fois par jour et est indiquée par une étiquette « Synchronisation en cours ».

    • Au cours de ce processus, les utilisateurs ne peuvent pas modifier la configuration de synchronisation (par exemple, ajouter/supprimer des projets ou des propriétés).

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.

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 :

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

• Pour des performances optimales, les propriétés Jira de plus de 1 000 valeurs ne seront pas importé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.

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. Dans la barre latérale, cliquez sur Paramètres → Importer.

2. À côté de Jira, sélectionnez ••• → 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.