Acciones XML
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.
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.
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 |
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de