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

Versione
Collegamento articolo
AEM as a Cloud Service (Componenti core)
Questo articolo
AEM as a Cloud Service (Componenti di base)
Fai clic qui
AEM 6.5
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 la finestra di dialogo per configurazione e finestra di dialogo per progettazione del componente Frammento di modulo.

Creare un frammento di modulo adattivo 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://[hostname]:[port]/aem/forms.html.

  2. Fai clic su Crea > Frammento modulo adattivo.

    Crea frammento di 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.

    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 la scheda Modello modulo e dal menu a discesa Seleziona da 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 si seleziona uno schema XML, è inoltre possibile creare un frammento di modulo adattivo selezionando un complexType presente nello schema selezionato dalla casella a discesa Tipo complesso dello schema XML. Quando selezioni uno schema JSON, puoi anche creare un frammento di modulo adattivo selezionando una definizione di schema presente nello schema selezionato dalla casella a discesa Definizioni schema JSON.

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

    Modello dati modulo (FDM)

  6. Fai clic su Crea, quindi su Apri per aprire il frammento, con un modello predefinito, in modalità di modifica. In modalità di modifica puoi aggiungere qualsiasi componente Modulo adattivo al frammento.

Una volta creato il frammento di modulo adattivo basato su uno schema o un modello di dati del modulo (FDM), gli elementi del modello di dati del modulo (FDM) 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 al modulo il componente Frammento modulo adattivo.

  3. Apri la finestra di dialogo Configurazione del componente Frammento di modulo adattivo.

  4. Selezionare il Riferimento frammento nella scheda Base. Vengono visualizzati tutti i frammenti di Forms adattivo disponibili per il modulo, a seconda del modello del modulo.

  5. Seleziona un frammento di modulo adattivo nel componente Frammento di modulo adattivo del modulo adattivo.

    seleziona lopzione Frammenti di modulo adattivi

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.

Utilizzo di frammenti all’interno di frammenti using-fragments-within-fragments

Puoi creare frammenti di modulo adattivo nidificati, il che significa che puoi aggiungere un frammento in un altro frammento e avere 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 un frammento di modulo basato su schema e non basato su elementi singoli in un modulo adattivo per salvare i dati in modo univoco per ogni campo dei frammenti 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.

utilizzo di più frammenti nel 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. Fai clic su 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.
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, vedere Anteprima modulo.
Scarica
Scarica il frammento selezionato.
Avvia revisione/Gestisci revisione
Consente di avviare e gestire una revisione del frammento selezionato. Per ulteriori informazioni, vedere Creazione e gestione delle revisioni.
Aggiungi dizionario
Genera un dizionario per la localizzazione del frammento selezionato. Per ulteriori informazioni, vedere Localizzazione di Forms adattivo.
Publish/Annulla pubblicazione
Pubblica o annulla la pubblicazione del frammento selezionato.
Elimina
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.
  • 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 modificare, modifica il frammento del modulo adattivo autonomo.
  • 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.

Frammenti di riferimento reference-fragments

Sono disponibili frammenti per moduli adattivi di riferimento che è possibile utilizzare per creare il modulo.

Consulta anche see-also

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab