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 Ihrer Integration und
- Verwalten Ihrer Integration
Das ErstellenIhrer Integration umfasst das Erstellen und Konfigurieren einer Prozesssynchronisierungsdefinition und der zugehörigen Datensätze. Um weitere Informationen zu den ersten Schritten beim Erstellen Ihrer Integration der Remote-Prozesssynchronisierung zu erhalten, führen Sie entweder ein Beispiel für die Erstellen Sie Ihre erste Remote Process Sync-IntegrationVorgehensweise durch, oder erfahren Sie mehr über Prozesssynchronisierungsdefinitionen.
DieVerwaltung Ihrer Integration umfasst die Überwachung der ausgehenden und eingehenden Warteschlangen und die Überprüfung auf Fehler im Zusammenhang mit ausgelösten Prozesssynchronisierungsdefinitionen. Weitere Informationen zum Überwachen und Überprüfen auf Fehler bei der Integration der Remote-Prozesssynchronisierung finden Sie unter Ausgehende Warteschlangen und eingehende Warteschlangen und Überwachung und Problembehandlung Ihrer Integration. Möglicherweise möchten Sie auch die ausgehenden und eingehenden Flows, die für Ihre Integration automatisch ausgeführt werden, regelmäßig auswerten und feststellen, ob Änderungen an diesen Flows in vorgenommen werden sollen Flow Designer.
Prozesssynchronisierungsdefinitionen
| Feld | Beschreibung |
|---|---|
| Name | Geben Sie einen Namen ein, der genau beschreibt, welchen Teil Ihres Geschäftsprozesses Ihre Instanz verarbeitet. Wenn Benutzer in Ihrer Instanz beispielsweise daran arbeiten, Service Catalog-Anforderungen für Ihre Kunden zu erfüllen, geben Sie einen Namen wie „Service Catalog-Anforderungserfüllung“ ein. |
| Beschreibung | Beschreiben Sie optional, welchen Teil Ihres Geschäftsprozesses diese Definition der Prozesssynchronisierung behandelt. |
| Anwendung | Automatisch auf Ihren aktuellen Anwendungsbereichfestgelegt. |
| 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
Erfassen Sie Definitionen
Eine Erfassungsdefinition gibt an, wann Ihre Instanz Daten an eine Remote-Instanz senden soll und welche Daten Ihre Instanz senden soll. Eine Erfassungsdefinition enthält die Konfigurationen für den Auslöser und die erfassten FelderIhrer 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, wird ein Objekt aus einem Quelldatensatz erstellt, der erfasste Felder enthält. Dann wird der ausgehende Flow ausgeführt und korreliert die erfassten Felder aus dem Quelldatensatz mit Feldern in einem zugehörigen Datensatz auf dem Remote-System.
Ein Erfassungsdefinitionsdatensatz verfügt über die folgenden Felder:
| Feld | Beschreibung |
|---|---|
| Verarbeitungs-Event | Verwenden Sie im Formular „Erfassungsdefinition“ das Symbol „ |
| Status | Wählen Sie Aktiv aus, um diese Erfassungsdefinition zu aktivieren, sodass die übergeordnete Prozesssynchronisierungsdefinition ausgelöst wird, wenn die im Abschnitt „Auslöser“ dieses Formulars festgelegten Bedingungen erfüllt sind. |
| Reihenfolge | Geben Sie einen Wert für die Reihenfolge ein, in der Ihre Erfassungsdefinition relativ zu anderen Erfassungsdefinitionen ausgelöst werden soll. Werte niedrigerer Ordnung werden vor Werten höherer Ordnung berücksichtigt. |
| Anwendung | Automatisch auf Ihren aktuellen Anwendungsbereichfestgelegt. |
| 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 Sie Ihre Prozesssynchronisierungsdefinition auslösen möchten. Sie können auch Feldbedingungen hinzufügen, die bei Erfüllung die Definition der Prozesssynchronisierung auslösen. 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 aus, deren Datensätze Ihre Prozesssynchronisierungsdefinition 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. Wählen Sie beispielsweise bewirkt, dass Ihre Prozesssynchronisierungsdefinition jedes Mal ausgelöst wird, wenn ein Datensatz im Status der ausgewählten Tabelle auf „In Arbeit“ 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 den auslösenden Datensätzen in Ihrer lokalen Instanz zugeordnet sind, mit Anhängen in korrelierten Datensätzen in der Remote-Instanz synchronisiert. Weitere Informationen finden Sie unter |
Ereignisse verarbeiten
Ein Prozess-Event 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 Remote-Instanz sollte 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 Prozessereignisdatensatz verfügt über die folgenden Felder:
| 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 Benutzer fordert Softwarean. Hinweis: Ein Administrator für die Remote-Instanz oder die Remote-Instanzen muss auch ein Prozess-Event mit demselben Namen erstellen, den Sie hier verwenden. Durch die Erstellung dieser Prozess-Events in separaten Instanzen wird die logische Verknüpfung erstellt, mit der Sie Daten zwischen mehreren Instanzen integrieren können. |
| Anwendung | Automatisch auf Ihren aktuellen Anwendungsbereichfestgelegt. |
| 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 Remote-System-Datensatz verfügt über die folgenden Felder:
| Feld | Beschreibung |
|---|---|
| Name | Geben Sie einen Namen ein, der die Remote-Instanz beschreibt. Wenn die Instanz beispielsweise 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 Remote-Systemdatensatz ein, der dasselbe Prozess-Event mit Ihrer Instanz verwendet. Um die Sys-ID eines Datensatzes abzurufen, wählen Sie sys_id kopieren aus dem Kontextmenü ( |
| Anwendung | Automatisch auf Ihren aktuellen Anwendungsbereichfestgelegt. |
| 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 den zugehörigen Link Remote-System validieren und aktivieren in der Formularansicht dieses Remote-System-Datensatzes auswählen, nachdem Sie die Erstellung des Datensatzes abgeschlossen haben. |
| Eingehender API-Anwender | Benutzer, der eine Verbindung zur Remote-Instanz herstellen kann. Dieser Benutzer muss über Anmeldeinformationen verfügen, die denen des Benutzers mit der Rolle „ih_process_sync_api“ in der Remote-Instanz entsprechen. |
| Eingehende Flows ausführen 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 den zugehörigen Link Remote-System validieren und aktivieren in der Formularansicht dieses Remote-System-Datensatzes auswählen, nachdem Sie die Erstellung des Datensatzes abgeschlossen haben. |
Nachdem Sie einen Prozessereignisdatensatz und einen Remote-Systemdatensatz erstellt haben, können Sie diesen Datensätzen Subflows Flow Designer zuordnen, sodass automatisierte Aktionen immer dann 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 verfügt über die folgenden Felder:
| Feld | Beschreibung |
|---|---|
| Verarbeitungs-Event | Wählen Sie das Symbol „ |
| Ausgehender Subflow | Wählen Sie das Symbol „Nachschlagen mit Liste“ (Symbol „ |
| Remotesystem | Wählen Sie das Symbol „ |
| Anwendung | Automatisch auf Ihren aktuellen Anwendungsbereichfestgelegt. |
| 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 von der Remote-Instanz gesendete Felder Feldern in der lokalen Instanz zu
- Verarbeiten Sie Daten, die von der Remote-Instanz an die lokale Instanz gesendet wurden
Ein eingehender Flow-Datensatz verfügt über die folgenden Felder:
| Feld | Beschreibung |
|---|---|
| Verarbeitungs-Event | Wählen Sie das Symbol „ |
| Eingehender Subflow | Wählen Sie das Symbol „Nachschlagen mit Liste“ (Symbol „ |
| Remotesystem | Wählen Sie das Symbol „ |
| Anwendung | Automatisch auf Ihren aktuellen Anwendungsbereichfestgelegt. |
| 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 Ausgehende Flow-Vorlage für Remote-Prozesssynchronisierung – Standard oder Remote-Prozesssynchronisierung eingehende Flow-Vorlage – Standard für Ihre Prozesssynchronisierungsdefinition auswählen, sollten Sie diese Subflows in Flow Designeranpassen.
Anhänge werden synchronisiert
- Wenn ein Datensatz in Ihrer Integration zum ersten Mal synchronisiert wird, 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 künstlichen Schlüssel, einen Hash, einen Dateinamen, einen Inhaltstyp und eine Größe.
- Die Remote-Instanz entscheidet, welche Anhänge empfangen werden sollen, indem jeder Hash und Dateiname aus der eingehenden Nutzlast mit denen in der Instanz verglichen wird. Dann wird der folgende Prozess ausgeführt:
- Das Ursprungssystem validiert den Schlüssel und sendet Anhänge an den Korrelationsdatensatz.
- Das Ursprungssystem benachrichtigt das Remote-System, dass die Anhänge abgeschlossen sind.
- Das Remote-System 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 wann erstellt hat.
Ausgehende Warteschlangen und eingehende Warteschlangen
Nach dem Erstellen Ihrer Remote Process Sync-Integration durch Erstellen und Konfigurieren der in den vorherigen Abschnitten genannten Datensätze 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 Daten ausgeführt wurden, die von Ihrer Instanz gesendet wurden. Um die Datensätze in Ihrer ausgehenden Warteschlange anzuzeigen, navigieren Sie zu .
Ein Datensatz für den Status einer ausgehenden Warteschlange weist die folgenden Felder auf:
| Feld | Beschreibung |
|---|---|
| Erstellt | Datum, an dem die automatisierte Aktion in Ihrer Integration aufgetreten ist |
| Fehlerinformationen | Statusmeldung für die ausgehende Nutzlast |
| Verarbeitungs-Event | Prozessereignis |
| 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 Verarbeitungssequenz und die 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 hat die folgenden Felder:
| Feld | Beschreibung |
|---|---|
| Sequenz | Reihenfolge in der Warteschlange. Eine niedrigere Nummer wird vor einer höheren Nummer verarbeitet. |
| Status | Verarbeitungsstatus der Nutzlast in der eingehenden Warteschlange. Verfügbare Optionen:
Hinweis: Wenn ein Datensatz einer eingehenden Warteschlange den Status Fehler aufweist, ändern Sie den Status in Bereit, um die Verarbeitung der eingehenden Nutzlast erneut zu versuchen. |
| Verarbeitungs-Event | Prozessereignis, das der Integrationsaktion zugeordnet ist |
| Vorgang | Typ des Datensatzvorgangs, den die Remote-Instanz ausgeführt hat und der die Remote-Instanz veranlasst hat, Daten auszulösen und zu senden. 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 | Remote-Systemdatensatz, der der Instanz zugeordnet ist, die die Daten gesendet hat |
| 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 Problembehandlung Ihrer 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 truesetzen. Durchsuchen Sie dann die Protokolle nach Fehlermeldungen, die mit OutboundQueueDao und InboundQueueDao beginnen, um Protokollnachrichten mit weiteren Informationen zu potenziellen Problemen bei Ihrer Integration zu finden. |
- Verbindungsfehler
- Ausgehende Verbindungsfehler werden mehrmals automatisch wiederholt, bevor der ausgehende Status des Remote-Systemdatensatzes auf Fehler gesetzt wird. Wenn für eine ausgehende Verbindung weiterhin Fehler auftreten, stellen Sie sicher, dass sich am eingehenden API-Benutzer des Remote-Systems nichts geändert hat, z. B. eine Änderung der Anmeldeinformationen des Benutzers. Validieren und aktivieren Sie dann den Remote-Systemdatensatz 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 E-Mail-Aktion, wenn sich der Status des Flow 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 beim Flow ein Fehler auftritt.