Zum Inhalt springen

ServiceNow Verbindung

Einführung

Eine ServiceNow Verbindung, die mit dem ServiceNow Connector erstellt wurde, stellt den Zugriff auf ServiceNow her. Sobald eine Verbindung konfiguriert ist, können Sie Instanzen von ServiceNow-Aktivitäten erstellen, die mit dieser Verbindung verknüpft sind und entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden können.

Notiz

Bevor Sie eine ServiceNow Verbindung konfigurieren, lesen Sie die ServiceNow Voraussetzungen, um sicherzustellen, dass die ServiceNow Instanz richtig konfiguriert wurde.

Hinweis

Dieser Connector unterstützt die Organisationsrichtlinie Erneute Authentifizierung bei Änderung aktivieren. Wenn aktiviert, müssen Benutzer bei einer Änderung der Client-ID, des Benutzernamens oder der Instanz in dieser Verbindung das Client-Geheimnis und das Passwort für die Verbindung erneut eingeben.

Erstellen oder Bearbeiten einer ServiceNow Verbindung

Eine neue ServiceNow-Verbindung wird mit dem ServiceNow Connector von einem dieser Standorte aus erstellt:

Eine vorhandene ServiceNow Verbindung kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer ServiceNow Verbindung

Jedes Benutzeroberflächenelement des ServiceNow Verbindungskonfigurationsbildschirms wird unten beschrieben.

ServiceNow Verbindungskonfiguration

Tipp

Felder mit variablem Symbol Unterstützung der Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit einer öffnenden eckigen Klammer [ in das Feld oder durch Klicken auf das Variablensymbol, um eine Liste der vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Verbindungsname: Geben Sie einen Namen ein, der zur Identifizierung der Verbindung verwendet werden soll. Der Name muss für jede ServiceNow-Verbindung eindeutig sein und darf keine Schrägstriche enthalten / oder Doppelpunkte :. Dieser Name wird auch verwendet, um den ServiceNow Endpoint zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf ihre Aktivitäten bezieht.

  • Client-ID: Geben Sie die Client-ID für die ServiceNow Instanz ein. Siehe ServiceNow-Voraussetzungen für weitere Einzelheiten.

  • Client Secret: Geben Sie das Client Secret für die ServiceNow-Instanz ein. Siehe ServiceNow-Voraussetzungen für weitere Einzelheiten.

  • Benutzername: Geben Sie den Benutzernamen für die ServiceNow Instanz ein. Siehe ServiceNow-Voraussetzungen für weitere Einzelheiten.

  • Passwort: Geben Sie das Passwort für die ServiceNow Instanz ein. Siehe ServiceNow Voraussetzungen für weitere Einzelheiten.

  • Instanz: Geben Sie die URL der ServiceNow Instanz ein, beispielsweise https://example.service-now.com/.

  • Erweiterte Konfigurationen: Wenn ausgewählt, wird die Tabelle Erweiterte Konfigurationseigenschaften angezeigt, die zum Hinzufügen zusätzlicher Konfigurationseigenschaften verwendet wird als Key-Value Paare. Klicken Sie auf das Symbol „Hinzufügen“ Symbol „Hinzufügen“, um der folgenden Tabelle eine Zeile hinzuzufügen und für jede Eigenschaft ein Key-Value Paar einzugeben.

    Um die Zeile zu speichern, klicken Sie auf das Senden-Symbol Senden-Symbol in der Spalte ganz rechts.

    Um eine einzelne Zeile zu bearbeiten oder zu löschen, bewegen Sie den Mauszeiger über die Spalte ganz rechts und verwenden Sie das Bearbeitungssymbol Bearbeitungssymbol oder Löschsymbol Löschsymbol.

    Um alle Zeilen zu löschen, klicken Sie auf Alles löschen.

  • Test: Klicken Sie hier, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die der aktuellen Umfeld zugeordnet ist. Dieser Connector unterstützt das Anhalten des Downloads der neuesten Connector-Version mithilfe der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.

  • Änderungen speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen an einer neuen oder vorhandenen Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

  • Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Verbindungskonfiguration hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen). Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Verbindung löschen möchten.

Konfigurieren von OAuth-Verbindungen

Dieser Connector unterstützt eine Verbindung über OAuth durch die Verwendung bestimmter Konfigurationseigenschaften. Nachdem Sie die erweiterte Konfigurationseigenschaft InitiateOAuth angegeben haben, können Sie die erforderliche Konfiguration mithilfe zusätzlicher Eigenschaften angeben, wie unten beschrieben.

Notiz

Um die OAuth-Authentifizierung erfolgreich abzuschließen, sind möglicherweise zusätzliche IDs, Geheimnisse, Bereiche und andere Authentifizierungstoken erforderlich. Weitere Informationen zu den Anforderungen finden Sie in der Endpoint.

Für diesen Connector werden zwei Szenarien unterstützt. In beiden Szenarien müssen Sie ein Drittpartei verwenden (z. B. Postman oder ein ähnliches Tool), um das oder die erforderlichen Zugriffstoken vom betreffenden Endpoint abzurufen. Beide Szenarien funktionieren nur für Einzelagentengruppen. Dabei handelt es sich um Agentengruppen, die aus einem einzelnen Agenten bestehen.

  • Szenario 1: Verwenden eines OAuth-Zugriffstokens, das nach einer festgelegten Zeit abläuft.

    Mit dieser Konfiguration geben Sie ein OAuth-Zugriffstoken an, das für einen festgelegten Zeitraum gültig ist, der vom jeweiligen Endpoint bestimmt wird. Der Connector verwendet das Token, um die Verbindung herzustellen. Die Verbindung funktioniert jedoch nicht mehr, sobald das Zugriffstoken abläuft. Sie konfigurieren den Connector für die Verwendung des Tokens, indem Sie diese Eigenschaften festlegen:

    Konfigurationseigenschaft Wert
    OAuth initiieren OFF
    OAuthAccessToken Auf den Wert des vom Endpoint erhaltenen OAuth-Zugriffstokens eingestellt

  • Szenario 2: Verwenden eines OAuth-Zugriffstokens in Kombination mit einem OAuth-Aktualisierungstoken, um die automatische Aktualisierung des Zugriffs zu ermöglichen.

    Mit dieser Konfiguration verwendet der Connector ein Aktualisierungstoken, um ein neues Zugriffstoken zu erhalten, sobald das aktuelle Zugriffstoken abgelaufen ist. Dies ist im Allgemeinen die beste Methode zum Konfigurieren von OAuth.

    Sie geben ein OAuth-Zugriffstoken und ein OAuth-Aktualisierungstoken an, je nach dem jeweiligen Endpoint. Sie konfigurieren den Connector für die Verwendung dieser Token, indem Sie die folgenden Eigenschaften festlegen:

    Konfigurationseigenschaft Wert
    OAuth initiieren REFRESH
    OAuthAccessToken Auf den Wert des vom Endpoint erhaltenen OAuth-Zugriffstokens gesetzt
    OAuthRefreshToken Auf den Wert des vom Endpoint erhaltenen OAuth-Aktualisierungstokens eingestellt

Nächste Schritte

Nachdem eine ServiceNow-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Design-Canvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden können.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Design-Komponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

  • Abfrage: Ruft Datensätze von ServiceNow ab und soll als Quelle in einem Operation verwendet werden.

  • Erstellen: Erstellt neue Datensätze bei ServiceNow und soll als Ziel in einem Operation verwendet werden.

  • Aktualisieren: Aktualisiert vorhandene Datensätze bei ServiceNow und soll als Ziel in einem Operation verwendet werden.

  • Löschen: Löscht vorhandene Datensätze aus ServiceNow und soll als Ziel in einem Operation verwendet werden.