Extraction de table

L'extraction de table, qui fait partie de Modern Experience dans Studio, vous permet d'utiliser le package d'activités UI Automation pour extraire automatiquement les données structurées des applications et les enregistrer en tant qu'objet DataTable qui peut ensuite être utilisé dans vos processus d'automatisation.

Ce processus peut être effectué à l'aide de l' Enregistreur d'extraction de table dans Studio, accessible depuis le ruban si le pack UIAutomation v21.4 ou version ultérieure est installé dans votre projet en cours, et que vous avez sélectionné Modern Experience.

Le même assistant est également utilisé lors de l’utilisation d’une activité Extraire les données de table dans votre workflow.

Utilisation de l'enregistreur d'extraction de table

Si vous avez sélectionné Modern Experience dans votre projet et que le package d’activités UI Automation est installé, vous pouvez trouver l’enregistreur d’extraction de table dans le ruban de Studio.

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

Cet assistant vous permet de configurer avec facilité l'ensemble des fonctionnalités offertes par l'activité Extract Table Data.

Pour basculer entre les infrastructures d'IU disponibles (Default, UIAutomation, ou Active Accessibility), vous pouvez sélectionner une option dans le menu déroulant ou appuyer sur F4.

En outre, la section Informations vous guidera à travers toutes les étapes à suivre pour extraire avec succès des données structurées. La section peut être réduite afin d'afficher davantage d'informations sur l'étape à laquelle vous vous trouvez actuellement.

Pour commencer le processus d’extraction des données, cliquez simplement sur le bouton Ajouter des données . Cela permet de commencer le processus d’indication d’une série d’éléments similaires qui peuvent être utilisés pour identifier la table que vous souhaitez créer. Cela démarre le processus Indiquer, qui met en surbrillance tous les éléments détectés de l’application avec laquelle vous travaillez actuellement. En sélectionnant le vous pouvez extraire les URL et les sources d’images des données extraites, si elles sont présentes. Ceux-ci sont ajoutés sous forme de nouvelle colonne à votre table finale.

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.

Si vous sélectionnez un élément qui est plus proche (ancêtre commun le plus bas) d'un seul des éléments de la première colonne, il est automatiquement considéré comme le premier élément d'une nouvelle colonne.

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

Chaque colonne peut être modifiée ou supprimée individuellement, vous permettant de personnaliser votre table finale comme bon vous semble.

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.

Modification des données d'extraction

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.

Modification des colonnes

Cliquer sur l'icône de roue dentée à côté de la colonne que vous souhaitez modifier ouvre la fenêtre Paramètres de la colonne (Column Settings).

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.

Texte

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.

Numérique

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 ,.

Remarque :

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

Date et heure

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.

Remarque :

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.

Section Paramètres

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.

Section Aperçu

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.

L'aperçu est désactivé lors de l'édition en mode hors ligne.

Extract Metadata

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.

Exemple :

<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>

Lorsque les attributs tag, idxet text ne suffisent pas pour identifier les exemples de données indiqués par l'utilisateur, un sélecteur CSS est généré à la place du chemin d'accès. Ce sélecteur utilise la classe commune des exemples d'éléments.

Exemple :

<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.

En option, si disponible, un sélecteur CSS peut également être utilisé pour la description :

<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>

La définition de ligne utilise les mêmes méthodes d'identification que la colonne et est utilisée pour extraire les données corrélées. Une ligne contient un élément de chaque colonne.

Exemple :

<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>

Paramètres de table

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.

Exemple :

<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>