Frammenti di moduli adattivi adaptive-form-fragments
Sebbene ogni modulo sia progettato per uno scopo specifico, la maggior parte dei moduli contiene alcuni segmenti comuni, ad esempio per fornire dati personali come nome e indirizzo, dettagli sulla famiglia, dettagli sul reddito e così via. Gli sviluppatori di moduli devono creare questi segmenti comuni ogni volta che viene creato un nuovo modulo.
I moduli adattivi consentono di creare segmenti di modulo una sola volta, ad esempio un pannello o un gruppo di campi, e di riutilizzarli nei moduli adattivi. Questi segmenti riutilizzabili e autonomi sono denominati frammenti di modulo adattivi.
Creare un frammento create-a-fragment
È possibile creare un frammento di modulo adattivo da zero o salvare un pannello in un modulo adattivo esistente come frammento.
Crea frammento da zero create-fragment-from-scratch
-
Accedi all’istanza di authoring di AEM Forms all’indirizzo https://[hostname]:[porta]/aem/forms.html.
-
Fai clic su Crea > Frammento di modulo adattivo.
-
Specifica titolo, nome, descrizione e tag per il frammento.
note note NOTE Assicurarsi di specificare un nome univoco per il frammento. Se esiste già un altro frammento con lo stesso nome, la creazione del frammento non riesce. -
Fai clic per aprire Modello Modulo e dalla scheda Seleziona da menu a discesa, selezionare uno dei seguenti modelli per il frammento:
- Nessuno: Specifica di creare il frammento da zero senza utilizzare alcun modello di modulo.
- Modello di modulo: Specifica di creare il frammento utilizzando un modello XDP caricato su AEM Forms. Selezionare il modello XDP appropriato come modello di modulo per il frammento.
Vengono visualizzati anche i sottomoduli contrassegnati come frammenti nel modello di modulo selezionato. È possibile selezionare un sottomodulo per un frammento di modulo adattivo dall’elenco a discesa.
Inoltre, è possibile creare un frammento di modulo adattivo utilizzando sottomoduli non contrassegnati come frammenti nel modello di modulo specificando l’espressione SOM per il sottomodulo nella casella a discesa.
- Schema XML: Specifica di creare il frammento utilizzando uno schema XML caricato in AEM Forms. È possibile caricare o selezionare dagli schemi XML disponibili come modello di modulo per il frammento.
È inoltre possibile creare un frammento di modulo adattivo selezionando un tipo complesso presente nello schema selezionato dalla casella a discesa.
-
Fai clic su Crea quindi fai clic su Apri per aprire il frammento, con un modello predefinito, in modalità di modifica.
In modalità di modifica, puoi trascinare nel frammento qualsiasi componente del modulo adattivo dalla barra laterale AEM. Per informazioni sui componenti per moduli adattivi, consulta Introduzione alla creazione di moduli adattivi.
Inoltre, se come modello di modulo per il frammento è stato selezionato uno schema XML o un modello di modulo XDP, in Content Finder verrà visualizzata una nuova scheda con la gerarchia del modello di modulo. Consente di trascinare elementi del modello di modulo sul frammento. Gli elementi aggiunti al modello di modulo vengono convertiti in componenti modulo mantenendo le proprietà originali dell'XDP o XSD associato.
Salva pannello come frammento save-panel-as-a-fragment
-
Apri un modulo adattivo che contiene il pannello da salvare come frammento di modulo adattivo.
-
Nella barra degli strumenti del pannello, fai clic su Salva come frammento. Viene visualizzata la finestra di dialogo Salva con nome frammento.
note note NOTE Se il pannello che si sta salvando come frammento contiene un pannello secondario, il frammento risultante li includerà. -
Nella finestra di dialogo Creazione frammento specificare le informazioni seguenti:
-
Nome: Nome del frammento. Il valore predefinito è il nome dell’elemento del pannello. È un campo obbligatorio.
note note NOTE Assicurarsi di specificare un nome univoco per il frammento. Se esiste già un altro frammento con lo stesso nome, la creazione del frammento non riesce. -
Titolo: Titolo del frammento. Il valore predefinito è il titolo del pannello.
-
Descrizione: Descrizione del frammento.
-
Tag: Assegna tag ai metadati del frammento.
-
Percorso di Target: Percorso archivio in cui verrà salvato il frammento. Se non si specifica un percorso, accanto al nodo contenente il modulo adattivo viene creato un nodo con lo stesso nome del frammento. Il frammento viene salvato in questo nodo.
-
Modello Modulo: A seconda del modello di modulo per il modulo adattivo, in questo campo viene visualizzato il campo Schema XML, Modello di modulo oppure Nessuno. Si tratta di un campo non modificabile.
-
Radice modello frammento: Viene visualizzato solo nei moduli adattivi basati su XSD. Specifica la radice del modello di frammento. Puoi scegliere / o il tipo complesso XSD dal menu a discesa. È possibile riutilizzare il frammento in un altro modulo adattivo solo se si seleziona il tipo complesso come radice del modello di frammento.
Se scegli / come radice del modello di frammento, la struttura XSD completa dalla radice è visibile nella scheda del modello dati del modulo adattivo. Per una radice del modello di frammento di tipo complesso, solo i discendenti del tipo complesso selezionato sono visibili nella scheda del modello di dati del modulo adattivo.
-
Rif. XSD: Viene visualizzato solo nei moduli adattivi basati su XSD. Visualizza la posizione dello schema XML.
-
Rif. XDP: Viene visualizzato solo nei moduli adattivi basati su XDP. Visualizza la posizione del modello di modulo XDP.
Figura: Finestra di dialogo Salva come frammento -
-
Fai clic su OK.
Il pannello viene salvato nel percorso specificato o predefinito nella directory archivio. Nel modulo adattivo, il pannello è sostituito da un’istantanea del frammento. Come illustrato di seguito, il pannello Informazioni generali e i relativi pannelli secondari, Informazioni personali e Indirizzo, vengono salvati come frammento.
Per modificare il frammento, fai clic su Modifica risorsa nella barra degli strumenti del pannello. Il frammento viene aperto in una nuova scheda o finestra in modalità di modifica.
Uso dei frammenti working-with-fragments
Configurare l’aspetto del frammento configure-fragment-appearance
Qualsiasi frammento inserito nei moduli adattivi viene visualizzato come immagine segnaposto. Nel frammento viene visualizzato un massimo di dieci pannelli secondari. È possibile configurare AEM Forms per mostrare il frammento completo invece dell’immagine segnaposto.
Per visualizzare frammenti completi nei moduli, effettua le seguenti operazioni:
- Vai AEM pagina di configurazione della console Web all'indirizzo https:[host]:[porta]/system/console/configMgr.
- Cerca e fai clic su Configurazione del canale web per moduli adattivi e comunicazioni interattive per aprirlo in modalità di modifica.
- Disattiva Abilita segnaposto al posto del frammento per mostrare frammenti completi anziché l’immagine segnaposto.
Inserire un frammento in un modulo adattivo insert-a-fragment-in-an-adaptive-form
I frammenti di modulo adattivo creati vengono visualizzati nella scheda Frammenti modulo adattivi di Content Finder AEM. Per inserire un frammento di modulo adattivo in un modulo adattivo:
-
Apri il modulo adattivo in modalità di modifica in cui desideri inserire un frammento di modulo adattivo.
-
Fai clic su Risorse nella barra laterale. Nel browser Risorse, seleziona Frammenti modulo adattivi dal menu a discesa.
È inoltre possibile scegliere di visualizzare tutti i frammenti di modulo adattivi o i filtri in base al relativo modello di modulo: Modello di modulo, Schema XML o Base.
-
Trascina un frammento di modulo adattivo nel modulo adattivo.
note note NOTE Il frammento di modulo adattivo non è abilitato per la creazione dall’interno del modulo adattivo. Inoltre, non è possibile utilizzare un frammento basato su XSD in un modulo adattivo basato su JSON e in modo opposto.
Il frammento di modulo adattivo viene inserito tramite riferimento nel modulo adattivo e sincronizzato con il frammento di modulo adattivo autonomo. Significa che quando si aggiorna il frammento di modulo adattivo, le modifiche si riflettono in tutti i moduli adattivi in cui viene utilizzato il frammento.
Incorporare un frammento in un modulo adattivo embed-a-fragment-in-adaptive-form
Per incorporare un frammento di modulo adattivo in un modulo adattivo, fai clic su **Incorpora risorsa: *fragmentName ***nella barra degli strumenti del pannello del frammento aggiunto, come illustrato nell’immagine di esempio seguente.
Uso dei frammenti all’interno dei frammenti using-fragments-within-fragments
È possibile creare frammenti di modulo adattivo nidificato, ovvero trascinare un frammento in un altro frammento e creare una struttura di frammento nidificata.
Modificare i frammenti change-fragments
È possibile sostituire o modificare un frammento di modulo adattivo con un altro frammento utilizzando la Seleziona risorsa frammento nella finestra di dialogo Modifica componente per un pannello frammento di modulo adattivo.
Mappatura automatica dei frammenti per il binding dei dati auto-mapping-of-fragments-for-data-binding
Quando si crea un frammento di modulo adattivo utilizzando un modello di modulo XFA o un tipo complesso XSD e si trascina il frammento in un modulo adattivo, il frammento XFA o il tipo complesso XSD viene sostituito automaticamente dal frammento di modulo adattivo corrispondente la cui radice del modello di frammento è mappata al frammento XFA o al tipo complesso XSD.
Puoi modificare la risorsa frammento e i relativi binding dalla finestra di dialogo Modifica componente.
Gestire i frammenti manage-fragments
È possibile eseguire diverse operazioni sui frammenti di modulo adattivi utilizzando l’interfaccia utente di AEM Forms.
-
Passa a
https://[hostname]:[port]/aem/forms.html
. -
Fai clic su Seleziona nella barra degli strumenti dell’interfaccia utente di AEM Forms e seleziona un frammento di modulo adattivo. Nella barra degli strumenti sono visualizzate le operazioni seguenti che è possibile eseguire sul frammento di modulo adattivo selezionato.
Localizzazione di moduli adattivi contenenti frammenti localizing-adaptive-form-containing-fragments
Per localizzare un modulo adattivo che contiene frammenti di modulo adattivo, è necessario localizzare separatamente il frammento e il modulo. L’idea è quella di localizzare un frammento una volta e riutilizzarlo in più moduli adattivi.
Punti chiave da ricordare durante l’utilizzo dei frammenti key-points-to-remember-when-working-with-fragments
-
Assicurati che il nome del frammento sia univoco. Se esiste un frammento esistente con lo stesso nome, la creazione del frammento non riesce.
-
In un modulo adattivo basato su XDP, se salvi un pannello come frammento che include un altro frammento XDP, il frammento risultante verrà automaticamente associato al frammento XDP secondario. Nel caso di un modulo adattivo basato su XSD, il frammento risultante sarà associato alla radice dello schema.
-
Quando si crea un frammento di modulo adattivo, viene creato un nodo di frammento, simile al nodo guideContainer per un modulo adattivo, in CRXDe Lite.
-
Un frammento in un modulo adattivo che utilizza un modello dati modulo diverso non è supportato. Ad esempio, un frammento basato su XDP non è supportato in un modulo adattivo basato su XSD e viceversa.
-
I frammenti di modulo adattivo sono disponibili per l’uso tramite la scheda Frammenti modulo adattivi in Content Finder AEM.
-
Qualsiasi espressione, script o stile in un frammento di modulo adattivo autonomo viene mantenuto se inserito tramite riferimento o incorporato in un modulo adattivo.
-
Non è possibile modificare un frammento di modulo adattivo, inserito mediante riferimento, direttamente da un modulo adattivo. Per modificare, è necessario modificare il frammento di modulo adattivo autonomo o incorporarlo nel modulo adattivo.
-
Quando si pubblica un modulo adattivo, è necessario pubblicare i frammenti di modulo adattivo autonomo inseriti mediante riferimento nel modulo adattivo.
-
Quando si ripubblica un frammento di modulo adattivo aggiornato, le modifiche si riflettono nelle istanze pubblicate del modulo adattivo in cui viene utilizzato il frammento.
-
Il modulo adattivo contenente il componente Verifica non supporta gli utenti anonimi. Inoltre, si sconsiglia di utilizzare il componente Verifica in un frammento di modulo adattivo.
-
(Solo Mac) Per garantire che la funzionalità dei frammenti di modulo funzioni perfettamente in tutti gli scenari, aggiungere la seguente voce al file /private/etc/hosts:
127.0.0.1 <Host machine>
Macchina host: Il computer Apple Mac su cui viene distribuito AEM Forms.
Frammenti di riferimento reference-fragments
Sono disponibili frammenti di modulo adattivo di riferimento utilizzabili per creare il modulo. Per ulteriori informazioni, consulta Frammenti di riferimento.