Frammenti di moduli adattivi

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 'istanza di creazione AEM Forms all'indirizzo https://[hostname]:[port]/aem/forms.html.

  2. Fare clic su Crea > Frammento modulo adattivo.

  3. Specificare titolo, nome, descrizione e tag per il frammento.

    NOTA

    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 su AEM Forms. Selezionare il modello XDP appropriato come modello di modulo per il frammento.

    Creazione di un modulo adattivo utilizzando il modello di modulo come modello

    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.

    Selezionare sottomoduli dal modello di modulo specificato

    È 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.

    Creare un frammento di modulo adattivo basato su uno schema XML come modello

    È inoltre possibile creare un frammento di modulo adattivo selezionando dall'elenco a discesa un tipo complesso presente nello schema selezionato.

    Selezionare un tipo complesso dal modello di schema XML specificato

  5. Fare clic su Crea, quindi su Apri per aprire il frammento, con un modello predefinito, in modalità di modifica.

In modalità di modifica, è possibile 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 il 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.

    NOTA

    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.

      NOTA

      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. Dal menu a discesa potete scegliere / o il tipo complesso XSD. È 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, la struttura XSD completa dal livello principale è 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.

    save-fragment
    Figura:finestra di dialogo Salva come frammento

  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.

    Modifica di un frammento

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 AEM pagina di configurazione della console Web all'indirizzo https:[host]:[port]/system/console/configMgr.
  2. Cercare e fare clic su Servizio configurazione modulo adattivo per aprirlo in modalità di modifica.
  3. Per visualizzare i 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 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 risorse-browser nella barra laterale. Nel browser delle risorse, selezionate Frammenti modulo adattivo dall'elenco 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.

    NOTA

    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

È possibile scegliere di incorporare un frammento di modulo adattivo in un modulo adattivo facendo clic su **Incorpora risorsa: Pulsante *fragmentName ***​nella barra degli strumenti del pannello del frammento aggiunto, come illustrato nell'immagine seguente.

Incorporare un frammento di modulo in un modulo adattivo

NOTA

Il frammento incorporato non è più collegato al frammento standalone. È possibile modificare i componenti del frammento incorporato direttamente dal modulo adattivo.

Uso di 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

È 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.

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.

NOTA

È inoltre possibile trascinare un frammento di modulo adattivo associato dalla libreria frammenti di modulo adattivi in AEM Content Finder e fornire il riferimento di binding corretto dalla finestra di dialogo Modifica componente del pannello frammento di modulo adattivo.

Gestire i 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. Fare clic su Seleziona nella barra degli strumenti interfaccia utente di AEM Forms e selezionare 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. Per ulteriori informazioni, vedere Gestione dei metadati.

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, vedere Creazione e gestione di revisioni.

Crea dizionario

Genera un dizionario per la localizzazione del frammento selezionato. Per ulteriori informazioni, vedere Localizzazione di 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.

NOTA

Le chiavi di localizzazione nel frammento non vengono visualizzate nel file XLIFF di un modulo adattivo.

Punti chiave da ricordare durante l'utilizzo 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 mediante la scheda Frammenti modulo adattivi in AEM Content Finder.

  • 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 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 è distribuito.

Frammenti di riferimento

Sono disponibili riferimenti a frammenti di modulo adattivo utilizzabili per creare il modulo. Per ulteriori informazioni, vedere Frammenti di riferimento.

In questa pagina