Grilles et sous-grilles des applications pilotées par modèle (référence de l’API client)

Les grilles et les sous-réseaux présentent des données dans un format tabulaire dans les applications basées sur des modèles. Utilisez les événements et objets de l’API client dans cet article pour utiliser des grilles en lecture seule et modifiables. Les grilles peuvent couvrir le formulaire entier ou peuvent être l’un des éléments d’un formulaire, ce que l’on appelle sous-grilles.

Types de grilles

Vous pouvez créer deux types de grilles dans les applications basées sur un modèle :

• Grilles en lecture seule : affichage des données sous forme de tableau. Pour modifier les données affichées dans une grille en lecture seule, vous devez sélectionner l’enregistrement dans la grille pour ouvrir le formulaire, modifier les données, puis enregistrer.
• Grilles modifiables : en plus d’afficher des données dans un format tabulaire, fournit des fonctionnalités d’édition inline enrichies sur les clients web et mobiles, notamment la possibilité de regrouper, trier et filtrer des données dans la même grille afin que vous n’ayez pas à changer d’enregistrements ou de vues. La grille modifiable est un contrôle personnalisé qui est pris en charge dans la grille principale et les sous-grilles d’un formulaire du client Web, et dans les tableaux de bord et grilles de formulaire des clients mobiles. Bien que le contrôle de grille modifiable fournisse la possibilité d’effectuer des modifications, il respecte les métadonnées de grille en lecture seule et les paramètres de sécurité au niveau des champs.

Obtenir le contexte de la grille

Le contexte de grille est la grille ou l’instance de sous-grille dans un formulaire dans lequel exécuter votre code. Pour plus d’informations sur l’obtention du contexte de grille pour exécuter votre code JavaScript, consultez le contexte de grille d’API cliente.

Événements Grid

Nom	Description	Applicable à
Événement OnLoad de sous-grille	Se produit chaque fois que la sous-grille s’actualise. Cet événement inclut lorsque les utilisateurs trient les valeurs dans le sous-réseau en cliquant sur les en-têtes de colonne.	Grille en lecture seule
Grille OnChange	Se produit lorsqu’une valeur est modifiée dans une cellule de la grille modifiable et que la cellule n’est plus activée	Grille modifiable
Grille OnRecordSelect	Se produit lorsqu’une seule ligne (enregistrement) est sélectionnée dans la grille modifiable	Grille modifiable
Grille OnSave	Se produit avant d’envoyer les informations mises à jour au serveur, et lorsque l’une des opérations suivantes se produit : il existe une modification dans la sélection d’enregistrement, l’utilisateur déclenche explicitement une opération d’enregistrement à l’aide du bouton d’enregistrement de la grille modifiable, ou l’utilisateur applique un tri, un filtre, un groupe, une pagination ou une opération de navigation à partir de la grille modifiable pendant qu’il y a des modifications en attente.	Grille modifiable

Note

Vous pouvez vous inscrire aux événements OnChange, OnRecordSelect et OnSave à l’aide de l’onglet Événements de la page Des applications basées sur des modèles que vous utilisez pour activer les grilles modifiables pour une table ou une grille en lecture seule.

Objets grid

Utilisez les objets suivants pour interagir avec les grilles. Ces objets forment une hiérarchie comme illustré dans le schéma suivant :

Nom	Description	Disponible pour
GridControl	Fournit des méthodes à utiliser avec le contrôle de grille ou de sous-grille.	Grilles modifiables et en lecture seule
Grid	Fournit des méthodes pour accéder aux informations sur les données de la grille.	Grilles modifiables et en lecture seule
GridRow	Fournit des méthodes à utiliser avec des lignes ou des lignes sélectionnées dans la grille.	Grilles modifiables et en lecture seule
GridRowData	Fournit des méthodes à utiliser avec des lignes ou des lignes sélectionnées dans la grille.	Grilles modifiables et en lecture seule
GridEntity	Fournit des méthodes pour accéder aux données sur des enregistrements spécifiques des lignes.	Grilles modifiables et en lecture seule
GridAttribute	Fournit des méthodes pour accéder aux données dans la cellule d’une grille modifiable.	Grille modifiable
GridCell	Fournit des méthodes pour accéder aux données liées au contrôle sur un formulaire lié à une colonne dans une grille modifiable.	Grille modifiable
ViewSelector	Fournit des méthodes pour obtenir ou définir des informations sur le sélecteur de vue du contrôle de sous-grille.	Grille en lecture seule

Articles associés

Contexte de grille de l’API client
Utiliser les grilles modifiables
Références de l’API client pour les applications basées sur un modèle
Guide du développeur des applications basées sur des modèles