Compartilhar via

Ações da XML

  • Artigo

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.

Captura de tela da ação Executar expressão XPath.

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.

Captura de tela da ação Obter atributo de XML.

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