Sincronizzazione di Adaptive Forms con i modelli di moduli XFA

ATTENZIONE

AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.

Introduzione

Puoi creare un modulo adattivo basato su un modello di modulo XFA ( *.XDP file). Questo riutilizzo consente di preservare 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 (come script, etichette e formato di visualizzazione) vengono copiate dal file XDP. È inoltre possibile scegliere di ignorare il valore di alcune di queste proprietà.

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

È possibile trascinare campi da un modulo XFA a un modulo adattivo

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

Prerequisiti

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

Per utilizzare le risorse fornisce l’esempio nell’articolo, scarica il pacchetto di esempio come spiegato nella sezione successiva, Pacchetto di esempio.

Pacchetto di esempio

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 dal Download in questo articolo.

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

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

Il pacchetto contiene le seguenti risorse:

  1. sample-form.xdp: Modello di modulo XFA utilizzato come esempio

  2. sample-xfa-af: Il modulo adattivo basato sul file sample-form.xdp. Questo modulo adattivo, tuttavia, non include alcun campo. Nel passaggio successivo, verrà aggiunto del contenuto a questo modulo adattivo.

Aggiungere contenuto al modulo adattivo

  1. Vai su https://<server>:<port>/aem/forms.html. Immetti le tue credenziali se richiesto.
  2. Apri sample-af-xfa per la modifica in modalità di authoring.
  3. Dal browser Contenuto nella barra laterale, scegliete la scheda Oggetti modello dati . Trascinare NumericField1 e TextField1 nel Modulo adattivo.
  4. Modificare il titolo del campo numerico1 da Campo numerico a Campo numerico AF.
NOTA

Nei passaggi precedenti, abbiamo sovrascritto una proprietà di un campo nel file XDP. Questa proprietà, quindi, non verrà sincronizzata se la proprietà corrispondente nel file XDP viene modificata in seguito.

Rilevamento delle modifiche nel file XDP

Ogni volta che si verificano modifiche in un file XDP o in 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 di nuovo nell’interfaccia utente di AEM Forms per segnalare le modifiche.

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

  1. Passa a https://<server>:<port>/projects.html. Immetti le tue credenziali, se richiesto.

  2. Fai clic sulla scheda Forms a sinistra.

  3. Scarica la sample-form.xdp sul computer locale. Il file XDP viene scaricato come .zip file, che può essere estratto utilizzando qualsiasi utilità di decompressione file.

  4. Apri sample-form.xdp e modificare il titolo del campo TextField1 da Campo di testo a Campo di testo personale.

  5. Carica il sample-form.xdp torna all’interfaccia utente di AEM Forms.

Se un file XDP viene aggiornato, compare un’icona nell’editor quando si modificano i moduli adattivi in base al 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.

Icona per visualizzare che il modulo adattivo non è sincronizzato con il file XDP

Sincronizzazione dei moduli adattivi con il file XDP più recente

Quando un modulo adattivo non sincronizzato con il file XDP viene aperto per la creazione successiva, viene visualizzato il seguente messaggio:
Schema/modello di modulo per il modulo adattivo è stato aggiornato. Click Here per riavviarlo con la nuova versione.

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

Per l'esempio utilizzato in questo articolo, apri sample-xfa-af in modalità authoring. Il messaggio viene visualizzato nella parte inferiore del modulo adattivo.

Messaggio che richiede la sincronizzazione del modulo adattivo con il file XDP

Aggiornamento delle proprietà

Tutte le proprietà copiate dal file XDP al modulo adattivo vengono aggiornate, ad eccezione delle proprietà esplicitamente sostituite nel modulo adattivo (dalla finestra di dialogo Componenti) dall’autore. L’elenco delle proprietà che sono state aggiornate è disponibile nei registri del server.

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

update-property

NOTA

L'etichetta AF Numeric Field non è stata modificata perché hai ignorato questa proprietà dalla finestra di dialogo delle proprietà del componente, come descritto in Aggiungere contenuto ai moduli adattivi.

Aggiunta di nuovi campi dal file XDP al modulo adattivo  

Tutti i campi aggiunti successivamente al file XDP originale vengono visualizzati nella scheda Gerarchia modulo ed è possibile trascinarli 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

Se un campo precedentemente copiato in un modulo adattivo viene eliminato da un file XDP, viene visualizzato un messaggio di errore in modalità di authoring che indica 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:

  1. Aggiorna sample-form.xdp file ed elimina NumericField1.

  2. Carica il sample-form.xdp nell’interfaccia utente di AEM Forms

  3. Apri sample-xfa-af modulo adattivo per l’authoring. Viene visualizzato il seguente messaggio di errore: Schema/modello di modulo per il modulo adattivo è stato aggiornato. Click Here per riavviarlo con la nuova versione.

  4. Fai clic sul collegamento (con l’etichetta " Click Here") nel messaggio. Viene visualizzato un messaggio di errore che segnala che il campo non esiste più nel file XDP.

Errore visualizzato quando si elimina un elemento nel file XDP

Anche il campo eliminato viene contrassegnato con un’icona che indica un errore nel campo.

Icona di errore nel campo

NOTA

Campi del modulo adattivo con binding non corretto (non valido) bindRef nella finestra di dialogo di modifica) sono anche considerati campi eliminati. Se l’autore non corregge questi errori e pubblica il modulo adattivo, il campo viene trattato come un normale campo modulo adattivo non associato e viene incluso nella sezione non associato del file XML di output.

Download

Pacchetto di contenuti per l'esempio in questo articolo

Ottieni file

In questa pagina