Utilisation du cadre de travail du créateur pour les notifications sortantes

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 3 minutes de lecture

    • Le cadre de travail du créateur sélectionne l’événement à partir de l’instance ServiceNow et envoie la notification sortante au système externe. Vous pouvez utiliser les détails de la notification à partir du service de messagerie installé sur votre système externe.

    Propriétés système

    Vous devez configurer les propriétés système pour utiliser le cadre de travail du créateur pour la notification sortante. La table suivante explique la liste des propriétés système définies pour les travaux planifiés.

    Tableau 1. Propriétés système du cadre de travail du producteur
    Propriété Description Type
    sn_api_notif_mgmt.event.log
    Niveau de journalisation à écrire dans les journaux de débogage. Vous pouvez sélectionner les niveaux de journalisation suivants :
    • emerg : échec total.
    • alert : Corruption du système d’une base de données, par exemple.
    • crit : généralement utilisé pour les erreurs matérielles, par exemple.
    • err : Toute erreur.
    • avertissement : tout avertissement
    • avis : Action requise possible mais pas essentielle.
    • Informations : aucune action n’est requise.
    • debug : généralement non utilisé, sauf pour capturer tout ce qui est nécessaire pour le diagnostic de pannes.

    Valeur par défaut : err

    		 Chaîne
    sn_api_notif_mgmt.publisher_message_bus_configuration Définit si les messages sont publiés à l’aide du service de messagerie Hermes, du bus de messages ouverts ou des deux bus de messages. Vous pouvez utiliser les valeurs suivantes :
    • openMessageBus
    • Hermès
    • les deux

    Valeur par défaut : openMessageBus

    		 Chaîne
    sn_api_notif_mgmt.inboundqueue.maxrecords Nombre maximal d’enregistrements que le planificateur extrait de la file d’attente entrante pour une exécution du planificateur. Cette valeur est utilisée conjointement avec le sn_api_notif_mgmt.inboundqueue.batch.limit paramètre.
    • Valeur par défaut : 200
    • Autres valeurs possibles : selon les besoins

    Par exemple, si la limite de lot est définie sur 50 et que maxrecords est défini sur 200, et si le nombre d’enregistrements qui se trouvent dans la file d’attente entrante est de 130, le planificateur extrait trois lots différents d’enregistrements en une seule exécution ; deux avec 50 disques et un avec 30 enregistrements. Si le nombre d’enregistrements dans la file d’attente entrante est de 220, le planificateur extrait quatre lots de 50 enregistrements et les 20 enregistrements restants ne sont traités qu’à la prochaine exécution du planificateur.

    Lors de la définition de cette valeur, vous devez également tenir compte du temps qu’il faudra au planificateur pour traiter plusieurs lots et définir la valeur sn_api_notif_mgmt.schedule.max.runtime en conséquence.

    		 Entier
    sn_api_notif_mgmt.inboundqueue.batch.limit Nombre d’enregistrements que le planificateur extrait et traite de la file d’attente entrante à un seul lot.
    • Valeur par défaut : 200
    • Autres valeurs possibles : selon les besoins
    		 Entier
    sn_api_notif_mgmt.glide.mutex.script.maxspins Nombre maximal de tentatives d’acquisition d’un verrou mutex dans les enregistrements de file d’attente entrante.
    • Type : entier
    • Valeur par défaut : 100
    • Autres valeurs possibles : selon les besoins
    		 Entier
    sn_api_notif_mgmt.schedule.max.exécution Durée maximale, en millisecondes, pendant laquelle la tâche planifiée peut s’exécuter avant qu’elle ne tombe en panne et signale une erreur.
    • Type : entier
    • Valeur par défaut : 90 000
    • Autres valeurs possibles : selon les besoins
    		 Entier
    sn_api_notif_mgmt.glide.mutex.script.spinwait Durée maximale, en millisecondes, d’attente entre les tentatives d’acquisition d’un verrou mutex sur les enregistrements de la file d’attente entrante.
    • Type : entier
    • Valeur par défaut : 100
    • Autres valeurs possibles : selon les besoins
    		 Entier

    Workflow du cadre de travail du créateur

    Lorsque le système envoie un événement à la table intermédiaire, les étapes suivantes sont effectuées dans le cadre du mécanisme du cadre de travail du créateur :
    1. Le planificateur sélectionne un certain nombre d’enregistrements à un intervalle préconfiguré, puis envoie des instantanés Glide au processeur d’événements.
    2. Le système convertit l’instantané Glide en une charge utile d’événement de réclamation TMF 688 en fonction du type d’événement.

      Pour en savoir plus sur les méthodes utilisées pour définir et générer les charges utiles compatibles TMF pour les événements de ticket d’incident, reportez-vous à la section TopicAPIUtilsOOB - Scoped.

    3. Le système vérifie si la configuration de notification est destinée à Hermes Kafka ou au bus de messages ouvert.

      Pour en savoir plus sur la configuration du cadre de notification d’événement du créateur, reportez-vous à la section Producer Event Notification Framework developer guide.