Tables de données de jointure (Join Data Tables)

UiPath.Core.Activities.JoinDataTables

Description

Combine des lignes de deux tables en utilisant les valeurs communes entre elles, selon une règle de jointure, qui est spécifiée dans la propriété JoinType.

Compatibilité du projet

Windows - Héritage | Windows | Multiplate-forme

Configuration multiplateforme

• DataTable1 : la première table à utiliser dans l'opération de jointure, stockée dans une variable DataTable. Ce champ prend uniquement en charge les variables DataTable.

• DataTable2 : la première table à utiliser dans l'opération de jointure, stockée dans une variable DataTable. Ce champ prend uniquement en charge les variables DataTable.

Remarque :L'ordre dans lequel les tables sont indiquées est très important, car il influence la structure de la table obtenue, en fonction de l'option sélectionnée dans le champ de propriété JoinType.

• JoinType : le type d'opération de jointure à utiliser. Les options suivantes sont disponibles :

  • Interne (Inner) : conservez toutes les lignes de DataTable1 et de DataTable2 qui répondent à la règle de jointure. Toutes les lignes qui ne répondent pas à la règle sont supprimées de la table obtenue.
  • Gauche (Left) : conservez toutes les lignes de DataTable1 et uniquement les valeurs de DataTable2 qui répondent à la règle de jointure. Les valeurs Null sont insérées dans la colonne pour les lignes de DataTable1 qui n'ont aucune correspondance dans les lignes de DataTable2.

  • Complète (Full) : conservez toutes les lignes de DataTable1 et de DataTable2, que la condition de jointure soit remplie ou non. Les valeurs Null sont ajoutées dans les lignes des deux tables qui n'ont aucune correspondance.

    Remarque : si une colonne de DataTable2 partage le même nom avec une colonne de DataTable1, le nom de la colonne de DataTable2 est remplacé par [ColumnName]_1 dans la table résultante. Si une colonne portant le nom [ColumnName]_1 existe déjà, le numéro consécutif qui n'est pas déjà utilisé est utilisé à la place. Par exemple, si TableDonnées1 a des colonnes nommées ID, ID_1 et ID_2, et si TableDonnées2 a une colonne nommée ID, après la jointure, la colonne de TableDonnées2 est nommée ID_3.

• Règles de jointure : les conditions de jointure des tables. La sélection du champ ouvre un générateur de filtres simple dans lequel vous pouvez ajouter des règles qui composent le filtre.

Windows - Héritage, configuration Windows

Panneau propriétés

Commun

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

Entrée

• DataTable1 : la première table à utiliser dans l'opération de jointure, stockée dans une variable DataTable. Ce champ prend uniquement en charge les variables DataTable.
• DataTable2 : la première table à utiliser dans l'opération de jointure, stockée dans une variable DataTable. Ce champ prend uniquement en charge les variables DataTable.
  Remarque :L'ordre dans lequel les tables sont indiquées est très important, car il influence la structure de la table obtenue, en fonction de l'option sélectionnée dans le champ de propriété JoinType.

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

Options

• JoinType : le type d'opération de jointure à utiliser. Les options suivantes sont disponibles :

  • Interne (Inner) : conservez toutes les lignes de DataTable1 et de DataTable2 qui répondent à la règle de jointure. Toutes les lignes qui ne répondent pas à la règle sont supprimées de la table obtenue.
  • Gauche (Left) : conservez toutes les lignes de DataTable1 et uniquement les valeurs de DataTable2 qui répondent à la règle de jointure. Les valeurs Null sont insérées dans la colonne pour les lignes de DataTable1 qui n'ont aucune correspondance dans les lignes de DataTable2.

  • Complète (Full) : conservez toutes les lignes de DataTable1 et de DataTable2, que la condition de jointure soit remplie ou non. Les valeurs Null sont ajoutées dans les lignes des deux tables qui n'ont aucune correspondance.

    Remarque : si une colonne de DataTable2 partage le même nom avec une colonne de DataTable1, le nom de la colonne de DataTable2 est remplacé par [ColumnName]_1 dans la table résultante. Si une colonne portant le nom [ColumnName]_1 existe déjà, le numéro consécutif qui n'est pas déjà utilisé est utilisé à la place. Par exemple, si TableDonnées1 a des colonnes nommées ID, ID_1 et ID_2, et si TableDonnées2 a une colonne nommée ID, après la jointure, la colonne de TableDonnées2 est nommée ID_3.

Sortie

• DataTable : la seconde table à utiliser dans l'opération de jointure, stockée dans la variable DataTable. Ce champ prend uniquement en charge les variables DataTable.

Assistant de jointure

Cet assistant vous aide à configurer les propriétés de l'activité Tables de données de jointure (Join Data Tables). Vous pouvez l'ouvrir en utilisant le bouton Assistant de jointure (Join Wizard) dans le corps de l'activité du panneau Concepteur (Designer).

Dans la section supérieure de l'assistant, vous pouvez sélectionner les deux variables DataTable à utiliser dans l'opération, le type de jointure et la variable de sortie, dans les champs suivants :

• DataTable1 d'entrée (Input DataTable1) : la variable DataTable contenant la première table à utiliser.
• DataTable2 d'entrée (Input DataTable2) : la variable DataTable contenant la seconde table à utiliser.
• DataTable de sortie (Output DataTable) : la variable DataTable dans laquelle stocker la table obtenue.
• Type de jointure (Join Type) : le type d'opération de jointure à utiliser. Les options suivantes sont disponibles :
• Interne (Inner) : conservez toutes les lignes de DataTable1 et de DataTable2 qui répondent à la règle de jointure. Toutes les lignes qui ne répondent pas à la règle sont supprimées de la table obtenue.
• Gauche (Left) : conservez toutes les lignes de DataTable1 et uniquement les valeurs de DataTable2 qui répondent à la règle de jointure. Les valeurs Null sont insérées dans la colonne pour les lignes de DataTable1 qui n'ont aucune correspondance dans les lignes de DataTable2.
• Complète (Full) : conservez toutes les lignes de DataTable1 et de DataTable2, que la condition de jointure soit remplie ou non. Les valeurs Null sont ajoutées dans les lignes des deux tables qui n'ont aucune correspondance.

Dans la section inférieure de l'assistant, vous pouvez configurer la structure de la table obtenue, en ajoutant des expressions qui indiquent les relations entre les colonnes. Chacune de ces expressions possède trois éléments, comme suit :

• Table de colonne 1 (Column Table 1) : le nom de la colonne de la première table. Ce champ prend uniquement en charge les variables String contenant le nom de la colonne, les variables Int32 contenant l'index de colonne ou les variables ExcelColumn.

• Opération (Operation) : l'opération qui définit la relation entre les colonnes. Les options suivantes sont disponibles :

  • = - Est égal à
  • != - N'est pas égal à
  • > - Supérieur à
  • < - Inférieur à
  • >= - Supérieur ou égal à
  • <= - Inférieur ou égal à
• Table de colonne 2 (Column Table 2) : le nom de la colonne de la seconde table. Ce champ prend uniquement en charge les variables String contenant le nom de la colonne, les variables Int32 contenant l'index de colonne ou les variables ExcelColumn.

Exemple d'utilisation de l'activité Tables de données de jointure (Join Data Tables)

Pour illustrer comment utiliser cette activité, nous avons créé un projet qui joint deux feuilles d'un classeur dans une autre feuille de ce classeur. La première feuille contient des détails sur les commandes, tandis que la seconde feuille contient des détails sur les clients. Les deux feuilles ont une colonne commune, CustomerID, qui est utilisée pour l'opération de jointure. Vous pouvez télécharger le projet ici.

1. Créez un Projet (Project) vierge.
2. Faites glisser un conteneur Sequence dans le panneau Concepteur (Designer).
3. Faites glisser une activité Excel Application Scope et placez le chemin d'accès du classeur Excel dans la propriété Workbook Path.
4. Créez deux variables DataTable, l'une pour la feuille Clients (Customers) et l'autre pour la feuille Commandes (Orders).
5. Dans Excel Application Scope, faites glisser deux activités Read Range.
6. Définissez les deux activités Read Range pour la lecture de chacune des feuilles dans le classeur Excel et stockez-les dans leurs variables correspondantes.
7. Créez une variable DataTable pour stocker la table obtenue.
8. Faites glisser une activité Tables de données de jointure (Join Data Tables) dans le conteneur d'étendue.
9. Cliquez sur le bouton Assistant de jointure (Join Wizard) dans le corps de l'activité. L'Assistant Tables de données de jointure (Join Data Tables Wizard) s'ouvre.
10. Définissez la variable contenant la feuille Clients (Customers) dans le champ DataTable 1 d'entrée (Input DataTable 1).
11. Définissez la variable contenant la feuille Commandes (Orders) dans le champ DataTable 2 d'entrée (Input DataTable 2).
12. Définissez la variable créée pour stocker la table obtenue dans le champ DataTable de sortie (Output DataTable).
13. Dans le menu déroulant Type de jointure (Join Type), sélectionnez Interne (Inner).
14. Dans le champ Table de colonne 1, entrez la colonne qui correspond à la colonne CustomerID dans la feuille Clients.
15. Dans le menu déroulant Opération (Operation), sélectionnez =.

16. Dans le champ Table de colonne 2 (Column Table 2), entrez la colonne qui correspond à la colonne CustomerID dans la feuille Commandes (Orders). L'assistant doit ressembler à ceci :

    
    

    

    
    
17. Faites glisser une activité Write Range vers le panneau Concepteur (Designer).
18. Configurez l'activité Write Range pour l'enregistrement de la variable DataTable contenant la table obtenue dans une nouvelle feuille du classeur initial.

19. Le workflow final doit ressembler à ceci :