ServiceNow-Verbindung in Jitterbit Studio

Einführung

Eine ServiceNow-Verbindung, die mit dem ServiceNow-Connector erstellt wird, stellt den Zugriff auf ServiceNow her. Nach der Konfiguration einer Verbindung können Sie ServiceNow-Aktivitäten erstellen, die dieser Verbindung zugeordnet sind und entweder als Quellen (zur Bereitstellung von Daten in einem Vorgang) oder als Ziele (zur Verarbeitung von Daten in einem Vorgang) verwendet werden.

ServiceNow-Verbindung erstellen oder bearbeiten

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

• Die Registerkarte Projektendpunkte und Connectors der Designkomponentenpalette (siehe Designkomponentenpalette).
• Die Seite Globale Endpunkte (siehe Globalen Endpunkt erstellen in Globale Endpunkte).

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

• Die Registerkarte Projektendpunkte und Connectors der Designkomponentenpalette (siehe Designkomponentenpalette).
• Die Registerkarte Komponenten des Projektbereichs (siehe Menü „Komponentenaktionen" in Registerkarte „Komponenten" des Projektbereichs).
• Die Seite Globale Endpunkte (siehe Globalen Endpunkt bearbeiten in Globale Endpunkte).

ServiceNow-Verbindung konfigurieren

Im Folgenden wird jedes Benutzeroberflächenelement des Konfigurationsbildschirms der ServiceNow-Verbindung beschrieben.

• Verbindungsname: 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 zur Identifizierung des ServiceNow-Endpunkts verwendet, der sich auf eine bestimmte Verbindung und ihre Aktivitäten bezieht.

• Client-ID: Geben Sie die Client-ID für die ServiceNow-Instanz ein. Weitere Informationen finden Sie unter ServiceNow-Voraussetzungen.

• Client-Geheimnis: Geben Sie das Client-Geheimnis für die ServiceNow-Instanz ein. Weitere Informationen finden Sie unter ServiceNow-Voraussetzungen.

• Benutzername: Geben Sie den Benutzernamen für die ServiceNow-Instanz ein. Weitere Informationen finden Sie unter ServiceNow-Voraussetzungen.

• Passwort: Geben Sie das Passwort für die ServiceNow-Instanz ein. Weitere Informationen finden Sie unter ServiceNow-Voraussetzungen.

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

• Erweiterte Konfigurationen: Wenn diese Option aktiviert ist, wird die Tabelle Eigenschaften für erweiterte Konfigurationen angezeigt, mit der Sie zusätzliche Konfigurationseigenschaften als Schlüssel-Wert-Paare hinzufügen können. Klicken Sie auf das Hinzufügungssymbol , um eine Zeile in der folgenden Tabelle 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ätigungssymbol in der rechten Spalte.

  Um eine einzelne Zeile zu bearbeiten oder zu löschen, fahren Sie mit der Maus über die rechte Spalte und verwenden Sie das Bearbeitungssymbol oder das Löschsymbol .

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

  Wichtig

  Felder in der Tabelle Eigenschaften für erweiterte Konfigurationen zeigen das Variablensymbol 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 Eigenschaften für erweiterte Konfigurationen unterstützen nicht die Verwendung von Variablen zum Übergeben von Raw JSON. Wenn Ihr Anwendungsfall das direkte Definieren von Raw JSON in den Feldern nicht unterstützt, maskieren Sie den JSON-Inhalt, bevor Sie ihn mit einer Variablen übergeben. Beispielsweise wird {"success": "true"}; zu {\"success\": \"true\"}; maskiert.

• Test: Klicken Sie, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von dem/den Agent(en) in der Agent-Gruppe heruntergeladen, die der aktuellen Umgebung zugeordnet ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.

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

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

• Löschen: Nachdem Sie eine vorhandene Verbindungskonfiguration geöffnet haben, klicken Sie, 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 der 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 Drittanbieter-Tool (z. B. Postman oder ein ähnliches Tool) verwenden, um das erforderliche Zugriffstoken oder die erforderlichen Zugriffstokens vom betreffenden 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-Zugriffstokens, das nach einem bestimmten Zeitraum abläuft.

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

  Konfigurationseigenschaft	Wert
  InitiateOAuth	OFF
  OAuthAccessToken	Auf den Wert des vom Endpunkt erhaltenen OAuth-Zugriffstokens setzen

• 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 zur Konfiguration von OAuth.

  Sie stellen ein OAuth-Zugriffstoken und ein OAuth-Aktualisierungstoken bereit, wie vom jeweiligen Endpunkt bestimmt. Sie würden den Connector zur Verwendung dieser Tokens konfigurieren, 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

Nach dem Erstellen einer ServiceNow-Verbindung 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. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

• Abfrage: Ruft Datensätze aus ServiceNow ab und ist als Quelle in einem Vorgang vorgesehen.

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

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

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