Zdieľať cez

Akcie XML

  • Článok

Power Automate poskytuje možnosť používať toky pracovnej plochy na správu atribútov a prvkov XML.

Ak chcete prečítať súbor XML, použite akciu Načítať XML zo súboru . Zadajte cestu alebo vyhľadajte súbor a vyberte jednu z možností kódovania.

Po výbere súboru použite na spustenie dotazu Xpath akciu Vykonať XPath výraz . Nasledujúci príklad používa na špecifikáciu dokumentu vytvorenú premennú z akcie Čítať XML zo súboru .

Snímka obrazovky akcie Execute XPath expression.

Ak chcete získať atribút zo súboru XML, použite akciu Získať atribút XML . V nasledujúcom príklade stav je atribútom klient, čo je prvok zoznam klientov. Hodnota sa získa ako textová hodnota.

Snímka obrazovky akcie Získať atribút XML.

Podobne na získanie hodnôt prvkov použite akciu Získať hodnotu prvku XML . Elementy a atribúty môžete spravovať pomocou príslušnej akcie na získanie, nastavenie alebo odstránenie atribútov alebo prvkov XML.

Čítať prvok XML zo súboru

Načíta obsah súboru XML do premennej.

Vstupné parametre

Argument Voliteľné Akceptuje Predvolená hodnota Description
File path No Súbor Súbor obsahujúci dokument XML, ktorý sa má prečítať
Encoding Neaplikovateľné Predvolené nastavenie systému, ASCII, Unicode, Unicode big endian, UTF-8 Predvolené nastavenie systému Kódovanie použité pre zadaný súbor

Premenné sú vytvorené

Argument Type Description
XmlDocument XML uzol Premenná, ktorá uchováva prečítaný dokument XML

Výnimky

Výnimka Popis
Adresár sa nenašiel Označuje, že adresár neexistuje
Súbor sa nenašiel Označuje, že súbor neexistuje
Nepodarilo sa čítať zo súboru Označuje problém s čítaním zo súboru
Súbor neobsahuje platný dokument XML Označuje, že súbor neobsahuje platný dokument XML

Zapísať prvok XML do súboru

Zapíše obsah premennej uzla XML do súboru.

Vstupné parametre

Argument Voliteľné Akceptuje Predvolená hodnota Description
File path No Súbor Súbor, do ktorého sa má zapísať dokument XML
Prvok XML, ktorý sa má zapísať No Textová hodnota Uzol alebo dokument XML, ktorý sa má zapísať do súboru
Encoding Neaplikovateľné Predvolené nastavenie systému, ASCII, Unicode, Unicode big endian, UTF-8 Predvolené nastavenie systému Kódovanie použité pre zadaný súbor
Kód XML formátu Neaplikovateľné Booleovská hodnota Pravdivé Určuje, či sa má prvok XML formátovať
Odsadenie na jednu úroveň Áno Číselná hodnota 2 Určuje, o koľko medzier sa má odsadiť každá úroveň súboru XML

Premenné sú vytvorené

Táto akcia nevytvára žiadne premenné.

Výnimky

Výnimka Description
Zadaný neplatný adresár Označuje, že zadaný adresár je neplatný
Nepodarilo sa zapísať prvok XML do súboru Označuje problém so zapisovaním prvku XML do súboru

Vykonajte XPath výraz

Extrahujte hodnoty z dokumentu XML na základe poskytnutého XPath dopytu.

Vstupné parametre

Argument Voliteľné Akceptuje Predvolená hodnota Description
Dokument XML, ktorý sa má analyzovať No Textová hodnota XML ako text alebo predtým definovaná premenná obsahujúca dokument XML, ktorý sa má analyzovať
XPath dopyt No Textová hodnota Výraz XPath , ktorý sa má vykonať proti dokumentu XML
Získať iba prvú hodnotu Neaplikovateľné Booleovská hodnota Nepravdivé Určuje, či sa má načítať jedna hodnota (iba prvá hodnota) alebo všetky hodnoty, ktoré sa zhodujú s poskytnutým XPath výrazom

Premenné sú vytvorené

Argument Type Description
XPathResult XML uzol Extrahované uzly ako uzol XML
XPathResults Zoznam z XML uzlov Extrahované uzly ako zoznam uzlov XML

Výnimky

Výnimka Popis
Poskytnutý neplatný dokument XML Označuje, že poskytnutý dokument XML je neplatný
Zadaný neplatný XPath výraz Označuje, že zadaný výraz XPath je neplatný

Získať atribút prvku XML

Načíta hodnotu atribútu prvku XML.

Vstupné parametre

Argument Voliteľné Akceptuje Predvolená hodnota Description
Dokument XML No XML uzol Dokument XML alebo prvok XML, ktorého atribút sa má načítať
XPath dopyt Áno Textová hodnota Výraz XPath na nájdenie podprvku a získanie jeho atribútu
Attribute name No Textová hodnota Názov atribútu, ktorého hodnota sa má načítať
Získať hodnotu ako Neaplikovateľné Textová hodnota, Číselná hodnota, Hodnota Datetime, Booleovská hodnota Textová hodnota Určuje typ údajov pre hodnotu atribútu

Premenné sú vytvorené

Argument Type Description
XmlAttributeValue Booleovská hodnota Načítaná hodnota atribútu XML
XmlAttributeValue Dátum Čas Načítaná hodnota atribútu XML
XmlAttributeValue Číselná hodnota Načítaná hodnota atribútu XML
XmlAttributeValue Textová hodnota Načítaná hodnota atribútu XML

Výnimky

Výnimka Description
Zadaný neplatný XPath výraz Označuje, že zadaný výraz XPath je neplatný
XPath výraz nevracia žiadny prvok Označuje, že výraz XPath nevracia žiadny prvok
Atribút sa v prvku nenašiel Označuje, že atribút v danom prvku neexistuje
Nepodarilo sa konvertovať hodnotu atribútu na požadovaný typ údajov Označuje problém s konverziou hodnoty atribútu na požadovaný typ údajov

Nastaviť atribút prvku XML

Nastaví hodnotu atribútu prvku XML.

Vstupné parametre

Argument Voliteľné Akceptuje Predvolená hodnota Description
Dokument XML No XML uzol Dokument XML alebo prvok XML, ktorého atribút sa má nastaviť
XPath dopyt Áno Textová hodnota Výraz XPath na vyhľadanie podprvku a nastavenie jeho atribútu
Attribute name No Textová hodnota Názov atribútu, ktorého hodnota sa má nastaviť
Hodnota atribútu No Textová hodnota Nová hodnota atribútu

Premenné sú vytvorené

Táto akcia nevytvára žiadne premenné.

Výnimky

Výnimka Description
Zadaný neplatný XPath výraz Označuje, že zadaný výraz XPath je neplatný
XPath výraz nevracia žiadny prvok Označuje, že výraz XPath nevracia žiadny prvok
Nepodarilo sa nastaviť atribút XML Označuje problém s nastavením atribútu XML

Odstrániť atribút prvku XML

Odstráni atribút z prvku XML.

Vstupné parametre

Argument Voliteľné Akceptuje Predvolená hodnota Description
Dokument XML No XML uzol Dokument XML alebo prvok XML, ktorého atribút sa má odstrániť
XPath dopyt Áno Textová hodnota Výraz XPath na nájdenie podprvku a odstránenie jeho atribútu
Attribute name No Textová hodnota Názov atribútu, ktorý sa má odstrániť

Premenné sú vytvorené

Táto akcia nevytvára žiadne premenné.

Výnimky

Výnimka Description
Zadaný neplatný XPath výraz Označuje, že zadaný výraz XPath je neplatný
XPath výraz nevracia žiadny prvok Označuje, že výraz XPath nevracia žiadny prvok
Atribút sa v prvku nenašiel Označuje, že atribút v danom prvku neexistuje
Nepodarilo sa odstrániť atribút XML Označuje problém pri odstraňovaní atribútu XML

Získať hodnotu prvku XML

Načíta hodnotu prvku XML.

Vstupné parametre

Argument Voliteľné Akceptuje Predvolená hodnota Description
Dokument XML No XML uzol Dokument XML alebo prvok XML, ktorého hodnota sa má načítať
XPath dopyt Áno Textová hodnota Výraz XPath na nájdenie podprvku a načítanie jeho hodnoty
Získať hodnotu ako Neaplikovateľné Textová hodnota, Číselná hodnota, Hodnota Datetime, Booleovská hodnota Textová hodnota Určuje typ údajov pre hodnotu prvku XML

Premenné sú vytvorené

Argument Type Description
XmlElementValue Booleovská hodnota Hodnota prvku XML
XmlElementValue Dátum Čas Hodnota prvku XML
XmlElementValue Číselná hodnota Hodnota prvku XML
XmlElementValue Textová hodnota Hodnota prvku XML

Výnimky

Výnimka Description
Zadaný neplatný XPath výraz Označuje, že zadaný výraz XPath je neplatný
XPath výraz nevracia žiadny prvok Označuje, že výraz XPath nevracia žiadny prvok
Nepodarilo sa konvertovať hodnotu prvku na požadovaný typ údajov Označuje problém s konverziou hodnoty prvku na požadovaný typ údajov

Nastaviť hodnotu prvku XML

Nastaví hodnotu prvku XML.

Vstupné parametre

Argument Voliteľné Akceptuje Predvolená hodnota Description
Dokument XML No XML uzol Dokument XML alebo prvok XML, ktorého hodnota sa má načítať
XPath dopyt Áno Textová hodnota Výraz XPath na nájdenie podprvku a načítanie jeho hodnoty
Hodnota prvku XML No Textová hodnota Nová hodnota prvku XML

Premenné sú vytvorené

Táto akcia nevytvára žiadne premenné.

Výnimky

Výnimka Description
Zadaný neplatný XPath výraz Označuje, že zadaný výraz XPath je neplatný
XPath výraz nevracia žiadny prvok Označuje, že výraz XPath nevracia žiadny prvok
Nepodarilo sa nastaviť hodnotu prvku Označuje problém s nastavením hodnoty prvku

Vložiť prvok XML

Vloží nový prvok XML do dokumentu XML.

Vstupné parametre

Argument Voliteľné Akceptuje Predvolená hodnota Description
Dokument XML No XML uzol Dokument XML, do ktorého sa má vložiť nový prvok XML
XPath dopyt No Textová hodnota Výraz XPath na vyhľadanie rodičovského prvku XML a vloženie nového prvku do neho
Prvok XML, ktorý sa má vložiť No XML uzol Nový prvok XML, ktorý sa má vložiť do dokumentu XML

Premenné sú vytvorené

Táto akcia nevytvára žiadne premenné.

Výnimky

Výnimka Description
Zadaný neplatný XPath výraz Označuje, že zadaný výraz XPath je neplatný
XPath výraz nevracia žiadny prvok Označuje, že výraz XPath nevracia žiadny prvok
Nepodarilo sa vložiť prvok XML Označuje problém s vložením prvku XML

Odstrániť prvok XML

Odstráni najmenej jeden prvok XML z dokumentu XML.

Vstupné parametre

Argument Voliteľné Akceptuje Predvolená hodnota Description
Dokument XML No XML uzol Dokument XML obsahujúci prvky XML, ktoré sa majú odstrániť
XPath dopyt No Textová hodnota Výraz XPath na nájdenie prvkov, ktoré chcete odstrániť

Premenné sú vytvorené

Táto akcia nevytvára žiadne premenné.

Výnimky

Výnimka Description
Zadaný neplatný XPath výraz Označuje, že zadaný výraz XPath je neplatný
Nepodarilo sa odstrániť prvok XML Označuje problém s odstránením prvku XML