Creare e utilizzare frammenti di Forms adattivi in un modulo adattivo adaptive-form-fragments
Sebbene ogni modulo sia progettato per uno scopo specifico, nella maggior parte dei moduli sono presenti alcuni segmenti comuni, ad esempio fornire dettagli personali like nome e indirizzo, familiari, dettagli sul reddito e così via. Gli sviluppatori di moduli devono creare questi segmenti comuni ogni volta che viene creato un nuovo modulo. L'Forms adattivo offre un pratico meccanismo per creare un segmento del modulo like un pannello o un gruppo di campi una sola volta e riutilizzarli in Forms adattivi. Questi segmenti riutilizzabili e autonomi sono denominati Frammenti di modulo adattivi.
Creare un frammento create-a-fragment
Puoi 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 AEM Forms dell'autore all'indirizzo https://[hostname]:[porta]/aem/forms.html.
-
Fare clic su Crea > frammento di modulo adattivo.
-
Specifica titolo, nome, descrizione e tag per il frammento.
note note NOTE Assicurati 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 la scheda Modello modulo e dal menu a discesa Seleziona da seleziona uno dei seguenti modelli per il frammento:
-
Nessuno: specifica di creare il frammento da zero senza utilizzare alcun modello di modulo.
note note NOTE In Adaptive Forms puoi utilizzare più volte un singolo frammento di modulo (basato su Componenti core) all’interno di un modulo. Supporta sia frammenti di modulo basati su nessuno che frammenti di modulo basati su schema. -
Modello modulo: specifica di creare il frammento utilizzando un modello XDP caricato in AEM Forms. Seleziona il modello XDP appropriato come modello di modulo per il frammento.
Vengono visualizzati anche i sottomoduli contrassegnati come frammenti nel modello di modulo selezionato. Puoi selezionare un modulo secondario per 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. Puoi caricare o selezionare dagli schemi XML disponibili come modello di modulo per il frammento.
Puoi anche creare un frammento di modulo adattivo selezionando dalla casella a discesa un complexType presente nello schema selezionato.
-
-
Fai clic su Crea, quindi su Apri per aprire il frammento, con un modello predefinito, in modalità di modifica.
In modalità di modifica puoi trascinare e rilasciare qualsiasi componente Modulo adattivo dalla barra laterale AEM sul frammento.
Inoltre, se hai selezionato uno schema XML o un modello di modulo XDP come modello di modulo per il frammento, nel Finder contenuto viene visualizzata una nuova scheda che mostra la gerarchia del modello di modulo. Consente di trascinare gli elementi del modello di modulo sul frammento. Gli elementi del modello modulo aggiunti vengono convertiti in componenti modulo mantenendo le proprietà originali dell’XDP o XSD associato.
Salvare il pannello come frammento save-panel-as-a-fragment
-
Apri un modulo adattivo contenente 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 come frammento (Save As Fragment).
note note NOTE Se il pannello che stai salvando come frammento contiene un pannello figlio, il frammento risultante li includerà. -
Nella finestra di dialogo Creazione frammento, specifica le seguenti informazioni:
-
Nome: nome del frammento. Il valore predefinito è il nome dell’elemento del pannello. È un campo obbligatorio.
note note NOTE Assicurati 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: metadati dei tag per il frammento.
-
Percorso di destinazione: percorso dell'archivio in cui viene salvato il frammento. Se non specifichi un percorso, viene creato un nodo con lo stesso nome del frammento accanto al nodo contenente il modulo adattivo. Il frammento viene salvato in questo nodo.
-
Modello modulo: a seconda del modello del modulo adattivo, in questo campo viene visualizzato Schema XML, Modello modulo o Nessuno. È un campo non modificabile.
-
Radice modello frammento: viene visualizzata solo in Adaptive Forms basato su XSD. Specifica la directory principale del modello per frammenti. È possibile scegliere / o il tipo complesso XSD dal menu a discesa. È possibile riutilizzare il frammento in un altro modulo adattivo solo selezionando il tipo complesso come radice del modello di frammento.
Se si sceglie / come radice del modello di frammento, la struttura XSD completa dalla radice è visibile nella scheda Modello dati modulo adattivo. Per un elemento principale del modello di frammento di tipo complesso, nella scheda Modello dati modulo adattivo sono visibili solo i discendenti del tipo complesso selezionato. -
Rif. XSD: viene visualizzato solo nel Forms adattivo basato su XSD. Viene visualizzata la posizione dello schema XML.
-
Rif. XDP: viene visualizzato solo in Adaptive Forms basato su XDP. Viene visualizzata la posizione del modello di modulo XDP.
Finestra di dialogo Salva come frammento
-
-
Fai clic su OK.
Il pannello viene salvato nella posizione specificata o predefinita nell’archivio. Nel modulo adattivo, il pannello viene sostituito da un’istantanea del frammento. Come mostrato 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.
Utilizzo dei frammenti working-with-fragments
Configurare l'aspetto del frammento configure-fragment-appearance
Qualsiasi frammento inserito in Adaptive Forms viene visualizzato come immagine segnaposto. Nel segnaposto vengono visualizzati titoli fino a un massimo di dieci pannelli secondari nel frammento. È possibile configurare AEM Forms per visualizzare il frammento completo anziché l'immagine segnaposto.
Per visualizzare i frammenti completi nei moduli, effettua le seguenti operazioni:
-
Vai alla pagina di configurazione della console Web AEM all'indirizzo https:[host]:[porta]/system/console/configMgr.
-
Cerca e fai clic su Servizio configurazione modulo adattivo per aprirlo in modalità di modifica.
-
Disabilita la casella di controllo Abilita segnaposto al posto della casella di controllo Frammento per visualizzare frammenti completi anziché l'immagine segnaposto.
Inserire un frammento in un modulo adattivo insert-a-fragment-in-an-adaptive-form
I frammenti di moduli adattivi creati vengono visualizzati nella scheda Frammenti di moduli adattivi di AEM contenuto Finder. Per inserire un frammento di modulo adattivo in un modulo adattivo:
-
Aprite il modulo adattivo, in modalità di modifica, in cui desiderate inserire un frammento di modulo adattivo.
-
Fai clic su Assets
È inoltre possibile scegliere di visualizzare tutti i frammenti di modulo adattivi o di filtrare in base al modello di modulo, ovvero Modello di modulo, Schema XML o Base.
-
Trascina un frammento di modulo adattivo sul modulo adattivo.
note note NOTE Il frammento di modulo adattivo non è abilitato per l’authoring dall’interno del modulo adattivo. Inoltre, non è possibile utilizzare un frammento basato su XSD in un modulo adattivo basato su JSON e viceversa.
Il frammento di modulo adattivo viene inserito per riferimento nel modulo adattivo e sincronizzato con il frammento di modulo adattivo indipendente. Ciò significa che quando aggiorni il frammento di modulo adattivo, le modifiche si riflettono in tutti i Forms 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 sul pulsante Incorpora risorsa: <fragmentName> nella barra degli strumenti del pannello del frammento aggiunto, come illustrato nell’immagine di esempio seguente.
Utilizzo di frammenti all’interno di frammenti using-fragments-within-fragments
È possibile creare frammenti di moduli adattivi nidificati, ovvero trascinare un frammento all’interno di un altro frammento e creare una struttura di frammenti nidificata.
Modifica frammenti change-fragments
È possibile sostituire o modificare un frammento di modulo adattivo con un altro frammento utilizzando la proprietà Seleziona risorsa frammento nella finestra di dialogo Modifica componente per un pannello Frammento di modulo adattivo.
Utilizzo di un frammento di modulo più volte in un modulo adattivo using-form-fragment-mutiple-times-in-af
È possibile utilizzare più volte un frammento di modulo basato su schema in un modulo adattivo per salvare i dati in modo univoco per ogni campo del frammento di modulo. Ad esempio, puoi utilizzare un frammento di modulo indirizzo per raccogliere i dettagli dell’indirizzo per indirizzi permanenti, di comunicazione e di presentazione in un modulo di richiesta di prestito.
Mappatura automatica dei frammenti per l’associazione dati auto-mapping-of-fragments-for-data-binding
Quando crei un frammento di modulo adattivo utilizzando un modello di modulo XFA o un tipo complesso XSD e trascini 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 del frammento e i relativi binding dalla finestra di dialogo Modifica componente.
Gestire i frammenti manage-fragments
È possibile eseguire diverse operazioni sui frammenti di moduli adattivi utilizzando l'interfaccia utente AEM Forms.
-
Passa a
https://[hostname]:'port'/aem/forms.html. -
Fai clic su Seleziona nella barra degli strumenti dell'interfaccia utente AEM Forms e seleziona un frammento di modulo adattivo. La barra degli strumenti mostra le seguenti operazioni che è possibile eseguire sul frammento di modulo adattivo selezionato.
Localizzazione di un modulo adattivo contenente frammenti localizing-adaptive-form-containing-fragments
Per localizzare un modulo adattivo contenente 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ù Forms adattivi.
Punti chiave da ricordare quando si lavora con i frammenti key-points-to-remember-when-working-with-fragments
- Assicurati che il nome del frammento sia univoco. Il frammento non viene creato se è presente un frammento con lo stesso nome.
- In un modulo adattivo basato su XDP, se si salva un pannello come frammento che include un altro frammento XDP, il frammento risultante viene automaticamente associato al frammento XDP figlio. Nel caso di un modulo adattivo basato su XSD, il frammento risultante è associato alla directory principale dello schema.
- Quando si crea un frammento di modulo adattivo, viene creato un nodo di frammento, che è simile al nodo guideContainer per un modulo adattivo, in CRXDe Lite.
- Un frammento in un modulo adattivo che utilizza un FDM (Form Data Model) diverso non è supportato. Ad esempio, un frammento basato su XDP non è supportato in un modulo adattivo basato su XSD e viceversa.
- I Frammenti di moduli adattivi sono disponibili per l’utilizzo tramite la scheda Frammenti di moduli adattivi nel Finder di contenuti AEM.
- Qualsiasi espressione, script o stile in un frammento di modulo adattivo autonomo viene mantenuto quando viene inserito tramite riferimento o incorporato in un modulo adattivo.
- Non è possibile modificare un frammento di modulo adattivo, inserito per riferimento, dall’interno di un modulo adattivo. Per apportare modifiche, puoi modificare il frammento di modulo adattivo autonomo o incorporarlo nel modulo adattivo.
- Quando pubblichi un modulo adattivo, devi pubblicare i frammenti di modulo adattivo autonomi inseriti per riferimento nel modulo adattivo.
- Quando ripubblichi 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, non è consigliabile 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>Computer host: il computer Apple Mac su cui AEM Forms viene distribuito.