Pesquisa por xpath

Objeto que realiza pesquisa de elemento por xpath

Visão Geral

O objeto Pesquisar com XPath é utilizado para localizar elementos específicos dentro de um arquivo XML utilizando expressões XPath.

XPath é uma linguagem de consulta utilizada para navegar na estrutura de documentos XML, permitindo identificar elementos com base em tags, atributos, hierarquia e posição dentro do documento.

Com esse objeto, o robô pode localizar rapidamente informações específicas em arquivos XML complexos, retornando o elemento encontrado para utilização em outras etapas do fluxo da automação.

Esse recurso é frequentemente utilizado em automações que processam documentos XML estruturados, como:

• Notas fiscais eletrônicas

• Documentos de integração entre sistemas

• Arquivos XML com estruturas hierárquicas complexas

---

Funcionamento

O objeto executa uma consulta XPath dentro da estrutura de um objeto XML.

O fluxo de funcionamento ocorre da seguinte forma:

1. O usuário seleciona um objeto XML previamente carregado ou criado no fluxo do robô.

2. Informa uma expressão XPath que será utilizada para localizar o elemento desejado.

3. Durante a execução do robô, o sistema executa a consulta XPath na estrutura do XML.

4. O elemento encontrado é retornado e pode ser utilizado dentro do fluxo da automação.

Caso a posição da tag não seja especificada na expressão XPath, o sistema retornará a primeira ocorrência encontrada.

Quando usar

• Quando for necessário localizar elementos específicos em XML utilizando XPath.

• Quando o XML possui estrutura hierárquica complexa.

• Quando for necessário realizar consultas mais avançadas em documentos XML.

Quando não usar

• Quando a busca puder ser realizada apenas pelo nome da tag utilizando objetos simples de leitura de XML.

• Quando não houver necessidade de utilizar expressões XPath para navegação no XML.

---

Configuração

CAMPO	DESCRITIVO
Versão do componente	Define a versão do componente utilizado pelo objeto.
Título	Nome do objeto dentro do fluxo do robô. Permite identificar a etapa da automação.
Nome Identificador do Objeto	Identificador utilizado para acessar o resultado retornado pelo objeto dentro do fluxo do robô.
Selecionar objeto do tipo XML	Define o objeto XML que será utilizado como base para execução da consulta XPath.
XPath	Expressão XPath utilizada para localizar o elemento desejado dentro do XML.

Observação:

• Caso a posição da tag não seja especificada na expressão XPath, a primeira ocorrência encontrada será retornada.

---

Exemplos

Exemplo simples

Localizar um elemento específico em um XML utilizando XPath.

Fluxo:

1. Carregar ou criar um objeto XML no robô.

2. Adicionar o objeto Pesquisar com XPath.

3. Selecionar o objeto XML.

4. Informar a expressão XPath para localizar o elemento desejado.

5. Executar o robô para capturar o elemento encontrado.

Exemplo aplicado

Extrair informações específicas de uma nota fiscal em XML.

Fluxo possível:

1. Receber o arquivo XML da nota fiscal.

2. Utilizar Pesquisar com XPath para localizar elementos como:

   • Número da nota

   • Valor total

   • CNPJ do emitente

3. Utilizar os dados retornados para validação, armazenamento ou integração com outros sistemas.

---

Retornos

O objeto retorna o elemento localizado através da expressão XPath.

Esse retorno pode ser utilizado em outros objetos do fluxo através do Nome Identificador do Objeto configurado.

---

Erros comuns e como evitar

Erro	Como evitar
Objeto XML não selecionado	Garantir que um objeto XML válido esteja configurado
XPath inválido	Verificar se a expressão XPath está corretamente estruturada
Elemento não encontrado	Confirmar se o XPath corresponde à estrutura real do XML

---

Boas práticas

• Verifique previamente a estrutura do XML antes de definir a expressão XPath.

• Utilize expressões XPath claras e específicas para evitar resultados incorretos.

• Defina corretamente o Nome Identificador do Objeto para facilitar o uso do retorno no fluxo.

• Utilize este objeto quando for necessário realizar consultas mais avançadas em XML.