In Designer sono disponibili diverse funzioni e strategie per il debug dei calcoli e degli script, in base al linguaggio di script scelto.
Per eseguire il debug degli script JavaScript, è possibile utilizzare i metodi alert o messageBox per ottenere il relativo feedback. Uno svantaggio di questo metodo è che esso costringe l'utente a chiudere molte finestre di messaggio. Un altro problema sta nel fatto che la visualizzazione di una finestra di messaggio può determinare variazioni al comportamento del modulo, specialmente nel caso in cui si stia tentando di eseguire il debug di uno script che sta impostando lo stato attivo all'interno di un oggetto del modulo. È consigliabile utilizzare console.println per inviare il testo alla console JavaScript da Acrobat ed eseguire il debug del modulo.
Messaggi di avviso e di convalida della palette Rapporto di Designer
La palette Rapporto contiene messaggi di avviso e di convalida utili per l'esecuzione del debug di un modulo durante la sua progettazione. La scheda Avvisi consente di visualizzare errori o messaggi generati in Designer al momento della progettazione del modulo. La scheda Registro consente di visualizzare gli errori e i messaggi seguenti:
Messaggi di convalida
Errori di esecuzione script JavaScript o FormCalc
Errori di rendering del modulo in fase di progettazione, generati nel corso dell'importazione o del salvataggio del modulo o al momento della sua visualizzazione in anteprima dalla scheda Anteprima PDF.
Per ulteriori informazioni sull'uso della palette Rapporto, vedere Uso dell'area di lavoro per eseguire il debug dei calcoli e degli script.
Feedback di debug con il metodo messageBox
Il metodo messageBox per il modello oggetto di modulo XML consente di trasmettere informazioni da un modulo interattivo ad una finestra di dialogo in fase di esecuzione. È possibile sfruttare il metodo messageBox per il modello oggetto di modulo XML al fine di visualizzare messaggi o valori di campo in fase di esecuzione. Quando eseguito, il metodo messageBox visualizza un valore di stringa in una nuova finestra di dialogo dell'applicazione client. Il valore di stringa può essere un messaggio di testo creato per il debug o il valore di stringa di campi o espressioni.
Ad esempio, si consideri uno scenario con una struttura del modulo semplice che contiene un singolo campo numerico (NumericField1) e un pulsante (Button1). In questo caso, ciascuno dei seguenti calcoli FormCalc e script JavaScript genera un messaggio che mostra del testo e il valore attualmente visualizzato nel campo numerico. Aggiungendo il calcolo o lo script all'evento click dell'oggetto pulsante, è possibile visualizzare in modo interattivo il valore del campo numerico in una nuova finestra di dialogo facendo clic sul pulsante.
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: Il metodo messageBox restituisce un valore intero che rappresenta il pulsante selezionato dal compilatore nella finestra di dialogo del messaggio. Se si associa il metodo messageBox all'evento calculate di un oggetto campo e il metodo messagebox viene inserito in corrispondenza dell'ultima riga dello script, nel campo viene visualizzato il valore restituito dal metodo messageBox in fase di esecuzione.
Per ulteriori informazioni sull'utilizzo di messageBox, vedere messageBox
Trasmissione di informazioni a un campo di testo
È possibile trasmettere informazioni, quali valori di campo o messaggi, a un campo di testo della struttura del modulo. Ad esempio, l'utente può aggiungere nuovi messaggi o valori al valore di un campo di testo per creare un registro utile come riferimento futuro.
