Intégration Microsoft Power Automate


À 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 Power Automate (anciennement Microsoft Flow) permet d’automatiser les tâches répétitives en construisant des flux de travail via des applications web.

  • L'outil s'appuie sur un vaste écosystème de connecteurs standard basés sur Microsoft Azure Logic Apps pour s’interfacer avec n’importe quel point de terminaison via HTTP/HTTPS.

    exemple  Azure Active Directory, Office 365, Skype For Business, Teams, Jira Software, SAP, ...

  • Il peut également utiliser la passerelle Microsoft Graph, via l'API MS Graph, lorsque aucun connecteur n'est disponible.
     

Cette intégration vous propose d'utiliser Microsoft Power Automate au travers de la fonctionnalité Analyse des sentiments de l’API Analyse de texte

  • un ticket est créé par un utilisateur dans Service Apps ;
  • le contenu de sa description est automatiquement évaluée par l'API et permet d'obtenir un score et une étiquette de sentiment de chaque phrase (détection des sentiments positifs ou négatifs de l'utilisateur).
     
Flux d’intégration des données (sens) Type d'authentification Options du connecteur d'intégration

Logo - EV Service Manager.png

Up and Down arrow.png

Logo Icon - Microsoft Flow.png

  • Selon le service externe utilisé (authentification prise en charge par Microsoft Power Automate)
  • Basic Authentication pour l’API REST Service Manager
Versions disponibles
SaaS On Premise
Service Manager Check icon.png Check icon.png
Produit tiers Check icon.png N/A

Remarques

PowerAutomatevsLogicApp

Quelles différences entre les applications Logic Apps et Microsoft Power Automate ?

  • Microsoft Power Automate est un outil intégré à certaines offres Microsoft 365. Il est basé sur des applications Logic Apps et présente le même concepteur de travail et les mêmes connecteurs. Il permet à n’importe quel utilisateur d’effectuer des intégrations simples sans faire appel à des développeurs ou au département informatique.

    exemple  Recevoir une notification par SMS lorsqu'un e-mail important est reçu

  • Les applications Logic Apps prennent en charge des intégrations avancées ou stratégiques, nécessitant des pratiques de développement et de sécurité au niveau de l’entreprise. Pour cela, Microsoft Azure Logic Apps dispose de plus de fonctionnalités destinées aux développeurs et aux membres du département informatique.

Flux d'échange de l'intégration

Cette intégration s’appuie sur un cas d’usage simple : analyser le texte saisi par un utilisateur lors de la création d’un incident via le portail et notifier à un responsable lorsque cet utilisateur est mécontent.

Le flux d'échange est représenté ci-dessous.
         Exchange flow diagram - FR.png

Processus d'intégration pas à pas

Le processus d'analyse des sentiments sur un ticket Service Manager se fait en plusieurs phases :

Prérequis

  • Vous devez disposer d'un abonnement Azure. Sinon, vous pouvez soit en créer un gratuitement (Open url.png voir Procédure), soit souscrire à un abonnement de type paiement à l’utilisation.
  • 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 Operation et Transition.

Microsoft Azure : Création d’un abonnement à l’analyse des sentiments

Étape 1 : Accès au portail Azure

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

Étape 2 : Création d'une ressource Azure pour l'analyse des sentiments

1. Cliquez sur + Créer une ressource sur la page d'accueil du portail.

         Azure portal - Create new resource.png

2. Cliquez sur IA + Machine Learning dans le menu latéral, puis sur Analytique de texte.

         Azure portal - Create new resource - Text analytics resource.png

3. Renseignez les informations de la nouvelle ressource.

         Azure portal - Create new resource - Text analytics resource - Information.png

4. Cliquez sur Créer.
La nouvelle ressource permettant l'utilisation de l'API d'analyse des sentiments est déployée.
 

Étape 3 : Obtention d'une clé d'accès à l'abonnement

1. Cliquez sur la ressource d'analyse des sentiments.

         Azure portal - Access Text analytics resource.png

2. Cliquez sur Clés et points de terminaison dans le menu latéral.
Les clés d'accès à votre abonnement Analyse des sentiments sont affichées.

         Azure portal - Keys Text analytics resource.png

3. Copiez l'une des clés affichée dans l'un des champs CLÉ 1 ou CLÉ 2, via Copy icon.png, et conservez-la temporairement dans votre éditeur de texte. Elle vous sera demandée pour la configuration du flux de travail MS Power Automate (étapes 2.5).

Microsoft Azure : Configuration d'un flux de travail MS Power Automate

Étape 1 : Importation d'un flux Analyse des sentiments dans Microsoft Power Automate

1. Téléchargez le fichier ci-dessous sur votre ordinateur.

       Download icon.png  Package Analyse des sentiments

2. Importez le fichier dans Microsoft Power Automate.

  • Cliquez sur Mes flux dans le menu latéral.
    La liste de vos flux MS Power Automate est affichée.
             Microsoft Flow - Flow list.png
  • Cliquez sur Importer dans la barre de menu et sélectionnez le fichier que vous avez téléchargé.
    Une fois importé, le contenu du package est affiché.
     

Étape 2 : Création d'une connexion Analyse de texte

1. Cliquez sur le lien Sélectionner pendant l’importation sous la colonne Importer la configuration.
         Microsoft Flow - Package information.png

Une fenêtre de configuration de l'import est affichée.
         Microsoft Flow - Package - Create connection 1.png

2. Créez une nouvelle connexion pour l'analyse des sentiments.

  • Cliquez sur + Créer.
  • Une instance MS Power Automate est ouverte dans un nouvel onglet de votre navigateur internet.
  • La liste des connexions existantes est affichée.
  • Cliquez sur + Nouvelle connexion.
             Microsoft Flow - Package - Create connection 2.png
  • Recherchez et sélectionnez le connecteur Analyse de texte via la zone de recherche.
             Microsoft Flow - Package - Select connection.png

3. Renseignez les informations de la nouvelle connexion.

         Microsoft Flow - Package - Information connection.png

  • Clé de compte : Copiez-collez la clé d'accès à l'API d'analyse des sentiments fournie par Azure, conservée dans votre éditeur de texte lors de la création de l'abonnement (étape 3.3).
  • URL du site : Copiez-collez l'URL d'accès à l'API Analyse de texte ci-dessous.

    https://westeurope.api.cognitive.microsoft.com/text/analytics/v2.0

4. Cliquez sur Créer.
La nouvelle connexion pour l'analyse des sentiments est créée.

5. Fermez l'onglet du navigateur internet.

  • Vous revenez sur la l'onglet affichant la liste des flux MS Power Automate.
  • La nouvelle connexion pour l'analyse des sentiments est affichée dans la liste des ressources.Microsoft Flow - Package - New connection added.png

6 Cliquez sur la connexion.
La fenêtre de configuration de l'import est affichée.
         Microsoft Flow - Package - Save connection.png

6 Cliquez sur Enregistrer.
 

Étape 3 : Configuration du flux importé

1. Cliquez sur Edit icon.png en regard du flux.
         Microsoft Flow - Edit flow.png

Le flux de travail est affiché.
         Microsoft Flow - Detail flow.png

2. Récupérez l'URL de la première étape Lors de la réception d'une demande HTTP.

  • Cliquez sur le libellé de l'étape.
    La fenêtre de propriétés de l'étape est affichée.
  • 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 pour le paramétrage dans Service Manager (étape 3.2).
             Microsoft Flow - Detail flow - When HTTP request step.png

3. Configurez l'action HTTP2 se trouvant dans l'étape Appliquer à tous.

  • Cliquez sur le libellé de l'étape Appliquer à tous.
    Le contenu de l'étape est affiché.
             Microsoft Flow - Detail flow - Apply for each step.png
  • Cliquez sur le libellé de l'action HTTP2.
    La fenêtre de propriétés de l'action est affichée.
             Microsoft Flow - Detail flow - HTTP 2 action.png
  • Renseignez le nom du serveur et le compte.
    • Cliquez sur la variable concat(…) dans le champ URI.
      Le contenu de la variable est affiché à droite de la fenêtre de propriétés.
    • Vérifiez que le nom du serveur est {your_server} et que le compte est {your_account}
    • Corrigez, si nécessaire, comme affiché en jaune ci-dessous et cliquez sur Modifier.

      concat('https://{your_server}/api/v1/{your_account}/requests/',triggerBody()?['id'])

               Microsoft Flow - Detail flow - HTTP 2 action - Account information.png
  • Renseignez les informations du compte ayant les droits d'utilisation de l'API REST dans Service Manager  - Open url.png voir Gestion des profils utilisateur
    • Cliquez sur le lien Afficher les options avancées en bas de la fenêtre de propriétés.
    • Saisissez les identifiants : nom d'utilisateur / mot de passe.
               Microsoft Flow - Detail flow - HTTP 2 action - Advanced settings.png
  • Cliquez sur Enregistrer en bas de la liste des étapes.
    Le flux de travail est configuré pour l'analyse des sentiments.

Service Manager : Création d'une ressource d'analyse des sentiments 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 d'analyse des sentiments associée à un service MS Power Automate

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

1. Créez un nouveau service MS Power Automate, via le menu Administration > REST > Services.
         Service Manager - Microsoft Flow Service.png

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

      https://prod-35.westeurope.logic.azure.com:443/workflows/?????/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=??????

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

2. Créez une nouvelle connexion au service MS Power Automate, via le menu Administration > REST > Connexions.
         Service Manager - Microsoft Flow Connection.png

  • Saisissez le nom de la connexion.
  • Méthode d'authentification : Aucune.
  • Nom du service : Sélectionnez le service MS Power Automate créé précédemment.
    L'URL du service est automatiquement affichée.
  • subdomain : Copiez-collez la valeur prod-35.westeurope de l'URL que vous avez conservée dans votre éditeur de texte.
     

4. Créez une ressource rattachée au service MS Power Automate, via le menu Administration > REST > Ressources.
         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 configuration du flux MS Power Automate (étape 3.2).
    • Conservez uniquement la partie affichée ci-dessous en jaune.

      https://prod-35.westeurope.logic.azure.com:443/workflows/?????/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=??????

  • 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.

    {"Description": "{Description}","id":"{id}"}


Étape 3 : Utilisation de la ressource d'analyse des sentiments 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.
         Service Manager - Workflow - REST action.png

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

Vérification et test

Étape 1 : Création d'un nouvel incident via Service Apps

1. Connectez vous à Service Apps.

2. Créez un incident.

Étape 2 : Exécution du flux MS Power Automate

1. Connectez-vous au site Microsoft Power Automate avec les informations d’identification de votre compte.

2. Sélectionnez le flux d'analyse des sentiments.

  • L'exécution du flux s'affiche dans l’historique.
             Microsoft Flow - Integration test.png
  • Une notification apparaît selon la note reçue en retour.

Étape 3 (optionnelle) : Visualisation de la note sur l'incident

1. Ouvez le formulaire d'incident dans Service Apps.

2. Ajoutez le champ Champ libre 6.

AccountFreeCreation

Comment créer un compte Azure gratuitement

1. Accédez au site Microsoft Azure.

2. Cliquez sur Démarrer gratuitement.

         Microsoft Flow - Free account.png

3. Connectez-vous à votre compte Microsoft professionnel.
         Microsoft Flow - Login account.png

4. Renseignez les informations d'identification.
         Microsoft Flow - Account creation - Identification 1.png

5. Cliquez sur Suivant.

6. Cochez la case d'acceptation du contrat d’abonnement.
         Microsoft Flow - Account creation - Identification 2.png

7. Cliquez sur Inscription.

EndAccountFreeCreation

Liens vers d'autres intégrations

Tags:
Modifié par Utilisateur inconnu le 2020/07/29 19:07
Créé par Administrator XWiki le 2018/07/23 15:15

Raccourcis

L'actualité mensuelle
•  Newsletter

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

Powered by XWiki ©, EasyVista 2021