apps
latest
false
Important :
Veuillez noter que ce contenu a été localisé en partie à l’aide de la traduction automatique.
UiPath logo, featuring letters U and I in white
Guide de l'utilisateur d'Apps
Automation CloudAutomation Cloud Public SectorAutomation Suite
Last updated 17 juin 2024

Modifier la grille

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

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.

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<PageName>.<ControlName>.<RuleName>.Error.Message
Par exemple : MainPage.EmployeeDetailsGrid.UpdateEntityRecord.Error.Message.

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

  • ÉlémentSélectionné (SelectectItem) (T) : fait référence à l'élément actuellement sélectionné par l'utilisateur de l'application

  • DataSource (ListeSource de T) : fait référence aux données disponibles sur la commande.

  • NouvelÉlément (NewItem) (T) : fait référence à l'élément créé par l'option Ajouter une ligne (Add row). À utiliser dans l'événement Ligne ajoutée (Row added).

  • Caché (Hidden) (Booléen) : fait référence à la propriété Caché (Hidden) de la commande.

  • Modifiable (Editable) (Boolean) : fait référence à la propriété Modifiable (Editable) de la commande.

  • AjouterLignes (AddRows) (Boolean) : référence la propriété Ajouter des lignes (Add Rows) de la commande.

  • SupprimerLignes (DeleteRows) (Boolean) : fait référence à la propriété Supprimer des lignes (Delete Rows) de la commande.

  • Rechercher (Search) (Boolean) : fait référence à la propriété Rechercher (Search) de la commande.

  • IndexLigne (RowIndex) (entier) : fait référence à l'élément dans la colonne pour les opérations de mise à jour et de suppression.

Important :

Utilisez cette propriété pour l'intégration de processus où l'ensemble de données complet est en mémoire.

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

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>.ToListSourceProcesses.<process_name>.<datatable_output_argument>.ToListSource

    Par exemple :

    Processes.Process_A.out_dt1.ToListSourceProcesses.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).

      docs image
    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>Processes.<process_name>.<datatable_output_parameter>

        Par exemple :

        Processes.Process_A.out_dt1Processes.Process_A.out_dt1

        Valeur (Value)

        Processes.<process_name>.<datatable_output_parameter>.AddRow(MainPage.EditGrid.NewItem)Processes.<process_name>.<datatable_output_parameter>.AddRow(MainPage.EditGrid.NewItem)

        Par exemple :

        Processes.Process_A.out_dt1.AddRow(MainPage.EditGrid.NewItem)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>Processes.<process_name>.<datatable_output_parameter>

        Par exemple :

        Processes.Process_A.out_dt1Processes.Process_A.out_dt1

        Valeur (Value)

        Processes.<process_name>.<datatable_output_parameter>.DeleteRowAt(MainPage.EditGrid.RowIndex)Processes.<process_name>.<datatable_output_parameter>.DeleteRowAt(MainPage.EditGrid.RowIndex)

        Par exemple :

        Processes.Process_A.out_dt1.DeleteRowAt(MainPage.EditGrid.RowIndex)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>Processes.<process_name>.<datatable_output_parameter>

        Par exemple :

        Processes.Process_A.out_dt1Processes.Process_A.out_dt1

        Valeur (Value)

        Processes.<process_name>.<datatable_output_parameter>.UpdateRowAt(MainPage.EditGrid.RowIndex, MainPage.EditGrid.SelectedItem)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)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 :
    OptionDescription

    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")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".
      docs image

    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.IdMainPage.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.IdMainPage.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"})})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>.IdMainPage.EditGrid.SelectedItem.<entity_name>.Id

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

Cette page vous a-t-elle été utile ?

Obtenez l'aide dont vous avez besoin
Formation RPA - Cours d'automatisation
Forum de la communauté UiPath
Uipath Logo White
Confiance et sécurité
© 2005-2024 UiPath Tous droits réservés.