Intégration Zapier


À 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

Zapier est un middleware qui permet d’intégrer et de connecter simplement plus de 750 applications web entre elles pour faciliter la vie des utilisateurs (particuliers, PME ou Grands comptes) et des intégrateurs d’applications, en évitant notamment d’écrire du code, de réaliser des interfaces logicielles et d’avoir à étudier les API des applications web supportées.

Cet outil utilise une mécanique basée sur des workflows prédéfinis.

  • Une intégration entre 2 applications s’appelle un zap et peut être configurée en quelques minutes. 
  • Un zap est constitué d’un événement déclencheur (trigger) principal et d’une ou plusieurs actions ou recherches en définissant d’autres événements déclencheurs.
     

exemple  Quand je reçois un e-mail dans ma boîte Gmail, il faut :

  • copier le fichier joint sur mon compte Dropbox ;
  • m’alerter dans Slack qu’un nouveau fichier est disponible sur mon compte Dropbox ;
  • m’envoyer un SMS.

 

2 intégrations vous sont proposées entre Service Manager et des services tiers supportés, en utilisant Zapier.

  • Effectuer des actions dans un service tiers depuis un workflow / règle métier Service Manager  - Open url.png voir Processus d'intégration n° 1

    exemple

    • Création d’un incident dans Service Manager via un workflow standard de gestion des incidents ou une règle métier  ==>  Création d’un nouvel incident dans JIRA Software
    • Validation d’un changement sur le logiciel SAP, dans une étape d’un workflow Service Manager de gestion des changements  ==>  Création d’une nouvelle carte dans Trello, ayant pour nom le numéro de la demande de changement
  • Effectuer des actions dans Service Manager depuis un service tiers  - Open url.png voir Processus d'intégration n° 2

    exemple  Création d’une carte dans Trello pour la proposition d'une nouvelle formation dans le catalogue RH  ==>  Création d’une nouvelle demande de changement Analyse nouvelle formation dans Service Manager, avec description de la carte Trello

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

Service Manager

Up and Down arrow.png

Logo - Zapier.png

Selon le service tiers utilisé

(authentification prise en charge par Zapier)

EV Integration connector icon - Workflow.png    Workflow

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

Webhooks icon.png    Webhooks (by Zapier)

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

Processus d'intégration pas à pas

         Open url.png voir Documentation de Zapier

Prérequis

  • Vous devez disposer d'au moins un compte Zapier. Sinon, utilisez le formulaire de création de compte Zapier (EN).
  • Vous devez être logué au compte Zapier de votre choix avec lequel vous souhaitez réaliser un zap et une nouvelle intégration avec Service Manager.

Processus d'intégration n° 1 : Service Manager vers un service tiers

exemple

  • Création d'un zap : Intégration entre Service Manager et Trello
  • Événement déclencheur principal dans Service Manager : Validation d’un changement dans une étape de workflow
  • Action réalisée dans Trello : Création d’une nouvelle carte décrivant le changement demandé

Étape 1 : Dans Zapier, initialisation du zap

1. Cliquez sur Make a Zap.

2. Nommez le nouveau zap.

exemple  EVSM_CHANGE WKFW (NORMAL) : Créer carte Trello

 

Étape 2 : Dans Zapier, configuration de l'événement déclencheur de Service Manager

2.1 : Dans Zapier, initialisation de la configuration

1. Configurez l'événement déclencheur (trigger) en suivant les étapes du panneau Trigger / 1. Set up this step.
         Trigger - 1 Set up this step.png

  • Nommez l'événement déclencheur via Edit icon.png Rename Step.

    exemple  Validation Nouveau changement EVSM

     
  • Étape Choose App :
    • Soit cliquez sur l'icône Webhooks Webhooks icon.png dans la fenêtre de droite (catégorie Built-in apps).
    • Soit saisissez le nom Webhooks dans la barre de recherche puis cliquez sur Webhooks icon.png.
  • Étape Choose Trigger :
    • Sélectionnez l'option Catch Hook.
    • Cliquez sur Save + Continue.

2. Conservez l'URL du webhook pour configurer l'action REST Zapier dans Service Manager.

  • Cliquez sur Continue.
  • Copiez l’URL fournie par Zapier.

    exemple  https://hooks.zapier.com/hooks/catch/799810/mtmjbz/

             Zapier - Webhook copy.png

3. Finalisez la configuration de l'événement déclencheur en réalisant successivement les étapes ci-dessous 2.2 et 2.3.
 

2.2 : Dans Service Manager, création d’une action REST Zapier

Note : L'action REST Zapier utilise le webhook créé précédemment dans Zapier (étape 2.1).

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

2. Créez une connexion au service Zapier.
         Create new connection.png

  • Nom de la connexion : Zapier vers le service tiers.
  • Méthode d'authentification : Aucune.
  • Nom du service : Service Zapier.
    L'URL du service Zapier est automatiquement affichée.
  • Paramètre {id} : Copiez-collez la valeur après catch de l'URL fournie par Zapier, conservée dans votre éditeur de texte lors de l'initialisation de l'événement déclencheur (étape 2.1).

    exemple  Conservez uniquement la partie affichée ci-dessous en jaune.

    https://hooks.zapier.com/hooks/catch/799810/mtmjbz/

3. Créez une ressource rattachée au service Zapier, permettant la création d'une action dans le service tiers.
         Create new resource.png

  • Label : Nom de la ressource.
  • Nom du service : Service Zapier.
  • Nom de la connexion : Zapier vers le service tiers.
  • Uri de la ressource : Identifiant de la nouvelle ressource. Copiez-collez la valeur à la fin de l'URL fournie par Zapier, conservée dans votre éditeur de texte lors de l'initialisation de l'événement déclencheur (étape 2.1).

    exemple  Conservez uniquement la partie affichée ci-dessous en jaune.

    https://hooks.zapier.com/hooks/catch/799810/mtmjbz

4. Insérez la nouvelle ressource rattachée au service Zapier dans une étape REST d'un processus.

  • 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
  • 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.
  • Renseignez les propriétés de la nouvelle étape en double-cliquant dessus.
             Create new process step.png
     

2.3 : Dans Zapier, finalisation de la configuration de l'événement déclencheur de Service Manager

Note : Le webhook Zapier doit avoir été utilisé au moins une fois dans un processus Service Manager.

1. Dans Service Manager, exécutez le processus créé à l'étape 2.2.
Le webhook Zapier est initialisé via l'exécution de l'action REST Zapier.

2. Dans Zapier, cliquez sur OK, I did this (étape Test this Step).
L'événement déclencheur de Service Manager est configuré dans Zapier.
         Zapier - Activate zap.png

 

Étape 3 : Dans Zapier, configuration de l'action à réaliser dans le service tiers

1. Configurez l'action à réaliser dans le service tiers, en suivant les étapes du panneau Action / 2. Set up this step.
         Action - 1 Set up this step.png
 

  • Nommez l'action à réaliser via Edit icon.png Rename Step.

    exemple  Création carte Trello (Changement Normal)

  • Étape Choose App : Cliquez sur l’icône du service tiers avec lequel l'action est à réaliser.

    exemple  Trello icon.png Trello

  • Étape Choose Action :
    • Sélectionnez l’action à réaliser.

      exemple  action Create Card

    • Cliquez sur Save + Continue.
  • Étape Choose Account :
    • Sélectionnez un compte existant ou connectez-vous à un nouveau compte.
    • Cliquez sur Save + Continue.
       
  • Étape Set Up Template : Configurez les options selon vos besoins.

    Note : Pour utiliser des valeurs de champs Service Manager (ex. : rfc_number, description) et les affecter dans le service tiers, vous devez utiliser le webhook Zapier au moins une fois. Pour cela, exécutez l’action REST Zapier via un processus Service Manager.

    exemple  Example Trello - Process1 - Set Up Template.png

2. Testez la configuration de l'action (étape Test this Step) via Create + Continue.
Le message Test Successful! s’affiche en cas de succès.

Note : Vous pouvez ajouter une action de type Send Email (via Gmail) pour envoyer un e-mail au compte de votre choix.

 

Étape 4 : Dans Zapier, activation du zap

1. Cliquez sur Finish.

2. Activez le nouveau zap via Your Zap is on.

Processus d'intégration n° 2 : Un service tiers vers Service Manager

exemple

  • Création d'un zap : Intégration entre Trello et Service Manager
  • Événement déclencheur principal dans Trello : Création d’une nouvelle carte
  • Action réalisée dans Service Manager : Création d'une demande de service

Étape 1 : Dans Zapier, initialisation du zap

1. Cliquez sur Make a Zap.

2. Nommez le nouveau zap.

exemple  EVSM - Créer demande de service depuis création carte Trello

 

Étape 2 : Dans Zapier, configuration de l'événement déclencheur dans le service tiers

1. Configurez l'événement déclencheur (trigger) en suivant les étapes du panneau Trigger / 1. Set up this step.
         Trigger - 1 Set up this step.png
 

  • Nommez l'événement déclencheur via Edit icon.png Rename Step.

    exemple  Nouvelle carte Trello

  • Étape Choose App : Cliquez sur l’icône du service tiers déclenchant l'événement.

    exemple  Trello icon.png Trello

  • Étape Choose Trigger :
    • Sélectionnez l'événement déclencheur dans le produit tiers.

      exemple  action New Card

    • Cliquez sur Save + Continue.
  • Étape Choose Account :
    • Sélectionnez un compte existant ou connectez-vous à un nouveau compte.
    • Cliquez sur Save + Continue.
  • Étape Set Up Options : Configurez les options selon vos besoins.

    exemple  Example Trello - Process2 - Set Up Options.png

     

Étape 3 : Dans Zapier, configuration de l'action à réaliser dans Service Manager

1. Configurez l'action à réaliser dans Service Manager, en suivant les étapes du panneau Action / 2. Set up this step.
         Action - 1 Set up this step.png

  • Nommez l'action à réaliser via Edit icon.png Rename Step.

    exemple  Créer demande de service EVSM

  • Étape Choose App :
    • Soit cliquez sur l’icône Webhooks Webhooks icon.png dans la fenêtre de droite (catégorie Built-in apps)
    • Soit saisissez le nom Webhooks dans la barre de recherche puis cliquez sur Webhooks icon.png.
  • Étape Choose Action :
    • Sélectionnez l'option Custom Request.
    • Cliquez sur Save + Continue.
  • Étape Set Up Template :
    • Configurez les options permettant de réaliser l'action dans Service Manager selon vos besoins.
    • Cliquez sur Save + Continue.

exemple  Créer une demande de service dans Service Manager (avec le code catalogue correspondant)

  • Option Data : Corps de requête au format JSON (pour l’appel à l’API REST Service Manager). Note : Dans l’exemple, l’objet urgency_id n’est pas obligatoire. Par défaut, c’est le niveau d’urgence renseigné dans le catalogue qui est appliqué.
  • Option Unflatten : Valeur no.
  • Option Basic Auth : Utilisez un compte de la plate-forme Service Manager autorisé à effectuer des requêtes REST (paramètre REST API coché dans son profil).
  • Option Headers : Couple de valeurs content-type et application/json.

         Example Service Manager - Process2 - Set Up Template 1.png
         Example Service Manager - Process2 - Set Up Template 2.png

2. Testez la configuration de l'action (étape Test this Step) via Create + Continue.
Le message Test Successful! s’affiche en cas de succès.

Note : Vous pouvez ajouter une action de type Send Email (via Gmail) pour envoyer un e-mail au compte de votre choix.

 

Étape 4 : Dans Zapier, activation du zap

1. Cliquez sur Finish.

2. Activez le nouveau zap via Your Zap is on.

Exemples d'intégration avec des services tiers

JIRA Software

Système de suivi de bugs.

Trello

Outil de gestion de projet en mode SaaS.

Tags:
Modifié par Utilisateur inconnu le 2020/06/19 12:46
Créé par Administrator XWiki le 2017/04/07 10:29

Raccourcis

L'actualité mensuelle
•  Newsletter

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

Glossaire

Powered by XWiki ©, EasyVista 2020