---
sourceDocument: Xanadu: Integrationen mit Anwendungen erstellen
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/integrate-applications

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu: Integrationen mit Anwendungen erstellen

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Nutzlastgenerator-Schritt

# Nutzlastgenerator-Schritt {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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 {#payload-build-step-action-designer__section_g2v_5jq_2fb}

Verfügbar als Workflow-Studio-Aktionsschritt. Benutzer 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 [JSON Builder-Schritt](https://servicenow-prod.fluidtopics.net/GZ2O7VAz3naFeM1ZI23azg "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.")ersetzt.

## Felder {#payload-build-step-action-designer__section_fhk_zjq_2fb}

{#payload-build-step-action-designer__table_hqc_ckq_2fb__entry__2}

| Felder | Beschreibung |
|-|-|
| Name/Wert-Paare | Die in die Nutzlast einzubeziehenden Name/Wert-Paare. Klicken Sie auf das Pluszeichen, um Name/Wert-Paare hinzuzufügen. Ziehen Sie Datenpillen in eines der beiden Felder, um dynamische Nutzlasten zu erzeugen. Der Name wird zu einem Schlüssel in JSON und einem Element in XML. Angenommen, Sie erstellen dieses Name/Wert-Paar. * Name: <kbd class="ph userinput">short_description</kbd> * Wert: <kbd class="ph userinput">[action]-&gt;[short_description]</kbd> {#payload-build-step-action-designer__ul_vcy_kmq_2fb} 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 Möglichkeit, ein Name/Wert-Paar auszuschließen, wenn der Wert leer oder null ist. Hinweis: Dieses Feld wird nur angezeigt, nachdem Sie auf den Abwärtspfeil geklickt haben, um erweiterte Optionen anzuzeigen. |
| Ausgabeformat | Das Nutzlast-Dateiformat. * 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. {#payload-build-step-action-designer__ul_gbf_3kq_2fb} |
| Namespace | Auf die einzelnen Elemente anzuwendender XML-Namespace. Beispielsweise wenn der Namespace auf <kbd class="ph userinput">incident</kbd> festgelegt ist: <incident:short_description>[action]->[short_description]</incident:short_description> Hinweis: Dieses Feld ist nur sichtbar, wenn das Ausgabeformat auf XMLfestgelegt ist. |
| Äußere Struktur einschließen | Die Option zum Einbeziehen oder Ausschließen eines Containers auf oberster Ebene entsprechend dem Ausgabeformat. Wenn das Ausgabeformat JSON lautet, enthalten geschweifte Klammern die Name/Wert-Paare. Wenn XML als Ausgabeformat ausgewählt ist, enthält ein angegebenes XML-Element die Name/Wert-Paare. Wenn das System das Name/Wert-Paar z. B. 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, gültige JSON- oder XML-Strukturen zu senden, wenn die Nutzlast leer ist. Aktivieren Sie diese Option, um strukturellen JSON- oder XML-Text in die Nutzlast aufzunehmen. Wenn das System z. B. eine leere Struktur im JSON-Format formatiert: {} Wenn das System eine leere Struktur im XML-Format formatiert: <xml></xml> Deaktivieren Sie diese Option, um eine leere Nutzlast zu erstellen. Leere Nutzlasten können auftreten, wenn Sie für jedes Name/Wert-Paar die Option Auslassen wenn leer auswählen und alle Name/Wert-Paare in der Nutzlast leere Werte erzeugen. |
| Ü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 das Ausgabeformat auf XML festgelegt und die Option zum Einbeziehen der äußeren Struktur aktiviert ist. |
| Vorschau | Die schreibgeschützte Nutzlast, die der Schritt erzeugt. |
[ ]

{#payload-build-step-action-designer__table_hqc_ckq_2fb}

## Fehlerbewertung der Aktion {#payload-build-step-action-designer__id_lg2_4s3_15b}

Wenn dieser Schritt fehlschlägt
:   Datentyp: Choice

    Option, um den nächsten Schritt auszuführen oder zur Fehlerauswertung zu wechseln. Informationen zur Verwendung des Schrittstatuscodes oder der Nachricht für eine anwenderdefinierte Aktionsfehlerbedingung finden Sie unter [Action error evaluation](https://www.servicenow.com/docs/access?context=action-error-evaluation&version=xanadu&pubname=xanadu-build-workflows&ft:locale=en-US).