Sincronizzazione di Forms adattivo con i modelli di modulo XFA synchronizing-adaptive-forms-with-xfa-form-templates

L’Adobe consiglia di utilizzare l’acquisizione dati moderna ed estensibile Componenti coreper creazione di un nuovo Forms adattivoo aggiunta di Forms adattivo alle pagine AEM Sites. Questi componenti rappresentano un progresso significativo nella creazione di Forms adattivi, garantendo esperienze utente straordinarie. Questo articolo descrive un approccio precedente all’authoring di Forms adattivi utilizzando i componenti di base.

Introduzione introduction

È possibile creare un modulo adattivo basato su un modello di modulo XFA ( *.XDP file). Questo riutilizzo consente di mantenere l’investimento nei moduli XFA esistenti. Per informazioni su come utilizzare un modello di modulo XFA per creare un modulo adattivo, Creare un modulo adattivo basato su un modello.

Puoi riutilizzare i campi del file XDP nel modulo adattivo. Questi campi sono denominati campi associati. Le proprietà dei campi associati (ad esempio script, etichette e formato di visualizzazione) vengono copiate dal file XDP. Puoi anche scegliere di ignorare il valore di alcune di queste proprietà.

AEM Forms consente di mantenere sincronizzati i campi dei moduli adattivi con eventuali modifiche apportate successivamente ai campi corrispondenti nel file XDP. Questo articolo spiega come abilitare questa sincronizzazione.

Nell’ambiente di authoring di AEM Forms, puoi trascinare i campi da un modulo XFA (a sinistra) a un modulo adattivo (a destra)

Prerequisiti prerequisites

Per utilizzare le informazioni contenute in questo articolo, si consiglia di acquisire familiarità con le seguenti aree:

Per utilizzare le risorse fornite per l’esempio di cui all’articolo, scarica il pacchetto di esempio come spiegato nella sezione successiva, Pacchetto di esempio.

Pacchetto di esempio sample-package

L’articolo utilizza un esempio per dimostrare come sincronizzare il modulo adattivo con un modello di modulo XFA aggiornato. Le risorse utilizzate nell’esempio sono disponibili in un pacchetto, che può essere scaricato da Download in questo articolo.

Dopo aver caricato il pacchetto, puoi visualizzare queste risorse nell’interfaccia utente di AEM Forms.

Installa il pacchetto utilizzando Gestione pacchetti: https://<server>:<port>/crx/packmgr/index.jsp

Il pacchetto contiene le seguenti risorse:

Aggiungere contenuto al modulo adattivo add-content-to-adaptive-form-br

Rilevamento delle modifiche nel file XDP detecting-changes-in-xdp-file

Ogni volta che si apportano modifiche a un file XDP o a un frammento, l’interfaccia utente di AEM Forms contrassegna tutti i moduli adattivi basati sul file XDP o sul frammento.

Dopo aver aggiornato un file XDP, devi caricarlo nuovamente nell’interfaccia utente di AEM Forms affinché le modifiche vengano segnalate.

Ad esempio, aggiorniamo il sample-form.xdp esegui i seguenti passaggi:

Se un file XDP viene aggiornato, viene visualizzata un’icona nell’editor quando si modificano i moduli adattivi basati sul file XDP. Questa icona indica che il modulo adattivo non è sincronizzato con il file XDP. Nell’immagine seguente, vedi l’icona accanto nella barra laterale.

Sincronizzazione dei moduli adattivi con il file XDP più recente synchronizing-adaptive-forms-with-the-latest-xdp-file

Quando un modulo adattivo non sincronizzato con il file XDP viene aperto per la creazione la volta successiva, viene visualizzato il seguente messaggio: Lo schema o il modello per il modulo adattivo è stato aggiornato. Click Here per basarlo sulla nuova versione.

Facendo clic sul messaggio, i campi del modulo adattivo vengono sincronizzati con i campi corrispondenti nel file XDP.

Nell’esempio utilizzato in questo articolo, apri sample-xfa-af in modalità authoring. Il messaggio viene visualizzato verso la parte inferiore del modulo adattivo.

Aggiornamento delle proprietà updating-the-properties

Tutte le proprietà copiate dal file XDP nel modulo adattivo vengono aggiornate, ad eccezione di quelle esplicitamente ignorate dall’autore nel modulo adattivo (dalla finestra di dialogo dei componenti). L’elenco delle proprietà aggiornate è disponibile nei registri del server.

Per aggiornare le proprietà nel modulo adattivo di esempio, fai clic sul collegamento (etichettato "Click Here") nel messaggio. Il titolo di TextField1 cambia da Campo di testo a Campo di testo personale.

Aggiunta di nuovi campi dal file XDP al modulo adattivo   adding-new-fields-from-xdp-file-to-adaptive-form-nbsp

Tutti i campi aggiunti successivamente al file XDP originale vengono visualizzati nella scheda Gerarchia modulo e puoi trascinare i nuovi campi nel modulo adattivo.

Non è necessario fare clic sul collegamento nel messaggio di errore per aggiornare i campi nella scheda Gerarchia modulo.

Campi eliminati nel file XDP deleted-fields-in-xdp-file

Se un campo copiato in precedenza in un modulo adattivo viene eliminato da un file XDP, nella modalità di authoring viene visualizzato un messaggio di errore che informa che il campo non esiste nel file XDP. In questi casi, elimina manualmente il campo dal modulo adattivo o cancella il bindRef nella finestra di dialogo del componente.

I passaggi seguenti illustrano questo flusso di utilizzo per le risorse nell’esempio utilizzato in questo articolo:

Anche il campo che è stato eliminato è contrassegnato da un'icona per indicare un errore nel campo.

Download downloads

Pacchetto di contenuti per l’esempio in questo articolo

Ottieni file