Événement OnSave de grille (référence de l’API client)
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 y a 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 enregistrement dans la séquence, l’événement
OnSave
ne se produit qu’une seule 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. La sélection du bouton Enregistrer dans l’un n’enregistre pas les modifications dans l’autre.
- La grille modifiable n’enregistre pas les modifications en attente 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. Il se peut donc que l’événement
OnSave
ne se déclenche pas. Par exemple, l’événementOnSave
peut ne pas se déclencher lors de la navigation vers un enregistrement différent à l’aide d’une colonne de recherche de formulaire ou via le ruban. - Si vous sélectionnez le bouton d’actualisation dans la grille modifiable, toutes les modifications en attente sont ignorées et l’événement
OnSave
n’est pas déclenché. - Le contrôle de la grille modifiable n’implémente pas de minuteur de sauvegarde automatique. La grille modifiable supprime les règles de détection des doublons.
Note
L’événement OnSave
pour les enregistrements de rendez-vous, de rendez-vous périodique ou d’activité de service annulera l’opération d’enregistrement et utilisera le message Book
pour conserver la modification au lieu de Create
ou Update
. De ce fait, les gestionnaires d’événements OnSave
et PostSave
pour ces tables ne fonctionneront pas.
Articles associés
Événement OnSave de formulaire
Événements (référence de l′API client)
Événements dans les formulaires et les grilles des applications basées sur un modèle