Mit ServiceNow verbinden

Konzept-Informationen

ACCESSDATA-Befehl

ServiceNow ist ein Cloud-Anbieter von Lösungen zur IT-Dienstverwaltung, IT-Vorgangsverwaltung und dem IT-Unternehmensmanagement. Verwenden Sie den ServiceNow-Datenkonnektor, um die ServiceNow-Daten Ihres Unternehmens zu importieren.

Hinweis

Sie können diesen Konnektor ohne Analytics nicht verwenden. Sie können einen DSN für den Konnektortreiber mit dem ODBC-Datenquellenadministrator von Windows konfigurieren. Sie müssen die DSN-Verbindung aber innerhalb von Analytics und nicht aus dem Dialogfeld des Konnektors zur Windows-DSN-Konfiguration heraus testen.

Vorbereitungen

Für eine Verbindung mit ServiceNow müssen Sie die folgenden Informationen einholen:

  • das sich verbindende Benutzerkonto, einschließlich Benutzername und Kennwort
  • die Instanz, aus der Tabellen abgerufen werden sollen
  • die Anmeldeinformationen (Client-ID und der geheime Clientschlüssel (Client-Geheimnis)), die Ihnen bei der Registrierung einer Anwendung von ServiceNows OAuth-Autorisierungsserver zugeteilt wurden

    Tipp

    Weitere Informationen über die Registrierung einer Anwendung und den Erhalt von OAuth-Anmeldeinformationen erhalten Sie durch die Suche nach „OAuth einrichten“ in der ServiceNow-Dokumentation.

Hilfe für die Zusammenstellung der Verbindungsvoraussetzungen erhalten Sie vom ServiceNow-Administrator Ihrer Organisation. Falls Ihr Administrator Ihnen nicht weiterhelfen kann, sollten Sie oder Ihr Administrator den ServiceNow-Support kontaktieren.

ServiceNow-Verbindung erstellen

  1. Wählen Sie aus dem Analytics-Hauptmenü Importieren > Datenbank und Anwendung.
  2. Auf der Registerkarte Neue Verbindungen im Abschnitt ACL-Konnektoren wählen Sie ServiceNow.

    Tipp

    Sie können die Liste verfügbarer Konnektoren filtern, indem Sie in das Feld Verbindungen filtern eine Suchzeichenfolge eingeben. Die Konnektoren sind alphabetisch aufgelistet.

  3. Im Bereich Datenverbindungseinstellungen rufen Sie die Verbindungseinstellungen auf und klicken unten innerhalb des Bereichs auf Speichern und verbinden.

    Sie können den standardmäßigen Verbindungsnamen akzeptieren oder einen neuen Namen eingeben.

Die Verbindung für ServiceNow wird in der Registerkarte Bestehende Verbindungen gespeichert. In Zukunft können Sie sich über die gespeicherte Verbindung erneut mit ServiceNow verbinden.

Sobald die Verbindung hergestellt ist, wird das Fenster „Datenzugriff“ im Stagingbereich geöffnet und Sie können den Datenimport beginnen. Hilfe für den Datenimport aus ServiceNow finden Sie unter Mit dem Fenster „Datenzugriff“ arbeiten.

Verbindungseinstellungen

Grundlegende Einstellungen

Einstellung Beschreibung Beispiel
Benutzer Das Benutzerkonto, das zur Authentifizierung an ServiceNow verwendet wird. admin_1
Kennwort

Das Kennwort, das zur Authentifizierung des Benutzers verwendet wird.

  
Vorkommen

Die ServiceNow-Instanz, aus der Tabellen abgerufen werden sollen.

 staging16387
OAuth-Client-Kennung

Die Client-ID, die Ihnen bei der Registrierung Ihrer Anwendung von ServiceNows OAuth-Autorisierungsserver zugeteilt wurde.

Im Rahmen von OAuth müssen Sie Ihre Anwendung registrieren. Während der Registrierung erhalten Sie eine Client-Kennung, die manchmal auch als Verbraucherschlüssel bezeichnet wird, sowie einen geheimen Clientschlüssel (Client-Geheimnis). Sie müssen für die Verbindung beide angeben.

 356a825803610300ef0662490d237522
OAuth-Client-Geheimnis

Der Clientschlüssel (Client-Geheimnis), der Ihnen bei der Registrierung Ihrer Anwendung von ServiceNows OAuth-Autorisierungsserver zugeteilt wurde.

Im Rahmen von OAuth müssen Sie Ihre Anwendung registrieren. Während der Registrierung erhalten Sie eine Client-Kennung sowie einen geheimen Clientschlüssel (Client-Geheimnis), der manchmal auch als Verbrauchergeheimnis bezeichnet wird. Sie müssen für die Verbindung beide angeben.

 secretTest

Erweiterte Einstellungen

Einstellung Beschreibung Beispiel
Datumzeit auf GMT konvertieren

Konvertiert während des Importierens Datumzeit-Felder auf die GMT-Zeitzone. Falls der Wert auf „falsch“ eingestellt ist, werden Datumzeit-Werte auf die Zeitzone des Betriebssystems für den Computer konvertiert, auf dem Analytics ausgeführt wird.

Hinweis

Wenn Sie diese Option wählen, verlangen alle Filter, die Sie auf Datumzeit-Felder mit dem Operator ON (=) anwenden, dass Sie den Formatspezifizierer „Z“ bei der Eingabe von Datumzeit-Werten innerhalb der Filterbedingung verwenden: 2017-01-01 12:38:54Z.

 wahr
Grenze der Schlüsselgröße

Die maximale Länge einer Primärschlüsselspalte. Wenn die Größe auf „0“ eingestellt wird, wird die ursprüngliche Schlüssellänge wiederhergestellt.

Durch diese Eigenschaft überschreibt der Konnektor die gemeldete Länge aller Primärschlüsselspalten.

 255
Long Varchar zuordnen

Kontrolliert, ob eine Spalte als SQL_LONGVARCHAR zurückgegeben wird.

Verwenden Sie diese Einstellung, um alle Spalten über einer bestimmten Größe so zuzuordnen, dass sie als SQL_LONGVARCHAR statt SQL_VARCHAR gemeldet werden.

 -1
WVarchar zuordnen

Kontrolliert, ob Zeichenfolgentypen als SQL_WVARCHAR statt SQL_VARCHAR zugeordnet werden. Standardmäßig ist diese Option aktiviert.

Zeichenfolgenspalten müssen SQL_WVARCHAR zugeordnet sein, um unterschiedliche internationale Zeichensätze zu unterstützen. „WVarchar zuordnen“ ist daher standardmäßig auf „wahr“ eingestellt. Sie können es auf „falsch“ setzen, wenn Sie stattdessen SQL_VARCHAR verwenden möchten.

 wahr
Pseudospalten

Gibt an, ob Pseudospalten der Tabelle ebenfalls als Spalten hinzugefügt werden sollen.

Diese Einstellung ist besonders im Entity Framework hilfreich, das Ihnen nicht ermöglicht, einen Wert für eine Pseudospalte anzugeben, solange sie keine Tabellenspalte ist.

Der Wert dieser Verbindungseinstellung hat das Format „Tabelle1=Spalte1, Tabelle1=Spalte2, Tabelle2=Spalte3“. Sie können das „*“-Zeichen verwenden, um alle Tabellen und alle Spalten einzuschließen.

 MeineTabelle=*
SSL-Serverzertifikat

Das durch den Server bei einer Verbindung mit TLS/SSL zu akzeptierende Zertifikat. Sie können die folgenden Einstellungen festlegen:

  • vollständiges PEM-Zertifikat
  • Pfad zu einer lokalen Datei, die das Zertifikat enthält
  • der öffentliche Schlüssel
  • der MD5-Fingerabdruck (Hexadezimalwerte können auch entweder durch Leerzeichen oder Doppelpunkte getrennt werden)
  • der SHA1-Fingerabdruck (Hexadezimalwerte können auch entweder durch Leerzeichen oder Doppelpunkte getrennt werden)

Wenn Sie eine TLS/SSL-Verbindung verwenden, kann diese Eigenschaft verwendet werden, um das TLS/SSL-Zertifikat festzulegen, das durch den Server akzeptiert wird. Andere Zertifikate, denen der Computer nicht vertraut, werden abgelehnt.

 C:\cert.cer
Authentifizierung für Proxy

Der Authentifizierungstyp, der für die Authentifizierung mit dem unter „Proxy-Server“ angegebenen Proxy zu verwenden ist.

Dieser Wert legt den Authentifizierungstyp fest, der für die Authentifizierung mit dem HTTP-Proxy (angegeben durch „Proxy-Server“ und „Proxy-Port“) zu verwenden ist.

Hinweis

Der Konnektor wird standardmäßig die Proxy-Einstellungen des Systems verwenden, sodass keine weitere Konfiguration notwendig ist. Wenn Sie sich mit einem anderen Proxy verbinden möchten, müssen Sie zusätzlich zur Angabe von „Proxy-Server“ und „Proxy-Port“ den Wert von „Autom. Proxy-Erkennung“ auf „falsch“ setzen. Zur Authentifizierung stellen Sie „Authentifizierung für Proxy“ ein und geben bei Bedarf „Proxy-Benutzer“ und „Proxy-Kennwort“ an.

Es gibt folgende Authentifizierungstypen:

  • BASIC Der Treiber führt eine HTTP-Standardauthentifizierung durch.
  • DIGEST Der Treiber führt eine HTTP-DIGEST-Authentifizierung durch.
  • NEGOTIATE In Abhängigkeit vom zutreffenden Authentifizierungsprotokoll ruft der Treiber einen NTLM- oder Kerberos-Token ab.
  • PROPRIETARY Der Treiber generiert keinen NTLM- oder Kerberos-Token. Sie müssen diesen Token im Autorisierungskopf der HTTP-Anforderung angeben.
 BASIC
Autom. Proxy-Erkennung Gibt an, ob die Proxy-Einstellungen des Systems verwendet werden sollen. Stellen Sie „Autom. Proxy-Erkennung“ auf FALSE ein, falls Sie benutzerdefinierte Proxy-Einstellungen verwenden möchten. Dies hat Vorrang gegenüber anderen Proxy-Einstellungen. wahr
Proxy-Benutzer

Ein Benutzername kann für die Authentifizierung mit dem unter „Proxy-Server“ angegebenen Proxy verwendet werden.

Die Optionen „Proxy-Benutzer“ und „Proxy-Kennwort“ werden verwendet, um eine Verbindung mit dem unter „Proxy-Server“ angegebenen HTTP-Proxy aufzunehmen und die Authentifizierung durchzuführen.

Sie können eine der verfügbaren Authentifizierungsarten unter „Authentifizierung für Proxy“ angeben. Wenn Sie eine HTTP-Authentifizierung verwenden, geben Sie den Benutzernamen eines Benutzers an, der durch den HTTP-Proxy erkannt wird. Falls Sie eine Windows- oder Kerberos-Authentifizierung verwenden, geben Sie in dieser Eigenschaft einen Benutzernamen in einem der folgenden Formate ein:

  • benutzer@domäne
  • Domäne\Benutzer
 karl_mustermann@beispiel.de
Proxy-Kennwort

Ein Kennwort kann für die Authentifizierung mit dem unter „Proxy-Server“ angegebenen Proxy verwendet werden.

Diese Eigenschaft wird für eine Authentifizierung an einem HTTP-Proxy-Server verwendet, der eine NTLM- (Windows), Kerberos- oder HTTP-Authentifizierung unterstützt. Um den HTTP-Proxy festzulegen, können Sie „Proxy-Server“ und „Proxy-Port“ einstellen. Zur Festlegung der Authentifizierung stellen Sie „Authentifizierung für Proxy“ ein.

Falls Sie eine HTTP-Authentifizierung nutzen, geben Sie zusätzlich den „Proxy-Benutzer“ und das „Proxy-Kennwort“ für den HTTP-Proxy an.

Wenn Sie eine NTLM-Authentifizierung verwenden, stellen Sie „Proxy-Benutzer“ ein und geben in „Proxy-Kennwort“ Ihr Windows-Kennwort an. Dies kann auch notwendig sein, wenn Sie die Kerberos-Authentifizierung abschließen.

  
Proxy-Server

Der Hostname oder die IP-Adresse eines Proxy, durch den der HTTP-Datenverkehr geleitet werden soll.

Der Hostname oder die IP-Adresse eines Proxy, durch den der HTTP-Datenverkehr geleitet werden soll. Der Treiber kann für die Authentifizierung an einem HTTP-Proxy die Authentifizierungsarten HTTP, Windows (NTLM) oder Kerberos verwenden.

Standardmäßig verwendet der Treiber den System-Proxy. Wenn Sie einen anderen Proxy nutzen müssen, legen Sie „Autom. Proxy-Erkennung“ ebenfalls auf „falsch“ fest.

 206.174.193.115
Proxy-Port Der TCP-Port, den der unter „Proxy-Server“ angegebene Proxy verwendet. 80
Proxy-SSL-Typ

Der SSL-Typ, der für die Verbindung mit dem unter „Proxy-Server“ angegebenen Proxy zu verwenden ist.

  • AUTO Wenn die URL eine HTTPS-URL ist, wird der Konnektor die TUNNEL-Option verwenden. Wenn die URL eine HTTP-URL ist, wird der Konnektor die NEVER-Option nutzen (Standard).
  • ALWAYS Für die Verbindung ist stets SSL aktiviert.
  • NEVER Für die Verbindung ist SSL nicht aktiviert.
  • TUNNEL Die Verbindung erfolgt durch einen Tunneling-Proxy: Der Proxy-Server öffnet eine Verbindung mit dem Remote-Host und der Datenverkehr fließt durch den Proxy.
 AUTO

Updates von Datenkonnektoren

Wenn Sie Analytics, den Robots-Agent oder AX Server aktualisieren, sollten Sie Ihre Skripts für Datenimporte mit einem der Analytics-Datenkonnektoren (Befehl ACCESSDATA) testen.

Es besteht die Möglichkeit, dass Änderungen eines Drittanbieters von Datenquellen oder eines Herstellers von ODBC-Treibern Aktualisierungen eines oder mehrerer Datenkonnektoren erfordert. Über Skripts hergestellte Datenverbindungen müssen unter Umständen aktualisiert werden, um nach wie vor ordnungsgemäß zu arbeiten.

  • Import erneut durchführen Die einfachste Möglichkeit, eine Verbindung zu aktualisieren, ist die manuelle Durchführung eines Imports mit dem Fenster „Datenzugriff“ der aktualisierten Version von Analytics. Kopieren Sie den Befehl ACCESSDATA aus dem Protokoll, und verwenden Sie ihn zur Aktualisierung Ihres Skripts.

    Hinweis

    Bevor Sie sich mit einer Datenquelle verbinden und den Import erneut ausführen, löschen Sie den Cache des Konnektors, um bestehende Tabellennamen zu entfernen.

    In der Registerkarte Bestehende Verbindungen des Fensters „Datenzugriff“ wählen Sie  > Cache löschen.

  • Feldspezifikationen aktualisieren Unter Umständen müssen Sie auch Feldspezifikationen im Skriptkörper aktualisieren, um die Änderungen des Tabellenschemas in der Datenquelle oder dem ODBC-Treiber anzupassen. Mögliche Änderungen beinhalten Feldnamen, Datentypen von Feldern sowie Feld- und Datensatzlängen.
  • Ergebnisse von Filtern überprüfen Sie sollten auch Ergebnisse von Filtern überprüfen, die Sie im Rahmen des Datenimports nutzen. Stellen Sie sicher, dass der Importfilter Datensätze ordnungsgemäß ein- und ausschließt.

Änderungen des ServiceNow-Datenkonnektors

Spezifische Änderungen des ServiceNow-Datenkonnektors sind im Folgenden aufgelistet.

Analytics-Version Ändern

14.2

Datumsfelder von ServiceNow werden nun im ServiceNow-Datenkonnektor einem Datumsdatentyp mit dem Format JJJ-MM-TT und einer Länge von zehn Zeichen zugeordnet.

Zuvor wurden Datumsfelder von ServiceNow im ServiceNow-Datenkonnektor einem Datumzeit-Datentyp mit dem Format JJJ-MM-TT hh:mm:ss und einer Länge von 19 Zeichen zugeordnet. Der Zeitanteil der importierten Daten war dabei leer und wies den Wert 00:00:00 auf.