Ações da XML

O Power Automate fornece a capacidade de usar fluxos da área de trabalho para gerenciar atributos e elementos XML.

Para ler um arquivo XML, use a ação Ler o XML do arquivo. Especifique o caminho ou navegue até o arquivo e selecione uma das opções de codificação.

Depois de selecionar um arquivo, use a ação Executar expressão XPath para executar uma consulta Xpath. O exemplo a seguir usa uma variável produzida da ação Ler XML do arquivo para especificar o documento.

Para recuperar um atributo de um arquivo XML, use a ação Obter atributo de XML. No exemplo a seguir, o status é um atributo do cliente, que é um elemento de clientlist. O valor será obtido como um valor de texto.

Da mesma forma, para recuperar valores de elemento, use a ação Obter o valor do elemento XML. Você pode gerenciar elementos e atributos usando a respectiva ação para obter, definir ou remover atributos ou elementos XML.

Ler XML do arquivo

Leia o conteúdo de um arquivo XML em uma variável.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Descrição
Caminho do arquivo	Não	Arquivo		O arquivo que contém o documento XML a ser lido
Codificação	N/D	Padrão do sistema, ASCII, Unicode, Unicode big endian, UTF-8	Padrão do sistema	A codificação usada para o arquivo especificado

Variáveis produzidas

Argumento	Type	Description
XmlDocument	Nó XML	A variável que contém o documento XML de leitura

Exceções

Exceção	Descrição
Directory not found	Indica que o diretório não existe
File not found	Indica que o arquivo não existe
Failed to read from file	Indica um problema ao ler do arquivo
File doesn't contain a valid XML document	Indica que o arquivo não contém um documento XML válido

Gravar XML em arquivo

Grave o conteúdo de uma variável de nó XML em um arquivo.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Caminho do arquivo	Não	Arquivo		O arquivo no qual gravar o documento XML
XML a ser gravado	Não	Valor do texto		O nó ou documento XML para gravar no arquivo
Codificação	N/D	Padrão do sistema, ASCII, Unicode, Unicode big endian, UTF-8	Padrão do sistema	A codificação usada para o arquivo especificado
Formatar XML	N/D	Valor booliano	Verdadeiro	Especifica se o XML deve ser formatado
Recuo por nível	Sim	Valor numérico	2	Especifica o número de espaços de recuo em cada nível do XML

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Description
Invalid directory specified	Indica que o diretório especificado é inválido
Falha ao gravar XML em arquivo	Indica um problema ao gravar XML no arquivo

Executar expressão XPath

Extrair valores de um documento XML com base na consulta XPath.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Descrição
Documento XML a ser analisado	Não	Valor do texto		O XML como texto ou uma variável predefinida que contém o documento XML a ser analisado
Consulta XPath	Não	Valor do texto		A expressão XPath a ser executada no documento XML
Obter somente o primeiro valor	N/D	Valor booliano	Falso	Especifica se deve recuperar um único valor (somente o primeiro valor) ou todos os valores que correspondam à expressão XPath fornecida

Variáveis produzidas

Argumento	Tipo	Descrição
XPathResult	Nó XML	Os nós extraídos como um nó XML
XPathResults	Lista de Nós de XML	Os nós extraídos como uma lista de nós XML

Exceções

Exceção	Descrição
Invalid XML document provided	Indica que o documento XML fornecido é inválido
Expressão XPath inválida fornecida	Indica que a expressão XPath fornecida é inválida

Obter atributo de elemento XML

Obtenha o valor de um atributo de um elemento XML.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Descrição
Documento XML	Não	Nó XML		O documento XML ou o elemento XML para recuperar seu atributo
Consulta XPath	Sim	Valor do texto		A expressão XPath para localizar o subelemento e recuperar seu atributo
Nome do atributo	Não	Valor do texto		O nome do atributo para recuperar seu valor
Obter valor como	N/D	Valor de texto, valor numérico, valor de datetime, valor booliano	Valor do texto	Especifica o tipo de dados do valor do atributo

Variáveis produzidas

Argumento	Tipo	Descrição
XmlAttributeValue	Valor booliano	O valor recuperado do atributo XML
XmlAttributeValue	Data/hora	O valor recuperado do atributo XML
XmlAttributeValue	Valor numérico	O valor recuperado do atributo XML
XmlAttributeValue	Valor do texto	O valor recuperado do atributo XML

Exceções

Exceção	Descrição
Expressão XPath inválida fornecida	Indica que a expressão XPath fornecida é inválida
A expressão XPath não retorna elementos	Indica que a expressão XPath não retorna elementos
Atributo não encontrado no elemento	Indica que o atributo não existe no elemento
Falha ao converter valor de atributo no tipo de dados solicitado	Indica um problema ao converter o valor do atributo no tipo de dados solicitado

Definir atributo de elemento XML

Defina o valor de um atributo de um elemento XML.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Descrição
Documento XML	Não	Nó XML		O documento XML ou o elemento XML para definir seu atributo
Consulta XPath	Sim	Valor do texto		A expressão XPath para localizar o subelemento e definir seu atributo
Nome do atributo	Não	Valor do texto		O nome do atributo para definir seu valor
Valor do atributo	Não	Valor do texto		O novo valor do atributo

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Descrição
Expressão XPath inválida fornecida	Indica que a expressão XPath fornecida é inválida
A expressão XPath não retorna elementos	Indica que a expressão XPath não retorna elementos
Falha ao definir o atributo XML	Indica um problema ao definir o atributo XML

Remover atributo de elemento XML

Remova um atributo de um elemento XML.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Descrição
Documento XML	Não	Nó XML		O documento XML ou o elemento XML para remover seu atributo
Consulta XPath	Sim	Valor do texto		A expressão XPath para localizar o subelemento e remover seu atributo
Nome do atributo	Não	Valor do texto		O nome do atributo a ser removido

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Descrição
Expressão XPath inválida fornecida	Indica que a expressão XPath fornecida é inválida
A expressão XPath não retorna elementos	Indica que a expressão XPath não retorna elementos
Atributo não encontrado no elemento	Indica que o atributo não existe no elemento
Falha ao remover atributo XML	Indica um problema ao remover o atributo XML

Obter valor de elemento XML

Obtenha o valor de um elemento XML.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Descrição
Documento XML	Não	Nó XML		O documento XML ou o elemento XML para recuperar seu valor
Consulta XPath	Sim	Valor do texto		A expressão XPath para localizar o subelemento e recuperar seu valor
Obter valor como	N/A	Valor de texto, valor numérico, valor de datetime, valor booliano	Valor do texto	Especifica o tipo de dados para o valor do elemento XML

Variáveis produzidas

Argumento	Tipo	Descrição
XmlElementValue	Valor booliano	O valor do elemento XML
XmlElementValue	Data/hora	O valor do elemento XML
XmlElementValue	Valor numérico	O valor do elemento XML
XmlElementValue	Valor do texto	O valor do elemento XML

Exceções

Exceção	Descrição
Expressão XPath inválida fornecida	Indica que a expressão XPath fornecida é inválida
A expressão XPath não retorna elementos	Indica que a expressão XPath não retorna elementos
Failed to convert element value to the requested data type	Indica um problema ao converter o valor do elemento no tipo de dados solicitado

Definir valor de elemento XML

Defina o valor de um elemento XML.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Descrição
Documento XML	Não	Nó XML		O documento XML ou o elemento XML para recuperar seu valor
Consulta XPath	Sim	Valor do texto		A expressão XPath para localizar o subelemento e recuperar seu valor
Valor do elemento XML	Não	Valor do texto		O novo valor do elemento XML

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Descrição
Expressão XPath inválida fornecida	Indica que a expressão XPath fornecida é inválida
A expressão XPath não retorna elementos	Indica que a expressão XPath não retorna elementos
Falha ao definir valor do elemento	Indica um problema ao definir o valor do elemento

Inserir elemento XML

Insira um novo elemento XML em um documento XML.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Descrição
Documento XML	Não	Nó XML		O documento XML para inserir o novo elemento XML
Consulta XPath	Não	Valor do texto		A expressão XPath para localizar o elemento XML pai e inserir o novo elemento nele
Elemento XML a ser inserido	Não	Nó XML		O novo elemento XML para inserir no documento XML

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Descrição
Expressão XPath inválida fornecida	Indica que a expressão XPath fornecida é inválida
A expressão XPath não retorna elementos	Indica que a expressão XPath não retorna elementos
Falha ao inserir elemento XML	Indica um problema ao inserir o elemento XML

Remover elemento XML

Remova um ou mais elementos XML de um documento XML.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Descrição
Documento XML	Não	Nó XML		O documento XML que contém os elementos XML a serem removidos
Consulta XPath	Não	Valor do texto		A expressão XPath para localizar os elementos a serem removidos

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Descrição
Expressão XPath inválida fornecida	Indica que a expressão XPath fornecida é inválida
Falha ao remover elemento XML	Indica um problema ao remover o elemento XML