Generare un documento di record per i moduli adattivi

Panoramica

Dopo aver inviato un modulo, i clienti in genere desiderano conservare una registrazione, in formato cartaceo o documentale, delle informazioni che hanno compilato nel modulo per riferimento futuro. Tale documento è denominato documento di record.

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

NOTA

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

Tipi di moduli adattivi e relativi documenti di record

Quando crei un modulo adattivo, puoi selezionare un modello di modulo. Le opzioni disponibili sono:

  • Modelli di modulo
    Consente 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 in precedenza.

  • Schema XML
    Consente di selezionare una definizione di schema XML per il modulo adattivo. Quando selezioni uno schema XML per il modulo adattivo, puoi:

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

Quando selezioni un modello di modulo, configura il documento di record utilizzando le opzioni disponibili in Configurazione modello documento di record. Consulta Configurazione modello documento record.

Documento di record generato automaticamente

Un documento record 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, rimuovi il campo età per i clienti che hanno selezionato Stati Uniti d’America come paese. Quando tali clienti generano un documento di record, il campo età non è visibile nel documento di record.

Il documento di record generato automaticamente presenta i seguenti vantaggi:

  • Si occupa dell’associazione dei dati.
  • Nasconde automaticamente i campi contrassegnati come esclusi dal documento record al momento dell’invio. Non è richiesto alcuno sforzo aggiuntivo.
  • Consente di risparmiare tempo per la progettazione di un documento di modello record.
  • Consente di provare stili e aspetti diversi utilizzando diversi modelli di base e di scegliere lo stile e l'aspetto migliori per il documento di record. Gli aspetti degli stili sono facoltativi. Se non specificate gli stili, gli stili di sistema vengono impostati come predefiniti.
  • Garantisce che qualsiasi modifica apportata al modulo venga immediatamente riportata nel documento di record.

Componenti per generare automaticamente un documento di record

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

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

Modello di base (consigliato) Modello XFA (file XDP) creato in Progettazione AEM. Il modello base viene utilizzato per specificare lo stile e le informazioni di branding per il modello del documento record.

Consulta Modello di base di un documento record

NOTA

Il modello base di un documento record è anche chiamato metamodello di un documento record.

Modello del documento record Modello XFA (file XDP) generato da un modulo adattivo.

Consulta Configurazione modello documento record.

Dati modulo Informazioni inserite da un utente nel modulo adattivo. Si unisce con il modello del documento record per generare il documento record.

Mappatura degli elementi del modulo adattivo

Nelle sezioni seguenti viene descritto come gli elementi di un modulo adattivo vengono visualizzati nel documento di record.

Campi

Componente modulo adattivo Componente XFA corrispondente Incluso per impostazione predefinita nel modello del documento 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 Disegno a mano 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 e-mail

Pulsante invio HTTP

false
Termini e condizioni vero
Allegato file false Non disponibile nel modello del documento record. Disponibile solo in un documento record tramite allegati.

Contenitori

Componente modulo adattivo Componente XFA corrispondente Note
Pannello
Sottomodulo
Il pannello ripetibile viene mappato su una sottomaschera ripetibile.

Componenti statici

Componente modulo adattivo Componente XFA corrispondente Note
Immagine Immagine I componenti TextDraw e Image, sia associati che 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, si ottengono schede diverse per la modifica delle proprietà dei campi.

Tabelle

I componenti della tabella per moduli adattivi come intestazione, piè di pagina e riga vengono mappati sui componenti XFA corrispondenti. Puoi mappare i pannelli ripetibili alle tabelle nel documento di record.

Modello di base di un documento record

Il modello base fornisce informazioni sullo stile e sull'aspetto del documento di record. Consente di personalizzare l'aspetto predefinito del documento di record generato automaticamente. Ad esempio, si desidera aggiungere il logo della società nell'intestazione e le informazioni sul copyright nel piè di pagina del documento record. La pagina master del modello base viene utilizzata come pagina master per il modello del documento record. 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 record utilizzando il modello base per la generazione automatica del documento record. L'utilizzo del modello di base consente di modificare le proprietà predefinite dei campi.

Segui Convenzioni modello base quando si progetta un modello di base.

Convenzioni modello 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 aziendale e il testo del copyright. La prima pagina master del modello di base viene copiata e utilizzata come pagina master per il documento di record, che contiene intestazione, piè di pagina, numero di pagina o qualsiasi altra informazione da visualizzare in tutte le pagine del documento di 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 del documento record. È consigliabile progettare il modello di base in base alle relative convenzioni e utilizzarlo per la generazione automatica del documento di record.

Convenzioni della pagina mastro

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

  • Pagina master con il nome AF_MASTERPAGE si trova sotto AF_METATEMPLATE alla sottomaschera principale viene data la preferenza per l'estrazione di informazioni su intestazione, piè di pagina e stile.

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

Convenzioni di stile per i campi

  • Per applicare lo stile ai campi del documento record, il modello di base fornisce i campi che si trovano nel AF_FIELDSSUBFORM sottometti sotto AF_METATEMPLATE sottomodulo principale.

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

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

  1. Clic File > Nuovo.

  2. Seleziona la In base a un modello opzione.

  3. Seleziona la Forms - Documento record categoria.

  4. Seleziona Modello base DoR.

  5. Clic Successivo e fornire le informazioni richieste.

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

  7. Salvare il modulo.

È ora possibile utilizzare il modulo salvato come modello di 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 ai campi nel modello di base, è consigliabile rimuovere tali campi dal modello di base in modo che gli aggiornamenti al modello di base vengano selezionati automaticamente.
  • Durante la modifica del modello di base, non rimuovere, aggiungere o modificare gli script.
NOTA

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

Configurazione modello del documento record

Configurare il modello del documento di record del modulo per consentire ai clienti di scaricare una copia stampabile del modulo inviato. Un file XDP funge da modello del documento di record. Il documento di record che i clienti scaricano 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 di creazione dell’AEM, fai clic su Forms > Forms e documenti.

  2. Seleziona un modulo e fai clic su Visualizza proprietà.

  3. Nella finestra Proprietà, tocca Modello modulo.
    È inoltre possibile selezionare un modello di modulo durante la creazione di un modulo.

    NOTA

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

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

    Nessuno Selezionare questa opzione se non si desidera configurare il documento di record per il modulo.

    Associa modello modulo come modello del documento record Seleziona questa opzione se disponi di un file XDP da utilizzare come modello per il documento di record. Quando si seleziona questa opzione, vengono visualizzati tutti i file XDP disponibili nell’archivio di AEM Forms. Selezionare il file appropriato.

    Il file XDP selezionato viene associato al modulo adattivo.

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

    NOTA

    Assicurati che lo schema utilizzato per creare il modulo adattivo e lo schema (schema dati) del modulo XFA siano gli stessi se:

    * Il modulo adattivo è basato su schema
    * Stai utilizzando **Associa modello modulo come modello del documento record** opzione per documento record
    
  5. Clic Fine.

Personalizzare le informazioni di branding nel documento record

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

Per localizzare le informazioni di branding immesse nella scheda Documento record, è necessario assicurarsi che le impostazioni internazionali del browser siano impostate in modo appropriato. La procedura seguente illustra come personalizzare le informazioni di branding del documento record:

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

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

  3. Selezionare il modello predefinito o un modello personalizzato per il rendering del documento record. Se selezioni il modello predefinito, sotto il menu a discesa Modello viene visualizzata un’anteprima in miniatura del documento di record.

    brandingtemplate

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

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

    • Immagine logo: puoi scegliere di utilizzare l’immagine del logo dal modulo adattivo, sceglierne una da DAM o caricarne una dal computer.
    • Titolo modulo
    • Testo intestazione
    • Etichetta di dichiarazione di non responsabilità
    • Liberatoria
    • Testo della liberatoria
    • Colore accento: colore con cui vengono riprodotti il testo dell’intestazione e le righe del separatore nel PDF del documento o del record
    • Famiglia font: famiglia di caratteri del testo nel documento record PDF
    • Per i componenti Casella di controllo e Pulsante di opzione, mostra solo i valori selezionati
    • Separatore per più valori selezionati
    • Includi oggetti modulo non associati al modello dati
    • Escludi campi nascosti dal documento record
    • Nascondi descrizione pannelli

    Se il modello XDP personalizzato selezionato include più pagine master, le proprietà di tali pagine vengono visualizzate nel contenuto sezione del Documento record scheda.

    Proprietà pagina mastro

    Le proprietà della pagina master includono l'immagine del logo, il testo dell'intestazione, il titolo del modulo, l'etichetta della liberatoria e il testo della liberatoria. Puoi applicare le proprietà del modulo adattivo o del modello XDP 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 record.

    NOTA

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

    <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 tabella e colonna per i pannelli nel documento record

Il modulo adattivo potrebbe essere lungo e contenere diversi campi modulo. È possibile che non si desideri salvare un documento record come copia esatta del modulo adattivo. Ora puoi scegliere un layout di tabella o colonna per salvare uno o più pannelli di moduli adattivi nel documento di record PDF.

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

Campi in un pannello sottoposti a rendering in un layout di tabella nel documento di record

Campi in un pannello sottoposti a rendering in un layout di tabella nel documento di record

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

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

Impostazioni del documento record

Le impostazioni del documento record consentono di scegliere le opzioni da includere nel documento record. Ad esempio, una banca accetta in 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 della filiale nel documento di record.

Le impostazioni del documento record di un componente sono disponibili nelle relative proprietà. Per accedere alle proprietà di un componente, selezionalo e fai clic su cmppr nella sovrapposizione. Le proprietà sono elencate nella barra laterale e le impostazioni seguenti sono disponibili.

Impostazioni a livello di campo

  • Escludi Da Documento Record: impostando la proprietà su true il campo viene escluso dal documento di record. Questa è una proprietà che supporta lo script denominata excludeFromDoR. Il suo comportamento dipende da Escludi campi dal DoR se nascosto proprietà a livello di modulo.

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

  • Escludi titolo da documento record: L’impostazione della proprietà esclude il titolo del pannello o della tabella dal documento di record. Applicabile solo al pannello e alla tabella.

  • Escludi descrizione da documento record: L’impostazione della proprietà esclude la descrizione del pannello o della tabella dal documento di record. Applicabile solo al pannello e alla tabella.

  • Paginazione > Luogo: determina dove posizionare il pannello.

    • Luogo > Dopo precedente: posiziona il pannello dopo l’oggetto precedente nel pannello principale.
    • Luogo > In area contenuti > Nome dell’area di contenuto: inserisce il pannello nell’area di contenuto specificata.
    • Luogo > Inizio area contenuti successiva: posiziona il pannello nella parte superiore dell’area del contenuto successiva.
    • Luogo > Inizio area contenuti > Nome dell’area di contenuto: posiziona il pannello nella parte superiore dell’area di contenuto specificata.
    • Luogo > A pagina > Nome della pagina master: inserisce il pannello nella pagina specificata. Se un’interruzione di pagina non viene inserita automaticamente, AEM Forms aggiunge un'interruzione di pagina.
    • Luogo > Inizio 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.
    • Luogo > Inizio pagina > Nome della pagina master: inserisce 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.
  • Paginazione > Dopo: determina quale area riempire dopo aver posizionato un pannello. I campi seguenti sono disponibili nel Dopo sezione:

    • Dopo > Continua a riempire elemento padre: continua l’unione dei dati per tutti gli oggetti che devono ancora essere riempiti nel pannello principale.
    • Dopo > Vai all'area contenuti successiva: inizia a riempire l’area di contenuto successiva dopo il posizionamento del pannello.
    • Dopo > Vai all'area contenuti > Nome dell’area di 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.
  • Paginazione > Overflow: imposta un overflow per un pannello o una tabella che si estende su più pagine. I campi seguenti sono disponibili nel Overflow sezione:

    • 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 a area contenuti > Nome dell’area di 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 più pagine master in un documento di record, consulta Applicare un’interruzione di pagina a un documento record e Applicare più pagine master a un documento record.

Impostazioni livello modulo

  • Includi campi non associati nel DoR: L’impostazione della proprietà include campi non associati da un modulo adattivo basato su schema in un documento di record. Per impostazione predefinita è true.
  • Escludi campi dal DoR se nascosto: Imposta la proprietà per escludere i campi nascosti da Documento record all’invio del modulo. Quando si abilita Riconvalida sul server, il server ricalcola i campi nascosti prima di escluderli dal Documento record.

Applicare un’interruzione di pagina a un documento record

È possibile applicare le interruzioni di pagina a 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 record per visualizzare le proprietà.

  3. In Paginazione sezione, tocca Cartella nel Luogo campo.

  4. Tocca Inizio pagina successiva e tocca Seleziona. Puoi anche toccare Inizio pagina, seleziona la pagina master e tocca Seleziona per applicare l’interruzione di pagina.

  5. Tocca Salva per salvare le proprietà.

Il pannello selezionato passa alla pagina successiva.

Applicare più pagine master a un documento record

Se il modello XDP personalizzato selezionato include più pagine master, le proprietà di tali pagine vengono visualizzate nel contenuto sezione del Documento record scheda. Per ulteriori informazioni, consulta Personalizzare le informazioni di branding nel documento record.

Per applicare più pagine master a un documento record, devi applicare pagine master diverse ai componenti di un modulo adattivo. Utilizza il Paginazione della sezione delle proprietà del documento record per applicare più pagine master.

Di seguito è riportato un esempio di applicazione di più pagine master a un documento record: puoi caricare un modello XDP che include quattro pagine master in AEM Forms server. AEM Forms applica le proprietà del modello al documento 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 della terza pagina master ai pannelli che seguono, eseguire la procedura seguente:

  1. Tocca il pannello per applicare la seconda pagina master e seleziona Configura.
  2. In Paginazione sezione, tocca Cartella nel Luogo campo.
  3. Tocca A 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. In Paginazione sezione, tocca Cartella nel Dopo campo.
  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 record

Quando lavori su un documento record per moduli adattivi, tieni presenti le considerazioni e le limitazioni seguenti.

  • I modelli di documento record non supportano il formato RTF. Pertanto, qualsiasi testo RTF nel modulo adattivo statico o nelle informazioni fornite dall’utente finale viene visualizzato come testo normale nel documento di record.
  • I frammenti di documento in un modulo adattivo non vengono visualizzati nel documento di record. Tuttavia, sono supportati i frammenti di modulo adattivi.
  • L’associazione del contenuto nel documento record generato per un modulo adattivo basato su schema XML non è supportata.
  • La versione localizzata del documento record viene creata su richiesta per una lingua quando l’utente richiede il rendering del documento record. La localizzazione del documento di record si verifica insieme alla localizzazione del modulo adattivo. Per ulteriori informazioni sulla localizzazione del documento di record e dei moduli adattivi consulta Utilizzo del flusso di lavoro di traduzione AEM per localizzare i moduli adattivi e i documenti di record.

In questa pagina