Erste Schritte mit Remote-Prozesssynchronisierung
Erfahren Sie mehr über die Grundlagen der Einrichtung einer Remote Process Sync-Integration, um automatisierte Prozesse zwischen zwei oder mehr zu verknüpfen ServiceNow® Instanzen zusammen.
Bevor Sie mit Ihrer Integration der Remote-Prozesssynchronisierung beginnen
- Erstellen Sie Ihre Integration, und
- Verwalten Ihrer Integration
Erstellen Sie Ihre Integration Umfasst die Erstellung und Konfiguration einer Prozesssynchronisierungsdefinition und der zugehörigen Datensätze. Um weitere Informationen zu den ersten Schritten mit der Integration Ihrer Remote-Prozesssynchronisierung zu erhalten, führen Sie entweder ein Beispiel für die Vorgehensweise durch Erstellen Sie Ihre erste Integration der Remote-Prozesssynchronisierung, Oder erfahren Sie mehr über Definitionen der Prozesssynchronisierung .
Verwalten 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 von Fehlern mit Ihrer Integration der Remote-Prozesssynchronisierung finden Sie unter Ausgehende Warteschlangen und eingehende Warteschlangen Und Überwachung und Fehlerbehebung Ihrer Integration. Möglicherweise möchten Sie auch regelmäßig die ausgehenden und eingehenden Flows auswerten, die für Ihre Integration automatisch ausgeführt werden, und festlegen, ob Änderungen an diesen Flows in vorgenommen werden sollen Workflow Studio.
Definitionen der Prozesssynchronisierung
| Feld | Beschreibung |
|---|---|
| Name | Geben Sie einen Namen ein, der genau beschreibt, welchen Teil Ihres Geschäftsprozesses Ihre Instanz verarbeitet. Wenn Anwender in Ihrer Instanz beispielsweise Servicekatalog-Anforderungen für Ihre Kunden erfüllen, geben Sie einen Namen ein, z. B. Erfüllung von Servicekatalog-Anforderungen. |
| Beschreibung | Beschreiben Sie optional, welchen Teil Ihres Geschäftsprozesses diese Prozesssynchronisierungsdefinition verarbeitet. |
| Anwendung | Wird automatisch auf Ihre aktuelle festgelegt Anwendungsbereich . |
| Domäne | Wenn sich Ihr Prozess auf eine bestimmte Domäne bezieht, wählen Sie eine andere Domäne als aus Global . Weitere Informationen finden Sie unter Domänentrennung für Service Provider . |
- Erfassungsdefinitionen
- Prozess-Ereignisse
- Remotesysteme
- Ausgehende Flows
- Eingehende Flows
Erfassungsdefinitionen
A 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 Ihre Prozesssynchronisierungsdefinitionen Auslöser Und Erfasste Felder . Der Auslöser gibt an, welcher Datensatzvorgang, z. B. das 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 beginnt der ausgehende Flow mit der Ausführung und korreliert die erfassten Felder aus dem Quelldatensatz mit Feldern in einem zugehörigen Datensatz auf dem Remotesystem.
Ein Erfassungsdefinitionsdatensatz enthält die folgenden Felder:
| Feld | Beschreibung |
|---|---|
| Prozess-Ereignis | Verwenden Sie im Formular „Erfassungsdefinition“ das Symbol „Suchen mit Liste“ ( |
| Status | Wählen Sie Aus Aktiv Dient zum Aktivieren dieser Erfassungsdefinition, damit die übergeordnete Prozesssynchronisierungsdefinition ausgelöst wird, wenn die Bedingungen erfüllt sind, die Sie im Abschnitt „Auslöser“ dieses Formulars festgelegt haben. |
| Reihenfolge | Geben Sie einen Wert für die Reihenfolge ein, in der Ihre Erfassungsdefinition im Vergleich zu anderen Erfassungsdefinitionen ausgelöst werden soll. Niedrigere Reihenfolgewerte werden vor höheren Reihenfolgewerten berücksichtigt. |
| Anwendung | Wird automatisch auf Ihre aktuelle festgelegt Anwendungsbereich . |
| Domäne | Wenn sich Ihr Prozess auf eine bestimmte Domäne bezieht, wählen Sie eine andere Domäne als aus Global . Weitere Informationen finden Sie unter Domänentrennung für Service Provider . |
Wählen Sie im Abschnitt Auslöser eine autorisierte Quelltabelle aus, deren Datensätze Sie Ihre Prozesssynchronisierungsdefinition auslösen möchten. Sie können auch Feldbedingungen hinzufügen, die bei Erfüllung Ihre Prozesssynchronisierungsdefinition 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 Ihre Prozesssynchronisierungsdefinition auslösen. Wählen Sie beispielsweise aus Bewirkt, dass Ihre Prozesssynchronisierungsdefinition jedes Mal ausgelöst wird, wenn ein Datensatz im Status Ihrer ausgewählten Tabelle in „in Bearbeitung“ aktualisiert wird. |
Fügen Sie schließlich 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 bei jedem Auslösen Ihrer Prozesssynchronisierungsdefinition mit Feldern in der Remote-Instanz synchronisieren möchten. Verwenden Sie das Symbol „Element hinzufügen“ ( 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 korrelierten Datensätzen in der Remote-Instanz synchronisiert. Weitere Informationen finden Sie unter |
Ereignisse verarbeiten
A Ereignis verarbeiten Gibt an, welcher Teil Ihres Geschäftsprozesses in Ihrer lokalen Instanz beginnt und in der Remote-Instanz endet. Der Prozess-Ereignis-Datensatz 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 freizugeben. Ein Prozessereignisdatensatz enthält 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 Anwender in Ihrer Instanz beispielsweise Software anfordern, die in der Remote-Instanz bereitgestellt wird, können Sie das Prozessereignis benennen Anwender fordert Software an . Hinweis: Ein Administrator für die Remote-Instanz oder Remote-Instanzen muss auch ein Prozessereignis mit demselben Namen erstellen, den Sie hier verwenden. Durch das Erstellen dieser Prozessereignisse in separaten Instanzen wird der logische Link erstellt, mit dem Sie Daten zwischen mehreren Instanzen integrieren können. |
| Anwendung | Wird automatisch auf Ihre aktuelle festgelegt Anwendungsbereich . |
| Domäne | Wenn sich Ihr Prozess auf eine bestimmte Domäne bezieht, wählen Sie eine andere Domäne als aus Global . Weitere Informationen finden Sie unter Domänentrennung für Service Provider . |
Remotesysteme
A Remotesystem Enthält die Konfigurationen für die ausgehenden und eingehenden Verbindungen, die sich auf eine andere beziehen ServiceNow Instanz. Ein Remote-System-Datensatz enthält die folgenden Felder:
| Feld | Beschreibung |
|---|---|
| Name | Geben Sie einen Namen ein, der die Remote-Instanz beschreibt. Wenn die Instanz beispielsweise von einem Ihrer Kunden verwaltet wird, Kunde A, geben Sie ein Instanz von Kunde A Im Feld Name. |
| 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 Prozessereignis für Ihre Instanz freigibt. Um die SYS-ID eines Datensatzes abzurufen, wählen Sie aus Kopieren Sie die sys_ID Über das Kontextmenü ( |
| Anwendung | Wird automatisch auf Ihre aktuelle festgelegt Anwendungsbereich . |
| Domäne | Wenn sich Ihr Prozess auf eine bestimmte Domäne bezieht, wählen Sie eine andere Domäne als aus Global . Weitere Informationen finden Sie unter Domänentrennung für Service Provider . |
| Fehler-Subflow | Wählen Sie das Symbol „Suchen mit Liste“ ( |
| Verbindungsalias | Wählen Sie das Symbol „Suchen mit Liste“ ( |
| Ausgehender Status | Auf festlegen Deaktiviert Standardmäßig. Sie können den Wert dieses Felds in ändern Aktiv Indem Sie auswählen Validieren und aktivieren Sie das Remote-System Zugehöriger Link in der Formularansicht dieses Remote-System-Datensatzes, nachdem Sie die Erstellung des Datensatzes abgeschlossen haben. |
| Eingehender API-Anwender | Anwender, der eine Verbindung zur Remote-Instanz herstellen kann. Dieser Anwender muss über Anmeldeinformationen verfügen, die denen des Anwenders mit der Rolle „ih_Process_Sync_api“ in der Remote-Instanz entsprechen. |
| Eingehende Flows ausführen als | Wählen Sie das Symbol „Suchen mit Liste“ ( |
| Eingehender Status | Auf festlegen Deaktiviert Standardmäßig. Sie können den Wert dieses Felds in ändern Aktiv Indem Sie auswählen Validieren und aktivieren Sie das Remote-System Zugehöriger Link in der Formularansicht dieses Remote-System-Datensatzes, nachdem Sie die Erstellung des Datensatzes abgeschlossen haben. |
Nachdem Sie einen Prozess-Ereignis-Datensatz und einen Remote-System-Datensatz erstellt haben, können Sie ihn zuordnen Workflow-Studio Subflows mit diesen Datensätzen, damit automatisierte Aktionen ausgeführt werden, wenn Ihre Prozesssynchronisierungsdefinition ausgelöst wird.
Ausgehende Flows Und ich Nbound-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 enthält die folgenden Felder:
| Feld | Beschreibung |
|---|---|
| Prozess-Ereignis | Wählen Sie das Symbol „Suchen mit Liste“ ( |
| Ausgehender Subflow | Wählen Sie das Symbol „Suchen mit Liste“ ( |
| Remotesystem | Wählen Sie das Symbol „Suchen mit Liste“ ( |
| Anwendung | Wird automatisch auf Ihre aktuelle festgelegt Anwendungsbereich . |
| Domäne | Wenn sich Ihr Prozess auf eine bestimmte Domäne bezieht, wählen Sie eine andere Domäne als aus Global . 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
- Prozessdaten, die von der Remote-Instanz an die lokale Instanz gesendet werden
Ein eingehender Flow-Datensatz enthält die folgenden Felder:
| Feld | Beschreibung |
|---|---|
| Prozess-Ereignis | Wählen Sie das Symbol „Suchen mit Liste“ ( |
| Eingehender Subflow | Wählen Sie das Symbol „Suchen mit Liste“ ( |
| Remotesystem | Wählen Sie das Symbol „Suchen mit Liste“ ( |
| Anwendung | Wird automatisch auf Ihre aktuelle festgelegt Anwendungsbereich . |
| Domäne | Wenn sich Ihr Prozess auf eine bestimmte Domäne bezieht, wählen Sie eine andere Domäne als aus Global . Weitere Informationen finden Sie unter Domänentrennung für Service Provider . |
Bevor Sie einfach die vom System bereitgestellte Remote-Prozesssynchronisierung für ausgehende Flow-Vorlage – Standard- oder Remote-Prozesssynchronisierung für eingehende Flow-Vorlage – Basis-Subflows für Ihre Prozesssynchronisierungsdefinition auswählen, sollten Sie diese Subflows in anpassen Workflow-Studio.
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 alle Anhänge senden.
- Anhangsmetadaten werden immer mit der ausgehenden Nutzlast gesendet. Diese Metadaten enthalten einen verschlüsselten synthetischen Schlüssel, einen Hash, einen Dateinamen, einen Inhaltstyp und eine verschlüsselte 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 erfolgt der folgende Prozess:
- Das Ursprungssystem validiert den Schlüssel und verschiebt 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 identifizieren können, welcher Anwender den Kommentar oder die Arbeitsnotiz erstellt hat und wann sie erstellt wurde.
Ausgehende Warteschlangen und eingehende Warteschlangen
Nachdem Sie Ihre Remote Process Sync-Integration erstellt haben, indem Sie die in den vorherigen Abschnitten genannten Datensätze erstellt und konfiguriert haben, können Sie Ihre Integration dann verwalten, indem Sie die ausgehende Warteschlange und die eingehende Warteschlange in Ihrer Instanz überwachen.
Ein Ausgehende Warteschlange Enthält 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 an.
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 aufgetreten ist |
| Fehlerinformationen | Statusnachricht für die ausgehende Nutzlast |
| Prozess-Ereignis | 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 |
Ein Eingehende Warteschlange Enthält den Status, die Verarbeitungssequenz 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 an.
Ein eingehender Warteschlangendatensatz enthält die folgenden Felder:
| Feld | Beschreibung |
|---|---|
| Sequenz | Reihenfolge in der Warteschlange. Eine niedrigere Zahl wird vor einer höheren Zahl verarbeitet. |
| Status | Verarbeitungsstatus der Nutzlast in der eingehenden Warteschlange. Verfügbare Optionen:
Hinweis: Wenn ein Datensatz der eingehenden Warteschlange einen Fehlerstatus hat, ändern Sie den Status in „bereit“, um die Verarbeitung der eingehenden Nutzlast erneut zu versuchen. |
| Prozess-Ereignis | Ereignis verarbeiten Ist der Integrationsaktion zugeordnet |
| Vorgang | Typ des Datensatzvorgangs, den die Remote-Instanz ausgeführt hat, wodurch die Remote-Instanz Daten ausgelöst und gesendet hat. 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-System Datensatz, 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 Fehlerbehebung Ihrer Integration
| Tabelle | Beschreibung |
|---|---|
| XML-Statistiken | Zeigen Sie an process_sync_queueAbschnitt mit Informationen zu den ausgehenden und eingehenden Warteschlangen für Ihre Integration, 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 von Datensätzen 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 festlegen glide.ih.process.sync.debugSystemeigenschaft zu Wahr . Scannen Sie dann die Protokolle nach Fehlermeldungen, die mit beginnen Outbound QueueDao Und Inbound QueueDao Um Protokollnachrichten mit weiteren Informationen zu potenziellen Problemen mit Ihrer Integration zu finden. |
- Verbindungsfehler
- Fehler bei ausgehenden Verbindungen Versuchen Sie es automatisch mehrmals, bevor Sie den ausgehenden Status des Remote-Systemdatensatzes auf „Fehler“ festlegen. Wenn bei einer ausgehenden Verbindung weiterhin Fehler auftreten, vergewissern Sie sich, dass sich am eingehenden API-Anwender des Remote-Systems nichts geändert hat, z. B. eine Änderung der Anmeldeinformationen des Anwenders. Validieren und aktivieren Sie dann den Remote-System-Datensatz erneut.
- Datenverarbeitungsfehler
- Datenverarbeitungsfehler treten normalerweise als Folge von Fehlern in einem ausgehenden Flow oder eingehenden Flow auf. Zur Behebung dieser Fehler können Sie Ihrem Flow Fehlerbehandlungsaktionen hinzufügen, z. B. eine Aktion „Protokoll“ oder „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“ erneut verarbeiten oder überspringen, wenn ein Fehler im Flow auftritt.