Partilhar via

Ações da XML

O Power Automate fornece a capacidade de utilização de fluxos de ambiente de trabalho para gerir atributos e elementos XML.

Para ler um ficheiro XML, utilize a ação Ler XML do ficheiro. Especifique o caminho ou navegue para o ficheiro e selecione uma das opções de codificação.

Depois de selecionar um ficheiro, utilize a ação Executar expressão XPath para executar uma consulta XPath. O exemplo que se segue utiliza uma variável produzida a partir da ação Ler XML do ficheiro para especificar o documento.

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

Para obter um atributo a partir de um ficheiro XML, utilize a ação Obter atributo XML. No exemplo seguinte, o estado é um atributo de cliente, que é um elemento de clientlist. O valor será obtido como um valor de texto.

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

Da mesma forma, para obter valores de elementos, utilize a ação Obter valor de elemento XML. Pode gerir elementos e atributos utilizando a respetiva ação para obter, definir ou remover atributos ou elementos XML.

Ler XML a partir de ficheiro

Ler o conteúdo de um ficheiro XML para uma variável.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Caminho do ficheiro Não Ficheiro O ficheiro que contém o documento XML a ler
Codificação N/D Predefinição do sistema, ASCII, Unicode, Unicode big endian, UTF-8 Predefinição do sistema A codificação utilizada para o ficheiro especificado

Variáveis produzidas

Argumento Tipo Descrição
XmlDocument Nó XML A variável que contém o documento XML lido

Exceções

Exceção Descrição
Diretório não encontrado Indica que o diretório não existe
Ficheiro não encontrado Indica que o ficheiro não existe
Falha ao ler o ficheiro Indica um problema ao ler a partir do ficheiro
O ficheiro não contém um documento XML válido Indica que o ficheiro não contém um documento XML válido

Escrever XML num ficheiro

Escrever o conteúdo de uma variável de nó XML num ficheiro.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Caminho do ficheiro Não Ficheiro O ficheiro no qual pretende escrever o documento XML
XML a escrever Não Valor de texto O nó ou documento XML a escrever no ficheiro
Codificação N/D Predefinição do sistema, ASCII, Unicode, Unicode big endian, UTF-8 Predefinição do sistema A codificação utilizada para o ficheiro especificado
Formatar XML N/D Valor booleano Verdadeiro Especifica se o XML deve ser formatado
Avanço por nível Sim Valor numérico 2 Especifica quantos espaços pretende avançar cada nível do XML

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Diretório inválido especificado Indica que o diretório especificado é inválido
Falha ao escrever XML no ficheiro Indica um problema ao escrever XML no ficheiro

Executar expressão XPath

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

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Documento XML a analisar Não Valor de texto O XML como texto ou uma variável previamente definida que contém o documento XML a analisar
Consulta XPath Não Valor de texto A expressão XPath a executar no documento XML
Obter apenas o primeiro valor N/D Valor booleano Falso Especifica se pretende obter um único valor (apenas 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 XML Os nós extraídos como uma lista de nós XML

Exceções

Exceção Descrição
Documento XML inválido fornecido 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

Obter o valor de um atributo de um elemento XML.

Parâmetros de entrada

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

Variáveis produzidas

Argumento Tipo Descrição
XmlAttributeValue Valor booleano O valor obtido do atributo XML
XmlAttributeValue Datetime O valor obtido do atributo XML
XmlAttributeValue Valor numérico O valor obtido do atributo XML
XmlAttributeValue Valor de texto O valor obtido 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 obtém nenhum elemento Indica que a expressão XPath não obtém nenhum elemento
Atributo não encontrado no elemento Indica que o atributo não existe no elemento
Falha ao converter o valor do atributo no tipo de dados pedido Indica um problema ao converter o valor do atributo no tipo de dados pedido

Definir atributo de elemento XML

Definir o valor de um atributo de um elemento XML.

Parâmetros de entrada

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

Variáveis produzidas

Esta ação não produz quaisquer 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 obtém nenhum elemento Indica que a expressão XPath não obtém nenhum elemento
Falha ao definir o atributo XML Indica um problema ao definir o atributo XML

Remover atributo de elemento XML

Remover um atributo de um elemento XML.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Documento XML Não Nó XML O documento XML ou elemento XML cujo atributo pretende remover
Consulta XPath Sim Valor de texto A expressão XPath para localizar o subelemento e remover o respetivo atributo
Nome do atributo Não Valor de texto O nome do atributo a remover

Variáveis produzidas

Esta ação não produz quaisquer 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 obtém nenhum elemento Indica que a expressão XPath não obtém nenhum elemento
Atributo não encontrado no elemento Indica que o atributo não existe no elemento
Falha ao remover o atributo XML Indica um problema ao remover o atributo XML

Obter valor de elemento XML

Obter o valor de um elemento XML.

Parâmetros de entrada

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

Variáveis produzidas

Argumento Tipo Descrição
XmlElementValue Valor booleano O valor do elemento XML
XmlElementValue Datetime O valor do elemento XML
XmlElementValue Valor numérico O valor do elemento XML
XmlElementValue Valor de 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 obtém nenhum elemento Indica que a expressão XPath não obtém nenhum elemento
Falha ao converter o valor do elemento no tipo de dados pedido Indica um problema ao converter o valor do elemento no tipo de dados pedido

Definir valor de elemento XML

Definir o valor de um elemento XML.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Documento XML Não Nó XML O documento XML ou elemento XML cujo valor pretende obter
Consulta XPath Sim Valor de texto A expressão XPath para localizar o subelemento e obter o respetivo valor
Valor do elemento XML Não Valor de texto O novo valor do elemento XML

Variáveis produzidas

Esta ação não produz quaisquer 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 obtém nenhum elemento Indica que a expressão XPath não obtém nenhum elemento
Falha ao definir o valor do elemento Indica um problema ao definir o valor do elemento

Inserir elemento XML

Inserir um novo elemento XML num documento XML.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Documento XML Não Nó XML O documento XML no qual pretende inserir o novo elemento XML
Consulta XPath Não Valor de texto A expressão XPath para localizar o elemento XML principal e inserir o novo elemento neste
Elemento XML a inserir Não Nó XML O novo elemento XML a inserir no documento XML

Variáveis produzidas

Esta ação não produz quaisquer 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 obtém nenhum elemento Indica que a expressão XPath não obtém nenhum elemento
Falha ao inserir elemento XML Indica um problema ao inserir o elemento XML

Remover elemento XML

Remover um ou mais elementos XML de um documento XML.

Parâmetros de entrada

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

Variáveis produzidas

Esta ação não produz quaisquer 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 o elemento XML Indica um problema ao remover o elemento XML