ServiceNow-Verbindung

Einführung

Eine ServiceNow-Verbindung, die mit dem ServiceNow-Connector erstellt wurde, ermöglicht den Zugriff auf ServiceNow. Sobald eine Verbindung konfiguriert ist, können Instanzen von ServiceNow-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind, um entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet zu werden.

Erstellen oder Bearbeiten einer ServiceNow-Verbindung

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

• Die Registerkarte Projektendpunkte und -connectoren der Designkomponentenpalette (siehe Designkomponentenpalette).
• Die Seite Globale Endpunkte (siehe Erstellen eines globalen Endpunkts in Globalen Endpunkten).

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

• Die Registerkarte Projektendpunkte und -connectoren der Designkomponentenpalette (siehe Designkomponentenpalette).
• Die Registerkarte Komponenten im Projektbereich (siehe Aktionsmenü für Komponenten in Projektbereich Komponenten-Registerkarte).
• Die Seite Globale Endpunkte (siehe Bearbeiten eines globalen Endpunkts in Globalen Endpunkten).

Konfigurieren einer ServiceNow-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die ServiceNow-Verbindung wird im Folgenden beschrieben.

• Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede ServiceNow-Verbindung einzigartig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch verwendet, um den ServiceNow-Endpunkt zu identifizieren, der sich sowohl auf eine spezifische Verbindung als auch auf deren Aktivitäten bezieht.

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

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

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

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

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

• Erweiterte Konfigurationen: Wenn ausgewählt, wird die Tabelle Eigenschaften der erweiterten Konfigurationen angezeigt, die verwendet wird, um zusätzliche Konfigurationseigenschaften als Schlüssel-Wert-Paare hinzuzufügen. Klicken Sie auf das Hinzufügen-Icon , um eine Zeile in der Tabelle unten hinzuzufügen und ein Schlüssel-Wert-Paar für jede Eigenschaft einzugeben.

  Um die Zeile zu speichern, klicken Sie auf das Symbol zum Übermitteln 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 Erweiterte Konfigurationsparameter zeigen das Symbol für Variablen nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit befüllt werden, muss die Agenten-Version mindestens 10.75 / 11.13 sein.

  Felder in der Tabelle Erweiterte Konfigurationsparameter unterstützen nicht die Verwendung von Variablen, um rohes JSON zu übergeben. Wenn Ihr Anwendungsfall nicht unterstützt, rohes JSON direkt in den Feldern zu definieren, entkommen Sie den JSON-Inhalt, bevor Sie ihn mit einer Variablen übergeben. Zum Beispiel wird das Entkommen von {"success": "true"}; zu {\"success\": \"true\"};.

• 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 den Agenten in der Agentengruppe heruntergeladen, die mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.

• Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.

• Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.

• Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration 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 Nachricht fragt Sie, ob Sie die Verbindung löschen möchten.

OAuth-Verbindungen konfigurieren

Dieser Connector unterstützt eine Verbindung über OAuth, indem spezifische Konfigurationseigenschaften verwendet werden. Nachdem die erweiterte Konfigurationseigenschaft InitiateOAuth festgelegt wurde, können die erforderlichen Konfigurationen mit zusätzlichen Eigenschaften angegeben werden, wie unten beschrieben.

Für diesen Connector werden zwei Szenarien unterstützt. In beiden Szenarien müssen Sie ein Drittanbieter-Tool (wie Postman oder ein ähnliches Tool) verwenden, um das erforderliche Zugriffstoken oder die Tokens vom beteiligten Endpunkt zu erhalten. Beide Szenarien funktionieren nur für Einzelagentengruppen. Dies sind Agentengruppen, die aus einem einzelnen Agenten bestehen.

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

  Mit dieser Konfiguration geben Sie ein OAuth-Zugriffstoken an, das für einen festgelegten 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-Refresh-Token, um eine automatische Aktualisierung des Zugriffs zu ermöglichen.

  Mit dieser Konfiguration verwendet der Connector ein Refresh-Token, um ein neues Zugriffstoken zu erhalten, sobald das aktuelle Zugriffstoken abgelaufen ist. Dies ist im Allgemeinen die beste Methode zur Konfiguration von OAuth.

  Sie geben ein OAuth-Zugriffstoken und ein OAuth-Aktualisierungstoken an, wie es der jeweilige Endpunkt bestimmt. Sie konfigurieren den Connector, um diese Tokens zu verwenden, indem Sie diese Eigenschaften festlegen:

  Konfigurationseigenschaft	Wert
  InitiateOAuth	REFRESH
  OAuthAccessToken	Auf den Wert des OAuth-Zugriffstokens setzen, das vom Endpunkt erhalten wurde
  OAuthRefreshToken	Auf den Wert des OAuth-Aktualisierungstokens setzen, das vom Endpunkt erhalten wurde

Nächste Schritte

Nachdem eine ServiceNow-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfskanvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Palette der Entwurfskomponenten zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

• Abfrage: Ruft Datensätze von 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.