Abonnez-vous à la demande de mises à jour d'entrée

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 2 minutes de lecture

    • Envoyer le résultat de chaque demande d'entrée Contrôle de santé des employés à un système tiers en configurant un webhook.

    Avant de commencer

    L'envoi d'appels webhook sortants nécessite les modules d'extension suivants.
    • ServiceNow Hub d'intégration Runtime (com.glide.hub.integration.runtime)
    • Studio de workflow Action Step - Payload Builder (com.glide.hub.action_step.payload)
    • ServiceNow Hub d'intégration Action Step - REST (com.glide.hub.action_step.rest)
    Ces modules d'extension doivent faire l'objet d'une demande via le Now Support Catalogue de services. Pour obtenir des instructions, consultez Demander un module d’extension.
    Lorsque vous configurez le webhook, le système envoie automatiquement une demande REST à un point de terminaison tiers chaque fois qu'un employé ou un visiteur demande à entrer. Travaillez avec un administrateur pour que le système tiers détermine le point de terminaison correct à fournir.
    Remarque :
    Le webhook n'inclut pas d'en-têtes d'authentification dans la demande. Assurez-vous de fournir un point de terminaison qui inclut des paramètres de requête pour authentifier la demande.

    Pour en savoir plus sur le module de demande d'entrée Contrôle de santé des employés, voir Effectuer un examen de santé pour l’entrée.

    Rôle requis : sn_imt_core.admin ou admin

    Procédure

    1. Accédez à la Tout > État de santé et de sécurité des employés > Webhooks sortants.
    2. Dans la table webhook [sn_imt_core_webhook], cliquez sur Nouveau.
    3. Renseignez les champs du formulaire.
      Tableau 1. Formulaire webhook
      Champ Description
      Nom Identificateur interne pour le point de terminaison tiers.
      Événement Événement auquel vous souhaitez vous abonner. Les options incluent :
      • Entrée demandée par l'employé : envoie une mise à jour chaque fois qu'un employé demande une entrée.
      • Entrée demandée par le visiteur : envoie une mise à jour chaque fois qu'un visiteur demande une entrée.
      Point de terminaison Point de terminaison auquel envoyer les données de demande d'entrée Contrôle de santé des employés.
      Remarque :
      Le webhook n'inclut pas d'en-têtes d'authentification dans la demande. Assurez-vous de fournir un point de terminaison qui inclut des paramètres de requête pour authentifier la demande.
      Paramètres sécurisés Paramètres de requête pour le point de terminaison qui doit être traité en toute sécurité, tel qu'un jeton d'autorisation. Fournissez des paramètres au format ?param1=value&param2=othervalue.
      Conseil :
      Si le système tiers vers lequel vous envoyez des données ne fournit pas de jeton d'autorisation généré de façon sécurisée, vous pouvez générer un jeton dans votre instance ServiceNow avec le script suivant. 
      var secureRandom = GlideSecureRandomUtil;
var secret = secureRandom.getSecureRandomString(30);
gs.log(secret);
      Actifs Option permettant de définir l'enregistrement sur actif.
    4. Cliquez sur Envoyer.

    Résultats

    L'application Contrôle de santé des employés envoie des données de demande d'entrée au point de terminaison tiers chaque fois qu'un employé demande une entrée. La charge utile JSON contient les données suivantes. 
    {
  "event": "entry.requested",
  "email": "aileen.mottern@example.com",
  "username": "aileen.mottern",
  "user_id": "a8f98bb0eb32010045e1a5115206fe3a",
  "location": "San Antonio",
  "location_id": "108486c7c611227500b093211aa88dcc",
  "access_granted": false,
  "updated": "2020-07-01 22:19:03"
}
    Propriété Description
    event Type d'événement défini dans la table webhook.

    Type de données : chaîne
    E-mail Adresse e-mail de l'employé.

    Type de données : chaîne
    username Nom d'utilisateur de l'employé issu de la table Utilisateurs Health and Safety [sn_imt_core_health_and_safety_user].

    Type de données : chaîne
    user_id Sys_id de l'enregistrement de l'utilisateur issu de la table Utilisateurs Health and Safety [sn_imt_core_health_and_safety_user].

    Type de données : chaîne
    emplacement Emplacement du dépistage de santé.

    Type de données : chaîne
    location_id Sys_id de l'enregistrement de l'emplacement à partir de la table Emplacement [cmn_location].

    Type de données : chaîne
    access_granted Marqueur qui indique si l'employé a été autorisé à entrer à la suite du dépistage de santé. Valeurs valides :
    • true : l'employé a passé le dépistage de santé et a obtenu l'accès.
    • false : l'employé n'a pas passé le dépistage de santé et n'a pas obtenu l'accès.

    Type de données : booléennes
    mises à jour Date et heure auxquelles l'employé ou le visiteur a demandé d'entrer.

    Type de données : Date/Heure