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 à partir du ruban si le pack UI Automation v21.4 ou supérieur est installé dans votre projet actuel 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 la table (Extract Table Data) dans votre workflow.

Utilisation de l'enregistreur d'extraction de table

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

Cliquer sur le bouton Extraction de table dans le ruban ouvre l ' assistant d' extraction de table.

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'interface utilisateur disponibles (Par défaut (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 (Add Data) . Cela démarre 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'image des données extraites, si elles sont présentes. Celles-ci sont ajoutées en tant que nouvelle colonne à votre table finale.

Comme vous pouvez le voir ci-dessus, après avoir cliqué sur un en-tête de colonne, l'assistant affiche un message vous demandant si vous souhaitez extraire toutes les colonnes disponibles, qui sont automatiquement identifiées. Sélectionner Oui (Yes) racle la table entière.

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.

Si le tableau s'étend sur plusieurs pages, il vous suffit de cliquer sur Bouton suivant ( Next Button ) et de sélectionner le bouton ou le lien de navigation de la page suivante.

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

Une fois que vous avez sélectionné toutes les données souhaitées, il suffit de cliquer sur le bouton Enregistrer et revenir à Studio pour fermer automatiquement l’assistant et enregistrer tout ce que vous avez fait dans votre workflow.

Modification des données d'extraction

Vous pouvez reprendre la modification d'une table déjà extraite en utilisant l'option Modifier l'extrait de données (Edit extract data) dans le menu contextuel dans le corps de l'activité Extract Table Data . L'utilisation de cette option rouvre l'assistant avec toutes les configurations effectuées précédemment et vous permet de reprendre là où vous vous êtes arrêté.

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

Ici, vous pouvez modifier le nom de la colonne. Cela peut être fait en utilisant simplement la zone de texte et en spécifiant le nom souhaité pour la colonne dans la table finale.

Le menu déroulant Analyser les données en tant que ( Parse data as ) vous permet de choisir entre les trois principaux types de données que vous pouvez utiliser pour les colonnes : Texte, Nombreet Date et heure.

La zone de texte Échantillon (Exemple) affiche un échantillon d'une valeur dans la colonne en cours d'analyse en tant que type de données que vous avez choisi dans la liste déroulante Analyser les données comme ( Parse data as ).

Texte

Le menu déroulant Trier (Sort) spécifie si vous souhaitez trier ou non les données de la colonne. Par défaut, Aucun (Aucun) est sélectionné, ce qui signifie que les données ne sont en aucun cas triées. Si vous souhaitez trier les données de la colonne par ordre alphabétique, vous pouvez le faire en sélectionnant Ascending ou Descending, selon la méthode que vous préférez.

Numérique

Sélectionner Nombre (Number) dans la liste déroulante Parse data as (Analyser les données en tant que) affiche d’autres options spécifiques aux nombres.

Le menu déroulant Trier (Sort) spécifie si vous souhaitez trier ou non les données de la colonne. Par défaut, Aucun est sélectionné, ce qui signifie que les données ne sont en aucun cas triées. Si vous souhaitez trier les données de la colonne par ordre alphanumérique, vous pouvez le faire en sélectionnant Ascending ou Descending, selon la méthode que vous préférez.

Le séparateur décimal spécifie le symbole que vous souhaitez utiliser pour la séparation décimale dans votre table finale. Par défaut, ce symbole est ..

Le séparateur des milliers spécifie le symbole que vous souhaitez utiliser pour la séparation des milliers dans votre table finale. Par défaut, ce symbole est ,.

Remarque : lors de l'extraction des nombres, ils sont analysés en fonction des options sélectionnées, ainsi que des séparateurs et autres symboles (par ex. $) sont supprimés.

Date et heure

Sélectionner Date et heure (Date & Time) dans la liste déroulante Analyser les données en tant que ( Parse data as ) affiche d’autres options, spécifiques aux formats de date et d’heure.

Si la colonne que vous modifiez ne correspond pas au format spécifié, la fenêtre Paramètres de colonne ( Column Settings ) vous en informe dans la section Échantillon .

Le menu déroulant Trier (Sort) spécifie si vous souhaitez trier ou non les données de la colonne. Par défaut, Aucun est sélectionné, ce qui signifie que les données ne sont en aucun cas triées. Si vous souhaitez trier les données de la colonne par date, vous pouvez le faire en sélectionnant Ascending ou Descending, selon la méthode que vous préférez.

La liste déroulante Format d'analyse des données ( Data parse format) vous permet de choisir parmi une multitude de formats de date et d'heure pris en charge.

Remarque : lors de la sélection des dates, elles sont formatées en fonction du format sélectionné dans votre système d'exploitation. Le format d'analyse sélectionné dans l'assistant sert uniquement à identifier les données que vous récupérez.

Section Paramètres

La section Paramètres (Settings) vous permet de choisir si vous souhaitez limiter l'extraction d'éléments dans le tableau. Par défaut, cette option est définie sur Aucune limite, ce qui ne limite en aucune façon l'extraction, en grattant l'intégralité de la table visible.

L'option Nombre maximal de lignes ( Max rows ) limite l'extraction en fonction du nombre de lignes mentionné dans le champ de droite. Par défaut, il est défini sur 1 000 lignes.

L'option Nombre maximal de pages (Max pages) limite l'extraction en fonction du nombre de pages mentionné dans le champ à droite. Par défaut, il est défini sur 100 pages.

Section Aperçu

La section Aperçu (Preview) spécifie le nombre de colonnes et de lignes identifiées pour la table que vous avez indiquée. En outre, en cliquant sur le bouton en forme d'œil, vous pouvez voir un aperçu de la table extraite.

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

Extract Metadata

La propriété Extraire les métadonnées contient une définition XML du chemin d'accès identifiant les données à extraire pour chaque colonne. Le chemin d'accès est construit à partir de la cible d'extraction de données (définie par votre sélecteur) jusqu'aux éléments de la colonne. Le chemin d'accès utilise des attributs tels que tag, idxet 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>

Pour la colonne Description , les attributs tag et index sont utilisés pour identifier les données de la colonne.

Pour la colonne Devise , les éléments sont identifiés via le sélecteur CSS qui contient la classe commune des échantillons.

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

Cette propriété contient une définition XML des paramètres de colonne, tels qu'ils ont été définis dans l'assistant d'extraction. Les propriétés de colonne telles que le nom ou le format peuvent être modifiées directement dans cette définition XML et seront utilisées au moment de l'exécution lors de la création de la table de données de sortie.

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>