Zum Inhalt springen

ServiceNow (Veraltet) – Create-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 restlichen Connector endgültig entfernt. Verwenden Sie stattdessen die Create-Aktivität im ServiceNow v2 Connector.

Einführung

Eine ServiceNow Create-Aktivität erstellt mit ihrer ServiceNow-Verbindung neue Datensätze in ServiceNow und wird als Ziel für die Datennutzung in einem Prozess verwendet.

Hinweis

Prozesse, die eine ServiceNow Create-Aktivität verwenden, schreiben alle Datensätze in die Prozessprotokolle, unabhängig davon, ob Werte in ServiceNow akzeptiert werden. Dabei werden nicht akzeptable Werte durch den Standardwert des Feldes ersetzt, was in einigen Fällen null-Werte sein können.

ServiceNow Create-Aktivität erstellen

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

Eine vorhandene ServiceNow Create-Aktivität kann von diesen Orten 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. Die einzelnen Benutzeroberflächenelemente dieses Schritts werden nachstehend beschrieben.

  • Endpunkt-Menü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, zeigt ein Menü oben auf dem Bildschirm den Namen des aktuellen Endpunkts an. 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 Namen des aktuellen Endpunkts 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: In diesem Bereich werden Objekte angezeigt, die im ServiceNow-Endpunkt verfügbar sind.

    • 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. Die Suche berücksichtigt keine Groß- und Kleinschreibung. Wenn Objekte bereits in der Tabelle angezeigt werden, wird das Tabellenergebnis mit jedem Tastendruck in Echtzeit gefiltert. Um Objekte vom Endpunkt bei der Suche neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann wie nachstehend beschrieben.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf 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.

  • 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-Endpunkt abgerufen:

    • Name: Der Objektname von ServiceNow.

    • Beschreibung: Die Objektbeschreibung von ServiceNow.

Tipp

Wenn die Tabelle sich nicht mit verfügbaren Objekten füllt, 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 Dataset in einer Batchanfrage ein Fehler auftritt. Falls Fehler auftreten, werden diese in das Operationsprotokoll geschrieben. Standardmäßig ist diese Einstellung nicht aktiviert.

  • 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 der letzten Seite 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 Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Datenblueprints überprüfen

Es werden alle Anforderungs- oder Antwortblueprints angezeigt. Jedes Benutzeroberflächenelement dieses Schritts ist unten beschrieben.

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

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

    Hinweis

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

    Tabellennamen mit dem Präfix sys_ werden in Namen mit dem Präfix system_ umbenannt, um reservierte Namen von ServiceNow zu vermeiden.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Blueprints vom ServiceNow-Endpunkt neu zu generieren. Diese Aktion generiert auch einen Blueprint an anderen Stellen im Projekt neu, an denen auf denselben Blueprint 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

Datumszeitfelder der ServiceNow-Aktivität müssen ihren Datentyp auf string gesetzt haben, um ihre Daten in Transformationen zu erhalten. Spiegeln Sie dazu das Blueprint in der Transformation, bearbeiten Sie es und ändern Sie den Datentyp aller dateTime-Felder in string.

Darüber hinaus werden falsch formatierte Datumszeitdaten mit Erfolg gemeldet, führen aber nicht zu einem Fehler, erstellen oder aktualisieren aber den ServiceNow-Objektdatensatz nicht. Die zurückgegebene Fehlermeldung meldet das falsche Datumsformat nicht als Ursache.

Vervollständigen Sie nach der Konfiguration einer ServiceNow-Aktivität vom Typ Erstellen die Konfiguration des Vorgangs durch Hinzufügen und Konfigurieren anderer Aktivitäten oder Tools als Vorgangsschritte. Sie können auch die Vorgangseinstellungen konfigurieren, zu denen die Möglichkeit gehört, Vorgänge 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-Create-Aktivitäten können als Ziel mit diesen Operationsmuster verwendet werden:

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

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