Partajați prin

Acțiuni XML

  • Articol

Power Automate oferă capacitatea de a utiliza fluxuri desktop pentru a gestiona atributele și elementele XML.

Pentru a citi un fișier XML, utilizați acțiunea Citiți XML din fișier . Specificați calea sau căutați fișierul și selectați una dintre opțiunile de codificare.

După selectarea unui fișier, utilizați acțiunea Execute XPath expression pentru a rula o interogare Xpath. Următorul exemplu utilizează o variabilă produsă din acțiunea Citiți XML din fișier pentru a specifica documentul.

Captură de ecran a acțiunii Execute XPath expression.

Pentru a prelua un atribut dintr-un fișier XML, utilizați acțiunea Obțineți atribut XML . În exemplul următor, starea este un atribut al client, care este un element al clientlist. Valoarea va fi obținută ca valoare text.

Captură de ecran a acțiunii Obțineți atributul XML.

În mod similar, pentru a prelua valorile elementelor, utilizați acțiunea Obțineți valoarea elementului XML . Puteți gestiona elemente și atribute folosind acțiunea respectivă pentru a obține, seta sau elimina atribute sau elemente XML.

Citire XML din fișier

Citiți conținutul unui fișier XML într-o variabilă.

Parametri de intrare

Argument Opțional Acceptă Valoare implicită Descriere
Cale fișier No Fişier Fișierul care conține documentul XML de citit
Codificare Nedisponibil Implicit de sistem, ASCII, Unicode, Unicode big endian, UTF-8 Valoare implicită de sistem Codificarea utilizată pentru fișierul specificat

Variabile produse

Argument Tipul Descriere
XmlDocument Nodul XML Variabila care stochează documentul XML citit

Excepții

Excepție Descriere
Directorul nu a fost găsit Indică faptul că directorul nu există
Fișierul nu a fost găsit Indică faptul că fișierul nu există
Citirea din fișier nu a reușit Indică o problemă la citirea din fișier
Fișierul nu conține un document XML valid Indică faptul că fișierul nu conține un document XML valid

Scriere XML în fișier

Scrieți conținutul unei variabile a unui nod XML într-un fișier.

Parametri de intrare

Argument Opțional Acceptă Valoare implicită Descriere
Cale fișier No Fişier Fișierul în care se scrie documentul XML
XML de scris No Valoare text Nodul sau documentul XML care se scrie în fișier
Codificare Nedisponibil Implicit de sistem, ASCII, Unicode, Unicode big endian, UTF-8 Valoare implicită de sistem Codificarea utilizată pentru fișierul specificat
Format XML Nedisponibil Valoare booleană Adevărat Specifică dacă XML trebuie formatat
Indentare pe nivel Da Valoare numerica 2 Specifică cu câte spații se indentează fiecare nivel al XML

Variabile produse

Această acțiune nu produce nicio variabilă.

Excepții

Excepție Descriere
Directorul specificat este nevalid Indică faptul că directorul specificat este nevalid
Scrierea XML în fișier nu a reușit Indică o problemă la scrierea XML în fișier

Executați XPath expresia

Extrageți valori dintr-un document XML pe baza XPath interogării furnizate.

Parametri de intrare

Argument Opțional Acceptă Valoare implicită Descriere
Document XML de analizat No Valoare text XML ca text sau o variabilă definită anterior care conține documentul XML de analizat
XPath interogare No Valoare text XPath Expresia de executat în raport cu documentul XML
Obțineți numai prima valoare Nedisponibil Valoare booleană Fals Specifică dacă se regăsește o singură valoare (doar prima valoare) sau toate valorile care se potrivesc cu expresia XPath furnizată

Variabile produse

Argument Tipul Descriere
XPathResult Nodul XML Nodurile extrase ca nod XML
XPathResults Lista de noduri XML Nodurile extrase ca listă de noduri XML

Excepții

Excepție Descriere
Documentul XML furnizat este nevalid Indică faptul că documentul XML furnizat este nevalid
Expresie XPath nevalidă furnizată Indică faptul că XPath expresia furnizată este nevalidă

Obținere atribut element XML

Obțineți valoarea unui atribut al unui element XML.

Parametri de intrare

Argument Opțional Acceptă Valoare implicită Descriere
Document XML No Nodul XML Documentul XML sau elementul XML al cărui atribut trebuie regăsit
XPath interogare Da Valoare text XPath Expresia pentru a localiza subelementul și a prelua atributul acestuia
Nume atribut No Valoare text Numele atributului pentru regăsirea valorii sale
Obțineți valoarea ca Nedisponibil Valoare text, valoare numerică, valoare datetime, valoare booleană Valoare text Specifică tipul de date pentru valoarea atributului

Variabile produse

Argument Tipul Descriere
XmlAttributeValue Valoare booleană Valoarea regăsită a atributului XML
XmlAttributeValue Datetime Valoarea regăsită a atributului XML
XmlAttributeValue Valoare numerica Valoarea regăsită a atributului XML
XmlAttributeValue Valoare text Valoarea regăsită a atributului XML

Excepții

Excepție Descriere
Expresie XPath nevalidă furnizată Indică faptul că XPath expresia furnizată este nevalidă
XPath expresia nu returnează niciun element Indică faptul că XPath expresia nu returnează niciun element
Atributul nu a fost găsit în element Indică faptul că atributul nu există în element
Nu s-a putut converti valoarea atributului la tipul de date solicitat Indică o problemă la conversia valorii atributului la tipul de date solicitat

Setare atribut de element XML

Setați valoarea unui atribut al unui element XML.

Parametri de intrare

Argument Opțional Acceptă Valoare implicită Descriere
Document XML No Nodul XML Documentul XML sau elementul XML al cărui atribut trebuie setat
XPath interogare Da Valoare text XPath Expresia pentru a localiza subelementul și a seta atributul acestuia
Nume atribut No Valoare text Numele atributului pentru setarea valorii sale
Valoare atribut No Valoare text Noua valoare a atributului

Variabile produse

Această acțiune nu produce nicio variabilă.

Excepții

Excepție Descriere
Expresie XPath nevalidă furnizată Indică faptul că XPath expresia furnizată este nevalidă
XPath expresia nu returnează niciun element Indică faptul că XPath expresia nu returnează niciun element
Nu s-a putut seta atributul XML Indică o problemă la setarea atributului XML

Eliminare atribut de element XML

Eliminați un atribut dintr-un element XML.

Parametri de intrare

Argument Opțional Acceptă Valoare implicită Descriere
Document XML No Nodul XML Documentul XML sau elementul XML al cărui atribut trebuie eliminat
XPath interogare Da Valoare text XPath Expresia pentru a localiza subelementul și a elimina atributul acestuia
Nume atribut No Valoare text Numele atributului de eliminat

Variabile produse

Această acțiune nu produce nicio variabilă.

Excepții

Excepție Descriere
Expresie XPath nevalidă furnizată Indică faptul că XPath expresia furnizată este nevalidă
XPath expresia nu returnează niciun element Indică faptul că XPath expresia nu returnează niciun element
Atributul nu a fost găsit în element Indică faptul că atributul nu există în element
Nu s-a putut elimina atributul XML Indică o problemă la eliminarea atributului XML

Obținere valoare element XML

Obțineți valoarea unui element XML.

Parametri de intrare

Argument Opțional Acceptă Valoare implicită Descriere
Document XML No Nodul XML Documentul XML sau elementul XML a cărui valoare trebuie regăsită
XPath interogare Da Valoare text XPath Expresia pentru a localiza subelementul și a prelua valoarea acestuia
Obțineți valoarea ca Nedisponibil Valoare text, valoare numerică, valoare datetime, valoare booleană Valoare text Specifică tipul de date pentru valoarea elementului XML

Variabile produse

Argument Tipul Descriere
XmlElementValue Valoare booleană Valoarea elementului XML
XmlElementValue Datetime Valoarea elementului XML
XmlElementValue Valoare numerica Valoarea elementului XML
XmlElementValue Valoare text Valoarea elementului XML

Excepții

Excepție Descriere
Expresie XPath nevalidă furnizată Indică faptul că XPath expresia furnizată este nevalidă
XPath expresia nu returnează niciun element Indică faptul că XPath expresia nu returnează niciun element
Nu s-a putut converti valoarea elementului la tipul de date solicitat Indică o problemă la conversia valorii elementului la tipul de date solicitat

Setare valoare element XML

Setați valoarea unui element XML.

Parametri de intrare

Argument Opțional Acceptă Valoare implicită Descriere
Document XML No Nodul XML Documentul XML sau elementul XML a cărui valoare trebuie regăsită
XPath interogare Da Valoare text XPath Expresia pentru a localiza subelementul și a prelua valoarea acestuia
Valoarea elementului XML No Valoare text Noua valoare a elementului XML

Variabile produse

Această acțiune nu produce nicio variabilă.

Excepții

Excepție Descriere
Expresie XPath nevalidă furnizată Indică faptul că XPath expresia furnizată este nevalidă
XPath expresia nu returnează niciun element Indică faptul că XPath expresia nu returnează niciun element
Valoarea elementului nu a putut fi setată Indică o problemă la setarea valorii elementului

Inserare element XML

Inserați un nou element XML într-un document XML.

Parametri de intrare

Argument Opțional Acceptă Valoare implicită Descriere
Document XML No Nodul XML Documentul XML pentru inserarea noului element XML
XPath interogare No Valoare text XPath Expresia pentru a localiza elementul XML părinte și pentru a introduce noul element în el
Elementul XML de inserat No Nodul XML Noul element XML de inserat în documentul XML

Variabile produse

Această acțiune nu produce nicio variabilă.

Excepții

Excepție Descriere
Expresie XPath nevalidă furnizată Indică faptul că XPath expresia furnizată este nevalidă
XPath expresia nu returnează niciun element Indică faptul că XPath expresia nu returnează niciun element
Nu s-a putut insera elementul XML Indică o problemă la inserarea elementului XML

Eliminare element XML

Eliminați unul sau mai multe elemente XML dintr-un document XML.

Parametri de intrare

Argument Opțional Acceptă Valoare implicită Descriere
Document XML No Nodul XML Documentul XML care conține elementele XML de eliminat
XPath interogare No Valoare text XPath Expresia pentru a localiza elementele de eliminat

Variabile produse

Această acțiune nu produce nicio variabilă.

Excepții

Excepție Descriere
Expresie XPath nevalidă furnizată Indică faptul că XPath expresia furnizată este nevalidă
Eliminarea elementului XML nu a reușit Indică o problemă la eliminarea elementului XML