Designer permite crear secuencias de comandos sobre determinados objetos JavaScript de Acrobat utilizando la sintaxis de secuencias de comandos de Acrobat. Como resultado, se pueden utilizar las propiedades y los métodos de esos objetos en los formularios. Por ejemplo, para mostrar un mensaje en la consola de JavaScript de Acrobat, se puede agregar la secuencia de comandos siguiente al suceso de un objeto de diseño de formulario en Designer:
console.println("Este mensaje aparece en la consola de JavaScript.");
También se puede hacer que se envíe el formulario por correo electrónico agregando la siguiente secuencia de comandos al suceso click de un botón:
var myDoc = event.target;
myDoc.mailDoc(true);
Nota: en Designer, debe asegurarse de que el lenguaje de secuencias de comandos para el suceso está definido como JavaScript para que la secuencia de comandos se ejecute correctamente en tiempo de ejecución.
Se pueden utilizar referencias a los objetos JavaScript de Acrobat en la sintaxis de referencia. Por ejemplo, la siguiente secuencia de comandos obtiene el estado firmado de un campo de firma y aplica una acción según el estado:
// Proceed if the current field is not signed.
var oState =
event.target.getField("form1[0].#subform[0].SignatureField1[0]")
.signatureValidate(); //Get the field's signed state.
if (oState == 0) {
...
}
Nota: en este ejemplo se utiliza sintaxis de referencia completa para hacer referencia al texto. Para obtener más información sobre las referencias a objetos de diseño de formularios, consulte
Referencia a propiedades y valores de objetos.
Cuando se utiliza JavaScript de Acrobat en Designer, se debe recordar lo siguiente:
En Designer, se debe utilizar event.target para acceder al objeto JavaScript Doc de Acrobat. En Acrobat, el objeto this se utiliza para hacer referencia al objeto Doc; sin embargo, en Designer, el objeto this hace referencia al objeto de diseño de formulario al que está adjunta la secuencia de comandos.
El Editor de secuencias de comandos no cuenta con una función de conclusión de instrucciones para los objetos JavaScript de Acrobat. Consulte JavaScript for Acrobat API Reference.
El método Doc event.target.importTextData("file.txt") no es compatible con formularios XFA dinámicos con certificado.
Para obtener más información acerca de la conversión de secuencias de comandos de Acrobat a Designer, consulte el artículo Converting Acrobat JavaScript for Use in Designer Forms (solo en inglés) en Developer Center.
