Zum Inhalt springen

ServiceNow Create-Aktivität in Jitterbit Studio

Einführung

Eine ServiceNow Create-Aktivität erstellt mit ihrer ServiceNow-Verbindung neue Datensätze in ServiceNow und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

Hinweis

Vorgänge, die eine ServiceNow Create-Aktivität verwenden, schreiben alle Datensätze in die Vorgangsprotokolle, unabhängig davon, ob Werte in ServiceNow akzeptiert werden. Nicht akzeptable Werte werden durch den Standardwert des Feldes ersetzt, was in einigen Fällen Nullwerte sein kann.

ServiceNow Create-Aktivität erstellen

Eine Instanz einer ServiceNow Create-Aktivität wird aus einer ServiceNow-Verbindung mit ihrem Create-Aktivitätstyp 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. Weitere Informationen finden Sie unter Aktivitäts- oder Tool-Instanz erstellen in Komponentenwiederverwendung.

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

ServiceNow Create-Aktivität konfigurieren

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

Schritt 1: Namen 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. 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 Create-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Objekt auswählen: Dieser Bereich zeigt im ServiceNow-Endpunkt verfügbare Objekte an.

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

    • Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Objektliste zu filtern. Die Suche ist nicht case-sensitiv. 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 nachfolgend beschrieben.

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Objekte vom ServiceNow-Endpunkt neu zu laden. Dies kann hilfreich 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-Endpunkt 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: Wählen 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 in das Operationsprotokoll geschrieben. Standardmäßig ist diese Einstellung deaktiviert.

  • Speichern und beenden: Wenn 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 die Schaltfläche Fertig im letzten Schritt 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 Meldung fordert Sie auf 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 nachfolgend 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 umbenannt, um mit system_ zu beginnen, um reservierte ServiceNow-Namen zu vermeiden.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemas vom ServiceNow-Endpunkt neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im Projekt neu, an denen auf dasselbe 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 Meldung fordert Sie auf 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. Spiegeln Sie dazu das Schema in der Transformation, bearbeiten Sie es und ändern Sie den Datentyp aller dateTime-Felder in string.

Darüber hinaus werden falsch formatierte Datetime-Daten mit Erfolg und Fehler gemeldet, aber es wird nicht möglich sein, den ServiceNow-Objektdatensatz zu erstellen oder zu aktualisieren. Die zurückgegebene Fehlermeldung meldet das falsche Datumsformat nicht als Ursache.

Nach der Konfiguration einer ServiceNow-Aktivität vom Typ Erstellen schließen Sie die Konfiguration der Operation ab, indem Sie weitere 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 über den Projektbereich und die Designoberfläche zugänglich. Weitere Informationen finden Sie unter Menü „Aktivitätsaktionen" in Connector-Grundlagen.

ServiceNow Create Aktivitäten können als Ziel mit diesen Operationsmustern verwendet werden:

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort 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 Kontrolle der Operationsprotokolle.