Intégration d'Atlassian Jira® et Microsoft® Azure® DevOps

Tour d'Horizon

L'intégration par DEON de solutions externes de suivi des problèmes et/ou de planification telles que Jira ou Azure permet aux utilisateurs d'utiliser facilement features d'entre eux directement dans leur espace de travail DEON. Des problèmes peuvent être créés, le contenu et les propriétés modifiés et enfin synchronisés avec le serveur. Les données distantes peuvent être facilement importées (en masse) et DEON permet également de coller les URL des problèmes sur la scène du projet.

 

Features

  • Connectez-vous facilement à Atlassian Jira® et Microsoft® Azure® DevOps
  • Visualisez vos projets en un coup d'œil
  • Créez de nouveaux tickets et modifiez-les à la volée
  • Importer des éléments uniques, une liste en vrac ou à partir d'une collection filtrée
  • Puissant langage de requête de recherche
  • Synchronisez en un clic votre travail avec votre serveur
  • Organisez vos articles avec plusieurs mises en page intégrées

 

Configuration initiale de Jira®

L'intégration de Jira permet à DEON d'accéder aux données du projet gérées par un serveur Jira distant. Pour ce faire, une procédure d'authentification et d'autorisation des utilisateurs doit être suivie et pour que cela fonctionne, le serveur doit d'abord être correctement configuré.

Veuillez noter : Des droits de serveur d'administration sont requis pour cette étape.

Commencez par vous connecter au système Jira cible, puis recherchez et accédez au lien d'application page sur le site Web. Habituellement, cette page est facile à trouver dans les paramètres et devrait être accessible par une URL très similaire comme celle-ci. https://YOUR_SITE_NAME.atlassian.net/plugins/servlet/applinks/listApplicationLinks. Une fois sur place, vous devriez pouvoir voir une liste des liens d'application existants (le cas échéant), comme indiqué dans l'image ci-dessous.

Cliquez sur Créer un lien et suivez attentivement ces instructions. Vous devez d’abord décider du type de lien, dans ce cas, sélectionnez Lien de candidature direct et met https://deon.de car URL de la candidature comme indiqué ci-dessous.

L'étape suivante consiste à définir un prénom et les terres parsemées de type d'application comme sur cette image. N'oubliez pas de vérifier Créer un lien entrant.

Enfin, définissez le La clé du consommateur à Clé Oauth, Nom du consommateur à DEON et copiez le Clé publique par le bas dans le domaine concerné. Continuez ensuite à finaliser le lien de candidature.

MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDwbjsh4GEf9NGWSwxvVWodfkCnG5DFhbqvf3+HOrzpEXDCvZBcS58lRz8h7Lb376QXxUoJfogLD//LGooUM02DLOIHbrZcMGWhG34+cbP7UNHppY1/m4AcRfTkXyyFzOBuWfbHYSIYeiE/qYIplWhib8By8rxlUVm9NMjhPp0mrQIDAQAB

Une fois créé, vous devriez pouvoir voir un nouveau lien d'application répertorié sur votre site Web, similaire à celui de l'image ci-dessous. Désormais ce serveur Jira permettra à DEON d'envoyer des requêtes et d'échanger des données.

 

Configuration initiale du DEON

Avant que les utilisateurs puissent bénéficier du suivi intégré features une connexion au serveur doit être créée.

Pour configurer une connexion au serveur, certaines informations doivent être fournies, généralement :

  1. Nom de la connexion
  2. Système cible (actuellement Jira ou Azure disponible)
  3. Environnement cible (cloud(basé ou dédié/sur site)
  4. Adresse du serveur (URL)
  5. Paramètre d'authentification (Mot de passe/PAT/API-Token/etc.)

La configuration de la connexion se trouve dans les paramètres DEON. Clique sur le dans la partie supérieure gauche de la barre de titre de la fenêtre pour ouvrir la boîte de dialogue des paramètres et accéder à Suivi des problèmes dans le volet gauche.

Il y a deux sections dans les paramètres de suivi des problèmes : Préférences et Configuration de la connexion. L'onglet de configuration n'est visible que sur les fenêtres de l'espace de travail DEON puisque les connexions sont liées aux projets. Si l'onglet est masqué, ouvrez un projet dans la liste et ouvrez à nouveau la boîte de dialogue des paramètres dans cette fenêtre.

Pour créer une nouvelle connexion, accédez à Configuration de la connexion  onglet et cliquez sur leicône. Un nouvel objet de connexion sera ajouté à la liste affichant toutes ses propriétés sur le côté droit.

Maintenant, tapez simplement tous les paramètres requis. Commencez par fournir un nom de connexion raisonnable, puis ajoutez l'adresse du serveur.

Veuillez noter : Utilisez uniquement l'adresse du serveur de base sans autre chemin de page. Exemple: https://dev.azure.com/COMPANY_NAME/

Sélectionnez le système cible, Azure ou Jira, et définissez l'environnement cible tel qu'il est soit cloud or sur site (également appelé hébergé, dédié, sur site, etc.) Dans la section Présélection du projet les utilisateurs peuvent spécifier des noms de projet (il peut s'agir de vrais noms ou d'identifiants, DEON essaiera de les identifier automatiquement) pour réduire le nombre total de projets qui seront synchronisés et mis en cache.

Enfin, jetez un deuxième coup d'œil pour vous assurer que toutes les données ont été saisies correctement et appuyez sur OK. DEON va maintenant essayer de se connecter au serveur spécifié et de créer le cache de données local. Une fois cela fait, la boîte de dialogue des paramètres peut être fermée.


Générer des jetons d'API/d'accès personnel (exemple ici pour Jira)

Le jeton API peut être généré pour tous les utilisateurs par eux-mêmes en accédant à la gestion des comptes dans le système Jira désigné. Dans les paramètres de gestion de compte, vous trouverez une section intitulée Sécurité (ou similaire) comme indiqué ci-dessous.

Cette page répertorie quelques options, notamment la réinitialisation du mot de passe, les paramètres d'authentification bidirectionnelle et également la génération de jeton API.

Cliquez sur Créer et gérer des jetons d'API pour créer un nouveau jeton. Un nouveau formulaire apparaîtra qui montre tous les jetons encore existants et permet également d'en générer de nouveaux. Cliquer sur Créer un jeton d'API continuer.

Tout ce que vous avez à faire est de fournir un nom utile et unique ou une soi-disant étiquette pour le jeton que vous souhaitez générer.

Une fois que vous avez choisi un nom approprié, cliquez sur Création. La boîte de dialogue suivante vous informe de la réussite de la génération et vous rappelle de copier le nouveau jeton pour le stocker en toute sécurité pour une utilisation ultérieure.

Une fois le processus terminé, vous reviendrez au tableau de bord des jetons et y verrez votre nouveau jeton répertorié. À partir de ce moment, ce jeton est prêt à être utilisé dans le processus d'authentification de connexion de DEON.

 

Processus d'authentification

Dans presque tous les cas, une connexion à un serveur nécessitera que l'utilisateur s'authentifie et autorise DEON à accéder au système de suivi des cibles. Une fois qu'une connexion a été configurée dans la configuration de la connexion et que processus de création de cache est lancée, cette connexion tentera d'authentifier l'utilisateur auprès du serveur.
DEON identifiera donc le type d'authentification et fournir plusieurs boîtes de dialogue pour faciliter ce processus. À partir de maintenant, l'intégration du système de suivi prend en charge l'interaction avec Jira et Azure, selon la connexion sélectionnée, vous verrez une boîte de dialogue différente comme illustré ci-dessous.

Boîte de dialogue d'authentification pour Azure:

Boîte de dialogue d'authentification pour Jira:

Dans ces deux cas, la connexion a été configurée pour diriger vers un cloud-Base serveur qui obligera l'utilisateur à fournir un Nom d'utilisateur et une correspondance Mot de passe or jeton d'accès. L'authentification bidirectionnelle est également prise en charge et certains systèmes comme Jira exigent d'autoriser explicitement l'application, dans ce cas DEON, à accéder aux données et fonctionnalités du serveur. Une fois le processus d'authentification/autorisation terminé et terminé avec succès vous pouvez fermer cette boîte de dialogue. A partir de maintenant cette connexion est active et peut être utilisée.

Pour Serveur Jira actuellement, une autre méthode d'authentification est obligatoire, qui consiste à fournir un Jeton API. Habituellement, la combinaison d'un nom d'utilisateur et de ce jeton est suffisante pour réussir complètement le processus d'authentification et d'autorisation.

Boîte de dialogue API-Token :

Pour plus d'informations sur la façon de générer ces jetons, veuillez lire la section précédente.

Dans tous les cas, toutes les informations d'identification fournies sont stockées en toute sécurité dans les paramètres de périmètre de DEON et tant que l'authentification/autorisation est acceptée par le serveur, vous n'avez pas besoin de les saisir à nouveau. Si la session d'authentification expire, DEON vous en informera avant que toute fonctionnalité de suivi des problèmes puisse être utilisée. Dans ce scénario, le processus d'authentification doit simplement être répété.

 

Importation/Création de tickets

Pour créer un nouveau problème/ticket, accédez au menu des widgets dans la barre de menus principale de DEON, comme indiqué ci-dessous

et trouver le suivi des problèmes features là. Ceux-ci resteront inactifs jusqu'à ce qu'une connexion valide soit établie. Une fois cette étape effectuée, cliquez sur le pour activer l'outil de création, puis cliquez n'importe où dans le projet pour lancer la création du problème à cet emplacement. Une nouvelle boîte de dialogue apparaîtra qui vous aidera à suivre toutes les étapes requises.

Sélectionnez d'abord le connexion dans le premier menu déroulant tout en haut qui sera utilisé pour cibler le bon serveur. Choisissez alors un Projet dans la liste ci-dessous et précisez le problème/ticket cible type (par exemple, bogue, tâche, etc.). Fournir un bon résumé est également obligatoire car il sert de résumé/titre du ticket. En option, vous pouvez également ajouter un priorité, un cessionnaire et la description de la matière. Une fois que vous avez terminé avec toutes les valeurs, cliquez simplement sur Accepter (si la Poussée automatique le réglage est activé, le bouton peut indiquer Accepter et synchroniser) pour créer un nouvel objet problème/ticket dans le projet. Le nouveau widget peut ressembler aux images ci-dessous, selon la dernière sélection mode d'affichage (carte or en ligne mode, la section menu contextuel contient plus de détails) :

Mode d'affichage de la carte :

Mode vue ligne :

Le widget contient de nombreux conseils et informations sur le contenu, comme une icône de système de suivi associé dans le coin supérieur gauche, le projet et l'ID du ticket (qui est un lien qui ouvre l'URL du ticket dans le navigateur), le type de problème, le l'état actuel du flux de travail et le destinataire (le cas échéant). En plein centre du widget, le résumé est affiché et peut être modifié directement à cet endroit.

Les problèmes/tickets existants peuvent être facilement importés dans votre projet à partir de n'importe quel serveur connecté et DEON propose plusieurs façons de le faire.

Importation groupée :
Une option est la soi-disant importation en vrac accessible en ouvrant la boîte de dialogue d'importation dans le menu des widgets de la barre de menus principale de DEON.

Là, cliquez simplement sur le icône. La boîte de dialogue suivante apparaît :

Sélectionnez d'abord la cible connexion qui sera utilisé pour cibler le bon serveur. Ensuite, choisissez votre désigné Projet et la liste des problèmes/tickets sera mise à jour automatiquement. Par défaut le requête de recherche trouve simplement tous les éléments liés au projet sélectionné. Vous pouvez modifier la requête de recherche manuellement en cliquant sur le icône.
Veuillez noter : Actuellement, il n'y a pas de contrôle de validation pour les erreurs de syntaxe, des entrées invalides sont possibles et peuvent entraîner des résultats de recherche indésirables !

La liste des éléments permet une sélection multiple afin que les utilisateurs puissent importer plusieurs éléments à la fois. Une fois que vous avez sélectionné tous les problèmes recherchés, cliquez simplement sur Accepter pour créer un nouveau widget pour chaque problème sélectionné dans le projet. Par défaut, tous les problèmes importés sont traités de la même manière et sont donc placés dans une disposition en grille. Si les problèmes sont liés les uns aux autres, vous pouvez également modifier le arrangement De à dans la liste déroulante des dispositions de la boîte de dialogue. Cela placera les problèmes/tickets parents au-dessus de leurs liens les enfants.

Importation par Copier/Coller des URL depuis un navigateur Web :
Une autre façon d'intégrer des problèmes/tickets externes dans un projet DEON consiste à copier puis à coller l'URL du ticket souhaité. Pour que ce processus réussisse, il est important que le lien URL contienne le nom ou l'ID du projet et l'ID/numéro du ticket.

Une éventuelle URL de ticket valide (Azure) ressemble à ceci : https://dev.azure.com/Le nom de votre société/Nom du projet/_workitems/modifier/4889/

Importation par Glisser-Déposer d'URL depuis un navigateur Web :
Au lieu de copier et coller l'URL, vous pouvez également utiliser une opération de glisser-déposer pour placer le ticket dans l'espace du projet DEON. Par conséquent, cliquez et faites glisser l'URL du navigateur directement sur DEON et déposez-la là. DEON reconnaîtra les URL valides pour les opérations de copier/coller et de glisser-déposer.

Les deux options fonctionnent également de l'intérieur navigateurs Web intégrés à DÉON. S'il vous arrive d'avoir un widget de navigateur placé dans votre projet, vous pouvez glisser-déposer ou copier/coller des URL de ticket depuis ce navigateur vers le projet DEON sans avoir à ouvrir ces URL en externe en premier lieu.

 

Édition et synchronisation

Chaque widget de problème est livré avec des options de menu contextuel pour travailler avec le ticket. Cliquez et sélectionnez l'objet du problème pour ouvrir le menu contextuel :

  Permet de modifier toutes les données du ticket dans une boîte de dialogue séparée. Après avoir accepté les modifications peuvent être synchronisées.
  Pousse les modifications en attente sur le serveur.
  Extrait les données de problème/ticket du serveur. Veuillez noter : Les données locales non synchronisées seront écrasées !
  Ouvre l'URL du problème dans un navigateur.
  Bascule le mode d'affichage du ou des problèmes sélectionnés entre le mode carte et le mode ligne.

Dans la boîte de dialogue d'édition, les utilisateurs peuvent modifier toutes les propriétés disponibles du problème/ticket sélectionné. Étant donné que les billets ont tendance à contenir de nombreux détails dans leur description, DEON prend également en charge l'édition du langage HTML à cette fin, comme indiqué dans l'image ci-dessous.

 

Notes

Le système d'intégration de suivi fonctionne sur un cache local, ce qui signifie qu'une certaine quantité de données doit être chargée occasionnellement à partir du serveur et est utilisée pour créer un cache de données local. En fonction de la sélection de l'utilisateur, cette étape doit se produire selon un calendrier récurrent (quotidien, hebdomadaire, etc.). Ce processus peut prendre un certain temps et dépend en grande partie du nombre de projets que DEON trouve sur le serveur.

En règle générale, les utilisateurs peuvent s'attendre à ce que plus de projets doivent être collectés à partir d'un serveur, plus de données sont mises en cache et plus il faut de temps pour terminer l'étape de construction du cache. DEON informera l'utilisateur dès que le processus sera terminé. Pendant ce temps, le suivi features ne sont pas disponibles.