Zum Inhalt springen

ServiceNow (Veraltet) Update-Aktivität in Jitterbit Studio

Warnung

Der ServiceNow-Connector ist veraltet und wird nicht mehr unterstützt. In einer zukünftigen Version wird diese Aktivität zusammen mit dem Rest des Connectors dauerhaft entfernt. Verwenden Sie stattdessen die Update-Aktivität im ServiceNow v2-Connector.

Einführung

Eine ServiceNow-Update-Aktivität verwendet ihre ServiceNow-Verbindung zum Aktualisieren vorhandener Datensätze in ServiceNow und ist dazu gedacht, als Ziel zum Verarbeiten von Daten in einem Vorgang verwendet zu werden.

Hinweis

Vorgänge, die eine ServiceNow-Update-Aktivität verwenden, schreiben alle Datensätze in die Vorgangsprotokolle, unabhängig davon, ob Werte in ServiceNow akzeptiert werden. Inakzeptable Werte werden durch den Standardwert des Felds ersetzt, bei dem es sich in einigen Fällen um Nullwerte handeln kann.

ServiceNow Update-Aktivität erstellen

Eine Instanz einer ServiceNow-Update-Aktivität wird aus einer ServiceNow-Verbindung mit ihrem Aktivitätstyp Update erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Einzelheiten finden Sie unter Erstellen einer Aktivitäts- oder Tool-Instanz unter Komponentenwiederverwendung.

Eine vorhandene ServiceNow-Update-Aktivität kann von diesen Orten aus bearbeitet werden:

ServiceNow Update-Aktivität konfigurieren

Führen Sie diese Schritte aus, um eine ServiceNow-Update-Aktivität zu konfigurieren:

Schritt 1: Name eingeben und Objekt auswählen

Geben Sie in diesem Schritt einen Namen für die Aktivität ein und wählen Sie ein Objekt aus. Alle Elemente der Benutzeroberfläche dieses Schritts werden nachstehend beschrieben.

  • Endpoint-Menü: Wenn mehrere Endpoints desselben Connector-Typs konfiguriert sind, wird oben im Bildschirm ein Menü mit dem aktuellen Endpoint-Namen angezeigt. Klicken Sie auf das Menü, um zu einem anderen Endpoint zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpoint ändern unter Konfigurationsbildschirme.

    • Endpoint bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den aktuellen Endpoint-Namen bewegen. Klicken Sie, um die Verbindungskonfiguration des derzeit ausgewählten Endpoints zu bearbeiten.

  • Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede ServiceNow-Update-Aktivität eindeutig sein und darf weder Schrägstriche / noch Doppelpunkte : enthalten.

  • Objekt auswählen: In diesem Bereich werden im ServiceNow-Endpoint verfügbare Objekte angezeigt.

    • Ausgewähltes ServiceNow-Objekt: Nach Auswahl eines Objekts wird es hier aufgelistet.

    • Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Objekte zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet. Wenn Objekte bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse bei jedem Tastenanschlag in Echtzeit gefiltert. Um Objekte vom Endpoint zu laden, wenn Sie suchen, geben Sie Suchkriterien ein und aktualisieren Sie dann wie unten beschrieben.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Objekte vom ServiceNow-Endpoint neu zu laden. Dies kann hilfreich sein, wenn Objekte zu ServiceNow hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der angezeigten Objekttabelle verwendet werden.

  • Ein Objekt auswählen: Klicken Sie in der Tabelle auf eine beliebige Stelle in einer Zeile, um ein Objekt auszuwählen. Es kann nur ein Objekt ausgewählt werden. Die verfügbaren Informationen für jedes Objekt werden vom ServiceNow-Endpoint abgerufen:

    • Name: Der Objektname aus ServiceNow.

    • Beschreibung: Die Objektbeschreibung aus ServiceNow.

Tipp

Wenn die Tabelle nicht mit verfügbaren Objekten gefüllt wird, ist die ServiceNow-Verbindung möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldedaten erneut testen.

  • Bei Fehler fortfahren: Aktivieren Sie diese Option, um die Aktivitätsausführung fortzusetzen, wenn bei einem Datensatz in einer Batch-Anfrage ein Fehler auftritt. Falls Fehler auftreten, werden diese im Operationsprotokoll geschrieben. Standardmäßig ist diese Einstellung deaktiviert.

  • Speichern & Beenden: Falls aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf der letzten Stufe auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Nachricht bittet Sie zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Datenschemas überprüfen

Alle Anfrage- oder Antwortschemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

  • Datenschemas: Diese Datenschemas werden von angrenzenden Transformationen geerbt und werden während der Transformationszuordnung erneut angezeigt.

    Der ServiceNow-Connector verwendet die ServiceNow REST-API. Weitere Informationen zu den Schemafeldern finden Sie unter Schemas und in der ServiceNow REST-API unter ServiceNow Developer-Dokumentation. Passen Sie die Dokumentations-URL an, indem Sie Ihre ServiceNow-Releaseversion auswählen.

    Hinweis

    Daten, die in einer Transformation bereitgestellt werden, haben Vorrang vor der Aktivitätskonfiguration.

    Tabellennamen mit dem Präfix sys_ werden so umbenannt, dass sie mit system_ beginnen, um reservierte ServiceNow-Namen zu vermeiden.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Schemas vom Endpoint neu zu generieren. Diese Aktion regeneriert auch ein Schema an anderen Stellen im Projekt, an denen auf das gleiche Schema verwiesen wird, z. B. in einer angrenzenden Transformation.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Nachricht bittet Sie zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Wichtig

ServiceNow-Aktivitätsdatumsfelder müssen ihren Datentyp auf string setzen, um ihre Daten in Transformationen zu bewahren. Dazu spiegeln Sie das Schema in der Transformation, bearbeiten es und ändern den Datentyp aller dateTime-Felder in string.

Darüber hinaus werden falsch formatierte Zeitdaten mit einem Fehler als erfolgreich gemeldet, aber das ServiceNow-Objekt-Datensatz wird nicht erstellt oder aktualisiert. Die zurückgegebene Fehlermeldung meldet das falsche Datumsformat nicht als Ursache.

Komplettieren Sie nach dem Konfigurieren einer ServiceNow-Aktivität vom Typ Update die Konfiguration der Operation, indem Sie andere Aktivitäten oder Tools als Operationsschritte hinzufügen und konfigurieren. Sie können auch die Operationseinstellungen konfigurieren, die die Möglichkeit bieten, Operationen zu verketten, die sich in denselben oder verschiedenen Workflows befinden.

Menüaktionen für eine Aktivität sind im Projektbereich und auf der Designoberfläche zugänglich. Details finden Sie unter Aktivitätsaktionsmenü in Connector-Grundlagen.

ServiceNow Update-Aktivitäten können als Ziel mit diesen Operationsmuster verwendet werden:

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Ort und verwenden Sie diesen temporären Ort dann in der Skriptfunktion.

Wenn alles bereit ist, stellen Sie die Operation bereit und führen Sie sie aus und überprüfen Sie das Verhalten durch Überprüfung der Operationsprotokolle.