Intégration de Jira

Si UiPath Automation Hub est l'endroit où vous pouvez gérer de manière centralisée votre ensemble des opportunités d'automatisation, alors Jira est l'endroit où vos développeurs suivront les tâches sous-jacentes utilisées dans le cycle de vie du développement de l'automatisation.

En liant les idées Automation Hub aux tickets Jira, vous obtiendrez une image plus claire de la progression du développement de vos automatisations.

L'authentification entre Automation Hub et Jira s'appuie sur le connecteur Jira Cloud (Jira Cloud Connector) existant, depuis UiPath Integration Service.

Configuration de l'intégration de Jira

Les utilisateurs d'Automation Hub qui disposent des autorisations permettant de Gérer l'intégration Jira peuvent la configurer et l'activer afin que les utilisateurs puissent lier ou créer un ticket Jira directement à partir d'une idée d'automatisation.

Authentification

L'intégration Jira doit être activée et configurée par un utilisateur d'Automation Hub disposant des autorisations nécessaires pour gérer l'intégration, avant de la déployer au reste des utilisateurs.

Dans cet onglet, l'utilisateur doit d'abord saisir un espace de travail Jira avant de pouvoir effectuer la configuration.

Remarque :

• Les administrateurs doivent disposer de l’autorisation Gérer l'intégration Jira (Manage Jira Integration).

• L'autorisation est attribuée par défaut aux rôles Propriétaire du compte et Administrateur système.

Suivez les étapes ci-dessous pour démarrer la configuration :

1. Connectez-vous tout d'abord à votre espace de travail Jira

• Dans Console d'administration (Admin Console) > Configuration de la plate-forme (Platform Setup), sélectionnez Intégration Jira (Jira Integration).

• Dans la section Authentification, vous devrez commencer par ajouter l'URL de votre espace de travail Jira et sélectionner Se connecter (Connect).

  
  

  

  
  
  L'URL de l'espace de travail Jira (Jira workspace) doit respecter le format suivant : https://[yourworskpace].atlassian.net

2. S'authentifier avec Jira

• Sélectionnez Ouvrir l'authentificateur (Open authenticator).
• UiPath Integration Service s'ouvre dans une nouvelle fenêtre à partir de laquelle vous pouvez sélectionner Ajouter une connexion (Add connection).

En savoir plus sur l'utilisation des connecteurs sur la page Connexions (Connections).

Une nouvelle fenêtre Se connecter à Jira (Connect to Jira) apparaît où l'URL du site et l'étendue doivent être pré-remplis. Sélectionnez Se connecter (Connect).

• La page Web Atlassian s'ouvre, où vous devez confirmer l'intégration UiPath - Jira. Sélectionnez Accepter.

  
  

  

  
  
  Remarque :

  Si vous n'êtes pas déjà connecté à Jira, il vous demandera de vous connecter d'abord, puis de reprendre l'intégration Uipath - Jira.

  La connexion que l'administrateur configure au niveau du service d'intégration ne peut pas être réutilisée pour le reste des utilisateurs qui utiliseront l'intégration. Tous les utilisateurs devront posséder une connexion existante pour utiliser l'intégration.

• Vous êtes redirigé vers la page Connexion Jira (Jira Connection) initiale dans Automation Hub où, sous le bouton Ouvrir l'authentification (Open authentication), vous devez sélectionner Confirmer (Confirm) pour que la connexion d'intégration soit réussie.

  À ce stade, votre connexion à Jira est en place et vous pouvez passer aux étapes suivantes.

  3. Configurer le type de problème et le nom du projet
• Dans la liste déroulante de chaque zone, sélectionnez le Nom du projet (Project Name) et le Type de problème (Issue type), qui seront utilisés lorsqu'un ticket Jira est créé à partir d'une idée d'automatisation. Sélectionnez Confirmer (Confirm).

• Les valeurs déroulantes sont extraites du Jira Workspace auquel vous êtes connecté.

  
  

  

  
  
  4. Sélectionner un problème existant comme modèle

• Vous devez maintenant ajouter le lien de problème (Issue link), représentant le modèle de ticket Jira de votre projet. Les sections préremplies de ce ticket sont toujours ajoutées aux tickets créés par l'utilisateur. Ajoutez l'URL du ticket Jira et sélectionnez Valider.

  
  

  

  
  

  Le problème du modèle sera validé avant d'être enregistré pour s'assurer que :

• Il provient du même projet que celui défini à l'étape précédente.
• Le type de problème correspond à celui défini à l'étape précédente.
• Le problème existe dans le Jira Workspace connecté.

• Le format de l'URL est correct : https://yourworskpace.atlassian.net/browse/YOURPROJECTKEY-1111

Exemple de configuration d'un modèle de problème Jira :

• Vous commencez à partir d'un ticket existant de votre projet Jira https://yourworskpace.atlassian.net/browse/KEY-1111 .
• Le problème vient du type Tâche (Task) et contient les champs Jira de base et un champ personnalisé supplémentaire appelé Validation nécessaire (Validation needed).
• Le ticket est enregistré dans la configuration d'Automation Hub.

• Dans l'onglet Mappage des champs (Field Mapping), vous pouvez effectuer la configuration suivante :

  • Le titre de l'idée est mappé au Résumé Jira.
  • La description de l'idée est mappée à la description de Jira.
• Vous pouvez choisir de mapper le champ Jira Validation nécessaire (Validation needed) vers un champ dans Automation Hub ou vous pouvez coder en dur dans le modèle pour toujours avoir une certaine valeur, par exemple Oui (Yes).
• Pour finir, on peut aussi ajouter un libellé AUTOMATION_HUB_IDEA codé en dur dans le modèle de problème Jira.

• En utilisant cette configuration, les tickets Jira créés à partir d'Automation Hub auront la configuration suivante :

  • Résumé et Description extraits des champs correspondants d'Automation Hub.
  • Champ personnalisé Validation nécessaire (Validation needed) codé en dur sur Oui (Yes) pour tous les problèmes.

  • Libellés codés en dur sur AUTOMATION_HUB_IDEA pour tous les problèmes.

    Une fois les tickets créés, ils suivront le workflow défini dans Jira pour ce type de problème.

Important : assurez-vous que le modèle n'est pas supprimé ou modifié lorsque la connexion Jira est active et définie, car cela pourrait entraîner l'interruption du flux d'intégration.

5. La dernière étape du flux de connexion indique que la connexion est maintenant activée.

Mappage des champs

Dans l'onglet Mappage des champs (Field Mapping), vous pouvez mapper les champs Automation Hub aux champs Jira. En faisant cela, vous configurerez la façon dont les tickets sont créés par les utilisateurs autorisés à déclencher la création de problèmes Jira à partir d'Automation Hub.

Lorsqu'un mappage est effectué, cela signifie que les valeurs du champ Automation Hub seront utilisées pour remplir le champ Jira mappé correspondant.

Par défaut, deux champs Jira sont mappés après une connexion Jira réussie :

Champ Jira	Champ Automation Hub
Résumé	Nom de l’automatisation
Un champ de texte brut	Description

Une nouvelle carte de champ peut être ajoutée en :

1. Sélectionnez +Ajouter un mappage (+Add mapping).
2. Sous le champ Jira, sélectionnez la nouvelle ligne créée et, dans la liste déroulante, sélectionnez le champ disponible souhaité.
3. Sous le champ Automation Hub, sélectionnez le champ disponible souhaité dans la liste déroulante.

Les lignes de la table de correspondance sont automatiquement enregistrées.

Pour supprimer une ligne, cliquez sur le menu à trois points sur le côté droit de la ligne et sélectionnez Supprimer (Delete).

Exemple de mappage :

• Vous avez un champ Jira appelé Raison commerciale.
• Vous avez également un champ dans Automation Hub appelé Raison commerciale (Business reason) (les noms ne correspondent pas obligatoirement) que vous avez défini dans l’une de vos évaluations.
• Dans l'onglet Mappage des champs (Field Mapping), vous mappez les deux ensemble.
• Lorsqu'un utilisateur sélectionne Créer un nouveau ticket Jira à partir d'Automation Hub, le champ Raison commerciale (Business reason) dans Jira recevra la valeur du champ Raison commerciale (Business reason) de l'idée Automation Hub.

Si le champ est Null ou n'existe pas dans le profil d'automatisation de l'idée, la création sera effectuée, mais le champ Jira correspondant aura des valeurs Null.

Supprimer la connexion à Jira

En supprimant la connexion Jira, toutes les données du formulaire d'authentification sont effacées.

1. Dans Console d'administration (Admin Console) > Configuration de la plate-forme (Platform Setup), sélectionnez Intégration Jira (Jira Integration).
2. Sélectionnez Supprimer la connexion (Delete Connection).

Le bouton Réinitialiser la connexion (Reset connection) permet de réinitialiser le formulaire d'authentification administrateur Jira (Jira Admin Authentication) avant que la connexion ne soit enregistrée.