Intégration Microsoft Azure Logics Apps


À 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

Microsoft Azure Logic Apps permet d’intégrer et de connecter simplement plusieurs centaines d’applications et services web (On-Premise ou dans le cloud), des données et des appareils.

  • L'outil s'appuie sur un vaste écosystème de connecteurs standard, qui s’agrandit régulièrement.

    Example documentation icon FR.png  Connecteurs standard : Azure (Active Directory, …), Office 365 (Outlook, One Drive, SharePoint, Dynamics…), Skype For Business, Teams, Planner, Jira Software, SAP, Google Suite, Salesforce, Dropbox, Slack, Facebook, Twitter, Plivo, LiveChat, MySQL, SFTP, Service Bus, etc.
       Open url.png voir Liste des connecteurs (EN)

  • Il permet de s’interfacer avec n’importe quel point de terminaison via HTTP/HTTPS (ex. : via des API REST). 
  • C'est un outil similaire à Zapier et IFTTT également supportés par Product name - ev itsm.png grâce à des connecteurs (services) standard utilisables dans des actions REST dans un workflow ou une règle métier  - Open url.png voir Intégration Zapier

Note : Microsoft Flow est un outil similaire intégré à certaines offres Microsoft Office 365, basé sur Logic Apps et présentant le même concepteur de travail et les mêmes connecteurs. Il permet à n’importe quel utilisateur d’effectuer des intégrations simples (ex. : Recevoir des SMS pour des e-mails importants) sans faire appel à des développeurs ou au département informatique  - Open url.png voir FAQ  - Plans Flow
À la différence, les applications de Logic Apps prennent en charge des intégrations avancées ou stratégiques (ex. : Processus B2B) nécessitant des pratiques de développement et de sécurité au niveau de l’entreprise. Pour cela, Logic Apps dispose de plus de fonctionnalités destinées aux développeurs et aux membres du département informatique.

Microsoft Azure Logic Apps vous permet de réaliser 2 types d’intégration entre Product name - ev itsm.png et des services tiers supportés :

  • Effectuer depuis un workflow ou une règle métier  Product name - ev itsm.png des actions dans des services tiers -  Open url.png voir Processus d'intégration n° 1

        Example documentation icon FR.png  

    • La validation d’une demande d’accueil d’un nouveau collaborateur (Processus RH d’Onboarding géré dans un workflow Product name - ev itsm.png) entraîne la création d’un utilisateur dans Microsoft Azure Active Directory avec les informations disponibles (nom, prénom, titre, département, localisation, n° de téléphone…), son ajout à un groupe AD et l’affectation d’un manager.
    • La création d’un nouvel incident dans Product name - ev itsm.png via un workflow standard de gestion des incidents ou une règle métier entraîne la création d’un incident dans Jira Software.
    • La validation d’un changement sur le logiciel SAP, dans une étape d’un workflow Product name - ev itsm.png de gestion des changements, entraîne la création dans le logiciel de gestion de projets (PPM) Trello, utilisé par le département Études & Développement, d’une nouvelle carte ayant pour nom le numéro de la demande de changement, dans une liste Demande Changements SAP Validés d’un tableau Suivi Développement SAP.
  • Effectuer depuis des services tiers des actions dans Product name - ev itsm.png -  Open url.png voir Processus d'intégration n° 2

    Example documentation icon FR.png  La création dans Trello d’une nouvelle carte dans une liste Étude nouvelles formations d’un tableau Nouveau catalogue des formations utilisé par le département Ressources humaines entraîne la création dans Product name - ev itsm.png d’une demande de service Analyse nouvelle formation avec la description de la carte Trello.

     
Flux d’intégration des données (sens) Type d'authentification Options du connecteur d'intégration

Product name - ev itsm - big.png

Up and Down arrow.png

Logo - Microsoft Azure Logic Apps.png

  • Selon le service externe utilisé (authentification prise en charge par Microsoft Azure Logic Apps)
  • Basic Authentication pour l’API REST Product name - ev itsm.png

Product name - ev itsm.png SaaS

Product name - ev itsm.png On-premise

Check icon.png

Check icon.png

Version SaaS du produit tiers

Version On-premise du produit tiers

Check icon.png

N/A

Processus d'intégration pas à pas

Documentation

Open url.png voir sur le wiki
Open url.png voir Documentation de Microsoft Logic Apps
Open url.png voir Documentation d'outils (EN)
Open url.png voir Les tarifs

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 Product name - ev itsm.png 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 Operation et Transition.

Processus n° 1 : ev|Service Manager vers des services tiers

Processus n° 1 : Utiliser un flux de travail d'application logique avec une action REST Logic Apps d'un workflow ou d'une règle métier Product name - ev itsm - big.png pour effectuer des actions dans un service tiers

Open url.png  voir Créez votre première application logique  (envoi d’un e-mail depuis un compte Outlook lors de la publication d’un nouveau contenu dans un flux RSS).

Example documentation icon FR.png  Ce processus s’appuie sur un cas d’usage simple : une demande de service créée dans Product name - ev itsm.png par un VIP (priorité haute) déclenche une action d’envoi d’un e-mail à une liste de membres en charge du traitement des demandes de VIP, en utilisant un compte de messagerie Office 365 Outlook déterminé.

Étape 1 : Dans Logic Apps, initialisation du flux de travail avec un déclencheur (depuis Product name - ev itsm.png)

         Notes :

  • Un déclencheur est un événement qui démarre le flux de travail de votre application logique, et qui est le premier élément requis par celle-ci.
  • Dans ce processus, le déclencheur est une action REST Logic Apps déclenchée dans un workflow Product name - ev itsm.png, et qui effectue une requête HTTP (via une méthode POST) vers un point de terminaison (URL).
  • Vous utilisez un déclencheur de requête HTTP.

1.1. Connectez-vous au Portail Microsoft Azure.

1.2. Dans le menu de gauche, sélectionnez Nouveau > Intégration d’entreprise > Application logique.
         Process 1 & 2 - Menu new Logic app.png

1.3. Dans la fenêtre de présentation du connecteur Logic App, cliquez sur [ CRÉER ].

1.4. Dans la fenêtre Créer une application logique, renseignez les informations ci-dessous puis cliquez sur [ CRÉER ].
         Process 1 - Step 1 - Window Create Logic App.png

  • Name : Nom de votre application logique.

    Note : Seuls sont autorisés les lettres et chiffres, ainsi que les caractères -  (  )  . . Les espaces ne sont pas autorisés.

    Example documentation icon FR.png  EVSM_New_Request_WKFW_(High-VIP)_SendE-mail

  • Abonnement : Votre abonnement Azure.
  • Resource group : Groupe de ressources Azure, qui permet d’organiser et de gérer des ressources Azure liées. Sélectionnez celui souhaité ou créez-en un nouveau.
  • Location : Emplacement du centre de données pour l’hébergement de votre application logique. 
  • Épingler au tableau de bord : Cochez la case pour permettre à votre application logique de s’afficher dans le tableau de bord Azure après le déploiement et de s’ouvrir automatiquement.

1.5. Sélectionnez le déclencheur dans le concepteur d’applications logiques :

  • Sélectionnez le déclencheur [ Lors de la réception d’une demande HTTP ] ou sélectionnez un modèle prédéfini que vous avez déjà créé.
             Process 1 - Step 1 - Select trigger.png
  • Dans la barre de commandes du concepteur, cliquez sur [ ENREGISTRER ] pour générer l'URL de votre déclencheur.
             Process 1 - Step 1 - Generate url.png

1.6. Copiez l’URL (URL HTTP POST) fourni par Logic Apps, utile pour l'étape 3.
 

Étape 2 : Dans Logic Apps, finalisation du flux de travail (action dans le service tiers)

         Notes :

  • Une action est une tâche effectuée par le flux de travail de votre application logique. 
  • Après l'ajout d'un déclencheur dans votre application logique, vous pouvez ajouter une action permettant d’effectuer des opérations avec les données générées par le déclencheur ou d’autres actions grâce au contenu dynamique.
  • Vous utilisez une action d'un connecteur.

Example documentation icon FR.png  Action envoyant un e-mail lorsqu’une action REST Logic Apps est déclenchée dans un workflow Product name - ev itsm.png et effectue une requête REST (méthode POST) sur le point de terminaison (URL) fourni à l’étape 1

2.1. Dans le concepteur, sous votre déclencheur, sélectionnez + Nouvelle étape > Ajouter une action.
         Process 1 & 2 - Menu new action.png

2.2. Sélectionnez l’action à effectuer.
         Process 1 - Step 2 - Action.png

  • Utilisez la zone de recherche pour filtrer la liste des connecteurs puis sélectionnez celui souhaité dans la zone Connecteurs.
             Example documentation icon FR.png  Saisissez Outlook puis sélectionnez Office 365 Outlook
  • La zone Actions affiche toutes les actions définies pour le connecteur sélectionné. Sélectionnez celle souhaitée.
             Example documentation icon FR.png  Action Office 365 Outlook - Envoyer un message électronique

2.3. Renseignez les informations d’identification requises pour vous connecter au service utilisé ou cliquez sur Modifier la connexion.
         Example documentation icon FR.png  Nom d’utilisateur et mot de passe du compte de messagerie Office 365 Outlook

2.4. Renseignez les informations de l'action selon vos besoins.
         Example documentation icon FR.png  Action d'envoi d'un e-mail à une liste de distribution, avec le connecteur Office 365 Outlook
         Process 1 - Step 2 - Example Action details.png

2.5. Dans la barre de commandes du concepteur, cliquez sur [ ENREGISTRER ].
         Process 1 & 2 - Save action.png
 

Étape 3 : Dans Product name - ev itsm.png, création d’une action REST Logic Apps dans un workflow ou une règle métier

         Open url.png  voir procédure Comment paramétrer un type d'action REST pour un nouveau service

3.1. Créez un nouveau service Logic Apps.
         Process 1 - Step 3 - New service.png

3.2. Créez une nouvelle connexion au service.

Note : Le paramètre {subdomain} dépend de l’emplacement du centre de données (pour l’hébergement de votre application logique) sélectionné à l’étape 1.

         Process 1 - Step 3 - New connection.png

Valeur du paramètre {subdomain} de l’URL du service Logic Apps = code avant .logic dans l’URL fourni par Logic Apps à l’étape 1  

Example documentation icon FR.png  URL  https://prod-29.eastus.logic.azure.com:443/workflows/1f5f40b60154432abcb0b8084892440f/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=5-nNWgR2Hho6s5YN2BYzqBFpzrLmf7UBqhrl6328rIB  ==>  prod-29.eastus

3.3. Créez une nouvelle ressource au service.

Note : Vous pouvez passer des paramètres à Logic Apps pour qu’ils soient utilisés dans une application tierce.
    Example documentation icon FR.png  Paramètre #[DB_FIELDS.RFC_NUMBER]#

Example documentation icon FR.png  Nouvelle ressource passant le numéro et le descriptif de l’incident dans l’e-mail envoyé à une liste de distribution
         Process 1 - Step 3 - New resource.png

Best Practice icon.png  Dans le champ Contenu, préférez une rédaction en ligne d'un schéma JSON en supprimant tous les espaces inutiles et les retours à la ligne (voir ci-dessus).
En effet, 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.

3.4. Ajoutez et paramétrez une action REST en utilisant la connexion et la ressource créées précédemment.
         Process 1 - Step 3 - New action REST.png
 

Étape 4 : Dans Logic Apps, paramétrage du déclencheur et de l’action pour prendre en charge les paramètres d’Product name - ev itsm.png

         Open url.png  voir Connecteur déclencheur de requête HTTP

         Notes :

  • Pour passer des paramètres d’Product name - ev itsm.png à Logic Apps, vous devez fournir un schéma JSON dans le corps de texte du déclencheur de requête HTTP. Pour cela, vous pouvez utiliser un outil tel que l’éditeur JSONSchema.net.
  • Vous pouvez ainsi utiliser les jetons générés par le concepteur de Logic Apps pour les propriétés dans la requête HTTP du déclencheur.
  • En utilisant les fonctionnalités de contenu dynamique dans une action, vous pouvez utiliser ces propriétés correspondant à des paramètres reçus d’Product name - ev itsm.png.

4.1. Paramétrez le déclencheur en créant un schéma JSON pour le corps de texte du déclencheur de requête HTTP :

  • Dans Product name - ev itsm.png, copiez le contenu du schéma JSON inséré dans le champ Contenu de la ressource REST créée à l’étape 3.
     
  • Supprimez tous les caractères invisibles via un éditeur de texte tel que notepad++.
     
  • Ouvrez l’éditeur JSONSchema.net puis :
    • (1) Collez ce contenu dans la zone JSON puis cliquez sur [ SUBMIT ].
    • (2) Passez en mode Plain et copiez le schema JSON via JSONSchemanet editor - Copy clipboard icon.png.
               Process 1 - Step 4 - JSONSchemanet editor.png
       
  • Retournez sur Logic Apps et collez le schéma JSON dans la zone Schéma JSON du corps de la demande.
             Process 1 - Step 4 - Logic Apps request body.png
     
  • Optionnel : Pour paramétrer le nom des propriétés (paramètres provenant d'Product name - ev itsm.png et apparaissant dans la fenêtre du contenu dynamique à l'étape suivante), modifiez le schéma JSON, soit dans Logic Apps, soit précédemment dans l’éditeur JSONSchema.net.

Example documentation icon FR.png  Modifier la valeur des objets title sous l'objet Properties

  • Objet comment > title : Description de l’incident dans Product name - ev itsm.png
          ==> ancienne valeur The comment schema
          ==> nouvelle valeur EVSM_Request_Description
  • Objet rfc_number > title : N° de l’incident dans Product name - ev itsm.png
          ==> ancienne valeur The rfc_number schema
          ==> nouvelle valeur EVSM_Request_Number
    Process 1 - Step 4 - Modify JSON schema.png

4.2. Paramétrez l’action en insérant le contenu dynamique via les propriétés du schéma JSON ajouté précédemment.

Process 1 - Step 4 - Dynamic content in Send email step.png Process 1 - Step 4 - Dynamic content selection.png

Étape 5 : Vérification et test

Example documentation icon FR.png  Création d'une demande de service dans Product name - ev itsm.png (via une entrée au catalogue spécifique)  ==>  Envoi automatique d’un e-mail à une liste de membres en charge du traitement des demandes de VIP, en utilisant un compte de messagerie Office 365 Outlook déterminé.

         Process 1 - Step 5 - Verification ev SM Incident form.png
         Process 1 - Step 5 - Verification ev SM email.png

Processus n° 2 : Services tiers vers ev|Service Manager

Processus n° 2 : Utiliser un flux de travail d'application logique pour effectuer des actions dans Product name - ev itsm - big.png depuis un service tiers

Open url.png  voir Documentation de Microsoft Azure :

Example documentation icon FR.png  Ce processus s’appuie sur un cas d’usage simple : un e-mail est réceptionné dans le dossier Inbox d’un compte de messagerie Office 365 Outlook déterminé, avec une demande de service. Cela déclenche une action de création d'une demande de service dans Product name - ev itsm.png.

Étape 1 : Dans Logic Apps, initialisation du flux de travail avec un déclencheur (depuis un service tiers)

         Notes :

  • Un déclencheur est un événement qui démarre le flux de travail de votre application logique, et qui est le premier élément requis par celle-ci.
  • Dans ce processus, le déclencheur est un événement effectué dans un service tiers.
  • Vous utilisez un déclencheur d’un connecteur.

Example documentation icon FR.png  Réception dans le dossier Inbox d’un compte de messagerie Office 365 Outlook déterminé d’un e-mail dont le sujet contient l'expression New Request By Email

1.1. Connectez-vous au Portail Microsoft Azure.

1.2. Dans le menu de gauche, sélectionnez Nouveau > Intégration d’entreprise > Application logique.
         Process 1 & 2 - Menu new Logic app.png

1.3. Dans la fenêtre de présentation du connecteur Logic App, cliquez sur [ CRÉER ].

1.4. Dans la fenêtre Créer une application logique, renseignez les informations ci-dessous puis cliquez sur [ CRÉER ].
         Process 2 - Step 1 - Window Create Logic App.png

  • Name : Nom de votre application logique.

    Note : Seuls sont autorisés les lettres et chiffres, ainsi que les caractères -  (  )  . . Les espaces ne sont pas autorisés.

    Example documentation icon FR.png  Create_Request_in_EVSM_from_NewE-mail

  • Abonnement : Votre abonnement Azure.
  • Resource group : Groupe de ressources Azure, qui permet d’organiser et de gérer des ressources Azure liées. Sélectionnez celui souhaité ou créez-en un nouveau.
  • Location : Emplacement du centre de données pour l’hébergement de votre application logique. 
  • Épingler au tableau de bord : Cochez la case pour permettre à votre application logique de s’afficher dans le tableau de bord Azure après le déploiement et de s’ouvrir automatiquement.

1.5. Sélectionnez le déclencheur dans le concepteur d’applications logiques :

  • Sélectionnez le déclencheur [ Application logique vide ] ou sélectionnez un modèle prédéfini que vous avez déjà créé.
             Process 2 - Step 1 - Select trigger.png
  • Utilisez la zone de recherche pour filtrer la liste des connecteurs puis sélectionnez celui souhaité dans la zone Connecteurs.
             Example documentation icon FR.png  Saisissez Outlook puis sélectionnez Office 365 Outlook
             Process 2 - Step 1 - Connector selection.png
  • La zone Déclencheurs affiche tous les déclencheurs définis pour le connecteur sélectionné. Sélectionnez celui souhaité.
             Example documentation icon FR.png  Déclencheur Office 365 Outlook - Lors de l’arrivée d’un nouveau message électronique
             Process 2 - Step 1 - Trigger selection.png

1.6. Renseignez les informations d’identification requises pour vous connecter au service utilisé ou cliquez sur Modifier la connexion.
         Example documentation icon FR.png  Nom d’utilisateur et mot de passe du compte de messagerie Office 365 Outlook

1.7. Renseignez les informations du déclencheur selon vos besoins.
         Process 2 - Step 1 - Example Trigger details.png

1.8. Dans la barre de commandes du concepteur, cliquez sur [ ENREGISTRER ].
         Process 1 & 2 - Save action.png
 

Étape 2 : Dans Logic Apps, finalisation du flux de travail (action dans Product name - ev itsm.png)

         Notes :

  • Une action est une tâche effectuée par le flux de travail de votre application logique. 
  • Après l'ajout d'un déclencheur dans votre application logique, vous pouvez ajouter une action permettant d’effectuer des opérations avec les données générées par le déclencheur ou d’autres actions grâce au contenu dynamique.
  • Vous utilisez le connecteur action HTTP – HTTP.

Example documentation icon FR.png  Envoi d’une requête HTTP POST à l’API REST d'Product name - ev itsm.png pour créer une demande de service avec le nom de l’expéditeur de l’e-mail comme bénéficiaire/demandeur et le sujet/corps de l’e-mail comme description de la demande

2.1. Dans le concepteur, sous votre déclencheur, sélectionnez + Nouvelle étape > Ajouter une action.
         Process 1 & 2 - Menu new action.png

2.2. Dans la zone Connecteurs, sélectionnez le connecteur Logic Apps connector - HTTP.png.
         Process 2 - Step 2 - Connector selection.png

2.3. Dans la zone Actions, sélectionnez l'action HTTP - HTTP.
         Process 2 - Step 2 - Action selection.png 

2.4. Renseignez les informations de l'action HTTP selon vos besoins, en utilisant l’API REST d’Product name - ev itsm.png  et en utilisant le contenu dynamique disponible.
         Example documentation icon FR.png  Action de création d'une demande de service dans Product name - ev itsm.png :

  • Bénéficiaire et demandeur : définis par l'adresse de la personne ayant envoyé l’e-mail 
  • Description de l’incident : contenu du sujet et du corps de l’e-mail
Process 2 - Step 2 - Dynamic content in Receive email step.png Process 2 - Step 2 - Dynamic content selection.png

2.5. Dans la barre de commandes du concepteur, cliquez sur [ ENREGISTRER ].
         Process 1 & 2 - Save action.png
 

Étape 3 : Vérification et test

3.1. Dans la barre de commandes du concepteur, cliquez sur [ EXÉCUTER ].
         Process 2 - Run action.png

3.2. Vérifiez le bon déroulement du flux de travail via l'affichage de Check icon.png dans la fenêtre du concepteur.
         Process 2 - Step 3 - Verification App logic workflow.png

Example documentation icon FR.png  Envoi d'un e-mail avec une nouvelle demande de service (en utilisant une adresse déterminée)  ==>  Création d'une demande de service dans Product name - ev itsm.png

         Process 2 - Step 3 - Verification App logic  email.png
         Process 2 - Step 5 - Verification ev SM request.png

Tags:
Modifié par Utilisateur inconnu le 2018/07/04 11:48
Créé par Administrator XWiki le 2017/10/18 16:29

Raccourcis

L'actualité mensuelle
•  Newsletter

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

Glossaire

Powered by XWiki ©, EasyVista 2020