Genera documento di record per i moduli adattivi

Panoramica

Dopo l'invio di un modulo, i clienti in genere desiderano conservare un record, in formato cartaceo o in formato documento, delle informazioni che hanno compilato nel modulo per il riferimento futuro. Tale documento è denominato documento di registrazione.

Questo articolo spiega come generare un documento di record per i moduli adattivi.

NOTA

La generazione automatica del documento di record non è supportata per i moduli adattivi basati su XFA. Tuttavia, è possibile utilizzare XDP utilizzato per creare il modulo adattivo come documento di record.

Tipi di moduli adattivi e relativi documenti di registrazione

Quando si crea un modulo adattivo, è possibile selezionare un modello di modulo. Le opzioni disponibili sono:

  • Modelli di moduloConsente di selezionare un modello XFA per il modulo adattivo.
    Quando selezioni un modello XFA, puoi utilizzare il file XDP associato per il documento di record come descritto sopra.

  • XML
    SchemaConsente di selezionare una definizione di schema XML per il modulo adattivo. Quando si seleziona uno schema XML per il modulo adattivo, è possibile:

    • Associa un modello XFA per il documento del record. Assicurati che il modello XFA associato utilizzi lo stesso schema XML del modulo adattivo
    • Genera automaticamente il documento di registrazione
  • Nessuno
    Consente di creare un modulo adattivo senza un modello di modulo. Il documento di record viene generato automaticamente per il modulo adattivo.

Quando si seleziona un modello di modulo, configurare il documento di record utilizzando le opzioni disponibili in Configurazione modello documento di record. Vedere Configurazione del modello del documento.

Documento generato automaticamente

Un documento di registrazione consente ai clienti di conservare una copia del modulo inviato a scopo di stampa. Quando si genera automaticamente un documento di record, ogni volta che si modifica il modulo, il relativo documento di record viene aggiornato immediatamente. Ad esempio, è possibile rimuovere il campo di età per i clienti che selezionano Stati Uniti d’America come proprio paese. Quando tali clienti generano un documento di record, il campo età non è visibile nel documento di record.

Il documento generato automaticamente presenta i seguenti vantaggi:

  • Si occupa del binding dei dati.
  • Nasconde automaticamente i campi contrassegnati come esclusi dal documento al momento dell'invio. Non è necessario uno sforzo supplementare.
  • Consente di risparmiare tempo per la progettazione di documenti di modelli di record.
  • Consente di provare stili e aspetto diversi utilizzando diversi modelli di base e scegliere lo stile e l'aspetto migliori per il documento di record. Gli stili sono facoltativi e, se non si specifica lo stile, gli stili di sistema sono impostati come predefiniti.
  • In questo modo qualsiasi modifica del modulo viene immediatamente riflessa nel documento di registrazione.

Componenti per generare automaticamente un documento di registrazione

Per generare un documento di record per i moduli adattivi, sono necessari i seguenti componenti:

Modulo adattivo per il quale si desidera generare un documento di record.

Modello di base (consigliato) Modello XFA (file XDP) creato in AEM Designer. Il modello di base viene utilizzato per specificare le informazioni relative allo stile e al branding per il modello di documento.

Vedere Modello di base di un documento di record

NOTA

Il modello di base di un documento di record è anche chiamato meta-template di un documento di record.

Documento del modello di record XFA (file XDP) generato da un modulo adattivo.

Vedere Configurazione del modello del documento.

Dati modulo Informazioni compilate da un utente nel modulo adattivo. Si unisce al documento del modello di record per generare il documento di record.

Mappatura degli elementi dei moduli adattivi

Nelle sezioni seguenti viene descritto come gli elementi modulo adattivi vengono visualizzati nel documento di registrazione.

espandibili

Componente per moduli adattivi Componente XFA corrispondente Incluso per impostazione predefinita nel documento Modello record? Note
Pulsante Pulsante false
Casella di selezione Casella di controllo vero
Selettore data Campo data/ora vero
Elenco a discesa Elenco a discesa vero
Firma a mano Firma vero
Casella numerica Campo numerico vero
Casella password Campo password false
Pulsante di scelta Pulsante di scelta vero
Casella di testo Campo testo vero
Pulsante Ripristina Pulsante Ripristina false
Pulsante Invia

Pulsante Invia per e-mail

Pulsante Invia per HTTP

false
Termini e condizioni vero
Allegato file false Non disponibile nel modello di documento. Disponibile solo nel documento di registrazione attraverso gli allegati.

Contenitori

Componente per moduli adattivi Componente XFA corrispondente Note
Pannello
Sottomodulo
Il pannello ripetibile è associato a un sottomodulo ripetibile.

Componenti statici

Componente per moduli adattivi Componente XFA corrispondente Note
Immagine Immagine I componenti TestoDisegno e Immagine, associati o non associati, vengono sempre visualizzati nel documento di record di un modulo adattivo basato su XSD, a meno che non vengano esclusi utilizzando le impostazioni del documento di record.
Testo Testo
NOTA

Nell’interfaccia classica, sono disponibili diverse schede per la modifica delle proprietà dei campi.

Tabelle

I componenti della tabella dei moduli adattivi, come intestazione, piè di pagina e mappa di riga, vengono associati ai componenti XFA corrispondenti. È possibile mappare pannelli ripetibili su tabelle nel documento di registrazione.

Modello di base di un documento di registrazione

Il modello di base fornisce informazioni sullo stile e l'aspetto del documento di record. Consente di personalizzare l'aspetto predefinito del documento di record generato automaticamente. Ad esempio, aggiungere il logo della società nell’intestazione e le informazioni sul copyright nel piè di pagina del documento di registrazione. La pagina master del modello di base viene utilizzata come pagina master per il modello di documento. La pagina master può contenere informazioni quali intestazione di pagina, piè di pagina e numero di pagina che è possibile applicare al documento di record. È possibile applicare tali informazioni al documento di registrazione utilizzando il modello di base per la generazione automatica del documento di record. L’utilizzo del modello base consente di modificare le proprietà predefinite dei campi.

Seguire le convenzioni di base del modello quando si progetta il modello di base.

Convenzioni dei modelli di base

Un modello di base viene utilizzato per definire intestazione, piè di pagina, stile e aspetto di un documento di record. L’intestazione e il piè di pagina possono includere informazioni quali il logo dell’azienda e il testo del copyright. La prima pagina master del modello base viene copiata e utilizzata come pagina master per il documento del record, che contiene intestazione, piè di pagina, numero di pagina o qualsiasi altra informazione che deve essere visualizzata in tutte le pagine del documento del record. Se si utilizza un modello di base non conforme alle convenzioni del modello di base, la prima pagina master del modello di base viene ancora utilizzata nel modello di documento. Si consiglia vivamente di progettare il modello di base in base alle sue convenzioni e di utilizzarlo per la generazione automatica del documento di registrazione.

Convenzioni delle pagine master

  • Nel modello di base, denominare il sottomodulo principale come AF_METATEMPLATE e la pagina master come AF_MASTERPAGE.

  • Alla pagina master con il nome AF_MASTERPAGE situato sotto il sottomodulo principale AF_METATEMPLATE viene data la preferenza per l’estrazione di informazioni relative a intestazione, piè di pagina e stile.

  • Se AF_MASTERPAGE è assente, viene utilizzata la prima pagina master presente nel modello base.

Convenzioni di stile per i campi

  • Per applicare uno stile ai campi del documento record, il modello base fornisce i campi situati nel sottomodulo AF_FIELDSSUBFORM sotto il sottomodulo principale AF_METATEMPLATE.

  • Le proprietà di questi campi vengono applicate ai campi del documento di registrazione. Questi campi devono seguire la convenzione di denominazione AF_<name of field in all caps>_XFO . Ad esempio, il nome del campo della casella di controllo deve essere AF_CHECKBOX_XFO.

Per creare un modello di base, eseguire le operazioni seguenti in AEM Designer.

  1. Fare clic su File > Nuovo.

  2. Selezionare l'opzione Basato su un modello.

  3. Selezionare la categoria Forms - Documento di record.

  4. Selezionare Modello di base DoR.

  5. Fare clic su Avanti e fornire le informazioni richieste.

  6. (Facoltativo) Modificare lo stile e l’aspetto dei campi che si desidera applicare ai campi del documento di record.

  7. Salvare il modulo.

È ora possibile utilizzare il modulo salvato come modello base per il documento di record.
Non modificare o rimuovere gli script presenti nel modello di base.

Modifica del modello di base

  • Se non si applica alcuno stile sui campi nel modello di base, è consigliabile rimuovere tali campi dal modello di base in modo che tutti gli aggiornamenti al modello di base vengano prelevati automaticamente.
  • Durante la modifica del modello di base, non rimuovere, aggiungere o modificare script.
NOTA

Progettare un modello di base utilizzando le convenzioni e seguendo rigorosamente i passaggi descritti in precedenza.

Configurazione modello del documento record

Configurare il modello di documento del modulo per consentire ai clienti di scaricare una copia del modulo inviato in formato cartaceo. Un file XDP funge da documento del modello di record. Il documento scaricato dai clienti del record viene formattato in base al layout specificato nel file XDP.

Per configurare un documento di record per i moduli adattivi, effettua le seguenti operazioni:

  1. Nell'istanza AEM autore, fai clic su Forms > Forms e Documenti.

  2. Selezionare un modulo e fare clic su Visualizza proprietà.

  3. Nella finestra Proprietà, tocca Modello modulo.
    È inoltre possibile selezionare un modello di modulo quando si crea un modulo.

    NOTA

    Nella scheda Modello modulo, assicurarsi di selezionare Schema o Nessuno dal menu a discesa Seleziona da. Il documento di record non è supportato per i moduli basati su XFA o adattivi con Modello di modulo come modello di modulo.

  4. Nella sezione Configurazione modello documento della scheda Modello modulo selezionare una delle opzioni seguenti.

    ​NessunoSelezionare questa opzione se non si desidera configurare il documento di record per il modulo.

    Associa modello di modulo come modello di recordSelezionare questa opzione se si dispone di un file XDP che si desidera utilizzare come modello per il documento di record. Selezionando questa opzione, vengono visualizzati tutti i file XDP disponibili nell’archivio AEM Forms. Selezionare il file appropriato.

    Il file XDP selezionato viene associato al modulo adattivo.

    Genera documento di recordSelezionare questa opzione per utilizzare un file XDP come modello di base per definire lo stile e l'aspetto del documento di record. Selezionando questa opzione, vengono visualizzati tutti i file XDP disponibili nell’archivio AEM Forms. Selezionare il file appropriato.

    NOTA

    Verificare che lo schema utilizzato per creare il modulo adattivo e lo schema (schema dati) del modulo XFA sia lo stesso se:

    • Il modulo adattivo è basato su schema
    • Si sta utilizzando l'opzione Associa modello di modulo come modello di documento per il documento di record
  5. Fare clic su Fine.

Personalizzare le informazioni sul marchio nel documento di registrazione

Durante la generazione di un documento di record, è possibile modificare le informazioni di branding per il documento di record nella scheda Documento di record. La scheda Documento di record include opzioni quali logo, aspetto, layout, intestazione e piè di pagina, liberatoria e se si desidera includere o meno le opzioni della casella di controllo e dei pulsanti di scelta non selezionati.

Per localizzare le informazioni di branding immesse nella scheda Documento di record, è necessario assicurarsi che le impostazioni internazionali del browser siano impostate in modo appropriato. Per personalizzare le informazioni di branding del documento di registrazione, completa i seguenti passaggi:

  1. Seleziona un pannello (pannello principale) nel documento di record, quindi tocca configura.

  2. Tocca dortab. Viene visualizzata la scheda Documento di record.

  3. Selezionare il modello predefinito o un modello personalizzato per il rendering del documento di record. Se si seleziona il modello predefinito, sotto il menu a discesa Modello viene visualizzata una miniatura del documento di record.

    modello di branding

    Se scegli di selezionare un modello personalizzato, sfoglia e seleziona un XDP sul server AEM Forms. Se desideri utilizzare un modello che non è già sul server AEM Forms, devi prima caricare XDP sul server AEM Forms.

  4. A seconda che si selezioni un modello predefinito o personalizzato, nella scheda Documento di record vengono visualizzate alcune o tutte le proprietà seguenti. Specifica in modo appropriato:

    • Immagine logo: Puoi scegliere di utilizzare l’immagine logo nel modulo adattivo, sceglierne uno da DAM o caricarne uno dal computer.
    • Titolo modulo
    • Testo intestazione
    • Etichetta di dichiarazione di non responsabilità
    • Liberatoria
    • Testo della liberatoria
    • Colore accento: Colore in cui viene eseguito il rendering del testo dell'intestazione e delle linee di separazione nel documento o nel record PDF
    • Famiglia font: Famiglia di font del testo nel documento PDF del record
    • Per i componenti Casella di controllo e Pulsante di scelta, mostrare solo i valori selezionati
    • Separatore per più valori selezionati
    • Includi oggetti modulo non associati a modelli dati
    • Escludere i campi nascosti dal documento del record
    • Nascondi descrizione pannelli

    Se il modello XDP personalizzato selezionato include più pagine master, le proprietà di tali pagine vengono visualizzate nella sezione content della scheda Document of Record .

    Proprietà pagina master

    Le proprietà della pagina master includono Immagine logo, Testo intestazione, Titolo modulo, Etichetta liberatoria e Testo liberatoria. È possibile applicare le proprietà del modello XDP o del modulo adattivo al documento di record. Per impostazione predefinita, AEM Forms applica le proprietà del modello al documento di record. È inoltre possibile definire valori personalizzati per le proprietà della pagina master. Per informazioni su come applicare più pagine master in un documento di record, vedere Applicare più pagine master a un documento di record.

    NOTA

    Se si utilizza un modello di modulo adattivo creato con una versione di Designer precedente alla versione 6.3, affinché le proprietà Colore accento e Famiglia font funzionino, assicurarsi che quanto segue sia presente nel modello di modulo adattivo sotto il sottomodulo principale:

    <proto>
    <font typeface="Arial"/>
    <fill>
    <color value="4,166,203"/>
    </fill>
    <edge>
    <color value="4,166,203"/>
    </edge>
    </proto>
    
  5. Per salvare le modifiche di branding, tocca Fine.

Layout di tabelle e colonne per pannelli nel documento di registrazione

Il modulo adattivo può essere lungo e contenere diversi campi del modulo. Potrebbe non essere necessario salvare un documento di record come copia esatta del modulo adattivo. Ora è possibile scegliere il layout di una tabella o di una colonna per salvare uno o più pannelli di moduli adattivi nel documento PDF del record.

Prima di generare un documento di record, nelle impostazioni di un pannello selezionare Layout per il documento di record per tale pannello come Tabella o Colonna. I campi nel pannello vengono organizzati di conseguenza nel documento di registrazione.

Campi di un pannello di cui è stato eseguito il rendering in un layout di tabella nel documento del record

Campi di un pannello di cui è stato eseguito il rendering in un layout di tabella nel documento del record

Rendering dei campi in un pannello con layout a colonne nel documento del record

Rendering dei campi in un pannello con layout a colonne nel documento del record

Impostazioni del documento di registrazione

Le impostazioni del documento di record consentono di scegliere le opzioni che si desidera includere nel documento di record. Ad esempio, una banca accetta un modulo nome, età, numero di previdenza sociale e numero di telefono. Il modulo genera un numero di conto bancario e i dettagli della filiale. È possibile scegliere di visualizzare solo il nome, il numero di previdenza sociale, il conto bancario e i dettagli del ramo nel documento di registrazione.

Il documento delle impostazioni di record di un componente è disponibile sotto le relative proprietà. Per accedere alle proprietà di un componente, selezionalo e fai clic su cmppr nella sovrapposizione. Le proprietà sono elencate nella barra laterale ed è possibile trovare le seguenti impostazioni.

Impostazioni a livello di campo

  • Escludi Dal Documento Di Registrazione: L'impostazione della proprietà su true esclude il campo dal documento del record. Si tratta di una proprietà modificabile in script denominata excludeFromDoR. Il suo comportamento dipende dalla proprietà Escludi campi da DoR se nascosta a livello di modulo.

  • Visualizza il pannello come tabella: l’impostazione della proprietà mostra il pannello come tabella nel documento di registrazione se il pannello contiene meno di 6 campi. Applicabile solo al pannello.

  • Escludi titolo dal documento di record: l'impostazione della proprietà esclude il titolo del pannello/tabella dal documento di record. Applicabile solo ai pannelli e alle tabelle.

  • Escludi descrizione dal documento di record: l'impostazione della proprietà esclude la descrizione del pannello/tabella dal documento di record. Applicabile solo ai pannelli e alle tabelle.

  • Impaginazione > Luogo: Determina la posizione in cui si seleziona di posizionare il pannello.

    • Inserisci > Seguente Precedente: Posiziona il pannello dopo l’oggetto precedente nel pannello principale.
    • Posiziona > Nell’area contenuto > Nome dell’area contenuto: Posiziona il pannello nell’area di contenuto specificata.
    • Posiziona > Parte superiore dell’area di contenuto successiva: Posiziona il pannello nella parte superiore dell’area di contenuto successiva.
    • Posiziona > Parte superiore dell’area contenuto > Nome dell’area contenuto: Posiziona il pannello nella parte superiore dell’area di contenuto specificata.
    • Posiziona > Sulla pagina > Nome della pagina master: Posiziona il pannello nella pagina specificata. Se un'interruzione di pagina non viene inserita automaticamente, AEM Forms aggiunge un'interruzione di pagina.
    • Posiziona > Parte superiore pagina successiva: Posiziona il pannello nella parte superiore della pagina successiva. Se un'interruzione di pagina non viene inserita automaticamente, AEM Forms aggiunge un'interruzione di pagina.
    • Posiziona > Parte superiore pagina > Nome della pagina master: Posiziona il pannello nella parte superiore della pagina quando viene eseguito il rendering della pagina specificata. Se un'interruzione di pagina non viene inserita automaticamente, AEM Forms aggiunge un'interruzione di pagina.
  • Impaginazione > Dopo: Determina l’area da compilare dopo l’inserimento di un pannello. Nella sezione ​Successivo sono disponibili i campi seguenti:

    • Dopo > Continua riempimento padre: Continua l’unione dei dati per tutti gli oggetti da riempire nel pannello principale.
    • Dopo > Vai all’area di contenuto successiva: Inizia a riempire l’area di contenuto successiva dopo il posizionamento del pannello.
    • Dopo > Vai all’area contenuto > Nome dell’area contenuto: Inizia a riempire l’area di contenuto specificata dopo il posizionamento del pannello.
    • Dopo > Vai alla pagina successiva: Inizia a riempire la pagina successiva dopo aver posizionato il pannello.
    • Dopo > Vai a pagina > Nome della pagina: Inizia a riempire la pagina specificata dopo il posizionamento del pannello.
  • Impaginazione > Overflow: Imposta un overflow per un pannello o una tabella che si estende su più pagine. I campi seguenti sono disponibili nella sezione Overflow :

    • Overflow > Nessuno: Inizia a riempire la pagina successiva. Se un'interruzione di pagina non viene inserita automaticamente, AEM Forms aggiunge un'interruzione di pagina.
    • Overflow > Vai all’area contenuto > Nome dell’area contenuto: Inizia a riempire l'area di contenuto specificata.
    • Overflow > Vai a pagina > Nome della pagina: Inizia a riempire la pagina specificata.

Per informazioni su come applicare interruzioni di pagina e applicare più pagine master in un documento di record, vedere Applicare un'interruzione di pagina in un documento di record e Applicare più pagine master a un documento di record.

Impostazioni a livello di modulo

  • Includi campi non associati in DoR: l’impostazione della proprietà include campi non associati di un modulo adattivo basato su schema nel documento di record. Per impostazione predefinita è true.
  • Escludi i campi dal DoR se nascosti: l’impostazione della proprietà sostituisce il comportamento della proprietà a livello di campo "Escludi dal documento di record" quando non è vera. Se i campi sono nascosti al momento dell’invio del modulo, verranno esclusi dal documento se la proprietà è impostata su true, purché la proprietà "Escludi dal documento di record" non sia impostata.

Applicazione di un'interruzione di pagina in un documento di registrazione

È possibile applicare interruzioni di pagina in un documento di record utilizzando più metodi.

Per applicare un'interruzione di pagina a un documento di record:

  1. Tocca il pannello e seleziona Configura.

  2. Espandi Documento di record per visualizzare le proprietà.

  3. Nella sezione Impaginazione, tocca Cartella nel campo Posiziona .

  4. Tocca Parte superiore della pagina successiva e tocca Seleziona. Puoi anche toccare Parte superiore pagina, selezionare la pagina master e toccare Seleziona per applicare l’interruzione di pagina.

  5. Tocca Salva per salvare le proprietà.

Il pannello selezionato si sposta sulla pagina successiva.

Applicare più pagine master a un documento di record

Se il modello XDP personalizzato selezionato include più pagine master, le proprietà di tali pagine vengono visualizzate nella sezione content della scheda Document of Record . Per ulteriori informazioni, consulta Personalizzare le informazioni di branding nel documento Record.

È possibile applicare più pagine master a un documento di record applicando diverse pagine master ai componenti di un modulo adattivo. Utilizzare la sezione Impaginazione delle proprietà del documento di record per applicare più pagine master.

Di seguito è riportato un esempio di come applicare più pagine master a un documento di record:
Puoi caricare un modello XDP che include quattro pagine master sul server AEM Forms . AEM Forms applica le proprietà del modello al documento di record per impostazione predefinita. AEM Forms applica anche le proprietà della prima pagina master del modello al documento di record.

Per applicare le proprietà della seconda pagina master a un pannello e le proprietà della terza pagina master ai pannelli seguenti, eseguire la procedura seguente:

  1. Toccare il pannello per applicare la seconda pagina master e selezionare Configura.
  2. Nella sezione Impaginazione, tocca Cartella nel campo Posiziona .
  3. Tocca Sulla pagina, seleziona la seconda pagina master e tocca Seleziona.
    AEM Forms applica la seconda pagina master al pannello e a tutti i pannelli successivi nel modulo adattivo.
  4. Nella sezione Impaginazione, tocca Cartella nel campo Dopo .
  5. Tocca Vai a pagina, seleziona la terza pagina master e tocca Seleziona.
  6. Tocca Salva per salvare le proprietà.
    AEM Forms applica la terza pagina master al pannello e a tutti i pannelli successivi nel modulo adattivo.

Considerazioni chiave durante l'utilizzo del documento di registrazione

Quando si lavora su un documento di record per i moduli adattivi, tenere presente le considerazioni e le limitazioni seguenti.

  • I modelli dei documenti non supportano il testo RTF. Pertanto, qualsiasi testo RTF nel modulo adattivo statico o nelle informazioni inserite dall’utente finale viene visualizzato come testo normale nel documento di registrazione.
  • I frammenti di documento in un modulo adattivo non vengono visualizzati nel documento di registrazione. Tuttavia, i frammenti di modulo adattivo sono supportati.
  • Il binding del contenuto nel documento di record generato per il modulo adattivo basato su schema XML non è supportato.
  • La versione localizzata del documento di record viene creata su richiesta per un'impostazione internazionale quando l'utente richiede il rendering del documento di record. La localizzazione del documento di record avviene insieme alla localizzazione del modulo adattivo. Per ulteriori informazioni sulla localizzazione di documenti di record e moduli adattivi, vedere Utilizzo AEM flusso di lavoro di traduzione per localizzare moduli adattivi e documenti di record.

In questa pagina