Intégration de Jira

S’applique à Automation Cloud uniquement.

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 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.
• Vous devez accéder à un espace de travail personnel.

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://[yourworkspace].atlassian.net

2. S'authentifier avec Jira

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

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

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

• 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, vous devrez vous connecter d'abord à Jira, puis reprendre avec l'intégration UiPath - Jira. La connexion que l'administrateur configure au niveau d'Integration Service 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 initiale dans Automation Hub où, en dessous du bouton Ouvrir l'authentification, vous devez sélectionner Confirmer, pour que la connexion d'intégration réussisse. À 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

• En utilisant le menu déroulant de chaque case, vous pouvez sélectionner 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 .

• 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://yourworkspace.atlassian.net/browse/YourPROJECTKEY-1111

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

• Vous commencez par un ticket existant à partir de votre projet Jira https://yourworkspace.atlassian.net/browse/KEY-1111 .
• Le problème est de type Tâche et contient les champs Jira de base et un champ personnalisé supplémentaire appelé Validation requise .
• 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 Validation requise Jira à un champ dans Automation Hub ou vous pouvez coder en dur dans le modèle pour toujours avoir une certaine valeur, par exemple Oui .
• La touche finale peut consister à ajouter également un libellé codé en dur AUTOMATION_HUB_IDEA 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 codé en dur sur Oui 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, il suivra 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 vous montre 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 .
2. Sous 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, accédez au menu à trois points sur le côté droit de la ligne et sélectionnez Supprimer .

Exemple de mappage :

• Vous avez un champ Jira nommé Raison commerciale.
• Vous avez également un champ dans Automation Hub appelé Raison commerciale (les noms ne doivent pas nécessairement correspondre) 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 ticket Jira à partir d'Automation Hub, le champ Raison commerciale dans Jira recevra la valeur du champ Raison commerciale 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 seront 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 .

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.