Show Menu
ARGOMENTI×

Genera documento di registrazione per i moduli adattivi

Panoramica

Dopo l'invio di un modulo, i clienti desiderano in genere tenere 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.
In questo articolo viene illustrato come generare un documento di record per i moduli adattivi.
La generazione automatica del documento di record non è supportata per i moduli adattivi basati su XFA. Tuttavia, è possibile utilizzare l'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 modulo Consente di selezionare un modello XFA per il modulo adattivo. Quando selezionate un modello XFA, potete utilizzare il file XDP associato per il documento del record come descritto sopra.
  • Schema XML Consente di selezionare una definizione di schema XML per il modulo adattivo. Quando si seleziona uno schema XML per il modulo adattivo, è possibile:
    • Associate un modello XFA per il documento del record. Verificare 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 si seleziona un modello di modulo, configurare il documento di record utilizzando le opzioni disponibili in Configurazione modello documento di record. See Document of Record Template Configuration .

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 record, ogni volta che si modifica il modulo, il relativo documento record viene aggiornato immediatamente. Ad esempio, è possibile rimuovere il campo di età per i clienti che scelgono Stati Uniti d'America come proprio paese. Quando tali clienti generano un documento di registrazione, il campo age non è visibile nel documento di registrazione.
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 è richiesto alcun sforzo supplementare.
  • Consente di risparmiare tempo per la progettazione del modello di documento.
  • Consente di provare stili e aspetto diversi utilizzando diversi modelli di base e di scegliere lo stile e l’aspetto migliori per il documento di registrazione. L'aspetto dello stile è facoltativo e, se non si specifica lo stile, gli stili di sistema sono impostati come predefiniti.
  • Garantisce che qualsiasi modifica del modulo venga immediatamente riflessa nel documento di registrazione.

Componenti per generare automaticamente un documento record

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 record.
Modello di base (consigliato) modello XFA (file XDP) creato in AEM Designer. Il modello di base viene utilizzato per specificare lo stile e le informazioni sul marchio per il modello del documento del record.
Il modello di base di un documento di record è anche denominato meta-template di un documento di record.
Modello XFA del modello di record (file XDP) generato da un modulo adattivo.
Informazioni sui dati del modulo compilate da un utente nel modulo adattivo. Viene unito al modello del documento per generare il documento del record.

Mappatura di elementi modulo adattivi

Le sezioni seguenti descrivono l’aspetto degli elementi modulo adattivi nel documento di record.

espandibili

Componente modulo adattivo Componente XFA corrispondente Incluso per impostazione predefinita nel modello del documento? 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 scarabocchio 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 del documento. Disponibile solo nel documento di registrazione attraverso gli allegati.

Containers

Componente modulo adattivo Componente XFA corrispondente Note
Pannello Sottomodulo Il pannello ripetibile viene mappato su un sottomodulo ripetibile.

Componenti statici

Componente modulo adattivo
Componente XFA corrispondente
Note
Immagine
Immagine
I componenti TestoDisegno e Immagine, associati o non associati, vengono sempre visualizzati nel documento record di un modulo adattivo basato su XSD, a meno che non venga escluso utilizzando le impostazioni del documento dei record.
Testo
Testo
Nell’interfaccia classica, sono disponibili diverse schede per la modifica delle proprietà dei campi.

Tabelle

I componenti della tabella dei moduli adattivi, ad esempio intestazione, piè di pagina e riga, vengono mappati sui componenti XFA corrispondenti. È possibile mappare i pannelli ripetibili alle tabelle nel documento di registrazione.

Modello di base di un documento record

Il modello di base fornisce informazioni sullo stile e l'aspetto al documento del record. Consente di personalizzare l'aspetto predefinito del documento di record generato automaticamente. Ad esempio, è necessario aggiungere il logo aziendale 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 del record. La pagina master può contenere informazioni quali l'intestazione della pagina, il piè di pagina e il numero di pagina che è possibile applicare al documento del 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 del modello di base quando si progetta il modello di base.

Convenzioni di base per i modelli

Un modello di base viene utilizzato per definire l’intestazione, il piè di pagina, lo stile e l’aspetto di un documento del record. L’intestazione e il piè di pagina possono includere informazioni come il logo aziendale e il testo del copyright. La prima pagina master nel 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 da visualizzare 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 comunque utilizzata nel modello di documento del record. Si consiglia vivamente di progettare il modello di base in base alle convenzioni e di utilizzarlo per la generazione automatica del documento di registrazione.
Convenzioni per le pagine master
  • Nel modello di base, assegnare al sottomodulo principale il nome come AF_METATEMPLATE e alla pagina master come AF_MASTERPAGE .
  • Alla pagina master con il nome AF_MASTERPAGE situato sotto il sottomodulo AF_METATEMPLATE principale viene data la preferenza per l'estrazione di informazioni di 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 del record, il modello di base fornisce i campi situati nel AF_FIELDSSUBFORM sottomodulo sotto il sottomodulo AF_METATEMPLATE principale.
  • Le proprietà di questi campi sono applicate ai campi nel documento di record. Questi campi devono seguire la convenzione di AF_<name of field in all caps>_XFO denominazione. Ad esempio, il nome del campo per la casella di controllo deve essere AF_CHECKBOX_XFO .
Per creare un modello di base, effettuare le seguenti operazioni in AEM Designer.
  1. Fate clic su File > Nuovo .
  2. Selezionare l'opzione Basato su modello .
  3. Selezionare la categoria Forms - Documento di registrazione .
  4. Selezionare Modello di base DoR.
  5. Fate clic su Avanti e fornite le informazioni richieste.
  6. (Facoltativo) Modificare lo stile e l'aspetto dei campi che si desidera applicare ai campi nel documento del record.
  7. Salvare il modulo.
È ora possibile utilizzare il modulo salvato come modello di base per il documento record. Non modificate o rimuovete 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 tutti gli aggiornamenti al modello di base vengano prelevati automaticamente.
  • Durante la modifica del modello di base, non rimuovere, aggiungere o modificare gli script.
Progettare i modelli di 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 del modulo inviato in formato cartaceo. Un file XDP funge da modello del documento del record. Il documento di record scaricato dai clienti viene formattato in base al layout specificato nel file XDP.
Per configurare un documento di record per i moduli adattivi, procedere come segue:
  1. In AEM’istanza di creazione, fate clic su Forms > Forms e documenti.
  2. Selezionare un modulo e fare clic su Visualizza proprietà .
  3. Nella finestra Proprietà, toccare Modello ​modulo. È inoltre possibile selezionare un modello di modulo al momento della creazione del modulo.
    Nella scheda Modello modulo, assicurarsi di selezionare Schema o Nessuno dall'elenco a discesa Seleziona da . Il documento del record non è supportato per i moduli XFA basati su moduli adattivi con il modello di modulo come modello di modulo.
  4. Nella sezione Configurazione modello documento di record della scheda Modello di 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 del documento di registrazione 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 archivio AEM Forms. Selezionare il file appropriato.
    Il file XDP selezionato viene associato al modulo adattivo.
    Genera documento record Selezionare questa opzione per utilizzare un file XDP come modello di base per definire lo stile e l'aspetto del documento del record. Selezionando questa opzione, vengono visualizzati tutti i file XDP disponibili archivio AEM Forms. Selezionare il file appropriato.
    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 modulo come modello del documento di record per il documento di record
  5. Fate 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, dichiarazione di non responsabilità e se si desidera includere o meno le opzioni di casella di controllo e pulsante 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 correttamente. Per personalizzare le informazioni di branding del documento di registrazione, completare i seguenti passaggi:
  1. Selezionate un pannello (pannello principale) nel documento del record, quindi toccate .
  2. Toccate . Viene visualizzata la scheda Documento di registrazione.
  3. Selezionare il modello predefinito o un modello personalizzato per il rendering del documento del record. Se selezionate il modello predefinito, sotto il menu a discesa Modello viene visualizzata una miniatura di anteprima del documento di record.
    Se scegliete di selezionare un modello personalizzato, individuate un file XDP da selezionare sul server AEM Forms . Se desiderate utilizzare un modello che non è già presente nel server AEM Forms , dovete prima caricare l'XDP nel server AEM Forms .
  4. A seconda che sia selezionato un modello predefinito o personalizzato, nella scheda Documento di record vengono visualizzate tutte o alcune delle proprietà seguenti. Specificate i seguenti parametri:
    • Immagine logo: Potete scegliere di utilizzare l'immagine logo nel 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 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 al modello dati
    • Escludere i campi nascosti dal documento record
    • Nascondi descrizione pannelli
    Se si utilizza un modello di modulo adattivo creato con una versione di Designer precedente alla 6.3, per il funzionamento delle proprietà Colore accento e Famiglia font, 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 al marchio, toccate Fine.

Layout di tabelle e colonne per i pannelli nel documento di registrazione

Il modulo adattivo può essere lungo e contenere più campi modulo. È possibile che non si desideri salvare un documento come copia esatta del modulo adattivo. Ora è possibile scegliere un layout di tabella o colonna per salvare uno o più pannelli di moduli adattivi nel documento PDF del record.
Prima di generare un documento di registrazione, nelle impostazioni di un pannello selezionare Layout per il documento di registrazione per tale pannello come Tabella o Colonna. I campi nel pannello vengono organizzati di conseguenza nel documento del record.
Rendering dei campi in un pannello in un layout di tabella nel documento del record
Rendering dei campi di un pannello in un layout di colonna nel documento del record

Impostazioni del documento di registrazione

Le impostazioni del documento dei record consentono di scegliere le opzioni che si desidera includere nel documento dei record. Ad esempio, una banca accetta nome, età, numero di previdenza sociale e numero di telefono in un modulo. Il modulo genera un numero di conto bancario e i dettagli della filiale. Potete scegliere di visualizzare solo il nome, il numero di previdenza sociale, il conto bancario e i dettagli del ramo nel documento del record.
Le impostazioni del documento di record di un componente sono disponibili nelle relative proprietà. Per accedere alle proprietà di un componente, selezionate il componente e fate 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 Record : Impostando la proprietà su true il campo viene escluso dal documento del record. Si tratta della proprietà script denominata excludeFromDoR . Il suo comportamento dipende dalla proprietà Escludi campi da DoR se la proprietà è nascosta a livello di modulo.
  • Visualizza pannello come tabella: Se la proprietà è impostata, il pannello viene visualizzato come tabella nel documento di record se contiene meno di 6 campi. Applicabile solo al pannello.
  • Escludi titolo dal documento record: L'impostazione della proprietà esclude il titolo del pannello o della tabella dal documento del record. Applicabile solo al pannello e alla tabella.
  • Escludi descrizione dal documento di registrazione: L'impostazione della proprietà esclude la descrizione del pannello/tabella dal documento del record. Applicabile solo al pannello e alla tabella.
Impostazioni a livello di modulo
  • Includi campi non associati in DoR: L'impostazione della proprietà include campi non associati da un modulo adattivo basato su schema nel documento record. Per impostazione predefinita è true.
  • Escludi campi da DoR se nascosti: L'impostazione della proprietà ha la priorità sul comportamento della proprietà a livello di campo "Escludi dal documento di registrazione" quando non è vera. Se i campi sono nascosti al momento dell'invio del modulo, saranno esclusi dal documento se la proprietà è impostata su true, purché la proprietà "Escludi dal documento di registrazione" non sia impostata.

Considerazioni chiave per l'utilizzo del documento record

Quando si lavora su un documento di record per i moduli adattivi, tenere presente le considerazioni e le limitazioni seguenti.
  • Il documento dei modelli di record non supporta il testo RTF. Di conseguenza, il testo RTF nel modulo adattivo statico o nelle informazioni compilate dall’utente finale viene visualizzato come testo normale nel documento del record.
  • I frammenti di documento in un modulo adattivo non vengono visualizzati nel documento del record. Tuttavia, i frammenti di modulo adattivo sono supportati.
  • Il binding del contenuto nel documento del record generato per il modulo adattivo basato su schema XML non è supportato.
  • La versione localizzata del documento del record viene creata su richiesta per una lingua quando l'utente richiede il rendering del documento del record. La localizzazione del documento del record avviene insieme alla localizzazione del modulo adattivo. Per ulteriori informazioni sulla localizzazione del documento dei moduli di registrazione e adattivi, vedere Utilizzo AEM flusso di lavoro di traduzione per localizzare moduli adattivi e documenti di record .