Configurazione di Designer per lo scripting

Visualizzazione dell'Editor di script

 Selezionare Finestra > Editor di script.
Nota: È possibile utilizzare il pulsante Espandi per ancorare o disancorare rapidamente l'Editor di script quando viene visualizzato nell'area di lavoro di Designer.

Per passare dalla visualizzazione su un'unica riga a quella su più righe

 Trascinare la barra della palette Editor di script finché non assume la dimensione desiderata.
Nota: La visualizzazione su più righe aggiunge le opzioni Tutti gli eventi e Eventi con script all'elenco Mostra. L'opzione Tutti gli eventi consente di visualizzare tutti gli eventi per un particolare oggetto struttura del modulo, anche se gli eventi non contengono calcoli né script. L'opzione Eventi con script consente di visualizzare solo gli eventi di un oggetto specifico che contengono calcoli o script.

Impostazione del linguaggio di script predefinito per i nuovi moduli

  1. Selezionare Strumenti > Opzioni.

  2. Fare clic su Area di lavoro.

  3. Nell'elenco Linguaggio predefinito per nuovi moduli, selezionare il linguaggio di script predefinito da usare con i nuovi moduli.

Impostazione del linguaggio di script predefinito per il modulo corrente

  1. Selezionare File > Proprietà modulo.

  2. Fare clic sulla scheda Valori predefiniti.

  3. Nell'elenco Linguaggio predefinito, selezionare il linguaggio di script predefinito per il modulo correntemente visualizzato.

Impostazione del linguaggio di script predefinito per un modello di modulo

  1. Creazione di una nuova struttura del modulo.

  2. Selezionare File > Proprietà modulo.

  3. Fare clic sulla scheda Valori predefiniti.

  4. Selezionare il linguaggio di script predefinito dall'elenco Linguaggio predefinito.

  5. Eseguire una copia di backup del file del modello di modulo originale che si trova nella cartella Templates in cui è installato Designer.

  6. Salvare la nuova struttura del modulo come file TDS e sovrascrivere il modello di modulo corrispondente. Ad esempio, salvare il file come Letter.tds e sovrascrivere il file Letter.tds che si trova nella cartella Templates\Blank.

Per impostare l'applicazione di elaborazione predefinita

  1. Selezionare File > Proprietà modulo.

  2. Fare clic sulla scheda Valori predefiniti.

  3. Selezionare l'applicazione di elaborazione predefinita dall'elenco Esegui su.

    Nota: Questa procedura imposta soltanto il valore dell'applicazione di elaborazione predefinita per l'istanza corrente del modulo.

    Per evitare di modificare l'applicazione di elaborazione predefinita ogni volta che si crea un modulo, è necessario modificare il corrispondente file del modello di modulo utilizzato per creare nuove strutture del modulo.

Per modificare l'applicazione di elaborazione predefinita per un modello di modulo

  1. Creazione di una nuova struttura del modulo.

  2. Selezionare File > Proprietà modulo.

  3. Fare clic sulla scheda Valori predefiniti.

  4. Selezionare l'applicazione di elaborazione predefinita dall'elenco Esegui su.

  5. Eseguire una copia di backup del file del modello di modulo originale che si trova nella cartella Templates in cui è installato Designer.

  6. Salvare la nuova struttura del modulo come file TDS e sovrascrivere il modello di modulo corrispondente. Ad esempio, salvare il file come Letter.tds e sovrascrivere il file Letter.tds che si trova nella cartella Templates\Blank.

Per visualizzare i caratteri arabi, ebraici, tailandesi e vietnamiti

Per visualizzare i caratteri arabi, ebraici, thai e vietnamiti nell'Editor di script o nella scheda Sorgente XML, è necessario modificare le impostazioni dei font utilizzati da Designer in queste schede. In caso contrario, in Designer verranno visualizzati rettangoli al posto dei caratteri specifici di ciascuna lingua.

  1. Selezionare Strumenti > Opzioni, quindi selezionare Area di lavoro dall'elenco a sinistra.

  2. Selezionare una delle opzioni seguenti:

    • Formattazione sintassi FormCalc per impostare il font nell'Editor di script quando si utilizza FormCalc

    • Formattazione sintassi JavaScript per impostare il font nell'Editor di script quando si utilizza JavaScript

    • Formattazione sintassi sorgente XML per impostare il font nella scheda Sorgente XML

  3. Nella casella di riepilogo Font, selezionare un font che supporti la lingua desiderata. Ad esempio, Adobe Arabic supporta l'arabo, Adobe Hebrew supporta l'ebraico, Adobe Thai supporta il thai e Myriad® Pro e Minion® Pro supportano il vietnamita. Qualora non si disponga nel sistema in uso del font desiderato per la lingua utilizzata, è possibile eseguire ricerche in Internet.

  4. Al termine, fare clic su OK.

  5. Fare clic su OK per chiudere la finestra di dialogo Opzioni.

Uso dell'area di lavoro per eseguire il debug dei calcoli e degli script

L'area di lavoro di Designer fornisce diversi modi per assistere l'utente nel debugging dei calcoli e degli script.

Nella tabella seguente sono riportati posizione e scopo di alcune utili informazioni di debugging che si trovano in varie palette e schede di Designer.

Posizione Area di lavoro

Scopo

Scheda Avvisi nella palette Rapporto

Visualizza i messaggi relativi alla destinazione e agli indicatori di avviso, nonché tutti gli errori di sintassi di script JavaScript o FormCalc, al momento della selezione del comando Controlla sintassi script. Per ulteriori informazioni, vedere Per controllare la sintassi di script.

Quando si fa doppio clic su un messaggio di avviso relativo alla sintassi nella scheda Avvisi, lo script che contiene l'errore viene caricato nell'Editor di script e la riga interessata dall'errore viene evidenziata.

È anche possibile fare doppio clic su un messaggio di avviso per selezionare l'oggetto correlato nella scheda Visualizzazione struttura e nella palette Gerarchia e premere F1 per visualizzare informazioni relative alla correzione degli avvisi.

Per verificare la presenza di errori in fase di esecuzione in JavaScript, è possibile attivare la console di JavaScript. Per ulteriori informazioni, vedere Debug in JavaScript.

Scheda Binding nella palette Rapporto

Se nella struttura del modulo si includono dei campi che sono associati a un'origine dati, la scheda Binding può essere di aiuto in quanto visualizza l'elenco dei campi in base a come sono stati definiti i binding dei campi stessi. Ad esempio, è possibile elencare solo i campi con binding dati globale o solo quelli per cui non è stato definito alcun binding dei dati. Questa funzionalità risulta particolarmente utile in moduli con un numero elevato di campi dati associati.

Scheda Registro nella palette Rapporto

Visualizza i messaggi di convalida, gli errori di esecuzione degli script JavaScript o FormCalc e gli errori di rendering dei moduli generati da Designer al momento dell'importazione o del salvataggio di un modulo oppure al momento della visualizzazione in anteprima di un modulo mediante la scheda Anteprima PDF.

Gerarchia, palette

La palette Gerarchia può essere utilizzata per determinare la posizione di un oggetto modulo per una sintassi di riferimento, La palette Gerarchia è una rappresentazione grafica della struttura di un modulo e consente di visualizzare i contenuti delle schede Pagine master e visualizzazione Struttura.

La palette Gerarchia visualizza inoltre gli oggetti a cui si fa riferimento nel nodo Oggetti a cui si fa riferimento. Un oggetto a cui si fa riferimento è un oggetto che viene aggiunto a un modulo solo quando richiesto. Quando si lavora con flussi di dati che ricoprono più pagine o aree di contenuto, l'overflow iniziale e i sottomoduli iniziali e finali vengono inseriti nel modulo nelle apposite posizioni.

Scheda Binding nella palette Oggetto

Ogni oggetto di Designer che può essere associato a un'origine dati ha una scheda Binding nella palette Oggetto. Se si associa un oggetto nella struttura del modulo a un particolare nodo di dati dalla propria connessione dati, l'elenco Binding dei dati (Apri, Salva, Invia) visualizza una sintassi di riferimento FormCalc valida per l'accesso al nodo di dati suddetto. È possibile utilizzare la sintassi di riferimento FormCalc in altri calcoli o script per eseguire prove.

Sorgente XML, scheda

La scheda Sorgente XML contiene il codice XML della struttura del modulo. Il codice XML di origine definisce tutti gli aspetti del modulo. La scheda Sorgente XML può essere utilizzata per visualizzare la struttura del modello di oggetto modulo XML di una struttura del modulo e per comprendere i rapporti tra gli oggetti e le proprietà. Nel codice XML di origine i nomi degli elementi XML sono equivalenti ai nomi degli oggetti nel modello di oggetto modulo XML e gli attributi sono equivalenti alle proprietà.

Quando si seleziona un oggetto nella palette gerarchia e si fa clic sulla scheda Sorgente XML, viene evidenziata la prima riga dell'elemento corrispondente. Il nome dell'oggetto in Designer, come elencato nella palette Gerarchia, diventa il valore dell'attributo nome nell'origine XML.

Nella finestra di dialogo Strumenti > Opzioni è possibile impostare le opzioni per visualizzare l'origine nella scheda Sorgente XML, ad esempio per nascondere o visualizzare i numeri di riga e impostare la colorazione della sintassi.

è preferibile non modificare direttamente il codice XML di origine.

Potrebbe inoltre essere utile modificare le opzioni predefinite dell'Editor di script in modo da facilitare il debug dei calcoli e degli script. Queste opzioni sono disponibili dal pannello Area di lavoro della finestra di dialogo Opzioni, che può essere visualizzata selezionando Strumenti > Opzioni, quindi Area di lavoro dall'elenco a sinistra. Ad esempio, è possibile scegliere di visualizzare i numeri di riga nell'Editor di script o modificare la formattazione della sintassi di FormCalc o di JavaScript.