JSON-Builder-Schritt

Erstellen Sie eine JSON-Nutzlast, die in einem anderen Schritt verwendet werden soll. Geben Sie Werte ein, oder verwenden Sie Datenpillen, um eine dynamische Nutzlast zu erstellen. Dieser Schritt unterstützt mehrere Datentypen, einschließlich Objekte und Arrays für geschachtelte Strukturen.

Rollen und Verfügbarkeit

Dieser Schritt erfordert ein IntegrationHub-Abonnement. Weitere Informationen finden Sie unter Zeitpläne für Rechtsabteilung – IntegrationHubÜbersicht . Nachdem das erforderliche Plugin aktiviert wurde, ist der Schritt unter Integrationen sichtbar.

Verfügbar als Workflow-Studio-Aktionsschritt. Anwender mit der Rolle „action_Designer“ können eine anwenderdefinierte Aktion mit einem oder mehreren Aktionsschritten erstellen.

Eingaben

Geben Sie einen Wert für jede Eingabe an, die Ihre Aktion benötigt. Um dynamische Werte hinzuzufügen, können Sie auch Pillen aus dem Datenbereich ziehen oder in der Pillenauswahl auswählen.

Name

Datentyp: String

Namensbestandteil eines Name-Wert-Paares. Geben Sie einen Wert ein, oder verwenden Sie eine Datenpille, um eine dynamische Nutzlast zu erstellen.

Wert

Datentyp: String

Wertteil eines Name-Wert-Paares. Geben Sie einen Wert ein, oder verwenden Sie eine Datenpille, um eine dynamische Nutzlast zu erstellen. Sie können eine komplexe Objektpille verwenden, um eine Zeile mit einem Objektdatentyp auszufüllen. Dadurch werden jedoch alle untergeordneten Elemente gelöscht, die die komplexe Objektpille bereits hat.

Typ

Datentyp: Choice

Datentyp für das Name-Wert-Paar. Wenn Sie eine Datenpille für den Namen oder Wert verwenden, stellen Sie sicher, dass der Datentyp für die Pille dem hier ausgewählten Datentyp entspricht. Die Optionen sind:

• Zeichenfolge
• Objekt
• Nummer
• Boolean
• Array

Verwenden Sie für Arrays und Objekte das Plus-Symbol ( ), um dem Array oder Objekt Name-Wert-Paare hinzuzufügen.

Wenn der Wert leer ist

Datentyp: Choice

Option zum Festlegen der Vorgehensweise, wenn ein Name-Wert-Paar einen leeren oder Null-Wert hat.

• Unverändert lassen : Behält den leeren oder Null-Wert als leere Zeichenfolge bei.
• Eigenschaft auslassen : Schließt ein Name-Wert-Paar aus, wenn der Wert leer oder null ist.
• Als Null festlegen : Gibt einen leeren oder Null-Wert als Null-Datentyp zurück.
• Fehler auslösen : Gibt einen Fehler zurück, wenn ein Name-Wert-Paar einen leeren oder Null-Wert hat.

Äußere Struktur einschließen

Datentyp: True/False

Option zum Einbeziehen der geschweiften Klammern für einen JSON-Container der obersten Ebene.

Leere Struktur Auslassen

Datentyp: True/False

Option zum Auslassen einer leeren Nutzlast. Leere Nutzlasten können auftreten, wenn Sie auswählen Eigenschaft auslassen Für Bei leerem Wert Die Eingabe für jedes Name-Wert-Paar und alle Name-Wert-Paare in der Nutzlast ergibt leere Werte.

Struktur

Datentyp: Structure

Schreibgeschützte Nutzlast, die der Schritt erstellt.

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 Aktionsfehlerauswertung.

Ausgaben

Diese Ausgaben werden im Datenbereich angezeigt. Sie können sie an anderer Stelle in Ihrer Aktion als Eingaben verwenden.

Ausgabe

Datentyp: String

JSON-Nutzlast als Zeichenfolge. Wenn Sie die Nutzlast als Objekt verwenden möchten, können Sie verwenden JSON-Parser-Schritt Zum Analysieren der Zeichenfolge.

Schrittstatus

Datentyp: Object

Objektdatenpille mit Laufzeitdetails zum Schritt. Jeder Schritt in einer Aktion gibt einen Schrittstatus zurück.

Schrittstatus > Code

Datentyp: Integer

Ganzzahldatenpille, die angibt, ob der Schritt einen Fehler verursacht hat. Standardmäßig gibt der Wert 1 an, dass der Schritt einen Fehler verursacht hat. Ein Wert von 0 gibt an, dass der Schritt erfolgreich ausgeführt wurde. Sie können diese Codes nicht anpassen.

Schrittstatus > Nachricht

Datentyp: String

Zeichenfolgendatenpille, die die vom Schritt oder Systemvorgang erzeugte Fehlermeldung enthält. Sie können diese Nachricht nicht anpassen.

Generieren Sie eine JSON-Nutzlast

Generieren Sie automatisch eine JSON-Nutzlast mit JSON für Nutzlast hinzufügen Schaltfläche. Diese Schaltfläche öffnet den Skript-Editor „Nutzlast hinzufügen“, in dem Sie eine JSON-Nutzlast eingeben können, die automatisch in eine strukturierte Eingabe deserialisiert wird.

Bei der Verwendung des JSON-Nutzlastgenerators sind einige Details zu beachten.

• Wenn das JSON leere Schlüssel enthält, wird die Nutzlast weiterhin generiert.
• Wenn im Skripteditor doppelte Schlüssel vorhanden sind, überschreibt der letzte Schlüsseleintrag im Objekt den Wert aller vorherigen Schlüssel mit demselben Namen.
• Wenn das Stammobjekt ein Array ist, wird das Stammarray in ein Stammobjekt umwickelt.
• Wenn ein Array mehrere Objekte enthält, werden alle Schlüssel in den Objekten zu einem übergeordneten Objekt zusammengefügt.

Der JSON-Nutzlastgenerator unterstützt Folgendes nicht.

• Leere Nutzlasten
• Nicht komplexe Objekttypen
• Ungültige JSON
• Leere Stammobjekte, z. B. ein leeres Array
• Nutzlasten größer als 65.000 Byte

Hinweis:

Durch das Generieren einer JSON-Nutzlast werden alle vorhandenen Strukturen im JSON-Builder-Schritt überschrieben.