preSubmit, suceso

Descripción

Se inicia cuando se envían datos al host desde un formulario a través del protocolo HTTP. En ese momento, los datos se han organizado en un conjunto de datos, pero no se han enviado al host todavía. Mediante los cálculos y las secuencias de comandos que estén asociados al suceso, se pueden examinar y cambiar los datos antes de que se envíe el formulario. Si el cálculo o la secuencia de comandos están definidos para ejecutarse en el servidor, se envían los datos del formulario al servidor indicando que se debe ejecutar la secuencia de comandos o el cálculo antes de realizar cualquier otro proceso adicional.

Nota: en este suceso no se distinguen los envíos que se inician mediante instancias de clic de botón ni que están destinados a distintas URL. Cualquier secuencia de comandos que tenga que hacer esas distinciones debe incluir código que determine el botón que se ha pulsado. En general, el suceso preSubmit es conceptualmente equivalente al suceso preSave y obedece a fines similares.

Tipo

Suceso de aplicación

Compatibilidad

Aplicación cliente

Disponibilidad

Acrobat y Adobe Reader

yes

Explorador HTML

yes

(Sólo para botones de envío)

Versión

XFA 2,1

Ejemplo

Se puede utilizar este suceso para cambiar los datos del formulario inmediatamente antes de que se envíe. Por ejemplo, se puede crear una secuencia de comandos en el suceso preSubmit para analizar la cantidad de datos y mostrar un mensaje al usuario con una estimación del tiempo que llevará completar el envío.