Compartir a través de

Acciones XML

  • Artículo

Power Automate proporciona la capacidad de usar flujos de escritorio para administrar atributos y elementos XML.

Para leer un archivo XML, use la acción Leer XML del archivo. Especifique la ruta o busque el archivo y seleccione una de las opciones de codificación.

Después de seleccionar un archivo, use la acción Ejecutar una expresión XPath para ejecutar una solicitud Xpath. El siguiente ejemplo usa una variable producida de la acción Leer XML del archivo para especificar el documento.

Captura de pantalla de la acción Ejecutar expresión XPath

Para recuperar un atributo de un archivo XML, utilice la acción Obtener el atributo del elemento XML. En el archivo XML, estado es un atributo de cliente, que es un elemento de lista de clientes. El valor se obtendrá como valor de texto.

Captura de pantalla de la acción Obtener el atributo de XML.

Del mismo modo, para recuperar los valores de los elementos, utilice la acción Obtener el valor del elemento XML. Puede administrar los elementos y atributos utilizando la acción respectiva para obtener, establecer o eliminar atributos o elementos XML.

Leer XML del archivo

Lee el contenido de un archivo XML en una variable.

Parámetros de entrada

Argumento Opcionales Acepta Valor predeterminado Descripción
Ruta de archivo No Archivo Archivo que contiene el documento XML que se leerá
Codificación N/D Predeterminado del sistema, ASCII, Unicode big endian, UTF-8 Valores predeterminados del sistema Codificación utilizada para leer el archivo especificado

Variables producidas

Argumento Type Descripción
XmlDocument Nodo XML Variable que contiene el documento XML leído

Excepciones

Excepción Descripción
Directorio no encontrado Indica que el directorio no existe
Archivo no encontrado Indica que el archivo no existe
No se pudo leer el archivo Indica un problema al leer el archivo
El archivo no contiene un documento XML válido Indica que el archivo no contiene un documento XML válido

Escribir XML en un archivo

Escribe el contenido de una variable de nodo XML en un archivo.

Parámetros de entrada

Argumento Opcionales Acepta Valor predeterminado Descripción
Ruta de archivo No Archivo Archivo en el que se escribirá el documento XML
XML para escribir No Valor de texto Nodo o documento XML que se escribirá en el archivo
Codificación N/D Predeterminado del sistema, ASCII, Unicode big endian, UTF-8 Valores predeterminados del sistema Codificación utilizada para leer el archivo especificado
XML de formato N/D Valor booleano True Especifica si se debe dar formato al XML
Sangría por nivel Sí Valor numérico 2 Especifica el número de espacios de sangría en cada nivel del código XML

Variables producidas

Esta acción no produce ninguna variable.

Excepciones

Excepción Descripción
El directorio especificado no es válido Indica que el directorio especificado no es válido
No se pudo escribir XML en el archivo Indica un problema al escribir XML en el archivo.

Ejecutar expresión XPath

Extrae valores de un documento XML en función de la consulta de XPath proporcionada.

Parámetros de entrada

Argumento Opcionales Acepta Valor predeterminado Descripción
Documento XML que se va a analizar No Valor de texto El XML como texto o una variable definida anteriormente que contiene el documento XML que se va a analizar.
Consulta XPath No Valor de texto La expresión XPath que se va a ejecutar en el documento XML.
Obtener solo el primer valor N/D Valor booleano False Especifica si se va a recuperar un solo valor (solo el primer valor) o todos los valores que coincidan con la expresión XPath especificada.

Variables producidas

Argumento Tipo Descripción
XPathResult Nodo XML Nodos extraídos como nodo XML
XPathResults Lista de nodos XML Nodos extraídos como lista de nodos XML

Excepciones

Excepción Descripción
Documento XML proporcionado no válido Indica que el documento XML proporcionado no es válido.
Expresión XPath proporcionada no válida Indica que la expresión XPath proporcionada no es válida.

Obtener el atributo del elemento XML

Obtiene el valor de un atributo de un elemento XML.

Parámetros de entrada

Argumento Opcionales Acepta Valor predeterminado Descripción
Documento XML No Nodo XML Documento o elemento XML para recuperar su atributo
Consulta XPath Sí Valor de texto La expresión XPath para buscar el subelemento y recuperar su atributo.
Attribute name No Valor de texto Nombre del atributo para recuperar su valor
Obtener valor como N/D Valor de texto, Valor numérico, Valor de fecha y hora, Valor booleano Valor de texto Especifica el tipo de datos para el valor de atributo

Variables producidas

Argumento Type Descripción
XmlAttributeValue Valor booleano Valor recuperado del atributo XML
XmlAttributeValue Fecha y hora Valor recuperado del atributo XML
XmlAttributeValue Valor numérico Valor recuperado del atributo XML
XmlAttributeValue Valor de texto El valor recuperado del atributo XML.

Excepciones

Excepción Descripción
Expresión XPath proporcionada no válida Indica que la expresión XPath proporcionada no es válida.
La expresión XPath no devuelve ningún elemento Indica que la expresión XPath no devuelve elementos.
No se encontró el atributo en el elemento Indica que el atributo no existe en el elemento
No se pudo convertir el valor del atributo al tipo de datos solicitado Indica un problema al convertir el valor del atributo al tipo de datos solicitado

Establecer el atributo del elemento XML

Establece el valor de un atributo de un elemento XML.

Parámetros de entrada

Argumento Opcionales Acepta Valor predeterminado Descripción
Documento XML No Nodo XML Documento o elemento XML para establecer su atributo
Consulta XPath Sí Valor de texto La expresión XPath para buscar el subelemento y establecer su atributo.
Attribute name No Valor de texto Nombre del atributo para establecer su valor
Valor de atributo No Valor de texto Nuevo valor del atributo

Variables producidas

Esta acción no produce ninguna variable.

Excepciones

Excepción Descripción
Expresión XPath proporcionada no válida Indica que la expresión XPath proporcionada no es válida.
La expresión XPath no devuelve ningún elemento Indica que la expresión XPath no devuelve elementos.
No se pudo establecer el atributo XML Indica un problema al establecer el atributo XML

Quitar el atributo del elemento XML

Quita un atributo de un elemento XML.

Parámetros de entrada

Argumento Opcionales Acepta Valor predeterminado Descripción
Documento XML No Nodo XML Documento o elemento XML para quitar su atributo
Consulta XPath Sí Valor de texto La expresión XPath para buscar el subelemento y quitar su atributo.
Attribute name No Valor de texto Nombre del atributo que se va a quitar

Variables producidas

Esta acción no produce ninguna variable.

Excepciones

Excepción Descripción
Expresión XPath proporcionada no válida Indica que la expresión XPath proporcionada no es válida.
La expresión XPath no devuelve ningún elemento Indica que la expresión XPath no devuelve elementos.
No se encontró el atributo en el elemento Indica que el atributo no existe en el elemento
No se pudo quitar el atributo XML Indica un problema al quitar el atributo XML

Obtener el valor del elemento XML

Obtiene el valor de un elemento XML.

Parámetros de entrada

Argumento Opcionales Acepta Valor predeterminado Descripción
Documento XML No Nodo XML Documento o elemento XML para recuperar su valor
Consulta XPath Sí Valor de texto La expresión XPath para buscar el subelemento y recuperar su valor.
Obtener valor como N/A Valor de texto, Valor numérico, Valor de fecha y hora, Valor booleano Valor de texto Especifica el tipo de datos para el valor del elemento XML

Variables producidas

Argumento Type Descripción
XmlElementValue Valor booleano Valor del elemento XML
XmlElementValue Fecha y hora Valor del elemento XML
XmlElementValue Valor numérico Valor del elemento XML
XmlElementValue Valor de texto El valor del elemento XML.

Excepciones

Excepción Descripción
Expresión XPath proporcionada no válida Indica que la expresión XPath proporcionada no es válida.
La expresión XPath no devuelve ningún elemento Indica que la expresión XPath no devuelve elementos.
No se pudo convertir el valor del elemento al tipo de datos solicitado Indica un problema al convertir el valor del elemento al tipo de datos solicitado

Establecer el valor del elemento XML

Establece el valor de un elemento XML.

Parámetros de entrada

Argumento Opcionales Acepta Valor predeterminado Descripción
Documento XML No Nodo XML Documento o elemento XML para recuperar su valor
Consulta XPath Sí Valor de texto La expresión XPath para buscar el subelemento y recuperar su valor.
Valor del elemento XML No Valor de texto Nuevo valor del elemento XML

Variables producidas

Esta acción no produce ninguna variable.

Excepciones

Excepción Descripción
Expresión XPath proporcionada no válida Indica que la expresión XPath proporcionada no es válida.
La expresión XPath no devuelve ningún elemento Indica que la expresión XPath no devuelve elementos.
No se pudo establecer el valor del elemento Indica un problema al establecer el valor del elemento.

Insertar elemento XML

Inserta un nuevo elemento XML en un documento XML.

Parámetros de entrada

Argumento Opcionales Acepta Valor predeterminado Descripción
Documento XML No Nodo XML El documento XML para insertar el nuevo elemento XML.
Consulta XPath No Valor de texto La expresión XPath para buscar el elemento XML primario e insertar el nuevo elemento en él.
Elemento XML para insertar No Nodo XML Nuevo elemento XML para insertar en el documento XML

Variables producidas

Esta acción no produce ninguna variable.

Excepciones

Excepción Descripción
Expresión XPath proporcionada no válida Indica que la expresión XPath proporcionada no es válida.
La expresión XPath no devuelve ningún elemento Indica que la expresión XPath no devuelve elementos.
No se pudo insertar el elemento XML Indica un problema al insertar el elemento XML

Quitar elemento XML

Quita uno o más elementos XML de un documento XML.

Parámetros de entrada

Argumento Opcionales Acepta Valor predeterminado Descripción
Documento XML No Nodo XML El documento XML que contiene los elementos XML que se quitarán.
Consulta XPath No Valor de texto La expresión XPath para buscar los elementos que se van a quitar.

Variables producidas

Esta acción no produce ninguna variable.

Excepciones

Excepción Descripción
Expresión XPath proporcionada no válida Indica que la expresión XPath proporcionada no es válida.
No se pudo quitar el elemento XML Indica un problema al quitar el elemento XML