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