Show Menu
ARGOMENTI×

Adaptive form fragments

Sebbene ogni modulo sia progettato per uno scopo specifico, nella maggior parte dei moduli sono presenti alcuni segmenti comuni, ad esempio per fornire dettagli personali come nome e indirizzo, dati 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 come un pannello o un gruppo di campi una sola volta e di riutilizzarli nei moduli adattivi. Questi segmenti riutilizzabili e standalone sono denominati frammenti di modulo adattivi.

Creazione di un frammento

È possibile creare un frammento di modulo adattivo da zero o salvare un pannello in un modulo adattivo esistente come frammento.

Crea frammento da zero

  1. Accedete all'istanza di creazione di AEM Forms all'indirizzo https:// #: #/aem/forms.html.
  2. Click Create > Adaptive Form Fragment .
  3. Specificare titolo, nome, descrizione e tag per il frammento.
    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.
  4. Fare clic per aprire la scheda Modello ​modulo e, dal menu a discesa Seleziona da , selezionare uno dei seguenti modelli per il frammento:
    • Nessuno : Specifica di creare il frammento da zero senza utilizzare alcun modello di modulo.
    • Modello modulo: Specifica se creare il frammento utilizzando un modello XDP caricato in 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 la creazione del frammento utilizzando uno schema XML caricato in AEM Forms. È possibile caricare o selezionare gli schemi XML disponibili come modello di modulo per il frammento.
    È inoltre possibile creare un frammento di modulo adattivo selezionando dall'elenco a discesa un tipo complesso presente nello schema selezionato.
  5. Fare clic su Crea , quindi su Apri per aprire il frammento, con un modello predefinito, in modalità di modifica.
In modalità di modifica, puoi trascinare qualsiasi componente di modulo adattivo dalla barra laterale AEM al frammento. Per informazioni sui componenti per moduli adattivi, vedere Introduzione alla creazione di moduli adattivi.
Inoltre, se si è selezionato uno schema XML o un modello di modulo XDP come modello di modulo per il frammento, in Content Finder viene visualizzata una nuova scheda con la gerarchia del modello di modulo. Consente di trascinare gli elementi del modello di modulo nel 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

  1. Aprire un modulo adattivo contenente il pannello da salvare come frammento di modulo adattivo.
  2. Nella barra degli strumenti del pannello, fare clic su Salva come frammento . Viene visualizzata la finestra di dialogo Salva come frammento.
    Se il pannello che si sta salvando come frammento contiene un pannello secondario, il frammento risultante verrà incluso.
  3. Nella finestra di dialogo Creazione frammenti, specificare le informazioni seguenti:
    • Nome : Nome del frammento. Il valore predefinito è il nome dell’elemento del pannello. È un campo obbligatorio.
      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 corrisponde al titolo del pannello.
    • Descrizione : Descrizione del frammento.
    • Tag : Consente di aggiungere tag ai metadati del frammento.
    • Percorso di destinazione: Percorso dell'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, questo campo visualizza lo schema ​XML, il modello di modulo o Nessuno . Si tratta di un campo non modificabile.
    • Radice modello frammento: Viene visualizzato solo nei moduli adattivi basati su XSD. Specifica il livello principale del modello di frammento. È possibile scegliere / o il tipo complesso XSD dall'elenco 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 si sceglie / come radice del modello di frammento, l'intera struttura XSD della radice è visibile nella scheda del modello di dati del modulo adattivo. Per un modello principale di frammento di tipo complesso, solo i discendenti del tipo complesso selezionato sono visibili nella scheda del modello di dati del modulo adattivo.
    • XSD Ref : 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. Viene visualizzata la posizione del modello di modulo XDP.
    Figura: Salva come frammento, finestra di dialogo
  4. Fai clic su OK .
    Il pannello viene salvato nella posizione specificata o predefinita nella directory 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, fare clic su Modifica risorsa nella barra degli strumenti del pannello. Il frammento viene aperto in una nuova scheda o in una nuova finestra in modalità di modifica.

Uso dei frammenti

Configurare l’aspetto del frammento

I frammenti inseriti nei moduli adattivi vengono visualizzati come immagine segnaposto. Il segnaposto visualizza i titoli fino a un massimo di dieci pannelli secondari nel frammento. È possibile configurare AEM Forms per visualizzare l'intero frammento invece dell'immagine segnaposto.
Per visualizzare frammenti completi nei moduli, effettuare le seguenti operazioni:
  1. Andate alla pagina di configurazione della console Web AEM in https: #: #/system/console/configMgr.
  2. Cercare e fare clic su Servizio configurazione modulo adattivo per aprirlo in modalità di modifica.
  3. Per visualizzare frammenti completi anziché l’immagine segnaposto, disattivate la casella di controllo Abilita segnaposto al posto del frammento .

Inserire un frammento in un modulo adattivo

I frammenti di modulo adattivo creati vengono visualizzati nella scheda Frammenti modulo adattivi di Content Finder di AEM. Per inserire un frammento di modulo adattivo in un modulo adattivo:
  1. Aprire il modulo adattivo in modalità di modifica in cui si desidera inserire un frammento di modulo adattivo.
  2. Fate clic su Risorse - browser risorse nella barra laterale. Nel browser delle risorse, selezionate Frammenti modulo adattivi dal menu a discesa.
    È inoltre possibile scegliere di visualizzare tutti i frammenti di modulo adattivi o i filtri in base al modello di modulo, ovvero Modello di modulo, Schema XML o Base.
  3. Trascinare un frammento di modulo adattivo sul modulo adattivo.
    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 viceversa.
Il frammento di modulo adattivo viene inserito mediante riferimento nel modulo adattivo e sincronizzato con il frammento di modulo adattivo indipendente. Ciò significa che, quando si aggiorna il frammento di modulo adattivo, le modifiche vengono applicate a tutti i moduli adattivi in cui è utilizzato il frammento.

Incorporare un frammento in un modulo adattivo

Per incorporare un frammento di modulo adattivo in un modulo adattivo, fare clic su Incorpora risorsa:*il pulsante fragmentName * ​sulla barra degli strumenti del pannello del frammento aggiunto, come illustrato nell'immagine di esempio seguente.
Il frammento incorporato non è più collegato al frammento standalone. È possibile modificare i componenti del frammento incorporato direttamente dal modulo adattivo.

Uso dei frammenti all'interno dei frammenti

È possibile creare frammenti di modulo adattivo nidificati, il che significa che è possibile trascinare un frammento in un altro frammento e che è possibile utilizzare una struttura di frammenti nidificata.

Modificare i frammenti

Per sostituire o modificare un frammento di modulo adattivo con un altro frammento, è possibile utilizzare la proprietà 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

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 automaticamente sostituito dal frammento di modulo adattivo corrispondente il cui livello principale del modello di frammento viene mappato sul frammento XFA o sul tipo complesso XSD.
È possibile modificare la risorsa del frammento e i relativi binding dalla finestra di dialogo Modifica componente.
È inoltre possibile trascinare un frammento di modulo adattivo associato dalla libreria frammenti di modulo adattivi in Content Finder di AEM e fornire il riferimento di binding corretto dalla finestra di dialogo Modifica componente del pannello frammento di modulo adattivo.

Gestione dei frammenti

È possibile eseguire diverse operazioni sui frammenti di modulo adattivo utilizzando l'interfaccia utente di AEM Forms.
  1. Passa a https://[hostname]:[port]/aem/forms.html .
  2. Fate clic su Seleziona nella barra degli strumenti dell'interfaccia utente di AEM Forms e selezionate un frammento di modulo adattivo. Nella barra degli strumenti sono visualizzate le operazioni seguenti che è possibile eseguire sul frammento di modulo adattivo selezionato.
Operazione
Descrizione
Apri
Apre il frammento di modulo adattivo selezionato in modalità di modifica.
Visualizza proprietà
Apre il pannello Proprietà. Dal pannello Proprietà è possibile visualizzare e modificare le proprietà, generare un'anteprima e caricare una miniatura per il frammento selezionato. For more information, see Managing metadata .
Copia
Copia il frammento selezionato. Il pulsante Incolla viene visualizzato nella barra degli strumenti.
Scarica
Scarica il frammento selezionato.
Anteprima
Fornisce opzioni per visualizzare l'anteprima del frammento come HTML o anteprima personalizzata unendo i dati di un file XML con il frammento. Per ulteriori informazioni, vedere Anteprima di un modulo .
Avvia revisione/Gestisci revisione
Consente di avviare e gestire una revisione del frammento selezionato. Per ulteriori informazioni, consultate Creazione e gestione di revisioni .
Crea dizionario
Genera un dizionario per la localizzazione del frammento selezionato. Per ulteriori informazioni, vedere Localizzazione dei moduli adattivi.
Pubblicare/Annullare la pubblicazione
Pubblica/annulla la pubblicazione del frammento selezionato.
Elimina
Elimina il frammento selezionato.

Localizzazione di moduli adattivi contenenti frammenti

Per localizzare un modulo adattivo contenente frammenti di modulo adattivi, è necessario localizzare separatamente il frammento e il modulo. È consigliabile localizzare un frammento una volta e riutilizzarlo in più moduli adattivi.
Le chiavi di localizzazione nel frammento non vengono visualizzate nel file XLIFF di un modulo adattivo.

Punti chiave da ricordare durante l'uso dei frammenti

  • Assicurarsi che il nome del frammento sia univoco. Se è presente un frammento con lo stesso nome, la creazione del frammento non riesce.
  • In un modulo adattivo basato su XDP, se si salva 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 al livello principale dello schema.
  • Quando si crea un frammento di modulo adattivo, in CRXDe Lite viene creato un nodo di frammento simile al nodo guideContainer per un modulo adattivo.
  • 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 di AEM.
  • Qualsiasi espressione, script o stile in un frammento di modulo adattivo indipendente viene mantenuto se inserito mediante riferimento o incorporato in un modulo adattivo.
  • Non è possibile modificare un frammento di modulo adattivo, inserito mediante riferimento, direttamente da un modulo adattivo. Per apportare le modifiche, è possibile modificare il frammento di modulo adattivo autonomo oppure incorporarlo nel modulo adattivo.
  • Quando si pubblica un modulo adattivo, è necessario pubblicare i frammenti di modulo adattivo standalone inseriti mediante un riferimento nel modulo adattivo.
  • Quando si ripubblica un frammento di modulo adattivo aggiornato, le modifiche vengono riportate nelle istanze pubblicate del modulo adattivo in cui è 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 per 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 è distribuito AEM Forms.

Frammenti di riferimento

Sono disponibili riferimenti a frammenti di modulo adattivo utilizzabili per creare il modulo. For more information, see Reference Fragments .