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.

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.

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 →

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.

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.

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 → 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. Cliquez sur Paramètres dans la barre latérale → 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. 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 →

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.

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.

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