Modifier la grille

La commande Modifier la grille (Edit Grid) vous permet de répertorier, modifier, paginer ou rechercher des enregistrements tabulaires.

Démos

Modifier la grille (Edit Grid) : travailler avec des entités

Introduction

Cette application montre comment travailler avec les entités à l'aide de la commande Modifier la grille ( Edit Grid ).

Application de démonstration - essayez-la vous-même

Télécharger l’application de démonstration depuis GitHub

Aperçu de l’application de démonstration dans le cloud

Application de démonstration - instructions d'utilisation

1. Téléchargez le fichier zip avec l'application de démonstration. Il contient :

   • Schema.json : le schéma des entités utilisées par l'application

   • EditGridEntity_DemoApp.uiapp : le fichier UiPath^® Apps

2. Dans Data Service UiPath^® , importez le fichier Schema.json. Assurez-vous d'importer à la fois les entités (pays et employés) et les ensembles de choix (genre et compétences).
3. Renseignez vos entités et ensembles de choix avec des données.
4. Dans UiPath^® Apps, créez une nouvelle application et importez l'application téléchargée.
5. Vous remarquerez peut-être des erreurs. Pour les corriger, remplacez l'entité Employés référencée par celle que vous avez récemment importée à l'étape 2.
6. Prévisualisez l'application et interagissez avec les données dans Modifier la grille ( Edit Grid).

Général

• Source de données (Data source) : la source des données que vous souhaitez modifier dans la grille. Vous devez référencer un objet de type AppsDataSource, tel qu'une entité Data Service ou un processus Orchestrator.

  Une fois que vous avez récupéré la source de données, la grille détecte automatiquement les colonnes de données. En cliquant sur l'icône Plus (More) de chaque colonne, vous accédez aux propriétés suivantes :

  • Nom (Name) : nom affiché de l'en-tête de colonne.

  • Source : le champ de l'entité référencée.

  • Affichage du mode édition (Edit mode view) : détermine comment interagir avec la colonne :

    Option d'affichage du mode édition	Description
    Zone de texte	Les cellules de la colonne se comportent comme une commande Zone de texte (Textbox).
    Sélecteur de date	Les cellules de la colonne se comportent comme une commande DatePicker.
    Case à cocher	Les cellules de la colonne se comportent comme une commande Case à cocher (Checkbox).
    Liste déroulante	Les cellules de la colonne se comportent comme une commande Liste déroulante (Dropdown).
    Sélection multiple	Les cellules de la colonne se comportent comme une commande Sélection multiple (Multi select).

  • Masqué (Hidden) : si la valeur est true, masque la colonne au moment du runtime.

  • Modifiable (Editable) : si la valeur est false, marque le contenu de la colonne comme étant en lecture seule.

• Ajouter une nouvelle colonne (Add new column) : ajoutez de nouvelles colonnes à vos données en cliquant sur l'icône plus « + ».

• Masqué (Hidden) : si la valeur est true, masque la commande au moment du runtime.

• Modifiable (Editable) : si la valeur est false, marque le contrôle comme étant en lecture seule.

• Ajouter des lignes (Add rows) : si la valeur est true, permet aux utilisateurs de l'application d'ajouter de nouvelles lignes au moment du runtime. Si la valeur false, les utilisateurs ne peuvent pas ajouter de nouvelles lignes.

• Supprimer des lignes (Delete rows) : si la valeur est true, permet aux utilisateurs de l'application de supprimer des lignes. Si la valeur est false, les utilisateurs ne peuvent pas supprimer les lignes.

• Rechercher (Search) : si la valeur est true, affiche une fonctionnalité de recherche intégrée.

Remarque :

The Date Picker in the Edit Grid does not support editing column types which contain time values. Configure the column in your Data Service entity using the Exclude time option to avoid errors in your data.

If you need to include a column corresponding specifically to time, set the Edit mode view option of the column to the Textbox type.

Events

• Ligne sélectionnée (Row selected) : configurez ce qui se passe lorsqu'une ligne est sélectionnée.

• Ligne ajoutée (Row added) : configure ce qui se passe lorsqu'une ligne est ajoutée.

• Ligne modifiée (Row modified) : configurez ce qui se passe lorsqu'une ligne est modifiée.

• Ligne supprimée (Row deleted) : configurez ce qui se passe lorsqu'une ligne est supprimée.

Remarque :

Pour accéder aux erreurs dans les opérations de mise à jour, d'ajout ou de modification, utilisez la syntaxe suivante :

<PageName>.<ControlName>.<RuleName>.Error.Message

Par exemple : MainPage.EmployeeDetailsGrid.UpdateEntityRecord.Error.Message.

Remarque :

Pour utiliser un argument d'entrée/de sortie pour manipuler l'activité Modifier la grille ( Edit Grid), utilisez la syntaxe suivante :

Processes.ALLDATATYPES.out_datatable

Par exemple :

• Pour ajouter une ligne, utilisez Processes.ALLDATATYPES.out_datatable.AddRow(MainPage.EditGrid.NewItem).
• Pour supprimer une ligne, utilisez Processes.ALLDATATYPES.out_datatable.DeleteRowAt(MainPage.EditGrid.RowIndex).
• Pour mettre à jour une ligne, utilisez Processes.ALLDATATYPES.out_datatable.UpdateRowAt(MainPage.EditGrid.RowIndex, MainPage.EditGrid.SelectedItem).

Style

• Alignement de commande (Control Alignment) : hérite de l'alignement parent par défaut. Un autre alignement que le parent peut être défini. Pour revenir par défaut à l'alignement parent, désélectionnez les options remplacées.

  Remarque : l'alignement dépend de la mise en page sélectionnée pour le parent (Vertical vs Horizontal).

• Couleur d'arrière-plan (Background Color) : la couleur d'arrière-plan de l'en-tête de grille et du corps de grille.

• Bordure (Border) : la bordure de la commande. L'épaisseur (Thickness), la couleur (Color) et le rayon (Radius) peuvent être configurés.

• Police (Font) : attributs de police du texte de l'en-tête de colonne et du corps de colonne, tels que la famille de polices, la taille, la couleur ou le style (gras, italique et souligné). Par défaut, la commande hérite de la famille de polices de son conteneur parent immédiat, qui est indiqué par le mot-clé « Inherited ».

• Marge (Margin) : la marge de la commande. Par défaut, une marque de 4px est définie. Les propriétés des marges Haut/Bas (Top/Bottom)et Gauche/Droite (Left/Right) sont combinées. Ces propriétés peuvent être dissociées à l'aide du bouton Lier (Link) sur le côté droit de la section Marge (Margin).

• Taille (Size) : largeur et hauteur de la commande. Par défaut, la taille est définie sur auto. Pour définir des valeurs minimales ou maximales, cliquez sur l'icône à trois points (...).Si la taille du champ est inférieure à celle des options, une barre de défilement s'affiche.

Propriétés VB

Propriété VB	Type de données	Description
SelectedItem	Apps.Controls.TabularInitClass	Référence l'élément actuellement sélectionné dans la commande.
DataSource	Apps.Controls.ListSource(Of Apps.Controls.TabularInitClass)	Référence la source de données pour les valeurs à l'intérieur du champ Table.
NewItem	Apps.Controls.TabularInitClass	Fait référence à l'élément créé par l'option Ajouter une ligne (Add row ). L'événement Ligne ajoutée ( Row added) fait référence à cette propriété.
Editable	Booléen	Détermine si l'option Modifier la grille ( Edit Grid ) est modifiable.
AddRows	Booléen	Détermine si des lignes peuvent être ajoutées à la grille d'édition.
DeleteRows	Booléen	Détermine si les lignes peuvent être supprimées de l'activité Modifier la grille (Edit Grid).
RowIndex	Entier	Référence l'index de la ligne pour les opérations de mise à jour et de suppression. Doit être utilisé pour l'intégration de processus où l'ensemble de données complet est en mémoire.
Search	Booléen	Active ou désactive la fonction de recherche. Si True, la recherche est activée.
Value	Apps.Controls.TabularInitClass	La valeur actuellement sélectionnée de la commande.
Hidden	Booléen	Si la valeur est true, masque la commande au moment du runtime.
Disabled	Booléen	Si la valeur est true, désactive la commande au moment du runtime.

Conversion de données complexes en AppsDataSource

Pour convertir une table de données ou un type de données complexe en AppsDataSource : enregistrez la table de données dans une variable, puis utilisez la méthode .ToListSource qui convertit les données de la table de données en AppsDataSource.

1. Enregistrez les données dans une variable de type TableDonnées. Par exemple, nommez la variable « dt ».
2. Dans le champ Source de données (Data source) des commandes de table, utilisez l'expression suivante :

   dt.ToListSource()

De manière générale, les objets complexes peuvent être convertis en AppsDataSource en utilisant la syntaxe :

Processes.ALLDATATYPES.out_datatable.ToListSource()

Utilisation de TableDonnées dans les commandes Modifier la grille (Edit Grid)

Assurez-vous que vous avez déjà un objet TableDonnées dans votre application.

Les objets Tables de données (DataTables) peuvent être définis en tant qu'arguments d'entrée, de sortie ou d'entrée/de sortie d'un processus. Pour utiliser ces objets TableDonnées, vous devez référencer le processus où ils sont utilisés comme arguments.

Remarque :

TableDonnées ne prend en charge que les primitives dans une colonne. Les arguments de type complexe dans une colonne ne fonctionnent pas dans DataTable.

Supposons que vous ayez un processus nommé "Process_A", qui a les objets TableDonnées comme arguments :

Arguments d'entrée	in_dt1
Arguments de sortie	out_dt1
Arguments d'entrée/de sortie	inout_dt

Modifier la grille

1. Accédez à l'onglet Général (General) de votre commande Modifier la grille (Edit Grid ).

2. Dans le champ Source de données (Data source ) de la commande, ouvrez l'éditeur d'expressions et écrivez l'expression suivante :

   Processes.<process_name>.<datatable_output_argument>.ToListSource

   Par exemple :

   Processes.Process_A.out_dt1.ToListSource

3. Pour effectuer des opérations sur les lignes de la table de données, telles que l'ajout, la modification ou la suppression d'actions :

   1. Assurez-vous que les propriétés Modifiable ( Editable), Ajouter des lignes ( Add rows) et Supprimer des lignes ( Delete rows ) sont définies sur Vrai(True).

      

   2. Basculez vers l'onglet Événements (Events) de la commande Modifier la grille ( Edit Grid ), puis configurez les règles correspondantes :

      1. Pour ajouter des lignes, cliquez sur Créer la règle pour Ligne ajoutée ( Row added), puis utilisez la règle Définir la valeur ( Set Value ) :

         Élément à définir	Processes.<process_name>.<datatable_output_parameter> Par exemple : Processes.Process_A.out_dt1
         Valeur (Value)	Processes.<process_name>.<datatable_output_parameter>.AddRow(MainPage.EditGrid.NewItem) Par exemple : Processes.Process_A.out_dt1.AddRow(MainPage.EditGrid.NewItem)

      2. Pour supprimer des lignes, cliquez sur Créer une règle pour Ligne supprimée ( Row deleted), puis utilisez la règle Définir la valeur ( Set Value ) :

         Élément à définir	Processes.<process_name>.<datatable_output_parameter> Par exemple : Processes.Process_A.out_dt1
         Valeur (Value)	Processes.<process_name>.<datatable_output_parameter>.DeleteRowAt(MainPage.EditGrid.RowIndex) Par exemple : Processes.Process_A.out_dt1.DeleteRowAt(MainPage.EditGrid.RowIndex)

      3. Pour modifier les lignes, cliquez sur Créer une règle pour Ligne modifiée ( Row modified), puis utilisez la règle Définir la valeur ( Set Value ) :

         Élément à définir	Processes.<process_name>.<datatable_output_parameter> Par exemple : Processes.Process_A.out_dt1
         Valeur (Value)	Processes.<process_name>.<datatable_output_parameter>.UpdateRowAt(MainPage.EditGrid.RowIndex, MainPage.EditGrid.SelectedItem) Par exemple : Processes.Process_A.out_dt1.UpdateRowAt(MainPage.EditGrid.RowIndex, MainPage.EditGrid.SelectedItem)

Utilisation d'entités avec les commandes Modifier la grille (Edit Grid)

L'exemple suivant montre comment lier une entité à une commande Modifier la grille (Edit Grid), puis effectuer les opérations CRUD à l'aide de la commande et des règles spécifiques à l'entité.

L'entité utilisée s'appelle « Employé » (Employee) et comporte les champs suivants :

• Nom

• Âge

• Date de naissance

• Sexe

• Équipe

• Date d'adhésion

• EstTempsComplet

• Compétences

Affichage des enregistrements d'entité

1. Créez une nouvelle application VB, puis ajoutez l'entité Employé (Employee) à l'application.
2. Ajoutez la commande Modifier la grille (Edit Grid) à l'application.
3. Dans le champ Source de données (Data source) de la commande Modifier la grille (Edit Grid), utilisez le Générateur de requêtes (Query Builder) et sélectionnez l'entité Employé (Employee). Les colonnes de la commande sont automatiquement remplies avec les champs de l'entité.
4. Pour chaque colonne, assurez-vous que la liste déroulante Affichage du mode édition (Edit mode view) est définie sur le type de données correct, comme suit :

   Option	Description
   Date de naissance	Sélecteur de date
   Âge	Zone de texte
   Nom	Zone de texte
   Sexe	Liste déroulante
   Équipe	Liste déroulante
   Date d'adhésion	Sélecteur de date
   EstTempsComplet	Case à cocher
   Compétences	Sélection multiple

   Genre (Gender) et Équipe (Team) sont des ensembles de choix d'entité. Lorsque vous sélectionnez Liste déroulante (Dropdown) dans Affichage du mode édition (Edit mode view) de ces colonnes, deux nouvelles propriétés s'affichent : Source de la liste (List Source) et Colonne (Column).
5. Pour récupérer les options dans un ensemble de choix :
   1. Dans le champ Source de liste (List Source), utilisez la syntaxe suivante

      GetChoiceSet("Choiceset Name")

      Par exemple, pour les colonnes Genre (Gender) et Équipe (Team), le champ Source de la liste (List source) doit avoir :

      • Genre (Gender) : GetChoiceSet("Gender")
      • Équipe (Team) : GetChoiceSet("Team")
   2. Dans le champ Colonne (Column), saisissez "Name".
      

   Les compétences sont un ensemble de choix d'entité qui permet une sélection multiple. Lorsque vous sélectionnez Sélection multiple (Multi select) dans Affichage du mode édition (Edit mode view) de ces colonnes, deux nouvelles propriétés s'affichent : Source de la liste (List Source) et Colonne (Column).

6. Configurez la colonne Compétences (Skills) comme vous l'avez fait pour Genre (Gender) et Équipe (Team).
7. Accédez à l'onglet Événement (Event) de la commande Modifier la grille (Edit Grid).
8. Pour l'événement Ligne ajoutée (Row added), créez la règle suivante :
   1. Ajoutez la règle Créer un enregistrement d'entité (Create Entity Record).
   2. Dans Dans quelle entité l'enregistrement doit-il être créé ? (Which entity should the record be created in?), sélectionnez l'entité Employé (Employee).
   3. Dans le champ Valeurs à définir (Values to set), mettez à jour les éléments suivants :
      • Propriété Nom (Name) : MainPage.EditGrid.NewItem.Name
      • Propriété Date d'adhésion (Date of Joining) : MainPage.EditGrid.NewItem.Dateofjoining
      • Propriété Âge (Age) : MainPage.EditGrid.NewItem.Age
      • Propriété Genre (Gender) : MainPage.EditGrid.NewItem.Gender
      • Propriété Équipe (Team) : MainPage.EditGrid.NewItem.Team
      • Propriété EstTempsComplet (IsFullTime) : MainPage.EditGrid.NewItem.Isfulltime
      • Propriété Compétences (Skills) : MainPage.EditGrid.NewItem.Skills
9. Pour l'événement Ligne modifiée (Row modified), créez la règle suivante :
   1. Ajoutez la règle Mettre à jour un enregistrement d'entité (Update Entity Record).
   2. Dans Quel enregistrement d'entité doit être mis à jour ? (Which entity's record should be updated?), sélectionnez l'entité Employé (Employee).
   3. Dans ID d'enregistrement d'entité (Entity record Id), écrivez l'expression suivante :

      MainPage.EditGrid.SelectedItem.Id

   4. Dans le champ Valeurs à définir (Values to set), mettez à jour les éléments suivants :
      • Propriété Nom (Name) : MainPage.EditGrid.SelectedItem.Name
      • Propriété Date d'adhésion (Date of Joining) : MainPage.EditGrid.SelectedItem.Dateofjoining
      • Propriété Âge (Age) : MainPage.EditGrid.SelectedItem.Age
      • Propriété Genre (Gender) : MainPage.EditGrid.SelectedItem.Gender
      • Propriété Équipe (Team) : MainPage.EditGrid.SelectedItem.Team
      • Propriété EstTempsComplet (IsFullTime) : MainPage.EditGrid.SelectedItem.Isfulltime
      • Propriété Compétences (Skills) : MainPage.EditGrid.SelectedItem.Skills
10. Pour l'événement Ligne supprimée (Row deleted), créez la règle suivante :
    1. Ajoutez la règle Supprimer un enregistrement d'entité (Delete Entity Record).
    2. Dans Quel enregistrement d'entité doit être supprimé ? (Which entity record should be deleted?), sélectionnez l'entité Employé (Employee).
    3. Dans ID d'enregistrement d'entité (Entity record Id), écrivez l'expression suivante :

       MainPage.EditGrid.SelectedItem.Id

11. Prévisualisez votre application et interagissez avec les différentes fonctionnalités Modifier la grille (Edit Grid) telles que la pagination, la recherche, l'ajout d'une nouvelle ligne, la mise à jour d'une ligne ou la suppression de lignes.

Utilisation de relations dans les commandes Modifier la grille (Edit Grid)

Pour utiliser des champs d'entité de type Relation (Relationship) dans une commande Modifier la grille (Edit Grid) :

1. Dans le champ Affichage du mode édition (Edit mode view), définissez les champs de relation sous la forme d'une liste déroulante (Dropdown).
2. Dans la propriété Source de la liste (List Source) qui suit, utilisez l'expression suivante :

   Fetch(of <entity_name>)(Nothing, Nothing, Nothing, Nothing, New ExpansionFieldOption(){addExpansionFieldOption("CreatedBy", New String(){"Id","Name"}), addExpansionFieldOption("UpdatedBy", New String(){"Id","Name"})})

3. Dans la propriété Colonne (Column) suivante, écrivez "Name".
4. Dans les règles liées à l'entité, telles que Créer (Create), Mettre à jour (Update) ou Supprimer un enregistrement d'entité (Delete Entity Records), transmettez l'ID du champ de relation comme suit :

   MainPage.EditGrid.SelectedItem.<entity_name>.Id