Intégration Jira (via Microsoft Flow)


À propos de cette intégration

IntegrationIntroduction

Il existe plusieurs moyens d’intégrer des systèmes tiers avec Product name - ev itsm.png. Cela, en fonction des besoins métiers, des contraintes d’architecture et de sécurité en vigueur ainsi que des spécificités de chaque application ou service tiers.

Cette page présente un processus d’intégration type déjà mis en œuvre dans un contexte client. 

Pour plus de détails sur cette intégration (scripts à utiliser, etc.), veuillez contacter les départements "Consulting & Professional Services" et Support d'Logo - EasyVista.png ou vos fournisseurs de services et intégrateurs habituels.
 

Synthèse de l’intégration

Jira est un système de suivi de bugs, de gestion des incidents et de gestion de projets développé par Atlassian.
Cette intégration vous permet de créer un ticket JIRA à partir d'un ticket créé dans Service Manager, en utilisant Microsoft Flow : un flux de travail MS Flow est créé dans Microsoft Azure Logic Apps en utilisant le connecteur EasyVista Service Manager.

  • Microsoft Flow permet d’automatiser les tâches répétitives en construisant des flux de travail via des applications web s'appuyant sur des connecteurs basés sur Microsoft Azure Logic Apps. Il permet de s’interfacer avec n’importe quel point de terminaison via HTTP/HTTPS.
       Open url.png voir Intégration Microsoft Flow
     
Flux d’intégration des données (sens) Type d'authentification Options du connecteur d'intégration

Service Manager

Down arrow.png

Logo - Microsoft Flow.png

Down arrow.png

Logo - Jira Software.png

  • Selon le service externe utilisé (authentification prise en charge par Logic Apps)
  • Basic Authentication pour l'API REST Service Manager
  • Service Manager :

    EV Integration connector icon - Workflow.png    Workflow

    EV Integration connector icon - Business rule.png    Règle métier

  • MS Flow :

    EV Integration connector icon - Receive.png    Connecteur : Lors de la réception d’une demande HTTP

    (Trigger Service Manager => Logic Apps)

Versions disponibles
SaaS On Premise
Service Manager Check icon.png Check icon.png
Produit tiers Check icon.png N/A

Flux d’échange

         Data feed diagram - FR.png

Processus d'intégration pas à pas

Un ticket Service Manager est créé dans JIRA via Microsoft Flow en 2 phases :

Prérequis

  • Vous devez disposer d'un abonnement Azure. Sinon, vous pouvez soit en créer un gratuitement, soit souscrire à un abonnement de type paiement à l’utilisation.
  • Vous avez les comptes et droits d’accès suffisants aux services avec lesquels vous souhaitez vous interfacer avec Logic Apps.
  • Vous devez disposer d’un compte d’accès à votre plateforme Service Manager avec un profil et des droits d’accès et d’édition suffisants pour créer ou modifier un workflow, accéder au menu Administration et aux menus dont vous avez besoin, comme par exemple Service Operation et Service Transition.

Microsoft Azure Logic Apps : Création du flux MS Flow

Description du flux de travail

         Azure flow description.png

Étape 1 : Création de l'étape de déclenchement du flux lorsqu'un nouveau ticket Service Manager est créé

1. Connectez-vous au portail Azure avec les informations d’identification de votre compte Azure.

2. Créez une étape de déclenchement de type Lors de la réception d’une demande http pour démarrer le flux de travail.

         Action Azure - When a http request is received.png

3. Renseignez les informations du déclencheur.

  • Body : Effectuez un copier-coller du schéma JSON ci-dessous.

    Afficher le schéma JSON

    {
       "$id": "http://example.com/example.json",
       "type": "object",
       "definitions": {},
       "$schema": "http://json-schema.org/draft-07/schema#",
       "properties": {
           "Description": {
               "$id": "/properties/Description",
               "type": "string",
               "title": "Description",
               "default": "",
               "examples": [
                   "{Description}"
                ]
            },
           "id": {
               "$id": "/properties/id",
               "type": "string",
               "title": "Id",
               "default": "",
               "examples": [
                   "{id}"
                ]
            },
           "Host": {
               "$id": "/properties/Host",
               "type": "string",
               "title": "Host",
               "default": "",
               "examples": [
                   "{Host}"
                ]
          
     },
           "URL": {
               "$id": "/properties/URL",
               "type": "string",
               "title": "URL",
               "default": "",
               "examples": [
                   "{URL}"
                ]
            },
           "Account": {
               "$id": "/properties/Account",
               "type": "string",
               "title": "Account",
               "default": "",
               "examples": [
                   "{Account}"
                ]
            }
        }
    }
  • Méthode : POST.

4. Sauvegardez le déclencheur.

  Les informations suivantes sont récupérées depuis Service Manager : Description du ticket, ID du ticket, Host, URL, Account.

5. Copiez l'URL affichée dans le champ HTTP POST URL, via Copy icon.png et conservez-la temporairement dans votre éditeur de texte. Elle vous sera demandée lors du paramétrage dans Service Manager (étape 2).

Étape 2 : Récupération des informations du ticket Service Manager

1. Recherchez le connecteur EasyVista Service Manager.

2. Sélectionnez l'action de type View Request – Incident rattachée à ce connecteur.

Best Practice icon.png  Utilisez la zone de recherche pour trouver facilement le connecteur et le type d'action.

         Action Azure - EV SM View request – Incident (1).png

         Action Azure - EV SM View request – Incident (2).png

3. Renseignez les informations d'identification du compte et du ticket de Service Manager.

  • Account : Compte de la plate-forme Service Manager.
  • ID : Identifiant du ticket dans Service Manager.

4. Sélectionnez la connexion à votre environnement.

         Action Azure - EV SM View request – Incident (3).png

Étape 3 : Récupération de la description du ticket dans Service Manager

1. Recherchez le connecteur EasyVista Service Manager.

2. Sélectionnez l'action de type View Request – Incident Comment rattachée à ce connecteur.

         Action Azure - EV SM View request – Incident Comment.png

3. Renseignez les informations d'identification du compte et du ticket de Service Manager.

  • Account : Compte de la plate-forme Service Manager.
  • ID : Identifiant du ticket dans Service Manager.

3. Sélectionnez la connexion à votre environnement.

Étape 4 : Création d'un ticket dans JIRA

1. Recherchez le connecteur Jira.

2. Sélectionnez l'action de type Create a new issue rattachée à ce connecteur.

         Action Azure - JIRA - Create a new issue (1).png

3. Renseignez les informations d'authentification.
Note : Ces informations sont demandées uniquement à la première création d'un connecteur dans JIRA.
         Action Azure - JIRA - Create a new issue (2).png

4. Cliquez sur Enregistrer.

5. Renseignez les informations du ticket JIRA.

         Action Azure - JIRA - Create a new issue (3).png

  • Project : La liste contient tous les projets JIRA associés à vos comptes.
  • Issue Type id : Sélectionnez la nature du ticket (bug, sous-tâche, …).
  • Summary : Résumé du ticket.

    exemple  Ticket n° #RFC_NUMBER (information provenant du résultat de l'action EasyVista Service Manager > View Request – Incident)

  • Description : Description du ticket.

    exemple  Comment (information provenant du résultat de l'action EasyVista Service Manager > View Request – Incident Comment)

6. Sélectionnez la connexion à votre environnement.

Étape 5 (optionnelle) : Modification du ticket dans Service Manager

1. Recherchez le connecteur EasyVista Service Manager.

2. Sélectionnez l'action de type Update request – Incident.

         Action Azure - EV SM Update request – Incident (1).png

3. Sauvegardez le numéro de la tâche JIRA dans Service Manager.

4. Renseignez les informations du ticket JIRA.

         Action Azure - EV SM Update request – Incident (2).png

  • Account : Compte de la plate-forme Service Manager.
  • ID : Identifiant du ticket dans Service Manager.
  • Available_Field_6 : Identifiant du ticket JIRA (information provenant du résultat de l'action JIRA > Create a new issue : étape 4).

5. Sélectionnez la connexion à votre environnement.

Service Manager : Création d'une ressource Jira utilisée dans une étape REST d'un processus de création de ticket

Étape 1 : Gestion des droits pour l’utilisation de l’API REST Service Manager

    Open url.png voir Description des profils

1. Allez sur le menu Administration > Gestion des accès > Profils utilisateur.

2. Sélectionnez un profil autorisé à utiliser l'API REST.

3. Cochez la case REST API.
Les modifications sont automatiquement enregistrées.

4. Répétez ces actions pour tous les profils autorisés.

Étape 2 : Création d'une ressource Jira associée à un service Microsoft Flow

       Open url.png  voir procédure Comment définir une nouvelle ressource et l'associer à un type d'action REST

1. Allez sur le menu Administration > REST > Services.

2. Créez un nouveau service.
         Service Manager - Microsoft Flow Service.png

  • Nom du service : Microsoft Flow.
  • Méthode d'authentification : Aucune.
  • URL du service : URL d'accès au nouveau service Microsoft Flow.
    • Copiez-collez l'URL que vous avez conservée dans votre éditeur de texte lors de la création du flux MS Flow dans Logic Apps (étape 1).
    • Conservez uniquement la partie affichée ci-dessous en jaune.

      https://prod-55.westeurope.logic.azure.com:443/workflows/a903f9140a874277be8b9dd39b5c4305/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=R-FJw5q_MEn-I-98MNF794bVtN91QIWFt8gixg-8

    • Remplacez prod-55.westeurope par {subdomain}.
       

3. Créez une connexion au service Microsoft Flow.
         Service Manager - Microsoft Flow Connection.png

  • Nom de la connexion : JIRA.
  • Méthode d'authentification : Aucune.
  • Nom du service : Service Microsoft Flow créé précédemment.
    L'URL du service Microsoft Flow est automatiquement affichée.
  • subdomain : Copiez-collez la valeur prod-55.westeurope de l'URL que vous avez conservée dans votre éditeur de texte.
     

4. Créez une ressource rattachée au service Microsoft Flow, permettant la création d'un ticket dans Jira.
         Service Manager - Microsoft Flow Resource.png

  • Label : Nom de la ressource.
  • Uri de la ressource : Identifiant de la nouvelle ressource.
    • Copiez-collez l'URL que vous avez conservée dans votre éditeur de texte lors de la création du flux MS Flow dans Logic Apps (étape 1).
    • Conservez uniquement la partie affichée ci-dessous en jaune.

      https://prod-55.westeurope.logic.azure.com:443/workflows/a903f9140a874277be8b9dd39b5c4305/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=R-FJw5q_MEn-I-98MNF794bVtN91QIWFt8gixg-8

  • Contenu : Corps de la requête contenant les données à mettre à jour. Copiez-collez le texte ci-dessous, sans insérer d'espace ni retour à la ligne.

    Note : Si vous collez un schéma JSON copié depuis un éditeur tiers (Microsoft Word, notepad++, etc.), des caractères invisibles peuvent être insérés et créer un dysfonctionnement dans le traitement de l’étape REST utilisant la ressource.

    {"mail": "{mail}","creation": "{date_creation}","id":"{id}","schedulestart": "{schedulestart}","scheduleend": "{scheduleend}","actionid":"{actionid}"}

Étape 3 : Utilisation de la ressource Jira dans une étape REST d'un processus de création de ticket

       Open url.png  voir procédure Comment définir une nouvelle ressource et l'associer à un type d'action REST

1. Ouvrez le workflow ou le processus lié à une règle métier.

  • Workflow : Références > Autres références > Workflow (Operation / Transition)
  • Règle métier : Administration > Règles métier > Processus associés

2. Cliquez-glissez la nouvelle ressource depuis la catégorie Actions REST vers l'éditeur graphique du processus.
Une nouvelle étape est ajoutée au processus.

3. Renseignez les propriétés de la nouvelle étape en double-cliquant dessus.

Tags:
Modifié par Utilisateur inconnu le 2020/06/18 11:06
Créé par Administrator XWiki le 2020/03/24 12:25

Raccourcis

L'actualité mensuelle
•  Newsletter

Tous les changements
•  Service Manager
•  Service Apps
•  Self Help

Glossaire

Powered by XWiki ©, EasyVista 2020