Zum Inhalt springen

ServiceNow v2 (Beta) Update-Aktivität in Jitterbit Studio

Einführung

Eine ServiceNow v2 (Beta) Update-Aktivität verwendet ihre ServiceNow v2 (Beta)-Verbindung und aktualisiert vorhandene Datensätze in ServiceNow. Sie ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

Hinweis

Dieser Connector befindet sich derzeit in der Beta-Phase. Um Feedback zu geben, kontaktieren Sie das Jitterbit-Produktteam.

ServiceNow v2 (Beta) Update-Aktivität erstellen

Eine Instanz einer ServiceNow v2 (Beta) Update-Aktivität wird aus einer ServiceNow v2 (Beta)-Verbindung mit dem Aktivitätstyp Update erstellt.

Um eine Aktivitätsinstanz zu erstellen, ziehen Sie den Aktivitätstyp auf die Entwurfsfläche oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Entwurfsfläche ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

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

ServiceNow v2 (Beta) Update-Aktivität konfigurieren

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

Schritt 1: Namen eingeben und ServiceNow-Objekt auswählen

Geben Sie in diesem Schritt einen Namen für die Aktivität ein und wählen Sie ein ServiceNow-Objekt aus. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

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

    • Endpunkt bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den aktuellen Endpunktnamen bewegen. Klicken Sie, um die Verbindungskonfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

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

  • Objekt auswählen: Dieser Bereich zeigt Objekte an, die im ServiceNow v2 (Beta)-Endpunkt verfügbar sind.

    • Ausgewähltes Objekt: Nach der 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 mit jedem Tastendruck in Echtzeit gefiltert. Um Objekte vom Endpunkt beim Suchen neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann wie unten beschrieben.

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Objekte vom ServiceNow v2 (Beta)-Endpunkt neu zu laden. Dies kann nützlich sein, wenn Objekte zu ServiceNow hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten Objekttabelle verwendet werden.

    • 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 für jedes Objekt verfügbaren Informationen werden vom ServiceNow v2 (Beta)-Endpunkt abgerufen:

  • Name: Der Objektname aus ServiceNow.

    -   **Description:** Die Objektbeschreibung aus ServiceNow.

    Tipp

    Falls die Tabelle nicht mit verfügbaren Objekten gefüllt wird, ist die ServiceNow v2 (Beta) Verbindung möglicherweise nicht erfolgreich hergestellt worden. Stelle sicher, dass du verbunden bist, indem du die Verbindung erneut öffnest und die Anmeldedaten erneut testest.

  • Optional settings: Klicke, um zusätzliche optionale Einstellungen zu erweitern:

    • Use HTTP verb PUT: Wähle diese Option, um PUT statt PATCH (Standard) für die Update-Anfrage zu verwenden.

      • PUT ersetzt gesamte Objektdatensätze durch die für das Update bereitgestellten Daten. Wenn ein Feld vom PUT-Update ausgeschlossen wird, wird der Feldwert des Objektdatensatzes in ServiceNow auf null oder einen definierten Standardwert gesetzt. Aufgrund dieses Verhaltens müssen alle erforderlichen Felder für ein Objekt im Update enthalten sein.
      • PATCH ersetzt Objektdatensätze feldweise, was Teilupdates ermöglicht. Wenn ein Feld vom PATCH-Update ausgeschlossen wird, bleibt der Feldwert des Objektdatensatzes in ServiceNow unverändert.

    • Continue on error: Wähle 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 protokolliert.

  • Save & Exit: Falls aktiviert, klicke, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Next: Klicke, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn du auf der letzten Seite auf die Schaltfläche Finished klickst.

  • Discard changes: Klicke nach Änderungen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert dich auf zu bestätigen, dass du die Änderungen verwerfen möchtest.

Step 2: Review the data schemas

Alle Request- oder Response-Schemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

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

    Hinweis

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

    Der ServiceNow v2 (Beta) Connector verwendet die ServiceNow REST API. Weitere Informationen zu den Schema-Knoten und Feldern findest du in der API-Dokumentation.

  • Refresh: Klicke auf das Aktualisierungssymbol oder das Wort Refresh, um Schemas vom ServiceNow v2 (Beta) Endpunkt neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im Projekt neu, an denen auf das gleiche Schema verwiesen wird, z. B. in einer angrenzenden Transformation.

  • Back: Klicke, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

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

  • Discard changes: Klicke nach Änderungen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert dich auf zu bestätigen, dass du die Änderungen verwerfen möchtest.

Next steps

Wichtig

Datetime-Felder der ServiceNow v2 (Beta) Aktivität müssen ihren Datentyp auf string gesetzt haben, um ihre Daten in Transformationen zu bewahren. Dazu spiegelst du das Schema in der Transformation, bearbeitest es und änderst den Datentyp aller dateTime Felder in string.

Falsch formatierte Datetime-Daten melden Erfolg mit einem Fehler, erstellen oder aktualisieren aber den ServiceNow-Objektdatensatz nicht. Die zurückgegebene Fehlermeldung gibt das falsche Datumsformat nicht als Ursache an.

Jeder Datensatz, der an eine ServiceNow v2 (Beta) Update Aktivität übermittelt wird, muss auch einen gültigen sys_id Wert enthalten. Wenn sys_id für einen Datensatz fehlt, null ist, leer ist oder nur Leerzeichen enthält, schlägt dieser Datensatz mit einem Fehler fehl, der besagt, dass kein gültiger Wert für die sys_id Eigenschaft bereitgestellt wurde.

Nach der Konfiguration einer ServiceNow v2 (Beta) Update Aktivität schließt du die Konfiguration der Operation ab, indem du weitere Aktivitäten, Transformationen oder Skripte als Operationsschritte hinzufügst und konfigurierst. Du kannst 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 über den Projektbereich und die Design-Canvas zugänglich. Weitere Informationen finden Sie unter Aktivitätsaktionsmenü in Connector-Grundlagen.

ServiceNow v2 (Beta) Update-Aktivitäten können als Ziel mit diesen Operationsmustern verwendet werden:

Um die Aktivität mit Scripting-Funktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort dann in der Scripting-Funktion.

Wenn Sie bereit sind, stellen Sie die Operation bereit und führen Sie sie aus und validieren Sie das Verhalten, indem Sie die Operationsprotokolle überprüfen.