Genera documento di record per i moduli adattivi generate-document-of-record-for-adaptive-forms
Panoramica overview
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.
Tipi di moduli adattivi e relativi documenti di registrazione adaptive-form-types-and-their-documents-of-record
Quando si crea un modulo adattivo, è possibile selezionare un modello di modulo. Le opzioni disponibili sono:
-
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 sopra.
-
Consente 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. Vedi Configurazione del modello del documento di record.
Documento generato automaticamente automatically-generated-document-of-record
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 components-to-automatically-generate-a-document-of-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 AEM Designer. Il modello di base viene utilizzato per specificare le informazioni relative allo stile e al branding per il modello di documento.
Vedi Modello di base di un documento di registrazione
Documento del modello di record Modello XFA (file XDP) generato da un modulo adattivo.
Vedi Configurazione del modello del documento di record.
Dati modulo Informazioni inserite 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 mapping-of-adaptive-form-elements
Nelle sezioni seguenti viene descritto come gli elementi modulo adattivi vengono visualizzati nel documento di registrazione.
Campi fields
Contenitori containers
Componenti statici static-components
Tabelle tables
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 base-template-of-a-document-of-record
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.
Segui Convenzioni dei modelli di base quando si progetta un modello di base.
Convenzioni dei modelli di base base-template-conventions
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, assegnare al sottomodulo principale un nome come
AF_METATEMPLATEe la pagina master comeAF_MASTERPAGE. -
La pagina master con il nome
AF_MASTERPAGEsituato sottoAF_METATEMPLATEal sottomodulo principale 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 lo stile ai campi del documento di record, il modello di base fornisce i campi che si trovano nel
AF_FIELDSSUBFORMsotto ilAF_METATEMPLATEsottomodulo principale. -
Le proprietà di questi campi vengono applicate ai campi del documento di registrazione. Questi campi devono seguire
AF_<name of field in all caps>_XFOconvenzione di denominazione. Ad esempio, il nome del campo per la casella di controllo deve essereAF_CHECKBOX_XFO.
Per creare un modello di base, eseguire le operazioni seguenti in AEM Designer.
-
Fai clic su File > Nuovo.
-
Seleziona la Basato su un modello opzione .
-
Seleziona la Forms - Documento di registrazione categoria.
-
Seleziona Modello di base DoR.
-
Fai clic su Successivo e fornire le informazioni richieste.
-
(Facoltativo) Modificare lo stile e l’aspetto dei campi che si desidera applicare ai campi del documento di record.
-
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.
Configurazione modello del documento record document-of-record-template-configuration
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:
-
Nell’istanza AEM autore, fai clic su Forms > Forms e documenti.
-
Selezionare un modulo e fare clic su Visualizza proprietà.
-
Nella finestra Proprietà, tocca Modello Modulo.
È inoltre possibile selezionare un modello di modulo quando si crea un modulo.
note note NOTE Nella scheda Modello modulo, assicurarsi di selezionare Schema o Nessuno dal Seleziona da a discesa. Il documento di record non è supportato per i moduli basati su XFA o adattivi con Modello di modulo come modello di modulo. -
Nella sezione Configurazione modello documento 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 di modulo come modello di documento di record Selezionare 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 registrazione Selezionare 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.
Selezionare 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.
Selezionare Modello Forms come modello di base per generare 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. Selezionando questa opzione, vengono visualizzati tutti i file XDP disponibili nell’archivio AEM Forms. Selezionare il file appropriato.
note note NOTE 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
- Stai utilizzando Associa modello di modulo come modello del documento di record opzione per il documento di registrazione
-
Fai clic su Fatto.
Personalizzare le informazioni sul marchio nel documento di registrazione customize-the-branding-information-in-document-of-record
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:
-
Seleziona un pannello (pannello principale) nel documento del record, quindi tocca
-
Tocca
-
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.
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.
-
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 del 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 righe separatore nel documento o nel PDF record
- Famiglia di font: Famiglia di font del testo nel documento di record PDF
- 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
note note NOTE 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: code language-xml <proto> <font typeface="Arial"/> <fill> <color value="4,166,203"/> </fill> <edge> <color value="4,166,203"/> </edge> </proto> -
Per salvare le modifiche di branding, tocca Fine.
Layout di tabelle e colonne per pannelli nel documento di registrazione table-and-column-layouts-for-panels-in-document-of-record
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 un layout di tabella o colonna per salvare uno o più pannelli di modulo adattivi nel documento di record PDF.
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.
Rendering dei campi in un pannello con layout di tabella nel documento del record
Rendering dei campi in un pannello con layout a colonne nel documento del record
Impostazioni del documento di registrazione document-of-record-settings
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
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 da Escludere i campi dal DoR se nascosti proprietà a livello di modulo. -
Visualizza pannello come tabella: L’impostazione della proprietà visualizza il pannello come tabella nel documento se il pannello contiene meno di 6 campi. Applicabile solo al pannello.
-
Escludi titolo dal documento di registrazione: L'impostazione della proprietà esclude il titolo del pannello/tabella dal documento di registrazione. Applicabile solo ai pannelli e alle tabelle.
-
Escludi descrizione dal documento di registrazione: L'impostazione della proprietà esclude la descrizione del pannello/tabella dal documento di registrazione. Applicabile solo ai pannelli e alle tabelle.
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 registrazione. Per impostazione predefinita è true.
- Escludere 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 è true. 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.
Considerazioni chiave durante l'utilizzo del documento di registrazione key-considerations-when-working-with-document-of-record
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 documento di registrazione viene utilizzato solo a scopo di stampa.
- Il binding del contenuto nel documento di record generato per il modulo adattivo basato su schema XML non è supportato.
- 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, consulta Utilizzo AEM flusso di lavoro di traduzione per localizzare i moduli adattivi e il documento di registrazione.