Méthodes et objets de grille modifiables (référence côté client)
Date de publication : janvier 2017
S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Vous pouvez définir des gestionnaires d'événements pour s'abonner à des événements déclenchés par des grilles modifiables lorsque des données sont sélectionnées, modifiées, ou enregistrées dans une grille modifiable. Les grilles modifiables prennent en charge la plupart des méthodes côté client prises en charge par des grilles non modifiables. Pour plus d'informations, voir Utiliser des grilles modifiables dans Dynamics 365
Notes
La grille modifiable a été introduite dans Mise à jour de décembre 2016 pour Dynamics 365 (en ligne et local).
Contenu de la rubrique
Événements de grille modifiable
Méthodes de grille modifiable
Événements de grille modifiable
La grille modifiable prend en charge les événements suivants que vous pouvez utiliser pour enregistrer et exécuter vos scripts côté client. Vous pouvez vous inscrire à ces événements à l'aide de l'onglet Événements de la page Microsoft Dynamics 365 utilisée pour activer les grilles modifiables pour une entité ou une grille en lecture seule :
OnRecordSelect
OnChange
OnSave
Important
Utilisez la méthode getFormContext de contexte d'exécution pour créer des gestionnaires d'événements courants qui peuvent fonctionner sur une grille modifiable GridCell ou un champ de formulaire en fonction de l'emplacement où le gestionnaire d'événements est exécuté.Pour plus d'informations :getFormContext
OnRecordSelect
L'événement OnRecordSelect se produit lorsqu'une seule ligne (enregistrement) est sélectionnée dans la grille modifiable. Cet événement ne se produit pas si un utilisateur sélectionne différentes cellules de la même ligne, ou sélectionne plusieurs lignes.
OnChange
L'événement 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. Cet événement peut également se produire lorsqu'une valeur d'attribut est mise à jour à l'aide de la méthode setValue.
OnSave
L'événement OnSave se produit avant d'envoyer les informations actualisées au serveur et, lorsque l'un des éléments suivants survient :
Il existe un changement dans la sélection d'enregistrements.
L'utilisateur déclenche explicitement une opération d'enregistrement à l'aide du bouton d'enregistrement de la grille modifiable.
L'utilisateur applique une opération de tri, filtre, groupe, pagination, ou de navigation dans la grille modifiable lorsqu'il existe des modifications en attente.
Voici quelques remarques importantes concernant l'événement OnSave :
Si un utilisateur modifie plusieurs colonnes du même enregistrements en séquence, l'événement OnSave sera uniquement déclenché une fois pour garantir des performances optimales et la compatibilité du comportement du formulaire.
La grille modifiable et le formulaire parent ont des boutons d'enregistrement distincts. Cliquer sur le bouton d'enregistrement de l'un des deux n'enregistrera pas les modifications de l'autre.
La grille modifiable n'enregistre pas les modifications en instance lorsque des opérations de navigation sont effectuées en dehors de son contexte. Si le contrôle contient des données non enregistrées, ces données peuvent être perdues. Par conséquent, l'événement OnSave ne peut pas se déclencher. Par exemple, cela peut arriver lorsque vous accédez à un enregistrement différent à l'aide d'un champ de recherche de formulaire ou via le ruban.
Cliquer sur le bouton d'actualisation dans la grille modifiable entraîne sa suppression de toutes les modifications en attente, et l'événement OnSave ne sera pas déclenché.
Le contrôle de la grille modifiable n'implémente pas de délai d'expiration de sauvegarde automatique.
La grille modifiable supprime les règles de détection des doublons.
Méthodes de grille modifiable
La grille modifiable prend en charge certaines méthodes nouvelles et la plupart des méthodes existantes prises en charge par des grilles en lecture seule :
GridControl
Grille
GridRow
GridRowData
GridEntity
GridAttribute
GridCell
GridControl
Si vous connaissez le nom du contrôle de la grille modifiable, vous pouvez y accéder à l'aide du code suivant. Par exemple, pour accéder à la sous-grille CONTACTS dans le formulaire de compte par défaut :
var contactsGrid = Xrm.Page.getControl("Contacts");
Conseil
Pour identifier les noms des contrôles de grille dans le formulaire sans ouvrir l'éditeur de formulaires, voir les informations dans Utiliser les outils de développement du navigateur.
La grille modifiable prend en charge les méthodes de contrôle de grille en lecture seule suivantes : getEntityName et getGrid.
Grille
La grille modifiable prend en charge les méthodes suivantes pour la Grid renvoyée par le GridControl. La méthode getGrid : getRows, getSelectedRows, et getTotalRecordCount.
GridRow
La grille modifiable prend en charge la méthode getData pour la GridRow renvoyée par les méthodes Grid.getRows et Grid.getSelectedRows.
GridRow prend également en charge la collecte de data qui fournit des moyens d'utiliser une ligne de grille modifiable. Consultez Collections (référence côté client) pour plus d'informations sur les méthodes disponibles pour accéder aux données d'une collection.
GridRowData
La grille modifiable prend en charge la méthode getEntity pour les GridRowData renvoyées par la méthode GridRow.getData.
GridRowData fournit également des méthodes pour récupérer des informations spécifiques à un enregistrement affiché sur la ligne de la grille modifiable, notamment une collection de tous les attributs inclus dans la ligne. Les données d'attributs sont limitées aux colonnes présentées par la grille modifiable. Consultez Collections (référence côté client) pour plus d'informations sur les méthodes disponibles pour accéder aux données d'une collection.
GridEntity
La grille modifiable prend en charge les méthodes suivantes pour la GridEntity renvoyée par la méthode GridRowData.getEntity :
En dehors d'utiliser la méthode GridRowData.getEntity, vous pouvez récupérer l'GridEntity en accédant directement à l'objet GridRowData.entity.
GridEntity prend également en charge la collection d'attributes qui fournit des méthodes pour utiliser un ensemble d'attributs pour une entité dans la grille modifiable. Chaque attribut (GridAttribute) représente les données de la cellule d'une grille modifiable, et contient une référence à toutes les cellules associées à l'attribut. Consultez Collections (référence côté client) pour plus d'informations sur les méthodes disponibles pour accéder aux données d'une collection.
GridAttribute
Le GridAttribute prend en charge les méthodes suivantes pour les attributs d'une ligne de grille sélectionnée : getName, getRequiredLevel, setRequiredLevel, getValue, et setValue.
Utilisez la méthode Grid.getSelectedRows pour récupérer la ligne sélectionnée dans une grille modifiable.
GridAttribute prend également en charge la collecte controls pour les attributs d'une ligne de grille sélectionnée, qui fournit des méthodes pour utiliser une collection de cellules associées à l'attribut. Chaque cellule (GridCell) d'une ligne de grille sélectionnée est analogue à un contrôle dans un formulaire qui est lié à un attribut dans une grille modifiable. Consultez Collections (référence côté client) pour plus d'informations sur les méthodes disponibles pour accéder aux données d'une collection.
Conseil
Pour des raisons de performances, une ligne (enregistrement) d'une grille modifiable n'est pas modifiable tant que l'enregistrement n'est pas sélectionné. Les utilisateurs doivent sélectionner un enregistrement unique dans une grille pour la modifier. Lorsqu'un enregistrement est sélectionné dans une grille modifiable, Dynamics 365 évalue en interne un groupe d'éléments tels que l'accès utilisateur à l'enregistrement, si l'enregistrement est actif, et des validations de champ pour s'assurer que la protection et la validité des données sont honorées lorsque vous modifiez des données. Envisagez d'utiliser l'événement OnRecordSelect avec la méthode getFormContext pour accéder à des enregistrements dans la grille dont l'état est modifiable.
GridCell
En plus de setNotification et clearNotification, la GridCell prend en charge les méthodes de contrôle suivantes :
Notes
Les grilles modifiables affichent plus d'une notification à la fois.
getDisabled
Retourne si la cellule est désactivée (lecture seule).
gridCellObj.getDisabled()
- Valeur renvoyée
Type : Booléen. True si la cellule est désactivée, autrement False.
setDisabled
Définit si la cellule est désactivée.
gridCellObj.setDisabled(bool)
Arguments
Type : Booléen. True si la cellule doit être désactivée, autrement False.Remarques
Activer une cellule en lecture seule pour la modifier peut entraîner une erreur lorsque l'enregistrement est enregistré. Si le champ est considéré en lecture seule par le serveur, une erreur peut se produire si la valeur est modifiée. Cela peut se produire dans les scénarios où l'utilisateur ne possède pas de privilèges d'écriture sur les enregistrements, l'enregistrement est désactivé, ou l'utilisateur n'a pas les privilèges de sécurité nécessaires au niveau du champ.
getLabel
Renvoie l'étiquette de la colonne contenant la cellule.
gridCellObj.getLabel()
- Valeur renvoyée
Type : Chaîne. Étiquette de la colonne.
Voir aussi
Méthodes et objets de grille (lecture seule) (référence côté client)
Utiliser des grilles modifiables dans Dynamics 365
Microsoft Dynamics 365
© 2017 Microsoft. Tous droits réservés. Copyright