Nutzlastgenerator-Schritt

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

    • Ermöglichen Sie Aktionsdesignern, Name-/Wert-Paare mit dynamischen Daten einfach in JSON- und XML-Nutzlasten zu erstellen.

    Rollen und Verfügbarkeit

    Verfügbar als Workflow-Studio-Aktionsschritt. Anwender mit der Rolle „action_Designer“ können eine anwenderdefinierte Aktion mit einem oder mehreren Aktionsschritten erstellen.
    Hinweis:
    Für JSON ist dieser Schritt veraltet und wird durch ersetzt JSON-Builder-Schritt.

    Felder

    Felder Beschreibung
    Name/Wert-Paare

    Die Name-Wert-Paare, die in die Nutzlast aufgenommen werden sollen. Klicken Sie auf das Plus-Symbol, um Name-Wert-Paare hinzuzufügen. Ziehen Sie Datenpillen in Eines der Felder zum Erstellen dynamischer Nutzlasten.

    Die Name Wird zu einem Schlüssel in JSON und zu einem Element in XML. Angenommen, Sie erstellen dieses Name-Wert-Paar.
    • Name : Short_description
    • Wert : [Aktion]->[short_description]
    Wenn das System das Name-Wert-Paar als JSON formatiert:
    "short_description": "[action]->[short_description]"

    Wenn das System das Name-Wert-Paar als XML formatiert:

    <short_description>[action]->[short_description]</short_description>
    Wenn leer, auslassen Die Option, ein Name-Wert-Paar auszuschließen, wenn der Wert leer oder null ist.
    Hinweis:
    Dieses Feld ist nur sichtbar, nachdem Sie auf den Abwärtspfeil geklickt haben, um erweiterte Optionen anzuzeigen.
    Ausgabeformat Das Nutzlastdateiformat.
    • JSON : Wählen Sie diese Option aus, um die Nutzlast als JSON-Dokument zu formatieren.
    • XML : Wählen Sie diese Option aus, um die Nutzlast als XML-Dokument zu formatieren.
    Namespace Der XML-Namespace, der auf jedes Element angewendet werden soll. Beispiel: Wenn der Namespace auf festgelegt ist Incident :
    <incident:short_description>[action]->[short_description]</incident:short_description>
    Hinweis:
    Dieses Feld ist nur sichtbar, wenn Ausgabeformat Ist auf festgelegt XML .
    Äußere Struktur einschließen

    Die Option zum ein- oder Ausschließen eines Containers der obersten Ebene, der dem Ausgabeformat entspricht. Wenn Ausgabeformat Ist JSON, geschweifte Klammern enthalten die Name-Wert-Paare. Wenn Ausgabeformat Ist XML, enthält ein angegebenes XML-Element die Name-Wert-Paare.

    Beispiel: Wenn das System das Name-Wert-Paar als JSON formatiert:

    {
  "short_description": "[action]->[short_description]"
}

    Wenn das System das Name-Wert-Paar als XML formatiert:

    <xml>
  <short_description>[action]->[short_description]</short_description>
</xml>
    Leere Struktur senden

    Die Option zum Senden gültiger JSON- oder XML-Strukturen, wenn die Nutzlast leer ist. Aktivieren Sie diese Option, um JSON- oder XML-Strukturtext in die Nutzlast aufzunehmen.

    Beispiel: Wenn das System eine leere Struktur als JSON formatiert:
    {}

    Wenn das System eine leere Struktur als XML formatiert:

    <xml></xml>

    Deaktivieren Sie diese Option, um eine leere Nutzlast zu erstellen.

    Leere Nutzlasten können auftreten, wenn Sie auswählen Auslassen, wenn leer Option für jedes Name-Wert-Paar und alle Name-Wert-Paare in der Nutzlast erzeugen leere Werte.
    Übergeordneter Knoten Der Name des XML-Elements, das die Name-Wert-Paare enthält. Das standardmäßige übergeordnete Knotenelement ist xml .
    Hinweis:
    Dieses Feld ist nur sichtbar, wenn Ausgabeformat Ist auf festgelegt XML Und die Option auf Äußere Struktur Einschließen Ist aktiviert.
    Vorschau Die schreibgeschützte Nutzlast, die der Schritt erzeugt.

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