Modifier la grille

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

Démonstration : Modifier la grille

Téléchargez l'application de démonstration Apps_Tables_C heatsheet.zip et importez-la dans UiPath Studio Web pour voir un exemple de la façon dont le contrôle Modifier la grille peut être utilisé pour créer une feuille de calcul Table pour afficher et mettre à jour les données.

Général

• Source de données (Data source ) : la source des données que vous souhaitez modifier dans la grille. Par défaut, crée un workflow avec une activité Rechercher un enregistrement d’entité (Query Entity Record) . Vous pouvez également référencer un objet de type AppsDataSource.

  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 :

Le sélecteur de date de la grille d'édition ne prend pas en charge les types de colonnes de modification qui contiennent des valeurs d'heure. Configurez la colonne dans votre entité Data Service à l'aide de l'option Exclure le temps (Exclude time) pour éviter les erreurs dans vos données.

Si vous devez inclure une colonne d'heure, définissez l'option d'affichage du mode d'édition de la colonne sur le type Zone de texte .

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.

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 d'entités avec les commandes Table et Modifier la grille

Consultez la section Utiliser des commandes tabulaires avec des entités Data Service dans les projets d'application pour plus d'informations sur l'utilisation d'entités avec des commandes Table et Modifier la grille.

Remarque :

• Le formatage des dates n'est pas pris en charge par les commandes Table et Modifier la grille . Lors de l'utilisation de colonnes de date, le type DateTime s'affiche sans formatage supplémentaire (affiché sur valeurs brutes). En revanche, les colonnes de type DateOnly sont automatiquement formatées en fonction des paramètres régionaux et de langue du navigateur de l'utilisateur.
• Lorsque vous travaillez avec des entités, il est recommandé d'utiliser l'option Créer un workflow pour activer la pagination. Il n'est pas conseillé d'utiliser une variable Entity App comme source de données , car cela crée une copie locale des données et ne prend pas en charge la pagination de Data Fabric.