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 Gravador de Extração de Tabela no Studio, que pode ser acessado a partir da faixa de opções se o pacote UIAutomation v21.4 ou superior estiver instalado em seu projeto atual e você tiver selecionado a Experiência Moderna.

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

Usando o gravador de extração de tabela

Se tiver a Experiência Moderna selecionada em seu projeto e o pacote de atividades Automação de Interface Gráfica instalado, você pode localizar o gravador Extração de Tabela na Faixa de Opções no Studio.

Clicking the Table Extraction button in the Ribbon opens up the Table Extraction wizard.

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 interface gráfica disponíveis (Default, UIAutomation, ou Active Accessibility), você pode selecionar uma opção no menu suspenso ou pressionar 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 Indicar, que destaca todos os elementos detectados do aplicativo com o qual você está trabalhando no momento. Ao selecionar o Você pode extrair URLs e origens de imagens dos dados extraídos, caso eles estejam presentes. Elas são adicionadas como uma nova coluna à sua tabela final.

As you can see above, after clicking a column header, the wizard prompts you with a message, asking whether you want to extract all of the available columns, which are automatically identified. Selecting Yes scrapes the entire table.

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.

If the table spans multiple pages, you can simply click Next Button and select the next page navigation button or link.

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

Once you have selected all the data you want, simply clicking the Save and return to Studio button automatically closes the wizard and saves everything you have done in your workflow.

Editando dados de extração

You can resume editing an already scraped table by using the Edit extract data option in the contextual menu in the body of the Extract Table Data activity. Using this option reopens the wizard with all of the configurations performed earlier and enables you to pick up where you left off.

Editando Colunas

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

Here, you can edit the Column Name. This can be done by simply using the text box and specifying the name you want for the column in the final table.

The Parse data as drop-down menu enables you to select between the three main types of data you can use for the columns, Text, Number, and Date & Time.

The Sample text box displays a sample of a value in the column being parsed as the data type you chose in the Parse data as drop-down.

Texto

The Sort drop-down menu specifies whether you want to sort the data in the column or not. By default, None is selected, meaning the data is not sorted in any way. If you want to sort the data in the column alphabetically, you can do so by selecting Ascending or Descending, depending on the method you prefer.

Número

Selecting Number in the Parse data as drop-down displays other, number-specific options.

The Sort drop-down menu specifies whether you want to sort the data in the column or not. By default, None is selected, meaning the data is not sorted in any way. If you want to sort the data in the column alphanumerically, you can do so by selecting Ascending or Descending, depending on the method you prefer.

The Decimal separator specifies the symbol you want to use for decimal separation in your final table. By default, this symbol is ..

The Thousands separator specifies the symbol you want to use for thousand separation in your final table. By default, this symbol is ,.

Observação:

When scraping numbers, they are parsed according to the selected options, and separators and other symbols (e.g. $) are removed.

Data e hora

Selecting Date & Time in the Parse data as drop-down displays other options, specific to date and time formats.

If the column you are editing does not match the format that is specified, the Column Settings window lets you know in the Sample section.

The Sort drop-down menu specifies whether you want to sort the data in the column or not. By default, None is selected, meaning the data is not sorted in any way. If you want to sort the data in the column by date, you can do so by selecting Ascending or Descending, depending on the method you prefer.

The Data parse format drop-down enables you to select from a multitude of date and time formats that are supported.

Observação:

When selecting dates, they are formatted according to the format that is selected in your operating system. The parsing format selected in the wizard is just to identify the data you are scraping.

Seção de configurações

The Settings section lets you choose if you want to limit the extraction of elements in the table. By default, this option is set to No limit, which does not limit the extraction in any way, scraping the entire visible table.

The Max rows option limits the scraping according to the number of rows that is mentioned in the field to the right. By default, this is set to 1000 rows.

The Max pages option limits the scraping according to the number of pages that is mentioned in the field to the right. By default, this is set to 100 pages.

Seção de visualização

The Preview section specifies how many columns and rows are identified for the table you have indicated. Also, by clicking the eye button, you can see a preview of the extracted table.

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

ExtractMetadata

The Extract metadata property contains an XML definition of the path identifying the data to be extracted for each column. The path is built starting from the data extraction target (defined by your selector) to the column elements. The path uses attributes such as tag, idx, and 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>

For the Description column, tag and index attributes are used to identify the column data.

For the Currency column, the elements are identified via the CSS-selector which contains the common class of the samples.

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

This property contains an XML definition of the column settings, as they were defined in the scraping wizard. Column properties like Name or Format can be changed directly in this XML definition and will be used at runtime when building the output data table.

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>