Extração da Tabela

A extração de tabela, parte da experiência moderna no Studio, permite que você use o pacote de atividades de automação da interface do usuário para extrair automaticamente dados estruturados de aplicativos e salvá-los como um objeto DataTable que pode ser usado posteriormente em seus processos de automação.

Esse processo pode ser feito usando o Table Extraction Recorder no Studio, que pode ser acessado a partir da Faixa de opções se o pacote UI Automation v21.4 ou superior estiver instalado em seu projeto atual e você tiver selecionado o Modern Experience.

O mesmo assistente também é usado ao usar uma atividade Extract Table Data no seu fluxo de trabalho.

Usando o gravador de extração de tabela

Se você tiver a experiência moderna selecionada em seu projeto e o pacote de atividades de automação da interface do usuário instalado, poderá encontrar o gravador de extração de tabela na faixa de opções do Studio.

Clicar no botão Extração de tabela na Faixa de opções abre o assistente de Extração de tabela.

Esse assistente permite configurar todo o conjunto de recursos que a atividade Extract Table Data oferece, de maneira muito simples.

Para alternar entre as estruturas de IU disponíveis (Default, UIAutomation ou Active Accessibility), você pode selecionar uma opção no menu suspenso ou clicar em F4.

Além disso, a seção Informações orienta você em todas as etapas necessárias para extrair com sucesso quaisquer dados estruturados. A seção pode ser recolhida para revelar mais informações sobre a etapa na qual você está atualmente.

Para iniciar o processo de extração de dados, basta clicar no botão Adicionar Dados . Isso inicia o processo de indicação de uma série de elementos semelhantes que podem ser usados para identificar a tabela que você deseja criar. Isso inicia o processo Indicate, que destaca todos os elementos detectados do aplicativo com o qual você está trabalhando no momento. Ao selecionar o botão, você pode extrair URLs e fontes de imagem dos dados extraídos, se estiverem presentes. Elas são adicionadas como uma nova coluna à sua tabela final.

Como você pode ver acima, depois de clicar no cabeçalho de uma coluna, o assistente exibe uma mensagem, perguntando se você deseja extrair todas as colunas disponíveis, que são identificadas automaticamente. Selecionar Sim raspa toda a tabela.

Se você selecionar um elemento mais próximo (menor ancestral comum) de apenas um dos elementos da primeira coluna, ele será automaticamente considerado o primeiro elemento de uma nova coluna.

Se a tabela abranger várias páginas, basta clicar no botão Avançar e selecionar o botão ou link de navegação da próxima página.

Cada coluna pode ser editada ou excluída individualmente, permitindo que você personalize sua tabela final da maneira que achar melhor.

Depois de selecionar todos os dados desejados, basta clicar no botão Salvar e retornar ao Studio para fechar automaticamente o assistente e salvar tudo o que você fez em seu fluxo de trabalho.

Editando dados de extração

Você pode retomar a edição de uma tabela já copiada usando a opção Editar dados de extração no menu contextual no corpo da atividade Extrair dados da tabela . O uso dessa opção reabre o assistente com todas as configurações realizadas anteriormente e permite que você continue de onde parou.

Editando Colunas

Clicar no ícone da roda dentada ao lado da coluna que você deseja editar abre a janela Configurações da coluna.

Aqui, você pode editar o Nome da coluna. Isso pode ser feito simplesmente usando a caixa de texto e especificando o nome que deseja para a coluna na tabela final.

O menu suspenso Analisar dados como permite selecionar entre os três tipos principais de dados que você pode usar para as colunas, Texto, Númeroe Data e Hora.

A caixa de texto Amostra exibe uma amostra de um valor na coluna que está sendo analisada como o tipo de dados que você escolheu na lista suspensa Analisar dados como .

Texto

O menu suspenso Classificar especifica se você deseja classificar os dados na coluna ou não. Por padrão, Nenhum é selecionado, o que significa que os dados não são classificados de forma alguma. Se você deseja classificar os dados na coluna em ordem alfabética, pode fazê-lo selecionando Crescente ou Decrescente, dependendo do método de sua preferência.

Número

Selecionar Número no menu suspenso Analisar dados como exibe outras opções específicas de número.

O menu suspenso Classificar especifica se você deseja classificar os dados na coluna ou não. Por padrão, Nenhum é selecionado, o que significa que os dados não são classificados de nenhuma forma. Se você deseja classificar os dados na coluna de forma alfanumérica, pode fazer isso selecionando Ordem crescente ou Ordem decrescente, dependendo do método de sua preferência.

O separador decimal especifica o símbolo que você deseja usar para separação decimal em sua tabela final. Por padrão, este símbolo é ..

O separador de milhar especifica o símbolo que você deseja usar para separação de milhar em sua tabela final. Por padrão, esse símbolo é ,.

Nota: Ao raspar números, eles são analisados de acordo com as opções selecionadas, e separadores e outros símbolos (ex. $) são removidos.

Data e hora

Selecionar Data e hora no menu suspenso Analisar dados como exibe outras opções, específicas para formatos de data e hora.

Se a coluna que você está editando não corresponder ao formato especificado, a janela Configurações da coluna o informará na seção Amostra .

O menu suspenso Classificar especifica se você deseja classificar os dados na coluna ou não. Por padrão, Nenhum é selecionado, o que significa que os dados não são classificados de nenhuma forma. Se você deseja classificar os dados na coluna por data, pode fazer isso selecionando Ordem crescente ou Ordem decrescente, dependendo do método de sua preferência.

O menu suspenso Formato de análise de dados permite selecionar entre vários formatos de data e hora compatíveis.

Nota: Ao selecionar datas, elas são formatadas de acordo com o formato selecionado em seu sistema operacional. O formato de análise selecionado no assistente é apenas para identificar os dados que você está copiando.

Seção de configurações

A seção Configurações permite que você escolha se deseja limitar a extração de elementos na tabela. Por padrão, esta opção é definida como No limit, o que não limita a extração de forma alguma, raspando toda a tabela visível.

A opção Max linhas limita a raspagem de acordo com o número de linhas que é mencionado no campo à direita. Por padrão, isso é definido como 1.000 linhas.

A opção Máx. de páginas limita a coleta de acordo com o número de páginas que é mencionado no campo à direita. Por padrão, é definido como 100 páginas.

Seção de visualização

A seção Visualização especifica quantas colunas e linhas são identificadas para a tabela que você indicou. Além disso, clicando no botão de olho, você pode ver uma prévia da tabela extraída.

A visualização é desabilitada ao editar no modo offline.

ExtractMetadata

A propriedade Extract metadata contém uma definição XML do caminho que identifica os dados a serem extraídos para cada coluna. O caminho é construído a partir do destino de extração de dados (definido por seu seletor) até os elementos da coluna. O caminho usa atributos como tag, idxe text.

Exemplo:

<extract> 
<!—columns data identified by a path > 
<column exact='1' name=’Description’ attr='text'> 
<webctrl tag='div' /> 
<webctrl tag='div' idx='1' /> 
<webctrl tag='div' idx='1' /> 
<webctrl tag='div' idx='2' /> 
<webctrl tag='div' idx='1' /> 
<webctrl tag='div' idx='1' /> 
<webctrl tag='span' idx='1' /> 
</column> 
<column exact='1' name=’Currency’ attr='text'> 
<webctrl tag='div' /> 
<webctrl tag='div' idx='1' /> 
<webctrl tag='div' idx='1' /> 
<webctrl tag='div' idx='2' /> 
<webctrl tag='div' idx='1' /> 
<webctrl tag='div' idx='1' /> 
<webctrl tag='span' idx='2' /> 
</column> 
</extract>

Quando os atributos tag, idxe text não são suficientes para identificar os dados de amostra indicados pelo usuário, um seletor CSS é gerado no lugar do caminho. Este seletor usa a classe comum dos elementos de amostra.

Exemplo:

<extract> 
<!—column data identified by a path > 
<column exact='1' name='Description' attr='text'> 
<webctrl tag='li' /> 
<webctrl tag='div' idx='1' /> 
<webctrl tag='a' idx='1' /> 
<webctrl tag='div' idx='2' /> 
<webctrl tag='div' idx='1' /> 
<webctrl tag='h3' idx='1' /> 
</column> 
<!—column data identified by a css-selector > 
<column css-selector='.currency-value' name='Currency' attr='text' /> 
</extract>

Para a coluna Descrição , os atributos tag e index são usados para identificar os dados da coluna.

Para a coluna Moeda , os elementos são identificados por meio do seletor CSS que contém a classe comum das amostras.

Opcionalmente, se disponível, um seletor CSS também pode ser usado para a Descrição:

<extract> 
<!—columns data identified by css-selectors > 
<column css-selector='.product-title ' name='Description' attr='text' /> 
<column css-selector='.currency-value' name='Currency' attr='text' /> 
</extract>

A definição de linha usa os mesmos métodos de identificação da coluna e é usada para extrair dados correlacionados. Uma linha contém um elemento de cada coluna.

Exemplo:

<extract> 
<! -- row definition - ->  
<row exact='1'> 
<webctrl tag='li' /> 
<webctrl tag='div' idx='1' /> 
<webctrl tag='a' idx='1' /> 
<webctrl tag='div' idx='2' /> 
<webctrl tag='div' idx='1' /> 
</row> 
<column exact='1' name='Description' attr='text'> 
<webctrl tag='li' /> 
<webctrl tag='div' idx='1' /> 
<webctrl tag='a' idx='1' /> 
<webctrl tag='div' idx='2' /> 
<webctrl tag='div' idx='1' /> 
<webctrl tag='h3' idx='1' /> 
</column> 
<column css-selector='.currency-value' name='Column' attr='text' /> 
</extract>

Configurações da tabela

Esta propriedade contém uma definição XML das configurações da coluna, conforme elas foram definidas no assistente de raspagem. Propriedades de coluna como Nome ou Formato podem ser alteradas diretamente nesta definição XML e serão usadas em tempo de execução ao criar a tabela de dados de saída.

Exemplo:

<Table xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xmlns:xsd='http://www.w3.org/2001/XMLSchema' Type='Structured'> 
<Column xsi:type='DataColumn' ReferenceName='Column0' Name=’Description'> 
<Format xsi:type='TextColumnFormat' /> 
</Column> 
<Column xsi:type='DataColumn' ReferenceName='Column2' Name=’Currency'> 
<Format xsi:type='TextColumnFormat' /> 
</Column> 
</Table>