XML-Parser-Schritt

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 3 Minuten Lesedauer
  • 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 − IntegrationHub − Übersicht. Nachdem das erforderliche Plugin aktiviert wurde, wird der Schritt unter Integrationen angezeigt.

    Rollen und Verfügbarkeit

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

    Größenbeschränkung für Nutzlast

    Zur Laufzeit unterstützt XML-Parser-Schritt Nutzlasten 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 REST-Schritt-Datenpille „ Antworttext “. Zur Laufzeit füllen Werte aus der Datenquelle die komplexe Objektausgabe aus.

    Geben Sie unter Quelldaten und im Skriptfenster eine Beispielnutzlast ein, um ein komplexes Objekt zu generieren. Wenn Sie beispielsweise die Antwort von einem REST-API-Schritt 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 mit mehr als 2 MB 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 bearbeitbares 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 im Feld Ziel manuell erstellen, können Sie den XPath in das XPath-Feld des Ziels 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.
    Zielvorgabe

    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 die folgenden Informationen in der Ansicht „Objekt bearbeiten“:

    • 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 Zahlen sind keine gültigen Werte für den Namen eines Elements.
    • Typ: Datentyp, der „Zeichenfolge“, „Objekt“, „Array.String“ oder „Array.Object“ sein muss. Das Element der obersten Ebene muss ein Objekt sein.
    • Obligatorisch: Umschalter, um das Element erforderlich 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 ( Symbolzum Hinzufügen eines untergeordneten Elements) aus, 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 der Ausgabe fertig sind. Sie können dann das Symbol „Erweiterte Eingaben umschalten“ (Symbol „ Erweiterte Eingaben umschalten“ ) auswählen, um die XPath- Option anzuzeigen.

    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 dem Feld Nutzlastansicht 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.