Depuración de cálculos y secuencias de comandos

Designer incluye diversas funciones y estrategias que permiten depurar cálculos y secuencias de comandos, según el lenguaje de secuencias de comandos que se elija.

Para la depuración de las secuencias de comandos del lenguaje JavaScript, se pueden utilizar los métodos alert o messageBox para proporcionar información de depuración. Una desventaja de este método es que debe cerrar varios cuadros de mensajes. Otro problema es que al mostrar un cuadro de mensaje, el formulario puede comportarse de manera diferente, especialmente si intenta depurar una secuencia de comandos enfocada a un objeto del formulario. Para depurar un formulario, es conveniente usar console.println para incluir texto en la consola de JavaScript desde Acrobat.

Mensajes de advertencia y validación de la paleta Informe de Designer

La paleta Informe proporciona mensajes de advertencia y validación para ayudarle a depurar un formulario a medida que lo diseña. La ficha Advertencia le permite ver los errores o mensajes que genera Designer cuando se diseña un formulario. La ficha Registro le permite ver los siguientes errores y mensajes:

  • Mensajes de validación

  • Errores de ejecución de secuencias de comandos JavaScript o FormCalc

  • Errores de procesamiento de formulario durante la fase de diseño generados al importar o guardar un formulario o al previsualizarlo usando la ficha Vista previa de PDF.

Para obtener más información acerca del uso de la paleta Informe, consulte Uso del espacio de trabajo para depurar cálculos y secuencias de comandos.

Información de depuración mediante el método messageBox

El método messageBox del Modelo de objetos de formulario XML permite incluir información de un formulario interactivo en un cuadro de diálogo durante la ejecución. El método messageBox del Modelo de objetos de formulario XML se puede usar para que se muestren mensajes o valores de campo durante la ejecución. Cuando se inicia, el método messageBox muestra un valor de cadena en un cuadro de diálogo nuevo de la aplicación cliente. El valor de cadena puede ser un mensaje de texto que se cree con fines de depuración o el valor de cadena de campos o expresiones.

Por ejemplo, imaginemos una situación en la que se cuenta con un diseño de formulario sencillo que incluye un único campo numérico (NumericField1) y un botón (Button1). En esa situación, el cálculo de FormCalc y la secuencia de comandos de JavaScript siguientes muestran un mensaje que incluye texto y el valor que incluye en cada momento el campo de texto. Si se agrega el cálculo o la secuencia de comandos al suceso click del objeto de botón, se puede mostrar de forma interactiva el valor del campo numérico en un cuadro de diálogo nuevo haciendo clic en el botón.

FormCalc

    xfa.host.messageBox(Concat("The value of NumericField1 is: ", 
        NumericField1), "Debugging", 3)

JavaScript

    xfa.host.messageBox("The value of NumericField1 is: " + 
        NumericField1.rawValue, "Debugging", 3);
Importante: el método messageBox devuelve un valor entero que representa el botón que selecciona el usuario que rellena el informe en el cuadro de diálogo del mensaje. Si se adjunta el método messageBox al suceso calculate de un objeto de campo, y el método messagebox constituye la última línea de la secuencia de comandos, el campo muestra el valor devuelto del método messageBox durante la ejecución.

Para obtener más información acerca del uso de messageBox, consulte messageBox

Incluir información en un campo de texto

Puede incluir información, como valores de campo o mensajes, en un campo de texto del diseño del formulario. Por ejemplo, puede anexar nuevos mensajes o valores a un valor del campo de texto para crear un registro con el fin de consultarlo en el futuro.