Generate Data Table From Text

UiPath.Core.Activities.GenerateDataTable

Génère une variable TableDonnées à partir du texte structuré. Cette activité vous permet de sélectionner des séparateurs de colonnes et de lignes en fonction desquels la table est générée. Cette activité est générée automatiquement lors de l'utilisation de la fonctionnalité Generate Table de la fenêtre « extraction de données d’écran ».

Compatibilité du projet

Multiplateforme | Windows | Windows - Héritage

Configuration multiplateforme

• Entrée (Input) : la source du texte structuré.
• Méthode d'analyse (Parsing method) - Options de formatage des données pour la table. Les options disponibles sont :
  • CSV (Valeurs séparées par des virgules)
  • Personnalisé
  • Colonnes à largeur fixe

Propriétés

• Détecter automatiquement les types de colonnes - Lorsque cette option est sélectionnée, le type de colonne ou de ligne est automatiquement détecté, que ce soit String, Int32, etc.
• Utiliser la première ligne comme en-têtes de colonnes : si cette option est activée, utilise la première ligne identifiée comme en-tête de colonne.
• Ignorer la première colonne : si cette option est activée, la première colonne identifiée est ignorée.
• Continue On Error : indique si l'automatisation doit se poursuivre, même lorsque l'activité génère une erreur. Ce champ ne prend en charge que des valeurs booléennes (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et qu'une erreur est générée, l'exécution du projet s'arrête. Si la valeur est définie sur True, l'exécution du projet se poursuit indépendamment de toute erreur.
• Table de données (DataTable) - Variable DataTable qui contient la table générée.

Windows, Windows - Configuration héritée

• Entrée (Input) : la source du texte structuré. Dans StudioX, vous pouvez utiliser l'option Plus pour sélectionner l'une des options disponibles :

  • Données du Bloc-notes du projet, d'un fichier Excel parent ou d'un compte Outlook. Par exemple, sélectionnez un fichier Excel, puis sélectionnez Indiquer dans Excel pour indiquer une cellule du fichier, ou bien sélectionnez un e-mail dans Outlook, puis sélectionnez un champ de l'e-mail contenant les données à utiliser en tant qu'entrée.
  • Demander quand exécuté : permet de demander des données lorsque le projet est exécuté.
  • Coller à partir du Presse-papiers (Paste from clipboard) : permet de coller une valeur que vous avez précédemment copiée dans le presse-papiers du projet.
  • Texte : saisissez les données dans le générateur de texte.
  • Utiliser la valeur enregistrée : sélectionnez une valeur que vous avez précédemment enregistrée pour une utilisation ultérieure dans le projet.
  • Ouvrir dans l'éditeur avancé : utilisé pour saisir une expression VB.
• Options : cliquez pour ouvrir la fenêtre de l'assistant Générer une table de données.

• TableDonnées : choisissez où enregistrer la table de données. Dans StudioX, vous pouvez utiliser l'option Plus pour sélectionner l'une des options disponibles :

  • Sélectionnez un fichier Excel parent ou le bloc-notes de projet, puis sélectionnez une plage, une table ou une feuille désignée dans laquelle enregistrer les données, ou bien sélectionnez Indiquer dans Excel pour sélectionner directement à partir du fichier.
  • Copier dans le presse-papiers : permet d'enregistrer les données dans le presse-papiers.
  • Enregistrer pour une utilisation ultérieure : enregistrer les données afin de les utiliser ultérieurement dans votre projet en tant qu'entrée pour une autre activité.
  • Ouvrir dans l'éditeur avancé : utilisé pour saisir une expression VB.

Propriétés

Options

• Poursuite sur erreur (ContinueOnError) - Spécifie si l'automatisation doit continuer même si l'activité génère un message d'erreur. Ce champ prend uniquement en charge les valeurs booléennes (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et si une erreur est renvoyée, l'exécution du projet s'interrompt. Si la valeur est configurée sur True, l'exécution du projet continue indépendamment de toute erreur.

• NomAffichage (DisplayName) - Nom affiché de l'activité.

  Remarque : si cette activité est incluse dans l'activité Try Catch et que la valeur de la propriété ContinuerSurErreur est « True », aucune erreur ne sera détectée lors de l'exécution du projet.

Options de formatage fixes

• TaillesColonnes : spécifie la taille des colonnes qui doivent être créées dans la table. Ce champ prend uniquement en charge les variables IEnumerable.

Options de formatage

• Séparateurs de colonnes (ColumnSeparators) - Spécifie le caractère à utiliser comme séparateur de colonne. Ce champ prend en charge les variables String uniquement.
• AnalyseCSV : déterminez si vous souhaitez analyser les données saisies sous forme de fichier CSV. Ce champ ne prend en charge que les valeurs booléennes (True, False). La valeur par défaut est False.
• Nouveau séparateur de ligne (NewLineSeparator) - Spécifie le caractère à utiliser comme séparateur de retour à la ligne. Ce champ prend en charge les variables String uniquement.

Entrée

• Entrée : spécifie la source du texte structuré devant être converti en table. Ce champ ne prend en charge que les variables String.
• Positions : si un OCR est utilisé pour l'extraction et que la case « Obtenir les infos de mots » est cochée, ce champ contiendra la variable IEnumerable<KeyValuePair<Rectangle,String>> contenant la valeur InformationsMots.

Divers

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Sortie

• Table de données (DataTable) - Variable DataTable qui contient la table générée.

Options de table

• Types de détection auto (AutoDetectTypes) - Lorsque cette option est sélectionnée, le type de colonne ou de ligne est automatiquement détecté, que ce soit String, Int32, etc.
• Utiliser l'en-tête de colonne (UseColumnHeader) - Si cette option est sélectionnée, la première colonne identifiée est utilisée comme en-tête de colonne.
• Utiliser l'en-tête de ligne (UseRowHeader) - Si cette option est sélectionnée, la première ligne identifiée est utilisée comme en-tête de ligne.

Assistant Générer la table de données

Remarque :

L'assistant Générer une table de données (Generate Data Table Wizard) n'est disponible que pour Windows et les projets Windows - Héritage (Windows - Legacy).

Cliquez sur le bouton Options... pour ouvrir l'assistant Générer une table de données. Utilisez-le pour configurer et prévisualiser facilement le format de tableau obtenu.

Options de table

• Détection automatique Types de colonne : si cette option est cochée, détecte automatiquement le type de colonne ou de ligne.
• Utiliser la première ligne comme en-têtes de colonnes : si cette option est sélectionnée, la première colonne identifiée sera utilisée comme en-tête de colonne.
• Ignorer la première colonne : si cette option est cochée, la première colonne identifiée sera ignorée.

Options de formatage des données

• Format : sélectionnez le format d'entrée à utiliser :

  • CSV (Valeurs séparées par des virgules) : vous permet de définir des séparateurs de colonnes.
  • Personnalisé : vous permet de définir des séparateurs de colonne et des séparateurs de nouvelle ligne.
  • Colonnes à largeur fixe : vous permet de définir la largeur de colonne de toutes les colonnes.
• Séparateurs de colonne : spécifiez le caractère à utiliser en tant que séparateur de colonne.
• Séparateurs de nouvelle ligne : spécifiez le caractère à utiliser en tant que séparateur de nouvelle ligne.
• Aperçu : cliquez pour générer un aperçu du format de tableau obtenu.

Exemple d'utilisation de l'activité Generate Data Table

Cet exemple explique comment générer une table avec des informations spécifiques à l'aide de l'activité Generate Data Table.

Voici comment le processus d'automatisation peut être créé :

1. Ouvrez Studio et démarrez un nouveau Processus.

2. Faites glisser un conteneur Séquence vers le concepteur de workflow.

   Nom de variable	Types de variables	Valeur par défaut
   DT1	DataTable
   Résultat	Chaîne de caractères (string)
   Nom	ValeurGénérique

3. Faites glisser une activité Generate Data Table dans le conteneur Sequence.

   • Dans le panneau Propriétés, ajoutez la valeur False dans le champ AnalyseCSV.
   • Ajoutez la valeur Environment.NewLine dans le champ SéparateurNouvelleLigne.
   • Ajoutez l’expression "Name;Surname; John;Doe; James;Liam;" dans le champ Entrée.
   • Ajoutez la variable DT1 dans le champ Table de données.
   • Cochez la case de l’option UtiliserEnTêteColonne.

4. Cliquez sur le bouton Options... pour ouvrir l'assistant Générer une table de données.

   • Sélectionnez l'option Personnalisé dans le menu déroulant Format.
   • Sélectionnez l'option point-virgule dans la liste déroulante Séparateurs de colonne.
   • Sélectionnez l'option espace dans la liste déroulante Séparateurs de nouvelle ligne.
   • Cliquez sur OK pour fermer l'assistant.
   • Voici à quoi devrait ressembler le panneau de l'assistant Générer une table de données :

     
     

     

     
     

     
     

     

     
     

     6. Faites glisser une activité Output Data Table sous l'activité Generate Data Table.

   • Dans le panneau Propriétés , ajoutez la variable DT1 dans le champ TableDonnées .
   • Ajoutez la variable Result dans le champ Texte.

5. Ajoutez une activité Write Line sous l'activité Output Data Table.

   • Ajoutez la variable Result dans le champ Texte.
6. Exécutez le processus. Le robot va générer une table en utilisant les données d'entrée.

Téléchargez l'exemple