Consultez les connecteurs compatibles avec Application Integration.

Déclencheur ServiceNow

Le déclencheur ServiceNow est un déclencheur d'événement de connecteur qui vous permet d'appeler une intégration en fonction des événements ServiceNow personnalisés que vous avez définis dans la règle métier de votre instance ServiceNow.

Important:Integration Connectors est un composant facturable de Google Cloud. Pour en savoir plus sur les coûts et les frais d'utilisation des connecteurs d'intégration, consultez la page Tarifs Integration Connectors.

Avant de commencer

Si vous envisagez de créer ou de configurer une connexion pour le déclencheur ServiceNow, assurez-vous de disposer du rôle IAM suivant sur le projet:

• Administrateur des connecteurs (roles/connectors.admin)

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès.

Attribuez les rôles IAM suivants au compte de service que vous souhaitez utiliser pour le déclencheur ServiceNow :

• Demandeur Application Integration (roles/integrations.integrationInvoker)

Pour en savoir plus sur l'attribution d'un rôle à un compte de service, consultez la page Gérer l'accès aux comptes de service.

Ajouter le déclencheur ServiceNow

Pour ajouter un déclencheur ServiceNow à votre intégration, procédez comme suit:

1. Dans la console Google Cloud, accédez à la page Application Integration.

   Accéder à Application Integration

2. Dans le menu de navigation, cliquez sur Intégrations.

   La page Liste des intégrations s'affiche et liste toutes les intégrations disponibles dans le projet Google Cloud.

3. Sélectionnez une intégration existante ou cliquez sur Créer une intégration pour en créer une.

   Si vous créez une intégration :

   1. Saisissez un nom et une description dans le volet Create Integration (Créer une intégration).
   2. Sélectionnez une région pour l'intégration.
      Remarque : Le menu déroulant Régions ne répertorie que les régions provisionnées dans votre projet Google Cloud. Pour provisionner une nouvelle région, cliquez sur Activer la région. Pour en savoir plus, consultez la section Activer une nouvelle région.
   3. Sélectionnez un compte de service pour l'intégration. Vous pouvez modifier ou mettre à jour les informations du compte de service d'une intégration à tout moment dans le volet Récapitulatif de l'intégration de la barre d'outils d'intégration.
      Remarque : L'option permettant de sélectionner un compte de service ne s'affiche que si vous avez activé la gouvernance de l'intégration pour la région sélectionnée.
   4. Cliquez sur Créer.

   Cela entraîne son ouverture dans l'éditeur d'intégrations.

4. Dans la barre de navigation de l'éditeur d'intégration, cliquez sur Déclencheurs pour afficher la liste des déclencheurs disponibles.
5. Cliquez sur l'élément Déclencheur ServiceNow et placez-le dans l'éditeur d'intégrations.

Pour configurer le déclencheur ServiceNow, vous pouvez soit utiliser une connexion ServiceNow existante disponible dans Integration Connectors, soit créer une connexion ServiceNow à l'aide de l'option de création de connexion intégrée.

Configurer un déclencheur ServiceNow à l'aide d'une connexion existante

Vous pouvez configurer le déclencheur ServiceNow à l'aide d'une connexion ServiceNow existante dans Integration Connectors. Notez que le déclencheur ServiceNow est un déclencheur d'événement de connecteur. Par conséquent, vous ne pouvez utiliser qu'une connexion ServiceNow avec l'abonnement aux événements activé pour configurer le déclencheur.

Pour savoir comment configurer un déclencheur ServiceNow à l'aide d'une nouvelle connexion ServiceNow, consultez Configurer un déclencheur ServiceNow à l'aide d'une nouvelle connexion.

Pour configurer un déclencheur ServiceNow à l'aide d'une connexion ServiceNow existante, procédez comme suit :

1. Cliquez sur l'élément Déclencheur ServiceNow dans l'éditeur d'intégration pour ouvrir le volet de configuration du déclencheur.
2. Cliquez sur Configurer un déclencheur.
3. Fournissez les informations de configuration suivantes sur la page Éditeur de déclencheurs d'événements de connecteur:
   1. Région : sélectionnez la région de votre connexion ServiceNow.
   2. Connexion:sélectionnez la connexion ServiceNow que vous souhaitez utiliser.

      Application Integration n'affiche que les connexions ServiceNow actives et pour lesquelles un abonnement aux événements est activé.

   3. Type d'abonnement aux événements : saisissez le type d'événement que vous souhaitez utiliser pour déclencher l'intégration. Ces types d'événements doivent être définis dans la règle d'entreprise de votre instance ServiceNow.
   4. Compte de service : sélectionnez un compte de service disposant des rôles IAM requis pour le déclencheur ServiceNow.
4. Cliquez sur OK pour terminer la configuration du déclencheur et fermer la page.

Configurer un déclencheur ServiceNow à l'aide d'une nouvelle connexion

Pour configurer le déclencheur ServiceNow à l'aide d'une nouvelle connexion ServiceNow, procédez comme suit :

1. Cliquez sur l'élément Déclencheur ServiceNow dans l'éditeur d'intégrations pour ouvrir le volet de configuration du déclencheur.
2. Cliquez sur Configurer un déclencheur.
3. Ignorez le champ Région.
4. Cliquez sur Connexion, puis sélectionnez l'option Créer une connexion dans le menu déroulant.
5. Procédez comme suit dans le volet Créer une connexion:
   1. À l'étape Emplacement, choisissez l'emplacement de la nouvelle connexion ServiceNow:
      1. Région:sélectionnez une région dans la liste déroulante.
      2. Cliquez sur Suivant.
   2. À l'étape Détails de la connexion, fournissez les détails de la nouvelle connexion ServiceNow:
      1. Version du connecteur:choisissez une version disponible du connecteur ServiceNow dans la liste déroulante.
      2. Connection Name (Nom de la connexion) : saisissez un nom pour la connexion ServiceNow.
         Remarque : Les noms de connexion doivent répondre aux critères suivants.

         • Les noms de connexion peuvent contenir des lettres, des chiffres ou des traits d'union.
         • Les lettres doivent être en minuscules.
         • Les noms de connexion doivent commencer par une lettre et se terminer par une lettre ou un chiffre.
         • Les noms de connexion ne peuvent pas dépasser 63 caractères.
      3. (Facultatif) Description : saisissez une description de la connexion.
      4. (Facultatif) Activer Cloud Logging:cochez cette case pour stocker toutes les données de journal de la connexion.
      5. Compte de service: sélectionnez un compte de service disposant des rôles IAM requis pour la connexion ServiceNow.
      6. Activer l'abonnement aux événements:sélectionnez cette option pour créer et activer un abonnement à un événement pour la connexion ServiceNow. Vous pouvez uniquement activer les abonnements aux événements ou inclure également des entités, des opérations et des actions de connexion.
         Remarque : Les étapes de configuration de la connexion supplémentaires suivantes sont requises si vous choisissez d'activer les entités, les opérations et les actions pour la connexion :

         • Destinations
         • Authentification
      7. Inclure les tableaux système:sélectionnez cette option pour inclure des tableaux système dans la connexion ou pour générer un rapport.
      8. (Facultatif) Filtrer les tableaux:saisissez la liste des tables système que vous souhaitez inclure (en commençant par "sys_", séparées par une virgule).
      9. (Facultatif) Développez la section Paramètres avancés pour configurer les paramètres du nœud de connexion.

         Pour en savoir plus sur les paramètres du nœud de connexion pour ServiceNow, consultez la documentation sur la connexion à ServiceNow.

      10. (Facultatif) Cliquez sur + Ajouter un libellé pour ajouter un libellé à la connexion sous la forme d'une paire clé-valeur.
      11. Cliquez sur Suivant.
   3. À l'étape Destinations, fournissez les détails de l'instance ServiceNow :
      1. Type de destination : sélectionnez Adresse hôte.
      2. Host (Hôte) : saisissez le nom d'hôte ou l'adresse IP de votre instance ServiceNow.
      3. Cliquez sur Suivant.
   4. À l'étape Authentification, indiquez les informations d'authentification pour l'instance ServiceNow:
      1. Nom d'utilisateur:saisissez le nom d'utilisateur pour accéder à l'adresse de destination fournie.
      2. Mot de passe:sélectionnez le secret Secret Manager contenant le mot de passe associé au nom d'utilisateur ServiceNow.
      3. Version du secret : sélectionnez une version de secret.

      Pour en savoir plus sur la configuration de l'authentification, consultez Configurer l'authentification.

      4. Cliquez sur Suivant.
   5. À l'étape Event subscription details (Détails de l'abonnement à l'événement), fournissez les informations d'authentification qui seront utilisées pour valider la charge utile du jeton ServiceNow:
      1. Jeton d'authentification : (facultatif) sélectionnez le secret Secret Manager de votre jeton d'authentification, ainsi que la version du secret correspondante dans la liste déroulante Version du secret.
      2. Algorithme HMAC : (facultatif) sélectionnez l'algorithme HMAC pour chiffrer la charge utile de la réponse.
      3. Clé secrète HMAC:si vous avez sélectionné un algorithme HMAC, sélectionnez le secret Secret Manager de la clé HMAC, ainsi que la version du secret correspondante dans le menu déroulant Version du secret.
      4. Cliquez sur Suivant.
   6. Vérifiez les informations de connexion ServiceNow fournies.
   7. Cliquez sur Créer pour terminer de créer une connexion ServiceNow.
6. Une fois la connexion ServiceNow créée, vous devez accéder à votre instance ServiceNow et créer manuellement une règle d'entreprise.
   Remarque : ServiceNow ne crée pas automatiquement de règle métier. Vous devez donc créer manuellement une règle métier dans votre instance ServiceNow pour activer les abonnements aux événements. Pour savoir comment créer une règle d'entreprise, consultez l'article Créer une règle d'entreprise.
7. Event subscription type (Type d'abonnement aux événements) : saisissez le type d'événement que vous souhaitez utiliser pour déclencher l'intégration. Ces types d'événements doivent être définis dans la règle d'entreprise de votre instance ServiceNow.
8. Cliquez sur OK, puis fermez la page.

Créer une règle d'entreprise

Une règle métier ServiceNow est une logique côté serveur qui s'exécute lorsqu'un enregistrement de base de données est interrogé, mis à jour, inséré ou supprimé dans votre instance ServiceNow. Application Integration utilise ces règles métier pour identifier et écouter les événements qui déclenchent une intégration.

Pour savoir comment créer une règle métier, consultez la documentation ServiceNow.

Points clés :

• Utilisez la valeur Point de terminaison de l'écouteur d'événements de votre connexion ServiceNow dans les connecteurs d'intégration pour définir l'URL request.setEndpoint dans votre règle métier.
• Utilisez eventType comme clé pour définir les valeurs des types d'événements personnalisés dans request.setRequestBody.

L'image suivante présente un exemple de règle commerciale ServiceNow avec le type d'événement update_ticket:

Sortie du déclencheur

Le déclencheur ServiceNow prend quelques minutes pour terminer la configuration de l'abonnement à l'événement. Vous pouvez consulter l'état de votre abonnement à l'événement dans le volet de configuration du déclencheur, sous Détails de l'abonnement aux événements.

Le déclencheur ServiceNow indique l'état d'un abonnement à un événement. Il présente les états suivants:

• Creating: indique que le déclencheur s'abonne à l'abonnement à l'événement.
• Active: indique que le déclencheur a bien été abonné à un abonnement à un événement.
• Error: indique un problème avec l'abonnement à l'événement configuré.

En plus de l'état de l'abonnement à l'événement, la section Détails de l'abonnement aux événements affiche également d'autres informations telles que la région et le nom de la connexion, ainsi que le nom de l'abonnement à l'événement.

L'image suivante présente un exemple de mise en page du volet de configuration du déclencheur ServiceNow :

Variable de sortie du déclencheur

Pour chaque événement, le déclencheur ServiceNow génère une variable de sortie ConnectorEventPayload que vous pouvez utiliser dans vos tâches en aval. La variable de sortie est au format JSON et contient le schéma de charge utile ServiceNow de sortie.

Afficher les abonnements à des événements

Pour afficher et gérer tous les abonnements aux événements associés à une connexion dans Integration Connectors, procédez comme suit:

1. Accédez à la page Integration Connectors > Connections (Connecteurs d'intégration > Connexions).

   Accéder à la page "Connexions"

2. Cliquez sur la connexion pour laquelle vous souhaitez afficher les abonnements.
3. Cliquez sur l'onglet Abonnements aux événements.

   Tous les abonnements aux événements de la connexion s'affichent.

Modifier le déclencheur ServiceNow

Vous pouvez modifier un déclencheur ServiceNow pour modifier ou mettre à jour la configuration de la connexion et les détails de l'abonnement à l'événement.

Important:Lorsque vous modifiez un déclencheur ServiceNow, vous pouvez soit conserver l'abonnement d'événement précédemment configuré qui lui est associé, soit le supprimer. La suppression d'un abonnement à des événements affectera toutes les intégrations publiées qui l'utilisent.

Pour modifier un déclencheur ServiceNow, procédez comme suit:

1. Cliquez sur l'élément Déclencheur ServiceNow dans l'éditeur d'intégration pour ouvrir le volet de configuration du déclencheur.
2. Cliquez sur Configurer un déclencheur ServiceNow.
3. Procédez comme suit sur la page Éditeur de déclencheurs d'événements de connecteur:
   1. Pour conserver l'abonnement aux événements précédemment configuré, cliquez sur Conserver. Sinon, cliquez sur Supprimer.
      Avertissement : La suppression d'un abonnement à des événements affectera toutes les intégrations publiées qui l'utilisent. Cette opération est irréversible.
   2. Mettez à jour les détails de la configuration de la connexion et de l'abonnement aux événements selon vos besoins.
   3. Cliquez sur OK.

Vous pouvez afficher les détails mis à jour de la connexion et de l'abonnement aux événements dans le volet de configuration du déclencheur, sous Détails de l'abonnement aux événements.

Quotas et limites

Pour plus d'informations sur les quotas et les limites, consultez la section Quotas et limites.

Étape suivante

• Découvrez toutes les tâches et tous les déclencheurs.
• Découvrez comment tester et publier une intégration.
• En savoir plus sur la gestion des erreurs
• Découvrez les journaux d'exécution d'intégration.