Créer un déclencheur externe enregistré

Enregistrez un ensemble de définitions de déclencheur en tant que déclencheur réutilisable qui répond à un événement externe via des webhooks. Lorsqu’un événement se produit dans l’application tierce configurée qui répond aux conditions spécifiées, le déclencheur est activé.

Pourquoi et quand exécuter cette tâche

Créez un déclencheur enregistré qui répond aux événements se produisant dans un spoke tiers pris en charge qui est déjà configuré dans Studio de workflow. Le spoke tiers envoie la charge utile de l’événement à Studio de workflow chaque fois qu’un événement se produit. Dans la définition du déclencheur, spécifiez la charge utile de l’événement au format JSON et les conditions de démarrage du déclencheur. Obtenez le JSON de la charge utile de l’événement à partir du spoke tiers que vous configurez.

Avant de commencer

Rôle requis : trigger_designer, flow_designer ou admin

Abonnement requis : cette étape nécessite un abonnement au Centre d’intégration.

Modules d’extension requis : Installez les modules d’extension du Centre d’intégration suivants :

• Déclencheur externe du Centre d’intégration ServiceNow [com.glide.ih.external_trigger] : pour utiliser des déclencheurs externes prêts à l’emploi.

• Générateur de déclencheur externe [sn_ext_trg_bldr] : pour créer un déclencheur externe enregistré.

Remarque :

Pour plus d’informations sur ce qui est inclus dans les différents abonnements au Centre d’intégration, consultez Calendriers juridiques - Vue d’ensemble du Centre d’intégration

Assurez-vous d’avoir configuré les points de terminaison de déclencheur externes pour le spoke de l’application tierce. Les spokes pris en charge sont les suivants :

• Spoke Jira
• Spoke GitHub
• Docusign eSignature Spoke

Pour en savoir plus sur la configuration du spoke tiers, reportez-vous à la section Set up external trigger endpoints.

Important :

Gardez à portée de main le JSON de la charge utile de l’événement de l’application tierce. Consultez la documentation sur le webhook tiers pour savoir où vous pouvez copier le JSON de la charge utile. Par exemple, consultez le lien suivant qui affiche différentes formes de charge utile pour les événements Jira : Exécution d’un webhook.

Procédure

1. Accédez à Tous > Automatisation des processus > Studio de workflow.
2. Sur la page d’accueil de Studio de workflow, sélectionnez Nouveau > Déclencheur.
3. Remplissez les champs du formulaire.

   Tableau 1. Nouveau formulaire de déclencheur

   Champ	Description
   Nom du déclencheur	Nom permettant d’identifier le déclencheur.
   Type de déclencheur	Type du déclencheur pour démarrer votre flux. Sous Externe, sélectionnez Événement (Webhook).
   Description	Description du déclencheur.
   Application	Périmètre de l’application dans lequel créer le déclencheur. Studio de workflow Affiche les spokes configurés qui sont pris en charge.

4. Sélectionnez Afficher des propriétés supplémentaires et renseignez les champs.

   Tableau 2. Formulaire Additional properties (Propriétés supplémentaires)

   Champ	Description
   Accessible depuis	Les données de déclenchement sont accessibles à partir de tous les périmètres de l’application.
   Catégorie	Catégorie dans laquelle votre déclencheur s’affiche.
   Annotation de déclencheur	Annotation pour votre déclencheur que l’utilisateur peut voir avant de sélectionner le déclencheur.

5. Sélectionnez Générer un déclencheur.
   Studio de workflow affiche la page Définition du déclencheur. Dans la zone d’aperçu de la source d’événement, vous pouvez afficher des informations sur la façon dont le point de terminaison de déclenchement externe est configuré.
6. Sous Analyseur, renseignez les champs.

   Tableau 3. Formulaire de l’analyseur

   Champ	Description
   Nom de la sortie de déclencheur	Étiquette permettant d’identifier la sortie du déclencheur.
   En-têtes de demandes	Champ facultatif permettant de spécifier un ou plusieurs en-têtes à inclure dans la demande entrante.
   Paramètres de requête	Champ facultatif permettant de spécifier un ou plusieurs paramètres à inclure dans la demande entrante.

7. Sous Corps, dans l’éditeur JSON, collez le JSON de la charge utile à partir de l’application tierce.
   Consultez la documentation sur le webhook tiers pour savoir où vous pouvez copier le JSON de la charge utile.
8. Sélectionnez Visualiser des objets.
   L’éditeur affiche les objets qui se trouvent dans le JSON de la charge utile. Vous pouvez réorganiser ou supprimer les objets. Les objets sont disponibles en tant que pastilles de données à utiliser dans les conditions.
9. Dans l’éditeur de conditions, glissez-déplacez les pastilles de données pour créer un ensemble de conditions.
   Utilisez les opérateurs [ou] ou [et] pour ajouter d’autres conditions à l’ensemble de conditions.
10. Sélectionnez +Nouvel ensemble de conditions pour ajouter des ensembles de conditions supplémentaires selon vos besoins.
11. Sélectionnez Publier pour rendre le déclencheur disponible à d’autres utilisateurs.
    Remarque :

    Vous ne pouvez pas modifier un déclencheur externe enregistré après sa publication.