Crea e utilizzare frammenti di Forms adattivi in un modulo adattivo basato sui componenti core adaptive-form-fragments

Versione
Collegamento articolo
AEM 6.5
Questo articolo
AEM as a Cloud Service
Fai clic qui

Anche se ogni modulo è progettato per uno scopo specifico, nella maggior parte dei moduli sono presenti alcuni segmenti comuni, ad esempio per fornire dati personali come nome e indirizzo, dettagli sulla famiglia e dettagli sul reddito. Gli sviluppatori di moduli devono creare questi segmenti comuni ogni volta che viene creato un nuovo modulo.

L’Adaptive Forms fornisce un comodo meccanismo per creare segmenti di modulo una sola volta, ad esempio un pannello o un gruppo di campi, e riutilizzarli in Adaptive Forms. Questi segmenti riutilizzabili e autonomi sono denominati frammenti di modulo adattivo.

I frammenti di modulo si integrano perfettamente in più moduli, semplificando la creazione di moduli coerenti e dall’aspetto professionale. I Frammenti di modulo garantiscono riutilizzabilità, standardizzazione e coerenza del brand attraverso la funzionalità “cambia una volta e rifletti ovunque”. Migliora la manutenzione e l’efficienza, poiché gli aggiornamenti apportati in un’unica posizione vengono propagati automaticamente in tutti i moduli che utilizzano questi frammenti.

È possibile aggiungere più volte un frammento a un documento e utilizzare le proprietà di associazione dati dei relativi componenti per collegarlo a diverse origini dati o schemi. Ad esempio, puoi utilizzare lo stesso frammento di indirizzo per un indirizzo permanente, di comunicazione e di fatturazione e collegarlo a campi diversi di un’origine dati o di uno schema.

NOTE
Puoi personalizzare facilmente l’esperienza del frammento per gli utenti con Finestra di dialogo per configurazione e finestra di dialogo per progettazione del componente Frammento di modulo.

Creare un frammento di modulo create-a-fragment

Puoi creare un frammento di modulo adattivo da zero o salvare un pannello in un modulo adattivo esistente come frammento. Per creare un frammento di modulo:

  1. Accedi all’istanza di AEM Forms all’indirizzo https://[nome host]:[porta]/aem/forms.html.

  2. Clic Crea > Frammento modulo adattivo.

  3. Specifica titolo, nome, descrizione e tag per il frammento. Assicurati di specificare un nome univoco per il frammento. Se esiste un altro frammento con lo stesso nome, la sua creazione non riesce.

  4. Selezionare un modello di modulo. Forms Puoi creare un frammento di modulo per Forms adattivo basato su Componenti core o su Componenti di base.

    • Per creare un frammento di modulo per moduli basati su Componenti core, seleziona un modello basato su Componenti core.
    • Per creare un frammento di modulo per moduli basati su Componenti di base, seleziona un modello Componenti di base. Ad esempio, /libs/fd/af/templateForFragment/defaultFragmentTemplate.

    Quando crei un frammento di modulo per moduli basati su Componenti core, utilizza l’opzione Seleziona tema modulo per selezionare un tema basato su Componenti core.

  5. Fai clic per aprire Modello modulo e dalla scheda Seleziona da dal menu a discesa, seleziona uno dei seguenti modelli per il frammento:

    Visualizza il tipo di modello nella scheda Modello modulo

    • 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). Supporta sia frammenti di modulo basati su nessuno che frammenti di modulo basati su schema.
    • Schema: specifica di creare il frammento utilizzando uno schema XML o JSON caricato in AEM Forms. Puoi caricare o selezionare dagli schemi XML o JSON disponibili come modello di modulo per il frammento. Quando selezioni uno schema XML, puoi anche creare un frammento di modulo adattivo selezionando dallo schema un complexType presente nello schema selezionato Tipo complesso dello schema XML a discesa. Quando selezioni uno schema JSON, puoi anche creare un frammento di modulo adattivo selezionando una definizione di schema presente nello schema selezionato da Definizioni schema JSON a discesa.

    • Modello dati modulo: specifica di creare il frammento utilizzando un modello dati del modulo. È possibile creare un frammento di modulo adattivo basato su un solo oggetto modello dati in un modello dati modulo. Espandi il menu a discesa Definizioni modello dati modulo. Elenca tutti gli oggetti modello dati nel modello dati del modulo specificato. Seleziona un oggetto modello dati dall’elenco.

    Modello dati modulo

  6. Fare clic su Crea e quindi su Apri per aprire il frammento, con un modello predefinito, in modalità di modifica. In modalità di modifica, è possibile aggiungere qualsiasi componente modulo adattivo al frammento.

Inoltre, se è stato selezionato uno schema XML o un modello di modulo XDP come modello di modulo per il frammento, nel contenuto Finder verrà visualizzata una nuova scheda che visualizza 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.

Una volta creato il frammento di modulo adattivo basato su uno schema o un modello di dati del modulo, gli elementi del modello di dati del modulo o dello schema vengono visualizzati nella scheda Origini dati del browser Contenuto nell’editor di moduli adattivi. Puoi trascinare gli elementi del modello di modulo sul frammento. Gli elementi del modello modulo aggiunti vengono convertiti in componenti modulo mantenendo le proprietà originali dallo schema associato.

Aggiungere un frammento a un modulo adattivo insert-a-fragment-in-an-adaptive-form

Per aggiungere un frammento di modulo adattivo a un modulo adattivo:

  1. Apri il modulo adattivo in modalità di modifica.

  2. Aggiungi il Frammento di modulo adattivo al modulo.

  3. Fai clic su Risorse browser del contenuto nella barra laterale. Nel browser Risorse, sotto i percorsi, seleziona la Frammenti di moduli adattivi opzione. Vengono visualizzati tutti i frammenti di Forms adattivo disponibili per il modulo, a seconda del modello del modulo.

    seleziona l’opzione Frammenti di modulo adattivi

  4. Trascinare un frammento di modulo adattivo sul Frammento di modulo adattivo nel 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 aggiunto facendo riferimento al modulo adattivo e rimane sincronizzato con il frammento di modulo adattivo autonomo. Ciò implica che qualsiasi modifica apportata al frammento del modulo adattivo si rifletta su tutte le istanze in cui il frammento è incorporato in Adaptive Forms.

Incorporare un frammento in un modulo adattivo embed-a-fragment-in-adaptive-form

Per scegliere di incorporare un frammento di modulo adattivo in un modulo adattivo, fai clic sull'icona Incorpora nella barra degli strumenti del pannello del frammento aggiunto

Il frammento incorporato non è più collegato al frammento autonomo. È possibile modificare i componenti nel frammento incorporato dall'interno del modulo adattivo.

Uso dei frammenti all'interno dei frammenti using-fragments-within-fragments

Puoi creare frammenti di modulo adattivo nidificati, il che significa che puoi trascinare un frammento all’interno di un altro frammento e disporre di una struttura di frammenti nidificata.

Utilizzo di un frammento di modulo più volte in un modulo adattivo using-form-fragment-mutiple-times-in-af

È possibile utilizzare più volte in un modulo adattivo un frammento di modulo basato su schema o senza schemi per salvare i dati in modo univoco per ogni campo di frammenti di modulo. Ad esempio, è possibile utilizzare un frammento del modulo indirizzo per raccogliere i dettagli dell'indirizzo per indirizzi permanenti, di comunicazione e di soggiorno presenti in un modulo di applicazione di prestito.

Uso di più frammenti in un modulo adattivo

Automatico mappatura di 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 automaticamente sostituito 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.

Puoi anche trascinare un frammento di modulo adattivo associato dalla libreria Frammento di modulo adattivo nel Finder di contenuti AEM e fornire il riferimento di associazione corretto dalla finestra di dialogo Modifica componente del pannello Frammento di modulo adattivo.

Gestire i frammenti manage-fragments

Puoi eseguire diverse operazioni sui frammenti di moduli adattivi utilizzando l’interfaccia utente di AEM Forms.

  1. Passa a https://[hostname]/aem/forms.html.

  2. Clic Seleziona nella barra degli strumenti dell’interfaccia utente di 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.

Operazione
Descrizione
Modifica
Apre il frammento di modulo adattivo selezionato in modalità di modifica.
Proprietà
Apre il pannello Proprietà. Dal pannello Proprietà puoi visualizzare e modificare le proprietà, generare un’anteprima e caricare un’immagine in miniatura per il frammento selezionato. Per ulteriori informazioni, consulta Gestione dei metadati.
Copiare
Copia il frammento selezionato. Il pulsante Incolla viene visualizzato nella barra degli strumenti.
Scarica
Scarica il frammento selezionato.
Anteprima
Fornisce opzioni per visualizzare in anteprima il frammento come HTML o come anteprima personalizzata unendo i dati di un file XML con il frammento. Per ulteriori informazioni, consulta Anteprima di un modulo.
Avvia revisione/Gestisci revisione
Consente di avviare e gestire una revisione del frammento selezionato. Per ulteriori informazioni, consulta Creazione e gestione delle revisioni.
Aggiungi dizionario
Genera un dizionario per la localizzazione del frammento selezionato. Per ulteriori informazioni, consulta Localizzazione di Forms adattivi.
Pubblica/Annulla pubblicazione
Pubblica/annulla la pubblicazione del frammento selezionato.
Eliminare
Elimina il frammento selezionato.

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 salvi un pannello come frammento che include un altro frammento XDP, il frammento risultante viene associato automaticamente al frammento XDP secondario. Se utilizzi un modulo adattivo basato su XSD, il frammento risultante sarà associato alla directory principale dello schema.
  • Quando si crea un frammento di modulo adattivo, in CRXDE Liti viene creato un nodo di frammento simile al nodo guideContainer di un modulo adattivo.
  • Un frammento in un modulo adattivo che utilizza un modello di dati del 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 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 per 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 in cui viene distribuito AEM Forms.

Frammenti di riferimento reference-fragments

Fai riferimento ai frammenti di modulo adattivo che è possibile utilizzare per creare il modulo.

Consulta anche see-also

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2