Entwicklerleitfaden für Framework für Erstellererereignisbenachrichtigungen
Das Framework für Ereignisbenachrichtigungen für Produzenten für Telekommunikationen, Medien und Technologie ermöglicht die externe Verteilung von Ereignissen, z. B. Trouble Tickets, mit Nachrichtenbus In Ihrem Netzwerk implementiert.
- Ereignisse werden über veröffentlicht Hermes Messaging-Service: Wenn Sie Ereignisse mit Hermes Kafka veröffentlichen möchten, müssen Sie das Ersteller-Ereignisbenachrichtigungs-Framework für den Kafka-Nachrichtenbus konfigurieren. Sie können diesen Nachrichtenbus nur für cloudbasierte Instanzen verwenden. Details finden Sie unter Konfigurieren Sie das Framework für Erstellererereignisbenachrichtigungen für die Verwendung von Hermes Messaging-Service.
Weitere Informationen zum Veröffentlichen von Problemticketbenachrichtigungen mit Hermes finden Sie unter Producing outbound API notifications using Hermes.
Hinweis:Bevor Sie diesen Anwendungsfall implementieren können, müssen Sie bereits über verfügen Hermes Messaging-Service In Ihrer Instanz installiert und konfiguriert. Details finden Sie unter Hermes Messaging Service. - Veröffentlichen von Ereignissen über den offenen Nachrichtenbus: Wenn Ihre Instanz einen anwenderdefinierten Nachrichtenbus verwendet, müssen Sie das Ersteller-Ereignisbenachrichtigungs-Framework so konfigurieren, dass der offene Nachrichtenbus zum Senden von Ereignissen von verwendet wird ServiceNow Instanz für Verbraucher in Ihrem Netzwerk. Sowohl cloudbasiert als auch lokal ServiceNow Instanzen können Ereignisse über den offenen Nachrichtenbus veröffentlichen. Details finden Sie unter Konfigurieren Sie das Framework für Erstellererereignisbenachrichtigungen, um den Nachrichtenbus öffnen zu verwenden.
Weitere Informationen zum Veröffentlichen von Trouble Ticket-Benachrichtigungen mit dem offenen Nachrichtenbus finden Sie unter Producing outbound API notifications using the open message bus.
In diesem Dokument wird die Systemkonfiguration beschrieben, die ausgeführt werden muss, einschließlich der Skripteinbindungen, die überschrieben werden müssen, um diese Nachrichtenbus-Implementierungen in bereitzustellen ServiceNowÖkosystem.
Systemeigenschaften des Erstellers
In der folgenden Tabelle sind die Eigenschaften in aufgeführt ServiceNow Instanz, die die Funktionalität des Frameworks zur Ereignisbenachrichtigung des Erstellers steuert. Überprüfen Sie die Standardwerte dieser Eigenschaften, und ändern Sie sie bei Bedarf für Ihre spezifische Implementierung. Um diese Eigenschaften zu ändern, in ServiceNow UI gehe zu an.
| Eigenschaft | Beschreibung |
|---|---|
| sn_api_notif_mgmt.event.log | Protokollierungsebene, die in die Debug-Protokolle geschrieben werden soll. Gültige Werte:
Standard: ERR |
| sn_api_notif_mgmt.Glide.Mutex. Skript. Max. Drehungen | Maximale Anzahl von Versuchen, eine Mutex-Sperre für die Datensätze in der eingehenden Warteschlange zu erhalten. Standard: 100 |
| sn_api_notif_mgmt. Glide. Mutex. Skript. Spinwait | Wartezeit zwischen Versuchen, eine Sperre für die Datensätze in der eingehenden Warteschlange zu erhalten. Einheit: Millisekunden Standard: 100 |
| sn_api_notif_mgmt. Inbound-Warteschlange. Batch. Grenzwert | Anzahl der Datensätze, die der Planer Ruft ab und verarbeitet sie Aus der eingehenden Warteschlange gleichzeitig (ein Batch). Standard: 200 |
| sn_api_notif_mgmt. Inbound Queue.maxRecords | Maximale Anzahl von Datensätzen, die der Planer für eine Zeitplanerausführung aus der eingehenden Warteschlange abruft. Dieser Wert wird in Verbindung mit verwendet sn_api_notif_mgmt.inboundqueue.batch.limitParameter. Beispiel: Wenn das Batch-Limit auf 50 und die maxRecords auf 200 festgelegt ist, Und Die Anzahl der Datensätze, die sich in der eingehenden Warteschlange befinden, beträgt 130. Der Planer ruft drei verschiedene Batches von Datensätzen in einer einzigen Ausführung ab: Zwei mit 50 Datensätzen und einer mit 30 Datensätzen. Wenn die Anzahl der Datensätze in der eingehenden Warteschlange 220 beträgt, ruft der Planer vier Batches mit 50 Datensätzen ab, und die verbleibenden 20 Datensätze werden erst bei der nächsten Ausführung des Planers verarbeitet. Beim Festlegen dieses Werts müssen Sie auch die Zeit berücksichtigen, die der Planer benötigt, um mehrere Batches zu verarbeiten und festzulegen sn_api_notif_mgmt.schedule.max.runtimeWert entsprechend. Standard: 200 |
| sn_api_notif_mgmt. Herausgeber_Nachricht_Bus_Konfiguration | Definiert, ob Nachrichten mit veröffentlicht werden Hermes Messaging-Service, Der offene Nachrichtenbus oder beide Nachrichtenbusse. Gültige Werte:
Standard: OpenMessageBus |
| sn_api_notif_mgmt. Zeitplan. Max Laufzeit | Maximale Zeit, die eine geplante Aufgabe ausgeführt werden kann, bevor sie fehlschlägt und einen Fehler meldet. Einheit: Millisekunden Standard: 90.000 |