preSubmit, événement

Description

Se déclenche dès qu’un formulaire transmet des données à l’hôte via le protocole HTTP. A ce stade, les données sont organisées dans un ensemble de données, mais n’ont pas encore été envoyées à l’hôte. Les calculs et les scripts associés à l’événement peuvent examiner et corriger les données avant la soumission du formulaire. Si le calcul ou le script est défini de manière à être exécuté sur le serveur, le formulaire envoie les données au serveur en lui indiquant d’exécuter le calcul ou le script avant tout traitement supplémentaire.

Remarque : l’événement preSubmit ne fait pas la distinction entre les soumissions initiées par l’activation de différents boutons ou par différents URL. Tout script devant faire cette distinction doit inclure un code lui permettant de déterminer le bouton ayant été activé. En général, preSubmit est analogue à preSave et est utilisé dans le même but.

Type

Evénement d’application

Prise en charge

Application client

Disponibilité

Acrobat et Acrobat Reader

yes

Navigateur HTML

yes

(Pour les boutons d’envoi uniquement)

Version

XFA 2.1

Exemple

Grâce à cet événement, vous pouvez modifier les données du formulaire juste avant la soumission des données. Vous avez la possibilité, par exemple, de générer un script sur l’événement preSubmit consistant à analyser la quantité de données et à afficher par la suite un message à l’utilisateur l’informant du temps nécessaire à l’envoi des données.