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 Zeitpläne für Rechtsabteilung – IntegrationHubÜbersicht . Nachdem das erforderliche Plugin aktiviert wurde, ist der Schritt unter Integrationen sichtbar.

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.

Größenbeschränkung der Nutzlast

Zur Laufzeit, XML-Parser-SchrittUnterstützt Nutzlasten bis zu 10 MB. Erstellen Sie für größere Nutzlasten eine DatenstromAktion. Weitere Informationen finden Sie unter Datenstromaktionen und Paginierung.

Zum Designzeitpunkt XML-Parser-SchrittUnterstützt Beispielnutzlasten mit bis zu 64.000 Zeichen.

Felder

Feld Beschreibung
Quelle In Quelldaten Wählen Sie eine Datenpille aus, die die XML-Quelldaten enthält, oder ziehen Sie sie. Beispiel: Ein REST-Schritt Antworttext Datenpille. Zur Laufzeit füllen Werte aus der Datenquelle die Ausgabe des komplexen Objekts aus.

Geben Sie unter Quelldaten und im Skripting-Fenster eine Beispielnutzlast ein, um ein komplexes Objekt zu generieren. Wenn Sie beispielsweise die Antwort aus einem REST API-Schritt analysieren, der eine Liste von Anwendern zurückgibt, geben Sie die erwartete XML für einen einzelnen Anwender 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 und eine Fehlermeldung generiert werden. 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 Strukturansicht an. Klicken Sie auf ein Element in der Struktur, um den Element-XPath zu kopieren. Wenn Sie komplexe Daten in erstellen Ziel Feld manuell können Sie den XPath in das Ziel-XPath-Feld einfügen.
Ziel generieren Wählen Sie Aus Ziel Generieren Um die Ausgabestruktur des Schritts aus Ihrer Beispielnutzlast zu erstellen. Ihre Ausgabedatenstruktur wird in angezeigt Ziel Feld. Untergeordnete Elemente für jedes Objekt werden automatisch als Typ „Zeichenfolge“ generiert. Alternativ können Sie Ihr komplexes Zielobjekt manuell erstellen, indem Sie Elemente in hinzufügen Ziel Feld.
Zielvorgabe

Zeigen Sie die Ausgabestruktur der XML-Nutzlast an, oder bearbeiten Sie sie. Erstellen Sie eine strukturierte Ausgabe, indem Sie auf klicken Ziel Generieren , Oder fügen Sie Elemente manuell hinzu.

Jedes Element enthält die folgenden Informationen in der Ansicht „Objekt bearbeiten“:

  • Bezeichnung : Bezeichnung der Datenpille. Standardmäßig verwendet das System den Namen des XML-Elements.
  • Name : Interner Name für das Ausgabeelement.
    Hinweis: Ausrufezeichen, Doppelkolone, das @-Symbol oder nur Zahlen sind keine gültigen Werte für den Namen eines Elements.
  • Typ : Datentyp, der Zeichenfolge, Objekt, Array.Zeichenfolge oder Array.Object sein muss. Das Element der obersten Ebene muss ein Objekt sein.
  • Obligatorisch : Umschalter, um das Element als erforderlich festzulegen. Dies gilt nur für Elemente vom Typ „Zeichenfolge“.
  • Untergeordnetes Element hinzufügen : Wählen Sie das Symbol „untergeordnetes Element hinzufügen“ ( Symbol „untergeordnetes Element hinzufügen“), um ein geschachteltes untergeordnetes Element hinzuzufügen.

Elemente vom Typ „Objekt“ enthalten Als Vorlage speichern Erweiterte Option, 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 Tipp und einen Standardwert als erweiterte Optionen hinzufügen.

Wählen Sie im Header Ziel die Option aus Bearbeitungsmodus Beenden Wenn Sie mit Änderungen an der Struktur Ihrer Ausgabe fertig sind. Sie können dann das Umschaltsymbol für erweiterte Eingaben ( Symbol für erweiterte Eingaben ein/aus), um anzuzeigen XPath Option.

Der XPath ist der Pfad zum Element. Ändern Sie den XPath, um zu ändern, wie Quelldatenelemente komplexen Datenvariablen zugeordnet werden. Wenn Sie komplexe Datenvariablen manuell hinzufügen, können Sie den XPath aus kopieren Nutzlastansicht Feld und fügen Sie es in ein XPath-Feld der komplexen Datenvariablen ein, um die richtige Hierarchie sicherzustellen. Bedingte XPath-Ausdrücke werden nicht unterstützt.