ServiceNow (veraltet) Verbindung in Jitterbit Studio

Einführung

Eine ServiceNow Verbindung, erstellt mit dem ServiceNow Connector, stellt Zugriff auf ServiceNow her. Nach der Konfiguration einer Verbindung können Sie Instanzen von ServiceNow Aktivitäten erstellen, die mit dieser Verbindung verknüpft sind und entweder als Quellen (um Daten in einer Operation bereitzustellen) oder als Ziele (um Daten in einer Operation zu verarbeiten) verwendet werden.

ServiceNow Verbindung erstellen oder bearbeiten

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

• Die Registerkarte Project endpoints and connectors der Design-Komponentenpalette (siehe Design-Komponentenpalette).
• Die Seite Global Endpoints (siehe Globalen Endpoint erstellen in Global Endpoints).

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

• Die Registerkarte Project endpoints and connectors der Design-Komponentenpalette (siehe Design-Komponentenpalette).
• Die Registerkarte Components des Projektbereichs (siehe Kontextmenü für Komponentenaktionen in Registerkarte „Components" des Projektbereichs).
• Die Seite Global Endpoints (siehe Globalen Endpoint bearbeiten in Global Endpoints).

ServiceNow Verbindung konfigurieren

Im Folgenden wird jedes Benutzeroberflächenelement des ServiceNow Verbindungskonfigurationsbildschirms beschrieben.

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

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

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

• Username: Geben Sie den Benutzernamen für die ServiceNow Instanz ein. Siehe ServiceNow Voraussetzungen für Details.

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

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

• Erweiterte Konfigurationen: Nach Auswahl wird die Tabelle Advanced Configurations Properties angezeigt, mit der sich zusätzliche Konfigurationseigenschaften als Schlüssel-Wert-Paare hinzufügen lassen. Klicken Sie auf das Hinzufügen-Symbol , um der Tabelle unten eine Zeile hinzuzufügen, und geben Sie für jede Eigenschaft ein Schlüssel-Wert-Paar ein.

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

  Um eine einzelne Zeile zu bearbeiten oder zu löschen, fahren Sie mit der Maus über die Spalte ganz rechts und verwenden Sie das Bearbeitungs-Symbol oder das Lösch-Symbol .

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

  Wichtig

  Felder in der Tabelle Advanced Configurations Properties zeigen das Variablen-Symbol nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit gefüllt werden, muss die Agent-Version mindestens 10.75 / 11.13 sein.

  Felder in der Tabelle Advanced Configurations Properties unterstützen die Verwendung von Variablen nicht, um rohes JSON zu übergeben. Wenn Ihr Anwendungsfall das direkte Definieren von rohem JSON in den Feldern nicht unterstützt, maskieren Sie den JSON-Inhalt, bevor Sie ihn mit einer Variablen übergeben. Beispielsweise wird das Maskieren von {"success": "true"}; zu {\"success\": \"true\"};.

• Test: Klicken Sie hier, um die Verbindung anhand der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von dem/den Agent(s) in der Agent-Gruppe heruntergeladen, die der aktuellen Umgebung zugeordnet ist. Dieser Connector unterstützt die Unterbrechung des Downloads der neuesten Connector-Version durch die Verwendung der Organisationsrichtlinie Disable Auto Connector Update.

• Speichern: Klicken Sie, um die Verbindungskonfiguration zu speichern und zu schließen.

• Änderungen verwerfen: Nach Änderungen an einer neuen oder vorhandenen Konfiguration klicken Sie hier, um die Konfiguration ohne zu speichern zu schließen. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

• Löschen: Nach dem Öffnen einer vorhandenen Verbindungskonfiguration klicken Sie hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Verbindung löschen möchten.

OAuth-Verbindungen konfigurieren

Dieser Connector unterstützt eine Verbindung mit OAuth durch die Verwendung spezifischer Konfigurationseigenschaften. Nach Angabe der erweiterten Konfigurationseigenschaft InitiateOAuth können Sie die erforderliche Konfiguration mit zusätzlichen Eigenschaften angeben, wie nachfolgend beschrieben.

Für diesen Connector werden zwei Szenarien unterstützt. In beiden Szenarien müssen Sie ein Tool eines Drittanbieters (z. B. Postman oder ein ähnliches Tool) verwenden, um das erforderliche Zugriff-Token oder die erforderlichen Zugriff-Tokens vom beteiligten Endpunkt zu erhalten. Beide Szenarien funktionieren nur für einzelne Agent-Gruppen. Dies sind Agent-Gruppen, die aus einem einzelnen Agent bestehen.

• Szenario 1: Verwendung eines OAuth-Zugriff-Tokens, das nach einem bestimmten Zeitraum abläuft.

  Mit dieser Konfiguration stellen Sie ein OAuth-Zugriff-Token zur Verfügung, das für einen bestimmten Zeitraum gültig ist, der vom jeweiligen Endpunkt bestimmt wird. Der Connector verwendet das Token, um die Verbindung herzustellen. Die Verbindung funktioniert jedoch nicht mehr, sobald das Zugriff-Token abläuft. Sie würden den Connector so konfigurieren, dass er das Token verwendet, indem Sie diese Eigenschaften festlegen:

  Konfigurationseigenschaft	Wert
  InitiateOAuth	OFF
  OAuthAccessToken	Legen Sie den Wert des vom Endpunkt erhaltenen OAuth-Zugriff-Tokens fest

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

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

  Sie stellen ein OAuth-Zugriffstoken und ein OAuth-Aktualisierungstoken bereit, wie vom jeweiligen Endpunkt vorgegeben. Sie konfigurieren den Connector so, dass diese Token verwendet werden, indem Sie diese Eigenschaften festlegen:

  Konfigurationseigenschaft	Wert
  InitiateOAuth	REFRESH
  OAuthAccessToken	Auf den Wert des vom Endpunkt erhaltenen OAuth-Zugriffstokens setzen
  OAuthRefreshToken	Auf den Wert des vom Endpunkt erhaltenen OAuth-Aktualisierungstokens setzen

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 (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu verarbeiten) verwendet werden.

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

Diese Aktivitätstypen sind verfügbar:

• Query: Ruft Datensätze von ServiceNow ab und ist als Quelle in einem Vorgang gedacht.

• Create: Erstellt neue Datensätze in ServiceNow und ist als Ziel in einem Vorgang gedacht.

• Update: Aktualisiert vorhandene Datensätze in ServiceNow und ist als Ziel in einem Vorgang gedacht.

• Delete: Löscht vorhandene Datensätze aus ServiceNow und ist als Ziel in einem Vorgang gedacht.