Usar o componente Obter tabela

Extraia e exiba dados e a contagem de linhas de grades, listas, caixas de combinação e tabelas HTML usando o componente Obter tabela no Design studio de RPA para desktop.

Antes de Iniciar

Função necessária: nenhuma

Por Que e Quando Desempenhar Esta Tarefa

Muitas propriedades do componente Obter tabela são comuns a outros componentes de IU de ações. Para configurar essas propriedades, consulte Propriedades dos componentes de Ações (IU).

As propriedades exclusivas do componente Obter tabela são fornecidas.

Tabela 1. Obter propriedades do componente da tabela

Propriedade	Descrição
Ignorar Cabeçalho	Opção para especificar se a automação captura ou ignora o cabeçalho da tabela. O valor padrão é Falso.

Procedimento

1. No painel Caixa de ferramentas, navegue até Ações (IU) > Obter tabela.
2. Arraste o componente Obter tabela para a superfície Design.
3. No componente Obter tabela, clique no ícone da câmera (ícone da ).
   A mensagem Pressione "CTRL + SHIFT" para seleção é exibida.
4. Pressione as teclas Ctrl + Shift.
   O dispositivo do mouse se transforma em um ícone de cruzamento ( Ícone de ).
5. Arraste o mouse sobre a aplicação para cobrir a tabela e solte.
   A área selecionada do elemento é capturada como uma imagem no componente Obter tabela.
6. Arraste o ícone de adição verde (ícone de ) sobre a imagem capturada e coloque no local onde deseja que o componente execute uma ação.
7. Opcional: Adicione uma âncora à imagem capturada executando as seguintes ações:
   Uma âncora é um identificador exclusivo que permite que o componente Obter tabela identifique a aplicação em que o componente executará uma ação. Embora adicionar uma âncora seja uma boa abordagem, ela é opcional. Se você não adicionar uma âncora, o componente Obter tabela tratará toda a imagem capturada como uma âncora. Para saber mais sobre uma âncora, consulte as etapas para usar o Âncora.
   1. No componente Obter tabela, clique com o botão direito do mouse na imagem e clique em Adicionar âncora.
      A âncora aparece como um retângulo amarelo com bordas vermelhos.
   2. Arraste e coloque a âncora na imagem capturada.
      Dica:

      Para mudar as dimensões da âncora, posicione o dispositivo do mouse ao longo da borda da âncora até que o dispositivo do mouse se transforme em uma seta de dois lados ( Seta ) e arraste a âncora.

8. Opcional: Capture imagens alternativas executando as seguintes ações:
   Imagens alternativas evitam uma falha de execução quando o componente Obter tabela não encontra a imagem que foi capturada primeiro. Nesse caso, o componente Obter tabela pesquisa imagens alternativas para executar. Você pode adicionar quantas imagens alternativas forem necessárias.
   1. Na janela IMAGENS ALTERNATIVAS, clique no ícone adicionar imagem (ícone ).
   2. Clique no ícone da câmera (ícone da ).
      A mensagem Pressione "CTRL + SHIFT" para seleção é exibida.
   3. Arraste o mouse sobre a aplicação para cobrir a tabela e solte.
      A área selecionada é capturada como uma imagem na janela IMAGENS ALTERNATIVAS.
   4. Arraste o ícone de adição verde (ícone de ) sobre a imagem capturada e coloque no local onde deseja que o componente execute uma ação.
   5. Para fechar a janela IMAGENS ALTERNATIVAS, clique em OK.
9. Opcional: Para configurar as maneiras como os campos de saída mostram a saída, consulte Configurar propriedades da porta de saída.
10. Opcional: Conecte as portas conforme descrito na tabela a seguir.

    Tipo da porta	Nome da porta	Tipo de dados	Finalidade da conexão	Obrigatório?
    Dados esgotados	Contagem	Inteiro	Retorna a contagem total de linhas.	Não aplicável
    Dados esgotados	Tabela de dados	Não aplicável	Retorna a tabela.	Não aplicável.

11. Para testar o componente, clique com o botão direito do mouse na barra de componentes e clique em Executar a partir daqui.

Extrair dados de uma tabela HTML para um arquivo do Excel

O componente Obter tabela extrai dados de uma tabela HTML e passa os dados pela porta de saída de dados da DataTable. Os dados são passados por meio da porta de entrada de dados do componente WriteToExcel (para usar o componente WriteToExcel, consulte Usar o componente WriteToExcel). Os dados são gravados na planilha especificada no campo SheetName do documento do Excel especificado no campo Caminho de arquivo

.