Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
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.
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 |