Guide du développeur de Producer Event Notification Framework
Le cadre de notification d’é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 de trouble, à l’aide d’un bus de messages implémenté dans votre réseau.
- Publier des événements via le Service de messagerie Hermes : Si vous prévoyez de publier des événements à l’aide d’Hermes Kafka, vous devez configurer le cadre de notification d’événement du producteur 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 Configurer le cadre de travail des notifications d’événements du créateur pour utiliser le Service de messagerie Hermes.
Pour plus d’informations sur la publication de notifications de tickets 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é sur Service de messagerie Hermes 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 d’événement 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 Configurer 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 ouvert, reportez-vous à la section Producing outbound API notifications using the 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 créateur
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 créateur. 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, accédez à l’interface ServiceNow utilisateur .
| 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 de 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 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. Par exemple, si la limite de lots est définie sur 50, 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 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 nécessaire 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 de , du bus de messages 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 n’échoue et ne signale une erreur. Unité : millisecondes Par défaut : 90 000 |