getSaveMode (référence de l’API client)

Renvoie la valeur indiquant comment l’événement d’enregistrement a été initié par l’utilisateur.

Syntaxe

executionContext.getEventArgs().getSaveMode()

Valeur renvoyée

Type : Nombre

Description : le tableau suivant décrit les valeurs prises en charge renvoyées pour détecter les différentes manières dont les enregistrements de table peuvent être enregistrés par l’utilisateur.

Remarques

Cette méthode est indispensable si vous souhaitez activer l’enregistrement automatiquement pour la plupart des formulaires dans une organisation mais le désactiver pour des formulaires spécifiques.

Exemple

Le code suivant enregistré pour l’événement OnSave avec le contexte d’exécution qui lui est transmis empêche les enregistrements initiés par un enregistrement automatique, mais autorise tous les autres. Lorsque l’enregistrement automatique est activé, le fait de quitter équivaut à Enregistrer et fermer. Ce code empêche les enregistrements initiés par le minuteur de 30 secondes ou lorsque les utilisateurs quittent un formulaire avec des données non enregistrées.

function preventAutoSave(executionContext) {
    var eventArgs = executionContext.getEventArgs();
    if (eventArgs.getSaveMode() == 70 || eventArgs.getSaveMode() == 2) {
        eventArgs.preventDefault();
    }
}

Pour sauvegarder un enregistrement, l’utilisateur doit sélectionner l’icône Sauvegarder en bas du formulaire ou une commande Sauvegarder personnalisée doit être ajoutée à la barre de commandes.

Articles associés

isDefaultPrevented
preventDefault