Skriptschritt

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 5 Minuten Lesedauer

    • Fügen Sie anwenderdefiniertes JavaScript hinzu, das in einer wiederverwendbaren Aktion ausgeführt werden soll. Während die meisten Core-Aktionen und -Schritte zu allgemeinen Anwendungsfällen passen, können Sie einen Skriptschritt erstellen, um ein Verhalten auszuführen, das von den Core-Schritten nicht zufrieden ist.

    Rollen und Verfügbarkeit

    Verfügbar als Workflow-StudioAktionsschritt. Anwender mit der Rolle „action_Designer“ können eine anwenderdefinierte Aktion mit einem oder mehreren Aktionsschritten erstellen.
    Hinweis:
    IntegrationHub Siehe Anforderung IntegrationHub Für Informationen zu IntegrationHubNutzung und Abonnements.

    Felder

    Der Skriptschritt enthält separate Eingabe- und Ausgabevariablen, mit denen Sie JavaScript-Daten zuordnen können Workflow-StudioDaten. Durch Definieren von Eingabe- und Ausgabevariablen innerhalb des Schritts können Sie definieren, was Workflow-StudioDaten sind in Ihrem Skript verfügbar und welche Skriptvariablen für andere Schritte in Ihrer Aktion verfügbar sind.

    Feld Beschreibung
    Erforderliche Laufzeit
    Die zur Unterstützung des Skripts erforderliche Laufzeitumgebung. Auswahlmöglichkeiten:
    • Instanz : Der Aktionsschritt führt das Skript aus der Instanz aus. Wählen Sie diese Option aus, wenn das Skript Zugriff auf benötigt ServiceNowAPI- oder Instanzdaten. Dies ist der Standardwert.
    • MID : Der Aktionsschritt führt das Skript vom MID-Server aus. Wählen Sie diese Option aus, wenn das Skript Zugriff auf benötigt MID-Server-Skriptdateien Und APIs. Wenn Sie diese Option auswählen, wird angezeigt Wählen Sie den MID-Server mit aus Feld.
    • Vanilla (Core-JavaScript) : Der Aktionsschritt führt das Skript entweder über die Instanz oder DEN MID-Server aus. Wählen Sie diese Option aus, wenn das Skript nur die Core-JavaScript-APIs und nicht die benötigt ServiceNowAPI- oder Instanzdaten.

    Die von Ihnen ausgewählte Laufzeit bestimmt die in angezeigten JavaScript-Objekte und -Methoden Kontextbezogene Hilfe .

    Hinweis:
    Dieses Feld ist nur sichtbar, wenn IntegrationHubIst aktiviert.
    MID-Server auswählen mithilfe von
    Geben Sie den zu verwendenden MID-Server-Auswahlprozess an. Auswahlmöglichkeiten:
    • Beliebiger MID . Das System führt den Aktionsschritt von einem verfügbaren MID-Server aus.
    • Verwenden Sie Den Verbindungsalias . Das System führt die Aktion mit dem von Ihnen angegebenen Verbindungsalias aus. Wenn Sie diese Option auswählen, wird angezeigt Verbindungsalias Feld.
    • Inline-Auswahl Verwenden . Das System führt die Aktion anhand der Verbindungsdetails aus, die Sie in der Aktion angeben. Wenn Sie diese Option auswählen, wird angezeigt Host , MID-Anwendung , Und Fähigkeiten Felder.
    Hinweis:
    Dieses Feld ist nur sichtbar, wenn IntegrationHubIst aktiviert, und Sie wählen aus MID Von Erforderliche Laufzeit .
    Verbindungsalias Alias-Datensatz für Verbindungen und Anmeldeinformationen, den das System zur Ausführung des Aktionsschritts verwendet. Anwender mit der Rolle „Flow_Designer“ oder „admin“ können einen zugehörigen Verbindungsdatensatz erstellen oder auswählen. Durch die Verwendung eines Alias müssen bei der Verwendung einer Aktion in mehreren Umgebungen nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfiguriert werden. Wenn sich die Verbindungsinformationen ändern, müssen Sie Ihre anwenderdefinierte Aktion nicht aktualisieren. Weitere Informationen zu Verbindungen und Anmeldeinformationen finden Sie unter Anmeldeinformationen, Verbindungen und Aliasse . Nur Aliasse des Verbindungstyps „Standard“ werden unterstützt.
    Hinweis:
    Dieses Feld ist nur sichtbar, wenn IntegrationHubIst aktiviert, und Sie wählen aus Verwenden Sie Den Verbindungsalias Von Wählen Sie den MID-Server mit aus .
    Host Der vollqualifizierte Domänenname des MID-Servers, auf dem das System den Aktionsschritt ausführt. Beispiel: mid-server.domain.com.
    Hinweis:
    Dieses Feld ist nur sichtbar, wenn IntegrationHubIst aktiviert, und Sie wählen aus Inline-Auswahl Verwenden Von Wählen Sie den MID-Server mit aus .
    MID-Auswahl Option zum Auswählen des spezifischen MID-Servers oder MID-Clusters.
    • MID-Server automatisch auswählen : Wählt den MID-Server automatisch aus.
    • Bestimmter MID-Server : Verwendet den von Ihnen ausgewählten MID-Server.
    • Bestimmter MID-Cluster : Verwendet den von Ihnen ausgewählten MID-Cluster.
    Dieses Feld ist verfügbar, wenn MID Ist aus der erforderlichen Laufzeitliste und ausgewählt Inline-Auswahl Verwenden Ist aus der Liste MID-Server auswählen mit ausgewählt.
    MID-Cluster Datenpille für den MID-Cluster, den Sie verwenden möchten. Dieses Feld ist verfügbar, wenn MID Ist aus der erforderlichen Laufzeitliste und ausgewählt Inline-Auswahl Verwenden Ist aus der Liste MID-Server auswählen mit ausgewählt.
    MID-Anwendung Geben Sie die Anwendung an, die der MID-Server unterstützen muss, um für die Auswahl berechtigt zu sein. Das System führt den Aktionsschritt von einem MID-Server aus, der die ausgewählte Anwendung unterstützt.Dieses Feld ist nur sichtbar, wenn IntegrationHubIst aktiviert, MID-Server automatisch auswählen Ist aus der MID-Auswahlliste ausgewählt, und Sie wählen aus Inline-Auswahl Verwenden Von Wählen Sie den MID-Server mit aus .
    Fähigkeiten Fähigkeiten der MID-ServerMuss unterstützen, um für die Auswahl berechtigt zu sein. Das System führt den Aktionsschritt von einem aus aus MID-ServerDas die ausgewählten Fähigkeiten unterstützt. Dieses Feld ist nur sichtbar, wenn IntegrationHubIst aktiviert, MID-Server automatisch auswählen Ist aus der MID-Auswahlliste ausgewählt, und Sie wählen aus Inline-Auswahl Verwenden Von Wählen Sie den MID-Server mit aus .
    Spezifischer MID-Server Datenpille des erforderlichen MID-Server. Dieses Feld ist nur sichtbar, wenn IntegrationHubIst aktiviert, Bestimmter MID-Server Ist aus der MID-Auswahlliste ausgewählt, und Sie wählen aus Inline-Auswahl Verwenden Von Wählen Sie den MID-Server mit aus .
    Eingabevariablen Name-Wert-Paare, die Daten aus der Aktion darstellen, sodass Sie Aktionseingaben und Daten aus anderen Schritten innerhalb eines Skripts verwenden können.
    Skript
    Skript, das innerhalb der Aktion ausgeführt wird. Um auf Eingabe- und Ausgabevariablen in Ihrem Skript zuzugreifen, verwenden Sie die globalen Objekte Eingaben Und Ausgaben . Beispiel: Eingaben.meine Variable .
    Hinweis:
    Eingabe- und Ausgabenamen des Skriptschritts dürfen keinen der folgenden reservierten Systemnamen enthalten:
    • sys_id
    • sys_created_by
    • sys_created_on
    • sys_updated_on
    • sys_updated_by
    • sys_mod_count
    Erstellen Sie im Allgemeinen keine Variable mit demselben Namen wie ein Systemfeld. Der Skriptschritt kann eine solche Eingabevariable für einen Feldnamen verwechseln und den falschen Wert verwenden.
    Der Skriptschritt konvertiert immer Daten, die in gespeichert sind Eingaben Und Ausgaben Globale Objekte in Zeichenfolgen. Wenn Ihr Skriptschritt mit JSON-Daten arbeiten muss, können Sie verwenden Eingaben Globales Objekt zum Konvertieren der JSON-Daten in eine Zeichenfolge. Alternativ können Sie eine JavaScript-Variable als Zeichenfolge und nicht als JavaScript-Objekt definieren. Dieses Skript veranschaulicht beispielsweise zwei Möglichkeiten, wie Sie JSON-Daten ausgeben können.
    (function execute(inputs, outputs) {
  outputs.json_object_1 = inputs.json_input;
  var array_of_objs = '[{"name1":"value1"}, {"id":"abcd"}]';
  outputs.json_object_2 = array_of_objs;
})(inputs, outputs);

    Standardmäßig Workflow-StudioFühren Sie Skripts auf der Instanz aus. Zum Ausführen eines Skripts von einem MID-Server ist ein erforderlich IntegrationHubAbonnement.

    Workflow-Studio Führt das Skript aus der Domäne aus, aus der es ausgelöst oder initiiert wird. Weitere Informationen finden Sie unter Domain Separation und Workflow-Studio.

    Verfügbare Klassen und Methoden finden Sie unter Kontextbezogene JavaScript-API-Hilfe Oder API reference.
    Ausgabevariablen JavaScript-Ausgabe zuordnen Workflow-StudioDatenpillen. Definieren Sie Ausgabevariablen, wenn andere Schritte in der Aktion die Skriptausgabe verwenden sollen.

    Auswertung des Aktionsfehlers

    Wenn dieser Schritt fehlschlägt
    Datentyp: Choice

    Option, um den nächsten Schritt fortzusetzen oder zur Fehlerauswertung zu wechseln. Informationen zur Verwendung des Schrittstatuscodes oder der Meldung für eine anwenderdefinierte Aktionsfehlerbedingung finden Sie unter Auswertung des Aktionsfehlers.

    Beispiel

    In diesem Beispiel wird eine JSON-Nutzlast erstellt, die einfach aktualisiert oder geändert und einem nachfolgenden REST-Schritt hinzugefügt werden kann.

    Hinweis:
    REST-Schritt Ist im Basissystem nicht verfügbar und erfordert ServiceNow® IntegrationHubAbonnement.

    Beispielskriptschritt in einer Aktion.

    Indem Sie eine Ausgabevariable erstellen, die die Nutzlast darstellt, können Sie ziehen [Nutzlast] Datenpille in den REST-Schritt Textkörper Feld.