Progettazione di moduli per Forms

Se si intende utilizzare la stessa struttura del modulo per il rendering di moduli PDF e HTML, è importante comprendere che tra questi due tipi di output esistono alcune differenze di funzionamento.

Per creare una sola struttura del modulo in grado di limitare tali differenze di funzionamento, attenersi alle linee guida seguenti:

Consultare le Informazioni di riferimento per le trasformazioni

Poiché i moduli PDF possono essere visualizzati utilizzando Acrobat o Adobe Reader, il modulo in formato PDF supporta l'intera gamma di proprietà degli oggetti definita nella struttura del modulo. Se si distribuiscono moduli HTML basati sulla stessa struttura del modulo, alcune applicazioni client (ad esempio i browser Web) non forniscono lo stesso livello di supporto per le singole proprietà degli oggetti. Consultando le Informazioni di riferimento per le trasformazioni, è possibile determinare il funzionamento degli oggetti in una determinata applicazione client. Quando si crea la struttura del modulo, provare ad aggirare le limitazioni delle applicazioni client trovando un modo per implementare il modulo senza utilizzare le proprietà non supportate degli oggetti. Vedere Trasformazioni dei moduli.

Abilitare il caching dei moduli

Il caching dei moduli può migliorare le prestazioni dei moduli durante il rendering. Inoltre, quando si progetta un modulo con layout fisso di cui si desidera effettuare il rendering in formato HTML, è necessario abilitare il caching del modulo. Vedere Caching dei moduli.

Includere un layout che funzioni sia con i moduli PDF che con i moduli HTML

Durante il rendering di un modulo HTML le dimensioni di pagina (necessarie per l'impaginazione dei moduli PDF) non vengono prese in considerazione. Poiché un modulo con un layout fluido può essere visualizzato come una pagina HTML di lunghezza infinita, è importante evitare di inserire note a piè pagina nella pagina master. Una nota a piè pagina sotto l'area del contenuto di una pagina master potrebbe infatti sovrascrivere il contenuto HTML che viene a trovarsi oltre a quello che dovrebbe essere il limite inferiore della pagina (nel modulo PDF).

Specificare nomi univoci per campi, gruppi di esclusione e sottomoduli

Per l'output in formato HTML, tutti i campi, i gruppi di esclusione e i sottomoduli devono avere nomi univoci, per evitare problemi durante l'unione dei dati.

Accessibilità

Leggere la sezione sulla creazione dei moduli ad accesso facilitato e attenersi alle linee guida per abilitare l'accesso facilitato alla struttura del modulo. Vedere Informazioni sui moduli con accesso facilitato.

Definire le posizioni di esecuzione degli script all'interno della struttura del modulo

Per impostazione predefinita, gli script sono eseguiti sul client. Se è necessario eseguire gli script inclusi in un modulo sul server o sul client e sul server, è possibile che si debba modificare o ignorare le impostazioni predefinite. Vedere Considerazioni sulla creazione di moduli per l'elaborazione server.

Visualizzare l'anteprima del modulo

Visualizzare periodicamente un'anteprima del modulo utilizzando Designer (per i moduli PDF) o l'applicazione client di destinazione (per i moduli HTML) per risolvere i problemi nella fase iniziale del processo di progettazione. Vedere Visualizzazione in anteprima dei moduli e verifica del funzionamento nella scheda Anteprima PDF.

Verificare la struttura del modulo utilizzando dei dati di esempio

Se Forms dovrà unire moduli e dati, utilizzare dati di prova per testare accuratamente le strutture del modulo prima di rendere disponibili le versioni definitive in Forms. Vedere Visualizzazione in anteprima di un modulo con dati di esempio.

Limiti dei browser Web

Alcuni browser Web hanno funzioni limitate. È una buona idea considerare tali limiti e progettare i moduli in base alle funzioni minime supportate dai browser. Vedere Come aggirare i limiti dei browser Web.

Prima di inviare le strutture dei moduli a Forms , è necessario completare alcune operazioni aggiuntive:

• Lo sviluppatore dell'applicazione personalizzata deve definire i requisiti dell'applicazione. Il formato di file della struttura del modulo (XDP o PDF) dipende da tali requisiti.

• Le opzioni di trasformazione devono essere definite nell'API di Forms per supportare le trasformazioni necessarie. Lo sviluppatore dell'applicazione personalizzata deve impostare le opzioni in base alle informazioni fornite dal cliente.

• Se si utilizza un oggetto firma in una struttura del modulo PDF, lo sviluppatore dell'applicazione personalizzata deve integrare una soluzione di terze parti per il supporto delle firme digitali.

Durante la creazione di un modulo, è possibile specificare il formato di invio dei dati. È possibile specificare il formato di invio dei dati in Designer in uno dei due modi seguenti:

• Posizionando un oggetto pulsante sul modulo, specificandolo come pulsante di invio e scegliendo il formato di invio dei dati.

• Posizionando un pulsante Invia per HTTP oppure un pulsante Invia per e-mail sul modulo.

Dopo avere aggiunto l'oggetto Pulsante alla struttura del modulo, è possibile specificare un formato per l'invio dei dati sulla scheda Invia della palette Oggetto. I pulsanti Invia per HTTP e i pulsanti Invia per e-mail sono preconfigurati per l'utilizzo di formati di invio specifici. Per ulteriori informazioni sui formati di invio dei dati, vedere Invio di dati con un pulsante

Designer supporta quattro formati di invio dei dati:

• XML Data Package (XDP): questo è il solo formato che supporta l'aggiunta di allegati.

• PDF

• Dati XML (XML)

• Dati URL-encoded (HTTP Post)

Il formato dati URL-Encoded (HTTP Post) è l'unico formato disponibile per l'invio dei dati per i moduli HTML.

Forms esegue il rendering dei moduli in vari formati tramite le trasformazioni, che adattano i moduli alle capacità delle applicazioni client, come Acrobat, Adobe Reader, numerosi browser Web o un assistente vocale.

Forms supporta qualsiasi client HTML conforme alle specifiche CSS 2. Poiché il supporto di CSS2 varia notevolmente a seconda del browser e i browser di vecchia generazione non forniscono supporto, molti browser e agenti utente generici richiedono specifiche trasformazioni personalizzate.

Per un elenco completo delle proprietà e degli oggetti supportati per ogni tipo di trasformazione, vedere le Informazioni di riferimento per le trasformazioni.

Per fornire le strutture dei moduli a Forms, è necessario avere accesso in scrittura al percorso in cui Forms recupera i file in fase di esecuzione. Lo sviluppatore dell'applicazione personalizzata deve conoscere il percorso e l'amministratore di rete può impostare le autorizzazioni necessarie.

Le strutture dei moduli completate vengono archiviate nel file system locale, affinché lo sviluppatore dell'applicazione personalizzata possa accedervi. È necessario includere qualsiasi altro file necessario per supportare la struttura del modulo (ad esempio le immagini).

Se si utilizza la versione autonoma di Designer, è possibile pubblicare le strutture dei moduli nella posizione specificata. Una volta configurati i diritti di accesso dell'utente, utilizzare il comando di pubblicazione di Designer (selezionare File > Pubblica nell'archivio). Vedere Pubblicazione di moduli.

Forms accetta strutture del modulo nei seguenti formati:

• XDP

• PDF

XDP è il formato di file creato da Designer. Selezionare questo formato per inviare la struttura del modulo, i dati del modulo, le note, i tag di accesso facilitato e tutte le altre informazioni necessarie a Forms per effettuare il rendering del modulo in fase di esecuzione. Scegliere questo formato se il modulo avvia un'elaborazione sul lato server.

Effettuare il salvataggio in formato PDF se si intende aprire sempre il modulo in Acrobat o Adobe Reader.

Scegliere il formato PDF se il modulo contiene un campo firma o se gli utenti dovranno salvare dati direttamente nel modulo PDF in fase di esecuzione. Se il modulo di cui si effettua il rendering ha un layout fisso e si prevede che verrà richiesto di frequente, fornendo la struttura del modulo a Forms in formato PDF è possibile migliorare le prestazioni di in fase di esecuzione.

Non scegliere il formato PDF nei casi seguenti:

• Se il modulo avvia un'elaborazione sul lato server.

• Se si utilizza Forms per il rendering dei moduli HTML o di moduli con layout flessibile.