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.

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.

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