Problembehandlung bei serviceNow-Erfassung

Von Bedeutung

Der ServiceNow-Connector befindet sich in der öffentlichen Vorschau.

Auf dieser Seite werden häufige Probleme mit dem ServiceNow-Connector in Databricks Lakeflow Connect und deren Lösung beschrieben.

Allgemeine Pipeline-Problembehandlung

Wenn eine Pipeline beim Ausführen fehlschlägt, klicken Sie auf den Fehlgeschlagenen Schritt, und bestätigen Sie, ob die Fehlermeldung ausreichende Informationen zur Art des Fehlers bereitstellt.

Sie können die Clusterprotokolle auch auf der Seite mit den Pipelinedetails überprüfen und herunterladen, indem Sie im rechten Bereich auf "Details aktualisieren" und dann auf "Protokolle" klicken. Überprüfen Sie die Protokolle auf Fehler oder Ausnahmen.

Die Aufnahme einer bestimmten Tabelle ist langsam.

Arbeiten Sie als erster Schritt mit Ihrem ServiceNow-Administrator zusammen, um die Indizierung in der Cursorspalte zu aktivieren. Die Cursorspalte wird aus der folgenden Liste ausgewählt, in der Reihenfolge der Voreinstellung: sys_updated_on (erste Auswahl), sys_created_on (zweite Auswahl), sys_archived (dritte Auswahl). Wiederholen Sie dann die Aufnahmepipeline. Wenn das Problem weiterhin besteht, erstellen Sie ein Ticket. Anweisungen zum Aktivieren der Indizierung in ServiceNow finden Sie in der ServiceNow-Dokumentation.

Authentifizierungsfehler

Fehler:

com.databricks.pipelines.execution.conduit.common.DataConnectorException: [SERVICENOW_CONNECTION_ERROR.OAUTH_TOKEN_EXCHANGE] Failed to authenticate to ServiceNow. This can be caused by issues with your UC credentials, ServiceNow OAuth setup, and more...

Schritt 1:

Vergewissern Sie sich, dass Sie beim Erstellen der Unity-Katalogverbindung den richtigen Benutzernamen, das Kennwort, die Client-ID und den geheimen Clientschlüssel angegeben haben. Der Benutzername und das Kennwort für die Authentifizierung bei ServiceNow sind nicht unbedingt Ihr persönlicher Benutzername und Ihr Kennwort für SSO. ** Dies sind die Benutzername und Kennwort Werte, die einem Benutzer zugeordnet sind, der zur Authentifizierung und Integration mit externen Diensten genutzt wird.

Katalog-Explorer

1. Klicken Sie in der Randleiste des Azure Databricks-Arbeitsbereichs auf das Katalog.

2. Klicken Sie oben im Katalogbereich auf das , und wählen Sie im Menü "Verbindungen" aus.

   Alternativ können Sie auf der Seite " Schnellzugriff " auf die Schaltfläche " Externe Daten > " klicken und zur Registerkarte "Verbindungen " wechseln.

3. Klicken Sie auf den Namen der Verbindung.

   Verbindungsdetails werden auf der Registerkarte "Übersicht " aufgeführt.

cURL

Führen Sie die folgende curl-Anforderung aus. Ersetzen Sie die Elemente in Klammern durch Ihre Verbindungseigenschaften.

curl -X POST "https://<instance-id>.service-now.com/oauth_token.do" \
--header "Content-Type: application/x-www-form-urlencoded" \
--data-urlencode "grant_type=password" \
--data-urlencode "client_id=<client-id>" \
--data-urlencode "client_secret=<client-secret>" \
--data-urlencode "username=<username>" \
--data-urlencode "password=<password>"

Wenn die Anforderung erfolgreich ist, sind die Anmeldeinformationen korrekt.

Schritt 2:

Vergewissern Sie sich, dass der authentifizierende Benutzer über die admin Rolle verfügt. Databricks empfiehlt außerdem, dass der authentifizierende Benutzer über die snc_read_only Rolle verfügt, die Berechtigungen weiter einzuschränken.

Schritt 3:

Vergewissern Sie sich, dass der authentifizierende Benutzer als aktiv markiert ist:

1. Klicken Sie in ServiceNow auf "Organisationsbenutzer > ".

2. Wählen Sie den Benutzer aus, den Sie für die Authentifizierung verwenden möchten.

3. Vergewissern Sie sich, dass das Kontrollkästchen "Aktiv " aktiviert ist.

   

Schritt 4:

Vergewissern Sie sich, dass das OAuth 2.0-Plug-In in ServiceNow aktiv ist:

1. Klicken Sie in ServiceNow auf Systemdefinitions-Plug-Ins>.

2. Führen Sie das folgende Skript im Abschnitt "Skripts - Hintergrund" aus:

   var oauthActive = gs.getProperty('com.snc.platform.security.oauth.is.active');
   gs.info('OAuth Active: ' + oauthActive);
   

   Wenn das Skript zurückgegeben wird true, war die Plug-In-Installation erfolgreich. Wenn dieses Skript zurückgegeben wird false, deinstallieren Sie es, und installieren Sie es dann erneut.

   

Schritt 5:

Vergewissern Sie sich, dass der OAuth-Endpunkt ordnungsgemäß konfiguriert ist:

1. Besuchen Sie in ServiceNow die System OAuth > Application Registry.

2. Klicken Sie in der oberen rechten Ecke auf "NEU".

3. Klicken Sie in den OAuth-Anwendungsoptionen auf "OAuth-API-Endpunkt erstellen" für externe Clients.

   

4. Vergewissern Sie sich, dass das Kontrollkästchen "Aktiv " aktiviert ist.

   

   Nachdem Sie die OAuth-Anwendung erfolgreich erstellt haben, wird sie in der Liste in der System OAuth-Anwendungsregistrierung > mit dem Typ OAuth-Client angezeigt.

Schritt 6:

Wenn das Problem weiterhin auftritt, nachdem Sie diese Schritte zur Problembehandlung ausgeführt haben, geben Sie ein Supportticket ein.