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 par le biais de 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 concentrateur d’intégration suivants :

• Déclencheur externe du concentrateur d’intégration ServiceNow [com.glide.ih.external_trigger] : permet d’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, voir Calendriers juridiques - Vue d’ensemble du centre d’intégration

Vous créez les sources d’événement requises dans le générateur de sources d’événements ou vous pouvez utiliser les sources d’événements existantes de ces spokes.

• Spoke Jira
• Spoke GitHub
• Docusign eSignature Spoke
• Spoke Microsoft Azure DevOps Boards

Pour plus d’informations sur la création d’une source d’événement, reportez-vous à la section Créer une source d’événement externe.

Important :

Gardez à portée de main le JSON de la charge utile de l’événement de l’application tierce. Consultez la documentation sur les webhooks 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 à la Tous > Automatisation des processus > Studio de workflow.
2. Sur la page d’accueil du 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 pour créer le déclencheur. Studio de workflow Affiche les spokes configurés qui sont pris en charge.
   Source de l'événement	Système tiers qui enverra les événements à ServiceNow.
   Domaine	Champ d’application de domaine du flux. Pour plus d’informations sur la séparation en domaines, reportez-vous à la section Domain separation explained.

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

   Tableau 2. Formulaire 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 Créer 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 configuration du point de terminaison du déclencheur externe. Les configurations que vous effectuez sur le déclencheur sont enregistrées automatiquement.
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 les webhooks 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, faites glisser et 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 :

    Une fois le déclencheur publié, vous pouvez modifier uniquement les champs Étiquette de sortie.