Jira Cloud for Sheets vous permet d’importer des données Jira dans vos feuilles de calcul à l’aide de filtres Jira existants ou de JQL personnalisés (Jira Query Language).
Installer dans Google Sheets
A partir d’une feuille de calcul Google Sheets :
- Cliquez sur Add-ons, puis sur Get add-ons…
- Recherchez « Jira Cloud for Sheets » puis survolez la carte et cliquez sur +Free.
- Suivez les instructions pour donner à l’add-on l’accès à votre feuille de calcul Google Sheets.
Connectez votre site/instance cloud
- Ouvrez une feuille de calcul Google Sheets et sélectionnez Add-ons → Jira Cloud for Sheets → Open…
- Cliquez sur CONNECT, cela ouvrira une nouvelle fenêtre de navigateur.
- Sélectionnez le site que vous souhaitez ajouter dans la liste des sites disponibles, puis cliquez sur Accept.
Une fois l’autorisation réussie, vous serez redirigé vers votre feuille de calcul Google Sheets et vous devriez voir quelque chose comme le menu hamburger.
Importer des données depuis Jira
Vous pouvez maintenant importer des problèmes Jira dans votre feuille de calcul en cliquant sur Get data from Jira puis en utilisant l’une des méthodes suivantes :
Utilisation de JQL
- Cliquez sur Add-ons → Jira Cloud for Sheets → Open… → Get data from Jira
- Spécifiez le JQL de la requête que vous souhaitez exécuter. Vous pouvez cliquer sur le lien OPEN IN JIRA pour ouvrir et tester la requête JQL dans Jira.
- Cliquez sur GET DATA.
- Jira exécutera maintenant la requête et renverra tous les problèmes correspondants dans la feuille en cours.
Utilisation des filtres
Si vous avez des filtres définis sur votre site Jira Cloud, vous pouvez les utiliser dans la feuille de calcul.
- Cliquez sur Add-ons → Jira Cloud for Sheets → Open… → Get data from Jira
- Sélectionnez l’onglet FILTERS
- Choisissez votre filtre dans la liste des filtres disponibles.
- Cliquez sur GET DATA. Vous pouvez limiter le nombre de lignes renvoyées avec « Max Rows ».
Jira exécutera la requête et renverra tous les problèmes correspondants dans la feuille en cours.
Utilisez la fonction personnalisée JIRA() avec JQL
L’add-on fournit également une fonction personnalisée de Google Sheets, =JIRA(), que vous pouvez utiliser pour interroger Jira à partir d’une cellule de feuille de calcul :
- Cliquez sur Add-ons → Jira Cloud for Sheets → Open… → Settings
- Cliquez sur « Enable =JIRA() function for users of this sheet »
- Lisez l’avertissement et acceptez. Seuls les propriétaires du document peuvent activer cette fonction. Lorsqu’elle est activée, cette fonction utilise le site et le compte Jira configurés du propriétaire du document pour interroger Jira.
Vous pouvez utiliser la fonction à partir d’une cellule de la feuille de calcul.
Connectez d’autres sites cloud Jira (facultatif)
Pour connecter un autre site cloud Jira :
- Cliquez sur Add-ons → Jira Cloud for Sheets → Open…
- Cliquez sur la liste déroulante à côté de votre site actuel et cliquez sur ‘Add another site…’
- Suivez les instructions pour donner accès à l’add-on pour le site cloud Jira supplémentaire.
- Maintenant, vous pouvez basculer entre les sites lors de l’importation.
Problèmes connus et solutions de contournement
J’ai activé la fonction =JIRA() et cela me montre toujours une erreur.
Effacez la valeur de la cellule où vous utilisez la fonction =JIRA(), appuyez sur Entrée. Saisissez à nouveau la requête et cela devrait fonctionner maintenant. Vous n’aurez à le faire qu’une fois (nous travaillons à la résolution d’un bug causant ce comportement).
L’add-on renvoie une erreur lorsque je souhaite interroger un grand nombre de problèmes.
L’add-on fonctionne correctement avec des requêtes contenant jusqu’à 10 000 problèmes. Si vous devez renvoyer plus de problèmes, vous devez utiliser la fonction =JIRA(), qui vous permet de paginer les résultats. Assurez-vous de trier les résultats dans la requête.
Pour renvoyer par exemple 20 000 problèmes, mettez ceci dans une cellule pour renvoyer les 10 000 premiers problèmes :
=JIRA("project = ProjA", "issuekey,summary,created,reporter", 0, 10000)Et cela dans une autre cellule pour renvoyer les 10 000 problèmes suivants :
=JIRA("project = ProjA", "issuekey,summary,created,reporter", 10000, 20000)L’add-on renvoie des cellules vides pour les données utilisateur.
L’add-on respecte les paramètres de confidentialité individuels des utilisateurs pour les données de profil. Si un utilisateur a rendu ses informations de profil privées, l’add-on renverra une valeur vide pour cet utilisateur dans les colonnes telles que « assignee » ou « reporter ».
FAQ (Références)
Quelles fonctionnalités fournit Jira Cloud for Sheets ?
Jira Cloud for Sheets est un complément que vous pouvez utiliser dans les feuilles de calcul Google pour importer des données à partir de sites Jira Cloud :
- basé sur une JQL (Jira Query Language)
- basé sur des filtres pré-définis sur Jira Cloud
Comment spécifier quelles colonnes sont peuplées dans la feuille de calcul ?
L’add-on utilise les paramètres de colonne sur Jira Cloud lors de l’importation des données. Vous pouvez avoir des paramètres de colonne différents pour votre compte et également pour les filtres. Si aucun paramètre de colonne spécifique à un utilisateur/filtre n’est configuré sur Jira Cloud, l’add-on utilise les colonnes système par défaut.
Vous pouvez spécifier différentes colonnes en utilisant la fonction =JIRA(), par exemple :
=JIRA("project = ProjA", "issuekey,summary,created,reporter,customfield_10000")Comment désinstaller ce complément ?
Vous pouvez désinstaller le complément en cliquant sur Add-ons → Manage Add-ons → Manage → Remove.
Puis-je utiliser ce complément si je n’ai pas de produit Atlassian sous licence ?
Non, vous avez besoin d’une licence/abonnement pour Jira Cloud pour utiliser ce complément.
Puis-je utiliser ce complément avec Jira Server ?
Non, le complément ne fonctionne qu’avec les sites Jira Cloud pour Jira Work Management, Jira Software et Jira Service Management. Renseignez-vous auprès de votre administrateur Jira si vous n’êtes pas sûr de la différence entre cloud et serveur.
Comment déconnecter la feuille de calcul de toute instance Jira Cloud connectée ?
Vous pouvez déconnecter tous vos sites Jira Cloud configurés du complément. À partir de la feuille de calcul :
- Cliquez sur Add-ons → Jira Cloud for Sheets → Open
- Cliquez sur Disconnect site
- Cela vous redirigera vers la page de profil de votre identité Atlassian où vous pouvez déconnecter le complément en cliquant sur « Remove access ».
Ce complément est-il conforme au RGPD ?
Oui, et nous ne stockons aucune information personnelle des utilisateurs. Pour plus d’informations, veuillez consulter le lien suivant : https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/
