Guide du développeur de Producer Event Notification Framework
Le cadre de notification des événements du créateur pour les télécommunications, les médias et la technologie permet la distribution externe d’événements, tels que les tickets d’incident, à l’aide d’un bus de messages implémenté dans votre réseau.
- Publier des événements via le : Si vous prévoyez de publier des événements à l’aide d’Hermes Service de messagerie Hermes Kafka, vous devez configurer le Producer Event Notification Framework pour le bus de messages Kafka. Vous ne pouvez utiliser ce bus de messages que pour les instances basées sur le cloud. Pour plus de détails, voir Configurez le cadre de travail des notifications d’événements du producteur pour utiliser le Service de messagerie Hermes.
Pour plus d’informations sur la publication de notifications de ticket d’incident à l’aide d’Hermes, reportez-vous à la section Producing outbound API notifications using Hermes.
Remarque :Avant de pouvoir implémenter ce cas d’utilisation, vous devez déjà avoir installé et configuré le Service de messagerie Hermes sur votre instance. Pour plus de détails, voir Hermes Messaging Service. - Publication d’événements via le bus de messages ouverts : si votre instance utilise un bus de messages personnalisé, vous devez configurer le cadre de notification des événements du créateur pour utiliser le bus de messages ouvert afin d’envoyer des événements de votre ServiceNow instance aux consommateurs de votre réseau. Les instances basées sur le cloud et sur site ServiceNow peuvent publier des événements via le bus de messages ouvert. Pour plus de détails, voir Configurez le cadre de travail des notifications d’événements du créateur pour utiliser le bus de messages ouverts.
Pour plus d’informations sur la publication de notifications de ticket d’incident à l’aide du bus de messages ouverts, reportez-vous à la section Outbound trouble ticket notifications via open message bus.
Ce document décrit la configuration système qui doit être effectuée, y compris les includes de script qui doivent être remplacés pour déployer ces implémentations de bus de messages dans votre ServiceNow écosystème.
Propriétés système du producteur
Le tableau suivant répertorie les propriétés au sein de votre ServiceNow instance qui contrôlent la fonctionnalité du cadre de travail des notifications d’événements du producteur. Examinez les valeurs par défaut de ces propriétés et, si nécessaire, modifiez-les pour votre implémentation spécifique. Pour modifier ces propriétés, dans l’interface ServiceNow utilisateur, accédez à .
| Propriété | Description |
|---|---|
| sn_api_notif_mgmt.event.log | Niveau de journalisation à écrire dans les journaux de débogage. Valeurs valides :
Par défaut : err |
| sn_api_notif_mgmt.glide.mutex.script.Les maxspins | Nombre maximal de tentatives d’acquisition d’un verrou mutex sur les enregistrements de la file d’attente entrante. Par défaut : 100 |
| sn_api_notif_mgmt.glide.mutex.script.SpinWait | Temps d’attente entre les tentatives d’acquisition d’un verrou sur les enregistrements dans la file d’attente entrante. Unité : millisecondes Par défaut : 100 |
| sn_api_notif_mgmt.inboundQueue.batch.limit | Nombre d’enregistrements que le planificateur extrait et traite à partir de la file d’attente entrante en une seule fois (un lot). Par défaut : 200 |
| sn_api_notif_mgmt.inboundqueue.maxrecords | Nombre maximum 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. Par exemple, si la limite de lot est définie sur 50 et que maxrecords est défini sur 200, et que le nombre d’enregistrements 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 enregistrements et un avec 30 enregistrements. Si le nombre d’enregistrements dans la file d’attente entrante est égal à 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 sn_api_notif_mgmt.schedule.max.runtime valeur en conséquence. Par défaut : 200 |
| sn_api_notif_mgmt.publisher_message_bus_configuration | Définit si les messages sont publiés à l’aide du , du bus de message ouvert ou des Service de messagerie Hermes deux bus de messages. Valeurs valides :
Par défaut : openMessageBus |
| sn_api_notif_mgmt.schedule.max.runtime | Temps maximal d’exécution d’une tâche planifiée avant qu’elle ne tombe en panne et ne signale une erreur. Unité : millisecondes Par défaut : 90 000 |