Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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 |