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

Les grilles présentent les données sous forme de tableau dans les applications basées sur un modèle. 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 les données sous forme de tableau, elles offrent de riches fonctions d’édition en ligne sur les clients Web et mobiles, notamment la possibilité de regrouper, de trier et de filtrer les données au sein de la même grille afin de ne pas avoir à changer d’enregistrement ou de vue. 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.

Obtention du contexte de 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 la grille pour exécuter votre code JavaScript, voir Contexte de la grille de l’API client

Événements

Nom	Description	Applicable à
Événement OnLoad de sous-grille	Se produit chaque fois que la sous-grille s’actualise. Notamment lorsque les utilisateurs trient les valeurs de la sous-grille 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’un des événements suivants se produit : modification de la sélection d’enregistrement, l’utilisateur déclenche explicitement une opération de sauvegarde à l’aide du bouton de sauvegarde de la grille modifiable, ou lorsque l’utilisateur applique une opération de tri, de filtrage, de groupe, de pagination ou de navigation à partir de la grille modifiable pendant que des modifications sont en attente.	Grille modifiable

Notes

Vous pouvez vous inscrire aux événements OnChange, OnRecordSelect, et OnSave en utilisant l’onglet Événements de la page des applications pilotées par modèle qui est utilisée pour activer les grilles modifiables pour un tableau ou une grille en lecture seule.

Objets

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
Présentation générale des applications basées sur un modèle pour les développeurs

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).