Comparteix a través de

Accions de la XML

  • Article

Power Automate proporciona la capacitat d'utilitzar fluxos d'escriptori per gestionar atributs i elements XML.

Per llegir un fitxer XML, utilitzeu l'acció Llegiu XML de fitxer . Especifiqueu el camí o navegueu pel fitxer i seleccioneu una de les opcions de codificació.

Després de seleccionar un fitxer, utilitzeu l'acció Executa l'expressió XPath per executar una consulta Xpath. L'exemple següent utilitza una variable produïda de l'acció Read XML from file per especificar el document.

Captura de pantalla de l'acció Executa XPath l'expressió.

Per recuperar un atribut d'un fitxer XML, utilitzeu l'acció Obtén l'atribut XML. En l'exemple següent, status és un atribut de client , que és un element declientlist. El valor s'obtindrà com a valor de text.

Captura de pantalla de l'acció Obtén l'atribut XML.

De la mateixa manera, per recuperar els valors dels elements, utilitzeu l'acció Obtén el valor de l'element XML. Podeu administrar elements i atributs mitjançant l'acció corresponent per obtenir, definir o eliminar atributs o elements XML.

Llegeix XML del fitxer

Llegeix el contingut d'un fitxer XML en una variable.

Paràmetres d’entrada

Argument Opcional Accepta Valor per defecte Descripció
Camí de l'arxiu No Fitxer El fitxer que conté el document XML que es llegirà
Codificació N/A Per defecte del sistema, ASCII, Unicode, Unicode big endian, UTF-8 Valor per defecte del sistema La codificació utilitzada per al fitxer especificat

Variables generades

Argument Type Descripció
XmlDocument Node XML La variable que conté el document XML que es llegirà

Excepcions

Excepció Descripció
El directori no s'ha trobat Indica que el directori no existeix
No s’ha trobat el fitxer Indica que el fitxer no existeix
No s'ha pogut llegir el fitxer Indica un problema en llegir del fitxer
El fitxer no conté un document XML vàlid Indica que el fitxer no conté un document XML vàlid

Escriu l'XML al fitxer

Escriu el contingut d'una variable de node XML en un fitxer.

Paràmetres d’entrada

Argument Opcional Accepta Valor per defecte Descripció
Camí de l'arxiu No Fitxer El fitxer on s'escriurà la informació del document XML
XML que s'escriurà No Valor del text El node o document XML que s'escriurà al fitxer
Codificació N/A Per defecte del sistema, ASCII, Unicode, Unicode big endian, UTF-8 Valor per defecte del sistema La codificació utilitzada per al fitxer especificat
XML de format N/A Valor booleà Cert Especifica si es formatarà l'XML
Sagnia per nivell Sí Valor numèric 2 Especifica quants espais de sagnia s'aplicaran a cada nivell de l'XML

Variables generades

Aquesta acció no produeix cap variable.

Excepcions

Excepció Descripció
S'ha especificat un directori no vàlid Indica que el directori especificat no és vàlid
No s'ha pogut escriure XML al fitxer Indica un problema en escriure XML al fitxer

Executar XPath l'expressió

Extraieu valors d'un document XML en funció de la consulta proporcionada XPath .

Paràmetres d’entrada

Argument Opcional Accepta Valor per defecte Descripció
Document XML que s'analitzarà No Valor del text L'XML com a text o una variable definida prèviament que conté el document XML que s'analitzarà
XPath consulta No Valor del text L'expressió XPath a executar contra el document XML
Obtén només el primer valor N/A Valor booleà Fals Especifica si s'ha de recuperar un sol valor (només el primer valor) o tots els valors que coincideixin amb l'expressió proporcionada XPath

Variables generades

Argument Type Descripció
XPathResultat Node XML Els nodes extrets com a node XML
XPathResults Llista de nodes XML Els nodes extrets com a llista de nodes XML

Excepcions

Excepció Descripció
S'ha proporcionat un document XML no vàlid Indica que el document XML proporcionat no és vàlid
Es proporciona una expressió no vàlida XPath Indica que l'expressió proporcionada XPath no és vàlida

Obtén l'atribut de l'element XML

Obtén el valor d'un atribut d'un element XML.

Paràmetres d’entrada

Argument Opcional Accepta Valor per defecte Descripció
Document XML No Node XML El document XML o l'element XML del qual es recupera l'atribut
XPath consulta Sí Valor del text L'expressió XPath per localitzar el subelement i recuperar el seu atribut
Nom de l'atribut No Valor del text Nom de l'atribut del qual es recupera el valor
Obtén el valor com a N/A Valor del text, Valor numèric, Valor de data, Valor booleà Valor de text Especifica el tipus de dades del valor de l'atribut

Variables generades

Argument Type Descripció
XmlAttributeValue Valor booleà El valor recuperat de l'atribut XML
XmlAttributeValue Datació El valor recuperat de l'atribut XML
XmlAttributeValue Valor numèric El valor recuperat de l'atribut XML
XmlAttributeValue Valor del text El valor recuperat de l'atribut XML

Excepcions

Excepció Descripció
Es proporciona una expressió no vàlida XPath Indica que l'expressió proporcionada XPath no és vàlida
XPath L'expressió no retorna cap element Indica que l'expressió XPath no retorna cap element
L'atribut no s'ha trobat a l'element Indica que l'atribut no existeix a l'element
No s'ha pogut convertir el valor de l'atribut al tipus de dades sol·licitat Indica un problema en convertir el valor de l'atribut al tipus de dades sol·licitat

Defineix l'atribut de l'element XML

Defineix el valor d'un atribut d'un element XML.

Paràmetres d’entrada

Argument Opcional Accepta Valor per defecte Descripció
Document XML No Node XML El document XML o l'element XML del qual es definirà l'atribut
XPath consulta Sí Valor del text L'expressió XPath per localitzar el subelement i establir el seu atribut
Nom de l'atribut No Valor del text El nom de l'atribut del qual es definirà el valor
Valor de l'atribut No Valor del text El valor nou de l'atribut

Variables generades

Aquesta acció no produeix cap variable.

Excepcions

Excepció Descripció
Es proporciona una expressió no vàlida XPath Indica que l'expressió proporcionada XPath no és vàlida
XPath L'expressió no retorna cap element Indica que l'expressió XPath no retorna cap element
No s'ha pogut definir l'atribut XML Indica un problema en configurar l'atribut XML

Suprimeix l'atribut de l'element XML

Suprimeix un atribut d'un element XML.

Paràmetres d’entrada

Argument Opcional Accepta Valor per defecte Descripció
Document XML No Node XML El document XML o l'element XML del qual se suprimirà l'atribut
XPath consulta Sí Valor del text L'expressió XPath per localitzar el subelement i treure'n l'atribut
Nom de l'atribut No Valor del text El nom d'atribut de l'atribut que se suprimirà

Variables generades

Aquesta acció no produeix cap variable.

Excepcions

Excepció Descripció
Es proporciona una expressió no vàlida XPath Indica que l'expressió proporcionada XPath no és vàlida
XPath L'expressió no retorna cap element Indica que l'expressió XPath no retorna cap element
L'atribut no s'ha trobat a l'element Indica que l'atribut no existeix a l'element
No s'ha pogut suprimir l'atribut XML Indica un problema en eliminar l'atribut XML

Obtén el valor de l'element XML

Obtén el valor d'un element XML.

Paràmetres d’entrada

Argument Opcional Accepta Valor per defecte Descripció
Document XML No Node XML El document XML o l'element XML del qual es recupera el valor
XPath consulta Sí Valor del text L'expressió XPath per localitzar el subelement i recuperar el seu valor
Obtén el valor com a N/A Valor del text, Valor numèric, Valor de data, Valor booleà Valor de text Especifica el tipus de dades del valor de l'element XML

Variables generades

Argument Type Descripció
XmlElementValue Valor booleà El valor de l'element XML
XmlElementValue Datació El valor de l'element XML
XmlElementValue Valor numèric El valor de l'element XML
XmlElementValue Valor del text El valor de l'element XML

Excepcions

Excepció Descripció
Es proporciona una expressió no vàlida XPath Indica que l'expressió proporcionada XPath no és vàlida
XPath L'expressió no retorna cap element Indica que l'expressió XPath no retorna cap element
No s'ha pogut convertir el valor de l'element al tipus de dades sol·licitat Indica un problema en convertir el valor de l'element al tipus de dades sol·licitat

Defineix el valor de l'element XML

Defineix el valor d'un element XML.

Paràmetres d’entrada

Argument Opcional Accepta Valor per defecte Descripció
Document XML No Node XML El document XML o l'element XML del qual es recupera el valor
XPath consulta Sí Valor del text L'expressió XPath per localitzar el subelement i recuperar el seu valor
Valor de l'element XML No Valor del text El valor nou de l'element XML

Variables generades

Aquesta acció no produeix cap variable.

Excepcions

Excepció Descripció
Es proporciona una expressió no vàlida XPath Indica que l'expressió proporcionada XPath no és vàlida
XPath L'expressió no retorna cap element Indica que l'expressió XPath no retorna cap element
No s'ha pogut definir el valor de l'element Indica un problema en definir el valor de l'element

Insereix l'element XML

Insereix un nou element XML en un document XML.

Paràmetres d’entrada

Argument Opcional Accepta Valor per defecte Descripció
Document XML No Node XML El document XML on s'inserirà el nou element XML
XPath consulta No Valor del text L'expressió XPath per localitzar l'element XML pare i inserir-hi el nou element
Element XML que s'inserirà No Node XML El nou element XML que s'inserirà al document XML

Variables generades

Aquesta acció no produeix cap variable.

Excepcions

Excepció Descripció
Es proporciona una expressió no vàlida XPath Indica que l'expressió proporcionada XPath no és vàlida
XPath L'expressió no retorna cap element Indica que l'expressió XPath no retorna cap element
No s'ha pogut inserir l'element XML Indica un problema en inserir l'element XML

Suprimeix l'element XML

Suprimeix un o més elements XML d'un document XML.

Paràmetres d’entrada

Argument Opcional Accepta Valor per defecte Descripció
Document XML No Node XML El document XML que conté els elements XML que se suprimiran
XPath consulta No Valor del text L'expressió XPath per localitzar els elements a eliminar

Variables generades

Aquesta acció no produeix cap variable.

Excepcions

Excepció Descripció
Es proporciona una expressió no vàlida XPath Indica que l'expressió proporcionada XPath no és vàlida
No s'ha pogut suprimir l'element XML Indica un problema en suprimir l'element XML