XML-Parser-Schritt

Identifizieren Sie strukturierte Daten aus einer XML-Nutzlast, ohne ein Skript schreiben zu müssen. Ordnen Sie eingehende XML-Elemente einer komplexen Objektausgabe zu, die Sie in anderen Schritten oder Aktionen verwenden können. Zur Laufzeit füllen Werte einer XML-Nutzlast die Ausgabe des komplexen Objekts aus.

Weitere Informationen zu komplexen Objekten finden Sie unter Komplexe Daten.

Hinweis:

Dieser Schritt erfordert ein IntegrationHub-Abonnement. Weitere Informationen finden Sie unter Gesetzliche Zeitpläne − Integrations-Hub − Übersicht. Nachdem das erforderliche Plugin aktiviert wurde, wird der Schritt unter Integrationen angezeigt.

Rollen und Verfügbarkeit

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

Größenbeschränkung für Nutzlast

Zur Laufzeit unterstützt XML-Parser-Schritt Nutzlasten von bis zu 10 MB. Erstellen Sie für größere Nutzlasten eine Datenstrom -Aktion. Weitere Informationen finden Sie unter Datenstromaktionen und -paginierung.

Zur Entwurfszeit unterstützt XML-Parser-Schritt Beispielnutzlasten mit bis zu 64.000 Zeichen.

Felder

Feld	Beschreibung
Quelle	Wählen oder ziehen Sie im Feld Quelldaten eine Datenpille, die die XML-Quelldaten enthält. Zum Beispiel eine Datenpille des REST-Schritts Antworttext. Zur Laufzeit füllen Werte aus der Datenquelle die komplexe Objektausgabe. Geben Sie unter Quelldaten und im Skripterstellungsfenster eine Beispielnutzlast ein, um ein komplexes Objekt zu generieren. Wenn Sie beispielsweise die Antwort eines REST-API-Schritts analysieren, der eine Liste von Benutzern zurückgibt, geben Sie die erwartete XML für einen einzelnen Benutzer ein. Dieses Feld akzeptiert XML mit den folgenden Einschränkungen: XML-Namespaces werden nicht auf das komplexe Objekt angewendet. Mehr als ein Namespace in einer XML-Datei wird nicht unterstützt und generiert eine Fehlermeldung. Mehrdimensionale Arrays werden nicht unterstützt. Einige Sonderzeichen werden nicht unterstützt, z. B. Bindestrich und Punkt. Doppelte Doppelpunkte (::) werden in Attributwerten nicht unterstützt. Nutzlasten, die größer als 2 MB sind, können nicht gespeichert werden und generieren eine Fehlermeldung. Wenn Sie jedoch mit einem großen Beispiel arbeiten, können Sie das komplexe Objekt generieren und die Beispielnutzlast löschen, bevor Sie den Schritt speichern.
Strukturierte Payload-Ansicht	Wählen Sie eine Ansicht für die Beispielnutzlast aus. Raw (Bearbeitungsmodus): Zeigt bearbeitbare XML an. Strukturiert: Zeigt XML in einer Baumansicht an. Klicken Sie auf ein Element in der Struktur, um das XPath-Element zu kopieren. Wenn Sie komplexe Daten manuell im Feld „ Ziel “ erstellen, können Sie den XPath in das Feld „Ziel-XPath“ einfügen.
Ziel generieren	Wählen Sie Ziel generieren aus, um die Ausgabestruktur des Schritts aus Ihrer Beispielnutzlast zu erstellen. Ihre Ausgabedatenstruktur wird im Feld Ziel angezeigt. Untergeordnete Elemente für jedes Objekt werden automatisch als Typ „Zeichenfolge“ generiert. Alternativ können Sie Ihr komplexes Zielobjekt manuell erstellen, indem Sie Elemente im Feld Ziel hinzufügen.
Ziel	Zeigen Sie die Ausgabestruktur der XML-Nutzlast an, oder bearbeiten Sie sie. Erstellen Sie eine strukturierte Ausgabe, indem Sie auf Ziel generierenklicken, oder fügen Sie Elemente manuell hinzu. Jedes Element enthält in der Ansicht „Objekt bearbeiten“ die folgenden Informationen: Bezeichnung: Bezeichnung derDatenpille. Standardmäßig verwendet das System den Namen des XML-Elements. Name: Interner Name für das Ausgabeelement. Hinweis: Ausrufezeichen, doppelte Doppelpunkte, das @-Symbol oder nur Zahlen sind keine gültigen Werte für den Namen eines Elements. Typ: Datentyp, der „String“, „Object“, „Array.String“ oder „Array.Object“ sein muss. Das Element der obersten Ebene muss ein Objekt sein. Obligatorisch: Umschalten, um das Element obligatorisch zu machen. Dies gilt nur für Elemente vom Typ „Zeichenfolge“. Untergeordnetes Elementhinzufügen: Wählen Sie das Symbol zum Hinzufügen eines untergeordneten Elements ( zum Hinzufügen eines untergeordneten Elements), um ein geschachteltes untergeordnetes Element hinzuzufügen. Elemente vom Typ „Objekt“ enthalten die erweiterte Option „ Als Vorlage speichern“, mit der Sie die Struktur Ihres Objekts als komplexe Objektvorlage speichern können. Sie können diese Vorlage dann verwenden, um das Schema einer Objektausgabe für Ihre Aktion zu definieren. Für Elemente vom Typ „Zeichenfolge“ können Sie auch eine maximale Länge, einen Hinweis und einen Standardwert als erweiterte Optionen hinzufügen. Wählen Sie im Header Ziel die Option Bearbeitungsmodus beenden aus, wenn Sie mit den Änderungen an der Struktur Ihrer Ausgabe fertig sind. Sie können dann das Symbol zum Umschalten erweiterter Eingaben ( zum Umschalten erweiterter Eingaben ) wählen, um die XPath- Option anzuzeigen. Der XPath ist der Pfad zum Element. Ändern Sie den XPath, um die Zuordnung von Quelldatenelementen zu komplexen Datenvariablen zu ändern. Wenn Sie komplexe Datenvariablen manuell hinzufügen, können Sie den XPath aus dem Payload-Ansichtsfeld kopieren und in ein XPath-Feld für komplexe Datenvariablen einfügen, um die richtige Hierarchie sicherzustellen. Bedingte XPath-Ausdrücke werden nicht unterstützt.