Quando un modulo viene compilato o inviato, è possibile conservare un record del modulo, in formato cartaceo o documento. Questo record è denominato documento di registrazione (DoR). Si tratta di una copia stampabile del modulo inviato. È inoltre possibile fare riferimento al documento di registrazione per le informazioni che i clienti hanno compilato in una data successiva oppure utilizzare il documento di record per archiviare i moduli e i contenuti insieme in formato PDF.
Per creare un documento di record, un modello basato su XFA o Acroform viene unito ai dati raccolti tramite un modulo adattivo. È possibile generare automaticamente un documento di record o on-demand.
L’opzione su richiesta consente di specificare un modello XFA o Acrobat personalizzato per fornire un aspetto personalizzato al documento di record.
Operazioni disponibili:
Prima di iniziare ad apprendere e a preparare le risorse necessarie per un documento di record:
Modello di base: Un modello XFA (file XDP) creato in Forms Designer o in un modulo Acrobat (AcroForm). Modello di base viene utilizzato per specificare le informazioni sullo stile e il branding di un documento di record. Carica il modello XFA (file XDP) nella tua istanza AEM Forms prima di
Modulo adattivo: Modulo adattivo per il quale deve essere generato il documento di record.
Carica il modello XFA (file XDP) nella tua istanza AEM Forms. Esegui i seguenti passaggi per configurare un modulo adattivo per utilizzare il modello XFA (file XDP) come modello per il documento di record:
Il modulo adattivo è ora configurato per l’utilizzo di un file XDP come modello per Document of Record. I passaggi successivi sono i seguenti: associare i componenti Modulo adattivo ai campi modello corrispondenti.
Carica il tuo Adobe Acrobat PDF (Acroform) nella tua istanza AEM Forms. Esegui i seguenti passaggi per configurare un modulo adattivo per utilizzare Adobe Acrobat PDF (Acroform) come modello per il documento di record:
Il modulo adattivo è ora configurato per l’utilizzo di un Acroform come modello per Document of Record. I passaggi successivi sono i seguenti: associare i componenti Modulo adattivo ai campi modello corrispondenti.
Quando un Modulo adattivo è configurato per generare automaticamente un Documento di record, ogni volta che un modulo viene modificato, il relativo Documento di record viene aggiornato immediatamente. Ad esempio, se un campo viene rimosso da un modulo adattivo esistente, anche il campo corrispondente viene rimosso e non è visibile nel documento di record. Ci sono molti altri vantaggi di generare automaticamente Documento di record. :
Esegui i seguenti passaggi per configurare un modulo adattivo per generare automaticamente un documento di record:
Eseguire un binding dei campi modulo adattivo con i campi modello per visualizzare i dati del modulo acquisito nel campo del documento di record corrispondente. Per eseguire un binding dei componenti per modulo adattivo con i campi corrispondenti del modello di documento:
Aprire il Modulo adattivo configurato per l’utilizzo di un modello di modulo personalizzato per la modifica.
Seleziona un componente Modulo adattivo e fai clic su Apri Configura . icona. Apre il browser delle proprietà.
Nel browser delle proprietà, sfoglia e seleziona un campo.
Fai clic su Salva.
Puoi utilizzare l’azione Invia e-mail, Experience Manager Flusso di lavoro, insieme all’azione Invia Passaggio del documento di record e altre azioni di invio per ricevere un documento di registrazione.
I moduli adattivi e i corrispondenti documenti dei modelli di record possono evolvere nel tempo. È possibile scegliere di aggiungere, rimuovere o modificare i campi in un modulo adattivo o in un modello di documento di record.
Quando apporti modifiche a un modello Documento di record e carichi il modello Documento di record modificato in AEM Forms, l’editor di Forms adattivo rileva automaticamente i binding modificati e ti informa sui componenti del modulo adattivo che richiedono nuovi binding. Consente di eseguire aggiornamenti incrementali a un modello di documento di record.
Ad esempio, un'organizzazione, We.Retail ha un modello Document of Record basato su AcroForm, we-retail-fattura.pdf. Il modello si presenta come segue:
Dopo aver utilizzato il modello per un certo periodo di tempo, l'organizzazione decide di rinominare invoice-number
campo a bill-number
campo e acquisisci l'indirizzo e-mail degli acquirenti. Nome aggiornato da uno sviluppatore del invoice-number
e aggiunge un campo e-mail al modello. Crea anche una nuova versione del modello denominata we-retail-fattura-v2.pdf.
Lo sviluppatore carica e applica al modello aggiornato il modulo adattivo. Il modulo adattivo rileva e visualizza automaticamente l’elenco dei campi in cui è stato modificato il binding.
Lo sviluppatore del modulo unisce i campi Forms adattivi con il modello di documento di record corrispondente.
Ora, quando il modulo adattivo viene inviato, viene creato un documento di record aggiornato.
Quando si lavora a Document of Record per Adaptive Forms, tenere presente le considerazioni e le limitazioni seguenti.
Nella tabella seguente sono descritti i componenti Modulo adattivo e i componenti XFA corrispondenti, nonché quelli visualizzati in un documento di record.
Componente Modulo adattivo | Componente XFA corrispondente | Incluso per impostazione predefinita nel modello del documento di 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 Documento di record. Disponibile solo nel documento di registrazione attraverso gli allegati. |
Componente Modulo adattivo | Componente XFA corrispondente | Note |
---|---|---|
Pannello |
Sottomodulo |
Il pannello ripetibile è associato a un sottomodulo ripetibile. |
Componente Modulo adattivo | Componente XFA corrispondente | Note |
---|---|---|
Immagine | Immagine | I componenti TextDraw e Image, associati o non associati, vengono sempre visualizzati nel documento di record per un modulo adattivo basato su XSD, a meno che non vengano esclusi utilizzando le impostazioni Document of Record. |
Testo | Testo |
I componenti della tabella Forms adattivi, come intestazione, piè di pagina e mappa di riga, sono associati ai componenti XFA corrispondenti. È possibile mappare pannelli ripetibili su tabelle in Documento di record.
Il modello di base fornisce informazioni su stile e aspetto al documento di record. Consente di personalizzare l'aspetto predefinito del documento di record generato automaticamente. Ad esempio, è possibile utilizzare il modello di base per 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 Documento di record. La pagina master può contenere informazioni quali l’intestazione di pagina, il piè di pagina e il numero di pagina che è possibile applicare al documento di record. È possibile applicare tali informazioni al documento di record 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 sempre Convenzioni dei modelli di base quando si progetta un modello 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 di record, che contiene intestazione, piè di pagina, numero di pagina o qualsiasi altra informazione che deve essere visualizzata 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 Documento di record. Si consiglia vivamente di progettare il modello di base in base alle sue convenzioni e di utilizzarlo per la generazione automatica di documenti di record.
Convenzioni delle pagine master
Nel modello di base, denominare il sottomodulo principale come AF_METATEMPLATE
e la pagina master come AF_MASTERPAGE
.
La pagina master con il nome AF_MASTERPAGE
situato sotto AF_METATEMPLATE
il sottomodulo principale è preferibile 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 base.
Convenzioni di stile per i campi
Per applicare lo stile ai campi nel documento di record, il modello di base fornisce i campi che si trovano nel AF_FIELDSSUBFORM
sotto il AF_METATEMPLATE
sottomodulo principale.
Le proprietà di questi campi vengono applicate ai campi nel documento di registrazione. Questi campi devono seguire 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 Forms 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 nel documento di record.
Salvare il modulo.
È ora possibile utilizzare il modulo salvato come modello di base per Documento di record. Non modificare o rimuovere gli script presenti nel modello di base.
Modifica del modello di base
Seguire rigorosamente le convenzioni e le istruzioni di cui sopra per progettare un modello di base.
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, accertati che le impostazioni internazionali del browser siano impostate in modo appropriato. Per personalizzare le informazioni di branding del documento di registrazione, esegui i seguenti passaggi:
Seleziona un pannello (pannello principale) nel documento di record e tocca .
Tocca . Viene visualizzata la scheda Documento di record.
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 tuo AEM Forms server. Se desideri utilizzare un modello che non è già nel tuo AEM Forms server, devi prima caricare XDP nel tuo AEM Forms server.
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:
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>
Per salvare le modifiche di branding, tocca Fine.
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 Modulo adattivo nel PDF Document of Record.
Prima di generare un documento di record, nelle impostazioni di un pannello selezionare Layout per il documento di record per il pannello come Tabella o Colonna. I campi nel pannello vengono organizzati di conseguenza nel documento di registrazione.
Campi di un pannello di cui viene eseguito il rendering in un layout di tabella nel documento di record
Campi di un pannello di cui viene eseguito il rendering in un layout di colonna nel documento di record
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.
L’impostazione del componente Documento di record è disponibile nelle relative proprietà. Per accedere alle proprietà di un componente, selezionalo e fai clic su 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: Se si imposta la proprietà su true, il campo viene escluso dal documento di 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 di record 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
Un file XCI consente di impostare varie proprietà di un documento. Forms as a Cloud Service ha un file XCI principale. È possibile utilizzare un file XCI personalizzato per sostituire una o più proprietà predefinite specificate nel file XCI master. Ad esempio, è possibile scegliere di incorporare un font in un documento o di abilitare la proprietà tagged per tutti i documenti. La tabella seguente specifica le opzioni XCI:
Opzione XCI | Descrizione |
---|---|
config/current/pdf/creator | Identifica il creatore del documento utilizzando la voce Creatore nel dizionario Informazioni documento. Per informazioni su questo dizionario, vedi Guida di riferimento di PDF. |
config/present/pdf/produttore | Identifica il produttore del documento utilizzando la voce Produttore nel dizionario Informazioni documento. Per informazioni su questo dizionario, vedi Guida di riferimento di PDF. |
configurazione/attuale/layout | Controlla se l'output è un singolo pannello o impaginato. |
config/current/pdf/compressione/level | Specifica il grado di compressione da utilizzare per la generazione di un documento PDF. |
config/present/pdf/fontInfo/embed | Controlla l'incorporazione del font nel documento di output. |
config/current/pdf/scriptModel | Controlla se le informazioni specifiche di XFA sono incluse nel documento PDF di output. |
config/current/common/data/adjustData | Controlla se l'applicazione XFA regola i dati dopo l'unione. |
config/current/pdf/renderPolicy | Controlla se la generazione del contenuto della pagina viene eseguita sul server o differita al client. |
config/present/common/locale | Specifica le impostazioni internazionali predefinite utilizzate nel documento di output. |
configurazione/presente/destinazione | Se contenuto da un elemento presente, specifica il formato di output. Se contenuto in un elemento openAction, specifica l'azione da eseguire all'apertura del documento in un client interattivo. |
configurazione/attuale/uscita/tipo | Specifica il tipo di compressione da applicare a un file o il tipo di output da produrre. |
config/current/common/temp/uri | Specifica l’URI del modulo. |
config/present/common/template/base | Fornisce una posizione di base per gli URI nella struttura del modulo. Quando questo elemento è assente o vuoto, la posizione della struttura del modulo viene utilizzata come base. |
config/present/common/log/to | Controlla la posizione in cui vengono scritti i dati di registro o di output. |
config/current/output/to | Controlla la posizione in cui vengono scritti i dati di registro o di output. |
config/present/script/currentPage | Specifica la pagina iniziale all'apertura del documento. |
config/present/script/exclude | Informa Forms as a Cloud Service quali eventi ignorare. |
config/current/pdf/linearized | Controlla se il documento PDF di output è linearizzato. |
config/present/script/runScripts | Controlla quale insieme di script viene eseguito da Forms as a Cloud Service. |
config/present/pdf/tagged | Controlla l’inclusione dei tag nel documento PDF di output. I tag, nel contesto di PDF, sono informazioni aggiuntive incluse in un documento per esporre la struttura logica del documento. I tag facilitano gli strumenti di accessibilità e la riformattazione. Ad esempio, un numero di pagina può essere contrassegnato come artefatto in modo che l’assistente vocale non lo pronunci al centro del testo. Anche se i tag rendono un documento più utile, aumentano anche le dimensioni del documento e il tempo di elaborazione necessario per crearlo. |
config/present/pdf/fontInfo/alwaysEmbed | Specifica un font incorporato nel documento di output. |
config/present/pdf/fontInfo/maiEmbed | Specifica un font che non deve mai essere incorporato nel documento di output. |
config/present/pdf/pdfa/part | Specifica il numero di versione della specifica PDF/A a cui è conforme il documento. |
config/present/pdf/pdfa/amd | Specifica il livello di modifica della specifica PDF/A. |
config/current/pdf/pdfa/conformation | Specifica il livello di conformità con la specifica PDF/A. |
config/present/pdf/version | Specifica la versione del documento PDF da generare |
config/present/pdf/version/map | Specifica i font di ritorno per il documento |
Aggiungi il file XCI personalizzato al tuo progetto di sviluppo.
Specifica quanto segue proprietà inline:
{
"xciFilePath": "[path of XCI file]"
}
Ad esempio:
{
"xciFilePath": "/content/dam/formsanddocuments/customMinionProBoldAndTagged.xci"
}
Distribuisci il progetto nell’ambiente di Cloud Service.