Erste Schritte mit der Remote-Prozesssynchronisierung
Lernen Sie die Grundlagen der Einrichtung einer Remote Process Sync-Integration kennen, um die automatisierten Prozesse zwischen zwei oder mehr ServiceNow® Instanzen miteinander zu verknüpfen.
Bevor Sie mit der Integration der Remote-Prozesssynchronisierung beginnen
- Erstellen Sie Ihre -Integration, und
- Verwalten Ihrer Integration
Das ErstellenIhrer Integration umfasst das Erstellen und Konfigurieren einer Definition für die Prozesssynchronisierung und der zugehörigen Datensätze. Weitere Informationen zu den ersten Schritten beim Erstellen Ihrer Integration für die Remote-Prozesssynchronisierung finden Sie in einem Beispiel für Erstellen Sie Ihre erste Remote Process Sync-Integration, oder Sie erfahren mehr über Prozesssynchronisierungsdefinitionen.
DieVerwaltung Ihrer Integration umfasst die Überwachung der ausgehenden und eingehenden Warteschlangen und die Prüfung auf Fehler im Zusammenhang mit ausgelösten Prozesssynchronisierungsdefinitionen. Weitere Informationen zum Überwachen und Überprüfen auf Fehler mit der Integration der Remoteprozesssynchronisierung finden Sie unter Ausgehende Warteschlangen und eingehende Warteschlangen und Überwachung und Fehlerbehebung bei der -Integration. Sie können auch regelmäßig die ausgehenden und eingehenden Flows auswerten, die automatisch für Ihre Integration ausgeführt werden, und feststellen, ob Sie in Änderungen an diesen Flows vornehmen sollten Workflow-Studio.
Prozesssynchronisierungsdefinitionen
| Feld | Beschreibung |
|---|---|
| Name | Geben Sie einen Namen ein, der genau beschreibt, welchen Teil des Geschäftsprozesses Ihre Instanz verarbeitet. Wenn beispielsweise Benutzer in Ihrer Instanz daran arbeiten, Servicekatalog-Anforderungen für Ihre Kunden zu erfüllen, geben Sie einen Namen wie „Servicekatalog-Anforderungserfüllung“ ein. |
| Beschreibung | Beschreiben Sie optional, welchen Teil Ihres Geschäftsprozesses diese Definition der Prozesssynchronisierung behandelt. |
| Anwendung | Automatisch auf Ihren aktuellen Anwendungsbereichfestlegen. |
| Domäne | Wenn sich Ihr Prozess auf eine bestimmte Domäne bezieht, wählen Sie eine andere Domäne als globaleaus. Weitere Informationen finden Sie unter Domänentrennung für Service Provider. |
- Erfassungsdefinitionen
- Prozess-Ereignisse
- Remotesysteme
- Ausgehende Flows
- Eingehende Flows
Erfassungsdefinitionen
Eine Erfassungsdefinition gibt an, wann und welche Daten Ihre Instanz Daten an eine Remote-Instanz senden soll. Eine Erfassungsdefinition enthält die Konfigurationen für die Felder „ Auslöser“ und „Erfasst“ Ihrer Prozesssynchronisierungsdefinition. Der Auslöser gibt an, welcher Datensatzvorgang (z. B. Erstellen, Aktualisieren oder Löschen eines Datensatzes) dazu führt, dass Ihre -Instanz Daten an eine Remote-Instanz sendet. Wenn eine Erfassungsdefinition ausgelöst wird, erstellt sie ein Objekt aus einem Quelldatensatz, der erfasste Felder enthält. Dann wird der ausgehende Flow ausgeführt, und er korreliert die erfassten Felder aus dem Quelldatensatz mit Feldern in einem zugehörigen Datensatz auf dem Remote-System.
Ein Erfassungsdefinitionsdatensatz weist die folgenden Felder auf:
| Feld | Beschreibung |
|---|---|
| Verarbeitungsereignis | Verwenden Sie im Formular „Erfassungsdefinition“ das Symbol „ |
| Status | Wählen Sie Aktiv aus, um diese Erfassungsdefinition zu aktivieren, damit die Synchronisierungsdefinition des übergeordneten Prozesses ausgelöst wird, wenn die von Ihnen im Abschnitt „Auslöser“ dieses Formulars festgelegten Bedingungen erfüllt sind. |
| Bestellung | Geben Sie einen Wert für die Reihenfolge ein, in der Ihre Erfassungsdefinition relativ zu anderen Erfassungsdefinitionen ausgelöst werden soll. Niedrigere Reihenfolgenwerte werden vor höheren Reihenfolgenwerten berücksichtigt. |
| Anwendung | Automatisch auf Ihren aktuellen Anwendungsbereichfestlegen. |
| Domäne | Wenn sich Ihr Prozess auf eine bestimmte Domäne bezieht, wählen Sie eine andere Domäne als globaleaus. Weitere Informationen finden Sie unter Domänentrennung für Service Provider. |
Wählen Sie im Abschnitt Auslöser eine autorisierte Quelltabelle aus, für deren Datensätze die Definition der Prozesssynchronisierung ausgelöst werden soll. Sie können auch Feldbedingungen hinzufügen, bei deren Erfüllung die Definition der Prozesssynchronisierung ausgelöst wird. Wenn die Bedingungen für den in Ihrer Erfassungsdefinition angegebenen Auslöser erfüllt sind, werden alle ausgehenden Flows ausgeführt, die Ihrer Prozesssynchronisierungsdefinition zugeordnet sind. Weitere Informationen finden Sie unter Ausgehende Flows und eingehende Flows.
| Feld | Beschreibung |
|---|---|
| Quelltabellenname | Wählen Sie eine autorisierte Tabelle, deren Datensätze die Definition der Prozesssynchronisierung jedes Mal auslösen, wenn die Datensätze erstellt, aktualisiert und gelöscht werden. |
| Filter | Verwenden Sie den Bedingungsgenerator, um Bedingungen hinzuzufügen, die bei Erfüllung die Definition der Prozesssynchronisierung auslösen. Beispiel: Auswählen von bewirkt, dass Ihre Definition der Prozesssynchronisierung jedes Mal ausgelöst wird, wenn ein Datensatz im Status der ausgewählten Tabelle auf „In Bearbeitung“ aktualisiert wird. |
Zuletzt fügen Sie im Abschnitt „Erfassen“ der Liste Ausgewählt Felder hinzu, die Sie in die Nutzlast für Ihren ausgehenden Flow aufnehmen möchten.
| Feld | Beschreibung |
|---|---|
| Felder einschließen | Fügen Sie der Liste Ausgewählt Felder hinzu, die Sie jedes Mal mit Feldern in der Remote-Instanz synchronisieren möchten, wenn Ihre Prozesssynchronisierungsdefinition ausgelöst wird. Verwenden Sie das Symbol zum Hinzufügen von Elementen ( Hinweis:
|
| Anhänge hinzufügen | Wenn diese Option ausgewählt ist, werden alle Anhänge, die auslösenden Datensätzen in Ihrer lokalen Instanz zugeordnet sind, mit Anhängen in zugehörigen Datensätzen in der Remote-Instanz synchronisiert. Weitere Informationen finden Sie unter |
Ereignisse verarbeiten
Ein Prozessereignis gibt an, welcher Teil Ihres Geschäftsprozesses in Ihrer lokalen Instanz beginnt und in der Remote-Instanz endet. Der Prozessereignisdatensatz in Ihrer lokalen Instanz und in der Remoteinstanz sollten denselben Namen haben, da das Prozessereignis die Verknüpfung zwischen diesen Instanzen darstellt, die es ihnen ermöglicht, Teile desselben Geschäftsprozesses gemeinsam zu nutzen. Ein Prozessereignis-Datensatz weist die folgenden Felder auf:
| Feld | Beschreibung |
|---|---|
| Name | Geben Sie einen Namen ein, der den Teil Ihres Geschäftsprozesses beschreibt, der in Ihrer lokalen Instanz beginnt und in der Remote-Instanz endet. Wenn Benutzer in Ihrer Instanz beispielsweise Software anfordern, die in der Remote-Instanz bereitgestellt wird, können Sie das Prozess-Event Benutzeranforderungen Softwarenennen. Hinweis: Ein Administrator für die Remote-Instanz(en) muss auch ein Prozessereignis mit dem hier verwendeten Namen erstellen. Durch das Erstellen dieser Prozessereignisse in separaten Instanzen wird die logische Verknüpfung erstellt, mit der Sie Daten zwischen mehreren Instanzen integrieren können. |
| Anwendung | Automatisch auf Ihren aktuellen Anwendungsbereichfestlegen. |
| Domäne | Wenn sich Ihr Prozess auf eine bestimmte Domäne bezieht, wählen Sie eine andere Domäne als globaleaus. Weitere Informationen finden Sie unter Domänentrennung für Service Provider. |
Remotesysteme
Ein Remote-System enthält die Konfigurationen für die ausgehenden und eingehenden Verbindungen, die sich auf eine andere ServiceNow -Instanz beziehen. Ein Remotesystem-Datensatz weist die folgenden Felder auf:
| Feld | Beschreibung |
|---|---|
| Name | Geben Sie einen Namen ein, der die Remote-Instanz beschreibt. Beispiel: Wenn die Instanz von einem Ihrer Kunden, Kunde A, verwaltet wird, geben Sie im Namensfeld „Instanz von Kunde A“ ein. |
| Beschreibung | Geben Sie optional weitere Details ein, die den allgemeinen Zweck der Remote-Instanz in Ihrem Geschäftsprozess beschreiben. |
| Externe ID | Geben Sie die Sys-ID für den Remotesystem-Datensatz ein, der dasselbe Prozessereignis mit Ihrer -Instanz teilt. Um die Sys-ID eines Datensatzes abzurufen, wählen Sie in der Formularansicht des Datensatzes im Kontextmenü ( |
| Anwendung | Automatisch auf Ihren aktuellen Anwendungsbereichfestlegen. |
| Domäne | Wenn sich Ihr Prozess auf eine bestimmte Domäne bezieht, wählen Sie eine andere Domäne als globaleaus. Weitere Informationen finden Sie unter Domänentrennung für Service Provider. |
| Fehler-Subflow | Wählen Sie das Symbol „Nachschlagen mit Liste“ (Symbol „ |
| Verbindungsalias | Wählen Sie das Symbol „ |
| Ausgehender Status | Standardmäßig auf Deaktiviert festgelegt. Sie können den Wert dieses Felds in „ Aktiv “ ändern, indem Sie in der Formularansicht dieses Remotesystem-Datensatzes den zugehörigen Link „Remotesystem validieren und aktivieren“ auswählen, nachdem Sie das Erstellen des Datensatzes abgeschlossen haben. |
| Eingehender API-Anwender | Benutzer, der eine Verbindung zur Remote-Instanz herstellen kann. Die Anmeldeinformationen dieses Benutzers müssen mit denen des Benutzers mit der Rolle „ih_process_sync_api“ in der Remote-Instanz übereinstimmen. |
| Führen Sie eingehende Flows aus als | Wählen Sie das Symbol „ |
| Eingehender Status | Standardmäßig auf Deaktiviert festgelegt. Sie können den Wert dieses Felds in „ Aktiv “ ändern, indem Sie in der Formularansicht dieses Remotesystem-Datensatzes den zugehörigen Link „Remotesystem validieren und aktivieren“ auswählen, nachdem Sie das Erstellen des Datensatzes abgeschlossen haben. |
Nachdem Sie einen Prozessereignisdatensatz und einen Remotesystem-Datensatz erstellt haben, können Sie diesen Datensätzen Subflows Workflow-Studio zuordnen, sodass automatisierte Aktionen ausgeführt werden, wenn Ihre Prozesssynchronisierungsdefinition ausgelöst wird.
Ausgehende Flows und inbound Flows
- Verarbeiten Sie lokale Daten als in der Erfassungsdefinition erfasste Felder, die an die Remote-Instanz gesendet werden
- Korrelieren Sie diese Daten mit Daten in der Remote-Instanz
- Senden Sie diese Daten an die Remote-Instanz
Ein ausgehender Flow-Datensatz weist die folgenden Felder auf:
| Feld | Beschreibung |
|---|---|
| Verarbeitungsereignis | Wählen Sie das Symbol „ |
| Ausgehender Subflow | Wählen Sie das Symbol „Nachschlagen mit Liste“ (Symbol „ |
| Remotesystem | Wählen Sie das Symbol „Nachschlagen mit Liste“ (Symbol „ |
| Anwendung | Automatisch auf Ihren aktuellen Anwendungsbereichfestlegen. |
| Domäne | Wenn sich Ihr Prozess auf eine bestimmte Domäne bezieht, wählen Sie eine andere Domäne als globaleaus. Weitere Informationen finden Sie unter Domänentrennung für Service Provider. |
- Korrelieren Sie Daten in der lokalen Instanz mit den von der Remote-Instanz gesendeten Daten
- Ordnen Sie Felder, die von der Remote-Instanz gesendet werden, Feldern in der lokalen Instanz zu
- Verarbeiten Sie Daten, die von der Remote-Instanz an die lokale Instanz gesendet werden
Ein eingehender Flow-Datensatz weist die folgenden Felder auf:
| Feld | Beschreibung |
|---|---|
| Verarbeitungsereignis | Wählen Sie das Symbol „ |
| Eingehender Subflow | Wählen Sie das Symbol „Nachschlagen mit Liste“ (Symbol „ |
| Remotesystem | Wählen Sie das Symbol „Nachschlagen mit Liste“ (Symbol „ |
| Anwendung | Automatisch auf Ihren aktuellen Anwendungsbereichfestlegen. |
| Domäne | Wenn sich Ihr Prozess auf eine bestimmte Domäne bezieht, wählen Sie eine andere Domäne als globaleaus. Weitere Informationen finden Sie unter Domänentrennung für Service Provider. |
Bevor Sie einfach die vom System bereitgestellten Subflows für ausgehende Flow-Vorlage für Remote-Prozesssynchronisierung – Standard oder eingehende Flow-Vorlage für Remote-Prozesssynchronisierung – Standard für Ihre Definition der Prozesssynchronisierung auswählen, können Sie diese Subflows in Workflow-Studioanpassen.
Anhänge werden synchronisiert
- Bei der ersten Synchronisierung eines Datensatzes in Ihrer Integration werden alle Anhänge in der ausgehenden Nutzlast gesendet. Nachfolgende Synchronisierungen können entweder Änderungen an Anhängen oder an alle Anhänge senden.
- Anhangmetadaten werden immer mit der ausgehenden Nutzlast gesendet. Diese Metadaten enthalten einen verschlüsselten synthetischen Schlüssel, einen Hash, einen Dateinamen, einen Inhaltstyp und eine Größe.
- Die Remote-Instanz entscheidet, welche Anhänge empfangen werden sollen, indem sie jeden Hash und Dateinamen aus der eingehenden Nutzlast mit denen in der Instanz vergleicht. Dann wird der folgende Prozess ausgeführt:
- Das Ursprungssystem validiert den Schlüssel und sendet Anhänge an den Korrelationsdatensatz.
- Das Ursprungssystem benachrichtigt das Remotesystem, dass die Anhänge abgeschlossen sind.
- Das Remotesystem verschiebt die Anhänge aus dem Korrelationsdatensatz in den Zieldatensatz.
Kommentare und Arbeitsnotizen werden synchronisiert
In Ihrer Integration werden Kommentare und Arbeitsnotizen nur dann zwischen Instanzen synchronisiert, wenn Änderungen an diesen Journalfeldern auftreten. Change-Metadaten sind in Nutzlasten enthalten, damit Remote-Systeme erkennen können, welcher Benutzer den Kommentar oder die Arbeitsnotiz erstellt hat und wann er erstellt wurde.
Ausgehende Warteschlangen und eingehende Warteschlangen
Nachdem Sie Ihre Integration für die Remote-Prozesssynchronisierung durch Erstellen und Konfigurieren der in den vorherigen Abschnitten genannten Datensätze erstellt haben, können Sie Ihre Integration verwalten, indem Sie die ausgehende und eingehende Warteschlange in Ihrer Instanz überwachen.
Eine ausgehende Warteschlange enthält den Status, Fehlerinformationen, Wiederholungsdaten und Flow-Kontextinformationen für ausgehende Subflows, die für von Ihrer Instanz gesendete Daten ausgeführt wurden. Um die Datensätze in Ihrer ausgehenden Warteschlange anzuzeigen, navigieren Sie zu .
Ein Datensatz für den Status der ausgehenden Warteschlange enthält die folgenden Felder:
| Feld | Beschreibung |
|---|---|
| Erstellt | Datum, an dem die automatisierte Aktion in Ihrer Integration stattgefunden hat |
| Fehlerinformationen | Statusnachricht für die ausgehende Nutzlast |
| Verarbeitungsereignis | Ereignis verarbeiten |
| Remotesystem | Remotesystem |
| Metadaten erneut versuchen | Metadaten für alle Wiederholungsrichtlinien, die für Ihre ausgehende Nutzlast konfiguriert sind |
| Status | Verarbeitungsstatus der Nutzlast in der ausgehenden Warteschlange. Verfügbare Optionen:
|
| Domäne | Domäne, in der die automatisierte Aktion für Ihre Integration ausgeführt wurde |
| Ausgehender Subflow-Kontext | Sys-ID des Ausführungsdatensatzes für den ausgehenden Flow, der die Nutzlast verarbeitet hat |
Eine eingehende Warteschlange enthält den Status, die Verarbeitungsreihenfolge und Korrelationsinformationen für eingehende Subflows, die für Daten ausgeführt wurden, die von einer Remote-Instanz an Ihre lokale Instanz gesendet wurden. Um die Datensätze in Ihrer eingehenden Warteschlange anzuzeigen, navigieren Sie zu .
Ein Datensatz einer eingehenden Warteschlange weist die folgenden Felder auf:
| Feld | Beschreibung |
|---|---|
| Sequenz | Reihenfolge in der Warteschlange. Eine niedrigere Anzahl wird vor einer höheren Anzahl verarbeitet. |
| Status | Verarbeitungsstatus der Nutzlast in der eingehenden Warteschlange. Verfügbare Optionen:
Hinweis: Wenn ein Datensatz in einer eingehenden Warteschlange den Status „Fehler“ aufweist, ändern Sie den Status in „Bereit“, um die Verarbeitung der eingehenden Nutzlast zu wiederholen. |
| Verarbeitungsereignis | Prozessereignis, das der Integrationsaktion zugeordnet ist |
| Vorgang | Typ des von der Remote-Instanz ausgeführten Datensatzvorgangs, der dazu führten, dass die Remote-Instanz Daten auslöste und Daten sendete. Verfügbare Optionen:
|
| Transformationskontext | Sys-ID des Ausführungsdatensatzes für den eingehenden Flow, der die Nutzlast verarbeitet hat |
| ID für lokale Korrelation | Korrelations-ID in der lokalen Instanz |
| ID für Remotekorrelation | Korrelations-ID in der Remote-Instanz |
| Remotesystem | Remotesystem- Datensatz, der der Instanz zugeordnet ist, von der die Daten gesendet wurden |
| Domäne | Domäne, in der die automatisierte Aktion für Ihre Integration ausgeführt wurde |
| Nutzlast | Zeichenfolge als JSON-Nutzlast für eingehende Daten |
Überwachung und Fehlerbehebung bei der -Integration
| Tabelle | Beschreibung |
|---|---|
| XML-Statistiken | Zeigen Sie den Abschnitt process_sync_queue an, um Informationen zu den ausgehenden und eingehenden Warteschlangen für Ihre Integration zu erhalten, einschließlich der Größe der Warteschlange sowie der Fehler- und Verarbeitungsraten. |
| Ausgehende Warteschlange | Zeigen Sie die Erfassungsdaten für Datensätze an, die bereitgestellt werden, um von Ihrer -Instanz gesendet zu werden. |
| Status der ausgehenden Warteschlange | Zeigen Sie den Status der Datensätze in der Tabelle „Ausgehende Warteschlange“ an. |
| Eingehende Warteschlange | Zeigen Sie die kombinierte eingehende Warteschlange und Datensatztabelle an. |
| Protokolle | Aktivieren Sie zunächst das Debugging, indem Sie die Systemeigenschaft glide.ih.process.sync.debug auf den Wert true festlegen. Scannen Sie dann die Protokolle auf Fehlermeldungen, die mit „ OutboundQueueDao “ und „InboundQueueDao“ beginnen, um Protokollnachrichten mit weiteren Informationen zu potenziellen Problemen mit Ihrer Integration zu finden. |
- Verbindungsfehler
- Ausgehende Verbindungsfehler werden automatisch mehrmals wiederholt, bevor der ausgehende Status des Remotesystem-Datensatzes auf „Fehler“ gesetzt wird. Wenn bei einer ausgehenden Verbindung weiterhin Fehler auftreten, vergewissern Sie sich, dass sich beim eingehenden API-Benutzer des Remotesystems nichts geändert hat, z. B. bei einer Änderung der Anmeldeinformationen des Benutzers. Validieren und aktivieren Sie dann den Remotesystem-Datensatz erneut.
- Datenverarbeitungsfehler
- Datenverarbeitungsfehler treten normalerweise als Ergebnis von Fehlern in einem ausgehenden oder eingehenden Flow auf. Um diese Fehler zu beheben, können Sie Ihrem Flow Fehlerbehandlungsaktionen hinzufügen, z. B. eine Protokollaktion oder eine Aktion E-Mail senden, wenn sich der Status des Flows in Fehler ändert. Sie können auch Aktionen hinzufügen, die die Verarbeitung von Datensätzen in den Tabellen „Ausgehende Warteschlange“ oder „Eingehende Warteschlange“ überspringen, wenn ein Fehler mit dem Flow auftritt.