Freigeben über

XML-Aktionen

  • Artikel

Power Automate bietet die Funktionalität, Desktop-Flows zum Verwalten von XML-Attributen und -Elementen zu verwenden.

Um eine XML-Datei zu lesen, verwenden Sie die Aktion Lesen von XML aus Datei. Geben Sie den Pfad an oder suchen Sie nach der Datei und wählen Sie eine der Kodierungsoptionen.

Nachdem Sie eine Datei ausgewählt haben, wählen Sie die Aktion XPath-Ausdruck ausführen aus, um eine Xpath-Abfrage auszuführen. Im folgenden Beispiel wird eine erzeugte Variable aus der Aktion XML aus Datei lesen verwendet, um das Dokument anzugeben.

Screenshot der Aktion „XPath-Anweisung ausführen“

Um ein Attribut aus einer XML-Datei abzurufen, verwenden Sie die Aktion XML-Attribut abrufen. Im folgenden Beispiel ist Status ein Attribut von Client, das ein Element von clientlist ist. Der Wert wird als Textwert abgerufen.

Screenshot der Aktion „XML-Attribut abrufen“.

In ähnlicher Weise verwenden Sie zum Abrufen von Elementwerten die Aktion XML-Elementwert abrufen. Sie können Elemente und Attribute mit der jeweiligen Aktion verwalten, um XML-Attribute oder -Elemente zu erhalten, festzulegen oder zu entfernen.

XML aus Datei lesen

Liest den Inhalt einer XML-Datei in einer Variablen.

Eingabeparameter

Argument Optional Akzeptiert Standardwert Beschreibung des Dataflows
Dateipfad Nein Datei Die Datei, die das zu lesende XML-Dokument enthält
Codierung NICHT ZUTREFFEND Systemstandard, ASCII, Unicode, Unicode Big Endian, UTF-8 System-Standard Die Codierung zum Lesen der angegebenen Datei

Erzeugte Variablen

Argument Type Beschreibung des Dataflows
XmlDocument XML-Knoten Die Variable, die das zu lesende XML-Dokument enthält

Ausnahmen

Ausnahme Beschreibung
Directory not found Gibt an, dass das Verzeichnis nicht vorhanden ist
File not found Gibt an, dass die Datei nicht vorhanden ist
Failed to read from file Gibt ein Problem beim Lesen aus der Datei an
Die Datei enthält kein gültiges XML-Dokument Gibt an, dass die Datei kein gültiges XML-Dokument enthält

XML in Datei schreiben

Schreibt den Inhalt einer XML-Knotenvariable in eine Datei.

Eingabeparameter

Argument Optional Akzeptiert Standardwert Beschreibung des Dataflows
Dateipfad Nein Datei Die Datei, in die das XML-Dokument geschrieben werden soll
Zu schreibendes XML Nein Text Wert Der XML-Knoten oder das Dokument zum Schreiben in die Datei
Codierung NICHT ZUTREFFEND Systemstandard, ASCII, Unicode, Unicode Big Endian, UTF-8 System-Standard Die Codierung zum Lesen der angegebenen Datei
XML-Format NICHT ZUTREFFEND Boolescher Wert true Gibt an, ob die XML formatiert werden soll
Einrückung pro Ebene Ja Numerischer Wert 2 Gibt an, wie viele Leerzeichen jede XML-Ebene eingerückt werden soll

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Ausnahme Beschreibung des Dataflows
Ungültiges Verzeichnis angegeben Gibt an, dass das angegebene Verzeichnis ungültig ist
Schreiben von XML in Datei fehlgeschlagen Gibt ein Problem beim Schreiben von XML in die Datei an

XPath-Ausdruck ausführen

Extrahiert Werte aus einem XML-Dokument auf der Grundlage der bereitgestellten XPath-Abfrage.

Eingabeparameter

Argument Optional Akzeptiert Standardwert Beschreibung des Dataflows
XML-Dokument zum Analysieren Nein Text Wert Der XML-Code als Text oder eine zuvor definierte Variable, die das zu analysierende XML-Dokument enthält
XPath-Abfrage Nein Text Wert Der XPath-Ausdruck, der für das XML-Dokument ausgeführt werden soll
Nur ersten Wert abrufen NICHT ZUTREFFEND Boolescher Wert False Gibt an, ob ein einzelner Wert (nur der erste Wert) oder alle Werte abgerufen werden sollen, die mit dem bereitgestellten XPath-Ausdruck übereinstimmen

Erzeugte Variablen

Argument Typ Beschreibung
XPathResult XML-Knoten Den oder die extrahierte(n) Knoten als XML-Knoten
XPathResults Liste von XML-Knoten Den oder die extrahierte(n) Knoten als Liste von XML-Knoten

Ausnahmen

Ausnahme Beschreibung
Ungültiges XML-Dokument angegeben Gibt an, dass das XML-Dokument ungültig ist
Ungültiger XPath-Ausdruck angegeben Gibt an, dass der angegebene XPath-Ausdruck ungültig ist

XML-Elementattribut abrufen

Ruft den Wert eines Attributs eines XML-Elements ab.

Eingabeparameter

Argument Optional Akzeptiert Standardwert Beschreibung des Dataflows
XML-Dokument Nein XML-Knoten Das XML-Dokument oder XML-Element zum Abrufen seines Attributs
XPath-Abfrage Ja Text Wert Der XPath-Ausdruck zum Auffinden des Unterelements und zum Abrufen des Attributs
Attribute name Nein Text Wert Der Name des zu ändernden Attributs, um seinen Wert abzurufen
Wert abrufen als NICHT ZUTREFFEND Textwert, Numerischer Wert, Datetime-Wert, Boolescher Wert Text Wert Gibt den Datentyp für den Attributwert an

Erzeugte Variablen

Argument Type Beschreibung des Dataflows
XmlAttributeValue Boolescher Wert Der abgerufene Wert des XML-Attributs
XmlAttributeValue Datetime Der abgerufene Wert des XML-Attributs
XmlAttributeValue Numerischer Wert Der abgerufene Wert des XML-Attributs
XmlAttributeValue Textwert Der abgerufene Wert des XML-Attributs

Ausnahmen

Ausnahme Beschreibung
Ungültiger XPath-Ausdruck angegeben Gibt an, dass der angegebene XPath-Ausdruck ungültig ist
XPath-Ausdruck gibt kein Element zurück Gibt an, dass der XPath-Ausdruck kein Element zurückgibt
Das Attribut wurde nicht im Element gefunden Gibt an, dass das Attribut im Element nicht vorhanden ist
Der Attributwert konnte nicht in den angeforderten Datentyp konvertiert werden Gibt ein Problem beim Konvertieren des Attributwerts in den angeforderten Datentyp an

XML-Elementattribut einstellen

Legt den Wert eines Attributs eines XML-Elements fest.

Eingabeparameter

Argument Optional Akzeptiert Standardwert Beschreibung des Dataflows
XML-Dokument Nein XML-Knoten Das XML-Dokument oder XML-Element zum Einstellen seines Attributs
XPath-Abfrage Ja Text Wert Der XPath-Ausdruck zum Auffinden des Unterelements und zum Einstellen seines Attributs
Attribute name Nein Text Wert Der Name des Attributs, um seinen Wert einzustellen
Attributwert Nein Text Wert Der neue Wert für das Attribut.

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Ausnahme Beschreibung
Ungültiger XPath-Ausdruck angegeben Gibt an, dass der angegebene XPath-Ausdruck ungültig ist
XPath-Ausdruck gibt kein Element zurück Gibt an, dass der XPath-Ausdruck kein Element zurückgibt
Fehler beim Einstellen des XML-Attributs Weist auf ein Problem beim Einstellen des XML-Attributs hin

XML-Elementattribut entfernen

Entfernt ein Attribut aus einem XML-Element.

Eingabeparameter

Argument Optional Akzeptiert Standardwert Beschreibung des Dataflows
XML-Dokument Nein XML-Knoten Das XML-Dokument oder XML-Element zum Entfernen seines Attributs
XPath-Abfrage Ja Text Wert Der XPath-Ausdruck zum Auffinden des Unterelements und zum Entfernen des Attributs
Attribute name Nein Text Wert Der Name des zu entfernenden Attributs

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Ausnahme Beschreibung
Ungültiger XPath-Ausdruck angegeben Gibt an, dass der angegebene XPath-Ausdruck ungültig ist
XPath-Ausdruck gibt kein Element zurück Gibt an, dass der XPath-Ausdruck kein Element zurückgibt
Das Attribut wurde nicht im Element gefunden Gibt an, dass das Attribut im Element nicht vorhanden ist
Fehler beim Entfernen des XML-Attributs Weist auf ein Problem beim Entfernen des XML-Attributs hin

Den XML-Elementwert abrufen

Ruft den Wert eines XML-Elements ab.

Eingabeparameter

Argument Optional Akzeptiert Standardwert Beschreibung des Dataflows
XML-Dokument Nein XML-Knoten Das XML-Dokument oder XML-Element zum Abrufen seines Werts
XPath-Abfrage Ja Text Wert Der XPath-Ausdruck zum Auffinden des Unterelements und zum Abrufen des Werts
Wert abrufen als NICHT ZUTREFFEND Textwert, Numerischer Wert, Datetime-Wert, Boolescher Wert Textwert Gibt den Datentyp für den XML-Elementwert an

Erzeugte Variablen

Argument Type Beschreibung des Dataflows
XmlElementValue Boolescher Wert Der XML-Elementwert
XmlElementValue Datetime Der XML-Elementwert
XmlElementValue Numerischer Wert Der XML-Elementwert
XmlElementValue Textwert Der XML-Elementwert

Ausnahmen

Ausnahme Beschreibung
Ungültiger XPath-Ausdruck angegeben Gibt an, dass der angegebene XPath-Ausdruck ungültig ist
XPath-Ausdruck gibt kein Element zurück Gibt an, dass der XPath-Ausdruck kein Element zurückgibt
Der Elementwert konnte nicht in den angeforderten Datentyp konvertiert werden Gibt ein Problem beim Konvertieren des Elementwerts in den angeforderten Datentyp an

Den XML-Elementwert einstellen

Legt den Wert eines XML-Elements fest.

Eingabeparameter

Argument Optional Akzeptiert Standardwert Beschreibung des Dataflows
XML-Dokument Nein XML-Knoten Das XML-Dokument oder XML-Element zum Abrufen seines Werts
XPath-Abfrage Ja Text Wert Der XPath-Ausdruck zum Auffinden des Unterelements und zum Abrufen des Werts
XML-Elementwert Nein Text Wert Der neue Wert für das XML-Element

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Ausnahme Beschreibung
Ungültiger XPath-Ausdruck angegeben Gibt an, dass der angegebene XPath-Ausdruck ungültig ist
XPath-Ausdruck gibt kein Element zurück Gibt an, dass der XPath-Ausdruck kein Element zurückgibt
Fehler beim Festlegen des Elementwerts. Gibt ein Problem beim Einstellen des Elementwerts an

XML-Element einfügen

Fügt ein neues XML-Element in ein XML-Dokument ein.

Eingabeparameter

Argument Optional Akzeptiert Standardwert Beschreibung des Dataflows
XML-Dokument Nein XML-Knoten Das XML-Dokument, um ein neues XML-Element einzufügen
XPath-Abfrage Nein Text Wert Der XPath-Ausdruck zum Auffinden des übergeordneten XML-Elements und zum Einfügen des neuen Elements in dieses
XML-Element zum Einfügen Nein XML-Knoten Das neue XML-Element, um ein neues XML-Dokument einzufügen

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Ausnahme Beschreibung
Ungültiger XPath-Ausdruck angegeben Gibt an, dass der angegebene XPath-Ausdruck ungültig ist
XPath-Ausdruck gibt kein Element zurück Gibt an, dass der XPath-Ausdruck kein Element zurückgibt
Einfügen des XML-Elements fehlgeschlagen Gibt ein Problem beim Einfügen des XML-Elements an

XML-Element entfernen

Entfernt mindestens ein XML-Element aus einem XML-Dokument.

Eingabeparameter

Argument Optional Akzeptiert Standardwert Beschreibung des Dataflows
XML-Dokument Nein XML-Knoten Das XML-Dokument, das das/die zu entfernende(n) XML-Element(e) enthält
XPath-Abfrage Nein Text Wert Der XPath-Ausdruck zum Auffinden des/der zu entfernenden Elements/Elemente

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Ausnahme Beschreibung
Ungültiger XPath-Ausdruck angegeben Gibt an, dass der angegebene XPath-Ausdruck ungültig ist
Entfernen des XML-Elements fehlgeschlagen Gibt ein Problem beim Entfernen des XML-Elements an