--- 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 --- # JSON Builder-Schritt # JSON Builder-Schritt {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer 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 {#json-build-step-action-designer__section_g22_gnn_gxb} Dieser Schritt erfordert ein IntegrationHub-Abonnement. Weitere Informationen finden Sie unter [Gesetzliche Zeitpläne − Integrations-Hub − Übersicht](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf). Nachdem das erforderliche Plugin aktiviert wurde, wird der Schritt unter Integrationen angezeigt. Verfügbar als Workflow-Studio-Aktionsschritt. Benutzer mit der Rolle „action_designer" können eine anwenderdefinierte Aktion mit einem oder mehreren Aktionsschritten erstellen. ## Eingaben {#json-build-step-action-designer__section_fgp_z4n_gxb} 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.{#json-build-step-action-designer__inputs-description} Name : Datentyp: String Namensteil 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 zu füllen. Dadurch werden jedoch alle untergeordneten Elemente gelöscht, die die komplexe Objektpille bereits enthält. 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 mit dem hier ausgewählten Datentyp übereinstimmt. Die Optionen sind: * Zeichenfolge * Objekt * Nummer * Boolean * Array {#json-build-step-action-designer__ul_kqt_v4p_xbc} Verwenden Sie für Arrays und Objekte das Plus-Symbol ( ![Plus-Symbol]()), um dem Array oder Objekt Name/Wert-Paare hinzuzufügen. Wenn der Wert leer ist : Datentyp: Choice Option zum Festlegen der Aktion, 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. {#json-build-step-action-designer__ul_wtl_1pp_xbc} Äußere Struktur einschließen : Datentyp: True/False Option zum Einschließen 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 die Eigenschaft Auslassen für die Option Im Falle einer leeren Werteingabe für jedes Name-Wert-Paar auswählen, und alle Name-Wert-Paare in der Nutzlast erzeugen leere Werte. Struktur : Datentyp: Structure Schreibgeschützte Nutzlast, die der Schritt erzeugt. 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). ## Ausgaben {#json-build-step-action-designer__section_zch_jln_lyb} Diese Ausgaben werden im Datenbereich angezeigt. Sie können sie an anderer Stelle in Ihrer Aktion als Eingaben verwenden.{#json-build-step-action-designer__outputs-description} Ausgabe : Datentyp: String JSON-Nutzlast als Zeichenfolge. Wenn Sie die Nutzlast als Objekt verwenden möchten, können Sie den [JSON-Parser-Schritt](https://servicenow-prod.fluidtopics.net/QYjBLh7spdjru0NFDEcyvA "Identifizieren Sie strukturierte Daten aus einer JSON-Nutzlast, ohne ein Skript schreiben zu müssen. Ordnen Sie eingehenden JSON-Inhalt einer komplexen Objektausgabe zu, die Sie in anderen Schritten oder Aktionen verwenden können. Zur Laufzeit füllen Werte aus einer JSON-Nutzlast die komplexe Objektausgabe.") verwenden, um die Zeichenfolge zu analysieren. Schrittstatus : Datentyp: Object Objektdatenpille, die Laufzeitdetails zum Schritt enthält. Jeder Schritt in einer Aktion gibt einen Schrittstatus zurück. Schrittstatus \> Code : Datentyp: Integer Ganzzahlige Datenpille, die angibt, ob bei dem Schritt ein Fehler aufgetreten ist. Standardmäßig gibt der Wert 1 an, dass bei dem Schritt ein Fehler aufgetreten ist. Der Wert 0 zeigt 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-Payload {#json-build-step-action-designer__section_okh_v3w_sbc} Generiert automatisch eine JSON-Payload mit der Schaltfläche JSON für Payload hinzufügen. Diese Schaltfläche öffnet den Skript-Editor zum Hinzufügen von Nutzlast, in dem Sie eine JSON-Nutzlast eingeben können, die automatisch in eine strukturierte Eingabe deserialisiert werden soll. Bei der Verwendung des JSON-Nutzlastgenerators sind einige Details zu beachten. * Wenn die JSON leere Schlüssel enthält, wird die Nutzlast trotzdem generiert. * Wenn im Skript-Editor 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 Stamm-Array in ein Stammobjekt eingeschlossen. * Wenn ein Array mehrere Objekte enthält, werden alle Schlüssel in den Objekten zu einem übergeordneten Objekt zusammengefügt. {#json-build-step-action-designer__ul_t4t_dlw_sbc} Der JSON-Nutzlastgenerator unterstützt Folgendes nicht. * leere Nutzlasten * nicht komplexe Objekttypen * ungültiges JSON * leere Stammobjekte, z. B. ein leeres Array * Nutzlasten größer als 65.000 Byte {#json-build-step-action-designer__ul_igz_jkw_sbc} Hinweis: Durch das Generieren einer JSON-Payload werden vorhandene Strukturen im JSON Builder-Schritt überschrieben.