Skriptunterstützung für komplexe Daten

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 4 Minuten Lesedauer

    • Erstellen und referenzieren Sie komplexe Daten aus einem Skript. Verwenden Sie ein Skript, wenn Ihre Quelldaten aus einem Datenstrom, einer REST-Schritt-Antwort oder einem Schritt „Datensätze suchen“ stammen.

    Verwenden Sie ein Skript, um komplexe Daten zu erstellen, wenn Daten aus diesen Quellen stammen.

    Tabelle : 1. Datenquellen, die ein Skript erfordern
    Datenquelle Erstellen/ordnen Sie komplexe Daten aus zu
    Antwortstream der Datenstromaktion Schritt „Skript-Parser“
    REST-Schrittantwort Skriptschritt
    Schritt „Datensätze nachschlagen“

    Antwortstream der Datenstromaktion

    Datenstromaktionen verwenden ein Parser-Skript, um Stream-Elementwerte komplexen Objektwerten zuzuordnen. Verwenden Sie beim Schreiben eines Parser-Skripts JavaScript-Methoden, die dem Datenstromformat entsprechen. Verwenden Sie beispielsweise JSON: Bereichsbezogen Klasse zum Analysieren oder Codieren eines JSON-Datenstroms.

    Parser-Skripts haben Zugriff auf die Eingabe- und Ausgabeobjekte des Datenstroms sowie eine targetObject-Eigenschaft. Siehe Datenstromaktionen Weitere Informationen zum Analysieren eines Antwortstroms zum Erstellen komplexer Daten.

    REST-Schrittantwort

    Sie können eine REST-Schritt-Antwort in ein oder mehrere komplexe Objekte konvertieren, indem Sie sie mit einem Skriptschritt analysieren. Um über einen Skriptschritt auf eine Antwort zuzugreifen, müssen Sie eine Eingabeskriptvariable erstellen und der Antwortnutzlast aus dem vorherigen REST-Schritt zuordnen. Siehe Skriptschritt Weitere Informationen zum Erstellen von Skripteingabevariablen.

    Schreiben Sie ein Skript, das REST-Antwortwerte komplexen Objektwerten zuordnet. Verwenden Sie beim Schreiben eines REST-Antwortskripts JavaScript-Methoden, die dem Antwortformat entsprechen, z. B. die JSON-Parse()-Methode.

    Hinweis:
    Wenn Sie komplexe Daten als Quelle einer Zeichenfolgeneingabe verwenden, Workflow-Studio Konvertiert sie automatisch in eine JSON-Zeichenfolge.

    Sie müssen keinen Skriptschritt verwenden, um eine REST-Anforderung aus komplexen Daten zu erstellen. Sie können komplexe Daten in einer vorherigen Aktion oder einem vorherigen Schritt generieren und sie dann einer Zeichenfolgeneingabe des REST-Schritts zuordnen. Zur Laufzeit konvertiert die Aktion oder der Flow die komplexen Daten in eine JSON-Darstellung.

    Sehen Sie sich beispielsweise die in verwendeten Skriptschritte an Erste Schritte mit dynamischen Eingaben Für die Datenerfassungsaktionen. Die Datenerfassungsaktionen zum Abrufen von Tabellen- und Feldnamen verwenden einen Skriptschritt, um eine REST-Antwort in einem JSON-Objekt zu analysieren. Beide Datenerfassungsaktionen erstellen auch Ausgabevariablen, die komplexe Daten als JSON-Objekte speichern.

    Schritt „Datensätze nachschlagen“

    Während Flows verwenden können Für jeden Flow-Logik zur Verarbeitung einer Liste von Datensätzen erfordern Aktionen einen Skriptschritt. Der Skriptschritt ersetzt Für jeden Flow-Logik mit JavaScript, z. B. Für Oder Während Schleife.

    Um über einen Skriptschritt auf Datensatzdaten zuzugreifen, müssen Sie eine Eingabeskriptvariable erstellen und sie den Datensatzdaten aus dem vorherigen Suchschritt zuordnen. Siehe Skriptschritt Weitere Informationen zum Erstellen von Skripteingabevariablen.

    Siehe Erstellen Sie eine anwenderdefinierte Aktion, um ein Array von Objekten aus einer Liste von Datensätzen zu generieren Für eine Beispielaktion, die eine Liste von Anwenderdatensätzen in ein Array von Kontaktobjekten konvertiert.

    Hinweis:
    Die Aktion „Datensätze suchen“ erfordert keinen Skriptschritt, um Datensatzdaten in komplexe Daten zu konvertieren. Sie können eine anwenderdefinierte Aktion erstellen, um einen Datensatz in ein Objekt zu konvertieren und anzuwenden Für jeden Flow-Logik zur anwenderdefinierten Aktion. Siehe Erstellen Sie eine anwenderdefinierte Aktion, um ein Objekt aus einem Datensatz zu generieren Und Erstellen Sie einen anwenderdefinierten Flow, um ein Objekt für jeden Datensatz in einer Liste zu generieren Ein Beispiel für das Erstellen eines komplexen Objekts ohne Verwendung eines Skripts.

    DOT-Walking-Objektstrukturen

    Sie können Elemente aus der Struktur eines Objekts referenzieren, indem Sie den Pfad der Struktur durch Dot-Walking durchlaufen. Alle komplexen Datenpfade beginnen mit dem Namen der Datenquelle, die entweder das globale Objekt für Eingaben, das globale Objekt für Ausgaben oder der Name des Arrays oder Objekts ist, das Sie im Skript erstellt haben.

    Als Nächstes im Pfad befinden sich die Namen jedes strukturellen Elements, auf das verwiesen wird, getrennt durch Punktzahlen (auch als Punkte bezeichnet). Das Auflisten der Namen struktureller Elemente ist identisch mit dem Dot-Walking in einem Referenzfeld, in dem Sie die Tabellenstruktur für ein bestimmtes Referenzfeld auflisten.

    Hinweis:
    Ein Dot-Walk-Pfad listet immer den Namen eines strukturellen Elements und nicht seine Bezeichnung auf.

    Angenommen, Sie definieren ein Kontaktobjekt als Ausgabevariable. Das Objekt hat die folgende Struktur.

    Abbildung : 1. Beispiel für ein Kontaktobjekt
    Eine Skriptschritt-Ausgabevariable, die ein komplexes Objekt für Kontakt enthält.
    In Struktur platzieren Bezeichnung Name Typ
    Übergeordnet Kontakt Kontakt Objekt
    Untergeordnetes Element Vorname first_name Zeichenfolge
    Untergeordnetes Element Nachname last_name Zeichenfolge
    Untergeordnetes Element E-Mail-Adressen Email_address Array.Object
    Enkelkind E-Mail-Adresse email_address Objekt
    Urenkel Typ Typ Auswahl
    Urenkel E-Mail E-Mail Zeichenfolge
    Untergeordnetes Element Telefon telephone_number Array.Object
    Untergeordnetes Element Mailadressen Mailingadresse Array.Object

    Der Dot-Walk-Pfad zum Vorname Das strukturelle Element wäre Ausgaben.Kontakt.Vorname Während der Pfad zu E-Mail Das strukturelle Element wäre Ausgaben.Contact.email_address[0].email Da Sie ein einzelnes Element des Arrays anhand seines JavaScript-Indexwerts angeben müssen.

    Hinweis:
    Ein Dot-Walk-Pfad lässt den Namen des wiederholten Elements im Array aus. Beispielsweise muss ein Array von Objekten den Namen des Objektelements nicht angeben. Da Objekte jedoch Container für andere Elemente sind, können Sie ein untergeordnetes Element des Objekts in einem Dot-Walk-Pfad angeben.

    Allgemeine Leitlinien

    Beachten Sie diese allgemeinen Richtlinien beim Skripting mit komplexen Daten.

    Verwenden Sie Zeichenfolgeneingaben, um komplexe Daten in eine JSON-Zeichenfolge zu konvertieren
    Wenn Sie einer Zeichenfolgeneingabe komplexe Daten zuordnen, Workflow-Studio Konvertiert sie automatisch in eine JSON-Zeichenfolge. Anstatt ein Skript zu schreiben, können Sie einem REST-Schritt eine Zeichenfolgeneingabe hinzufügen und sie komplexen Daten aus einer vorherigen Aktion oder einem vorherigen Schritt zuordnen.
    Speichern Sie Ihre Objekte als Vorlagen
    Speichern Sie Ihre Objekte als Vorlagen, damit Sie sie in anderen Aktionen, Flows und Skriptschritten wiederverwenden können.
    Erstellen Sie Skripteingabevariablen, um auf vorherige Daten zuzugreifen
    Erstellen Sie eine Skripteingabevariable für alle Daten, auf die Sie über die Aktionseingabe oder einen vorherigen Schritt zugreifen möchten. Ordnen Sie die Skripteingabevariable der Eingabe- oder Schrittdatenpille zu. Ordnen Sie beispielsweise die Skripteingabevariable einer Liste von Anwenderdatensätzen zu, die Sie in einem vorherigen Schritt gesucht haben.
    Erstellen Sie eine Skriptausgabevariable, um komplexe Daten zu speichern
    Erstellen Sie eine Skriptausgabevariable, um komplexe Daten zu speichern, die Ihr Skript erstellt. Die Skriptausgabevariablen müssen mit den im Skript definierten Werten übereinstimmen. Erstellen Sie beispielsweise ein Kontakt-Array von Objekten, um mehrere Kontaktobjekte zu speichern. Speichern Sie das Kontaktobjekt als Vorlage, damit Sie es wiederverwenden können.
    Ordnen Sie die Aktionsausgabe der Skriptausgabevariable zu
    Wenn eine anwenderdefinierte Aktion komplexe Daten ausgeben soll, fügen Sie eine Aktionsausgabe hinzu, und ordnen Sie sie der Datenpille für Ihre Skriptschritt-Ausgabevariable zu. Erstellen Sie beispielsweise ein Kontakte-Array, und laden Sie die zuvor gespeicherte Kontaktobjektvorlage. Ordnen Sie die Aktionsausgabe dem Kontakte-Array zu, das von Ihrem Skriptschritt erstellt wurde.