Creare un modulo adattivo creating-an-adaptive-form-core-components

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

I moduli adattivi consentono di creare moduli coinvolgenti e reattivi, che si rivelano, inoltre, dinamici e adattivi. AEM Forms fornisce una procedura guidata intuitiva che consente agli utenti aziendali di creare rapidamente moduli adattivi. La procedura guidata fornisce una navigazione rapida a schede per selezionare facilmente modelli, stili, campi e opzioni di invio preconfigurati per creare un modulo adattivo.

Prima di iniziare, scopri i tipi di componenti dei moduli disponibili:

  • Componenti core dei moduli adattivi: si tratta di componenti di acquisizione dati standardizzati. Questi componenti forniscono funzionalità di personalizzazione e riducono i tempi di sviluppo e i costi di manutenzione per le esperienze di registrazione digitale. Uno sviluppatore può facilmente personalizzare e assegnare uno stile a questi componenti. L’Adobe consiglia di utilizzare questi componenti moderni ed estensibili per sviluppare Forms adattivo.

  • Componenti di base dei moduli adattivi: si tratta dei classici (precedenti) componenti di acquisizione dati. Puoi continuare a utilizzarli per modificare i componenti di base esistenti basati su modulo adattivo. Se stai creando nuovi moduli, Adobe consiglia di utilizzare Componenti core Forms adattivi per creare un Forms adattivo.

Creazione guidata di un modulo adattivo

Prerequisiti

Per creare un modulo adattivo è necessario quanto segue:

  • Abilita i componenti core adattivi di Forms per il tuo ambiente: quando crei un programma, i componenti core adattivi di Forms sono già abilitati per il tuo ambiente. Se disponi di un ambiente Forms as a Cloud Service basato sull’Archetipo 39 o versioni precedenti, consulta Abilitare i componenti core dei moduli adattivi per il tuo ambiente. Quando abiliti i componenti core per il tuo ambiente, vengono aggiunti il modello e l'area di lavoro del componente core moduli adattivi. Se la tua versione dell’SDK di AEM è precedente alla 2023.02.0, assicurati di aver abilitato il flag prerelease nel tuo ambiente, poiché i componenti core dei moduli adattivi facevano parte della versione prerelease precedente alla versione 2023.02.0.

  • Un modello di modulo adattivo: un modello fornisce una struttura di base e definisce l’aspetto (layout e stili) di un modulo adattivo. Include componenti preformattati contenenti determinate proprietà e struttura del contenuto. Fornisce inoltre le opzioni per definire un tema e un’azione di invio. Il tema definisce l’aspetto, mentre l’azione di invio definisce l’azione da intraprendere al momento dell’invio di un modulo adattivo. Ad esempio, l’invio dei dati raccolti a un’origine dati. Il Cloud Service fornisce un modello OOTB, denominato vuoto:

    • Il modello blank è incluso in ogni nuovo programma AEM Forms as a Cloud Service.
    • È possibile installare il pacchetto di riferimento tramite Gestione pacchetti per aggiungere il blank modello al programma AEM Forms as a Cloud Service.
    • È inoltre possibile creare un modello di Forms adattivo (Componenti core) da zero.
    • Puoi anche distribuire modelli di esempio nel tuo ambiente. che consentono di iniziare a creare rapidamente i moduli.
  • Un tema per moduli adattivi: un tema contiene dettagli sullo stile dei componenti e dei pannelli. Gli stili includono proprietà quali i colori di sfondo, i colori degli stati, la trasparenza, l’allineamento e le dimensioni. Quando applichi un tema, lo stile specificato si riflette sui componenti corrispondenti. Il modello Canvas è incluso in ogni nuovo programma AEM Forms as a Cloud Service. Puoi anche distribuire temi di esempio nel tuo ambiente. In questo modo è possibile iniziare a definire lo stile dei moduli e fornire una struttura di base per creare o personalizzare un tema in base alle proprie esigenze aziendali.

  • Autorizzazioni: aggiungi gli utenti a un gruppo forms-users. I membri del gruppo forms-users dispongono delle autorizzazioni per creare un modulo adattivo. Per un elenco dettagliato dei gruppi di utenti specifici per moduli, consulta Gruppi e autorizzazioni.

Creare un modulo adattivo create-an-adaptive-form-core-components

  1. Accedi all’istanza di authoring Experience Manager Forms. Può essere un’istanza Cloud o un’istanza di sviluppo locale.

  2. Inserisci le credenziali nella pagina di accesso di Experience Manager. Dopo aver effettuato l'accesso, nell'angolo superiore sinistro selezionare Adobe Experience Manager > Forms > Forms e documenti.

  3. Selezionare Crea > Forms adattivo. Viene aperta la procedura guidata. Nella scheda Sorgente, seleziona un modello:

    Modello componenti core

    Quando selezioni un modello, vengono selezionati automaticamente un tema e un’azione di invio specificati nel modello, mentre viene abilitato il pulsante Crea. È possibile passare alle schede Stile o Invio per selezionare un tema o un’azione di invio diversi. Se il modello selezionato non specifica un tema, il pulsante Crea rimane disabilitato. È possibile passare alla scheda Stili per selezionare manualmente un tema.

    note note
    NOTE
    Se non disponi del modello Moduli adattivi (componente core) nell’ambiente, abilita la funzione Componenti core dei moduli adattivi per il tuo ambiente. Quando abiliti i componenti core per il tuo ambiente, viene aggiunto il modello Moduli adattivi (componente core).
  4. Nella scheda Stile, seleziona un tema:

    • Quando il modello selezionato specifica un tema, lo stesso viene selezionato automaticamente nella procedura guidata. È possibile inoltre scegliere un tema diverso dalla scheda Stile.

    • Se il modello selezionato non specifica un tema, è possibile utilizzare la scheda Stile per sceglierne uno. Il pulsante Crea viene abilitato solo dopo la selezione di un tema.

  5. (Facoltativo) Nella scheda Dati, seleziona un modello dati:

    • Modello dati modulo (FDM): un Modello dati modulo consente di integrare entità e servizi da origini dati diverse a un Modulo adattivo. Scegli Modello dati modulo (FDM) se il modulo adattivo che stai creando richiede il recupero e la scrittura di dati da e verso più origini dati.

    • Schema JSON: lo Schema JSON è nostro modulo adattivo basato su componenti core che consente l’integrazione perfetta con il sistema back-end della tua organizzazione, grazie alla possibilità di associare uno schema JSON, che rappresenta la struttura dei dati prodotti o utilizzati. Questa associazione consente agli autori di aggiungere contenuti al modulo adattivo in modo dinamico, utilizzando gli elementi dello schema. Gli elementi dello schema sono facilmente accessibili nella scheda Oggetti modello dati del browser Contenuto durante il processo di authoring e tutti i campi vengono aggiunti automaticamente a qualsiasi modulo adattivo creato.

    Per impostazione predefinita, tutti i campi dello schema JSON associato vengono selezionati e convertiti automaticamente nei componenti corrispondenti del modulo adattivo, semplificando il processo di authoring. La procedura guidata offre l’ulteriore comodità di consentire la scelta selettiva dei campi da includere nel modulo adattivo tramite l’utilizzo di caselle di controllo.

  6. Nella scheda Invio, seleziona un’azione di invio:

    • Quando selezioni un modello, l’azione di invio specificata in quel modello viene selezionata automaticamente. Dalla scheda Invio puoi selezionare un’azione di invio diversa. La scheda Invio mostra tutte le azioni di invio disponibili.

    • Se nel modello selezionato non è specificata un’azione di invio, è possibile utilizzare la scheda Invio per selezionarne una.

  7. (Facoltativo) Nella scheda Consegna, è possibile specificare una data di pubblicazione o di annullamento della pubblicazione per un modulo adattivo.

  8. Seleziona Crea. Viene visualizzata una finestra di dialogo che specifica il titolo, il nome e la posizione in cui salvare il modulo adattivo:

    • Titolo: specifica il nome visualizzato del modulo. Il titolo consente di identificare il modulo nell’interfaccia utente di Experience Manager Forms.
    • Nome: specifica il nome del modulo. Nell’archivio viene creato un nodo con il nome specificato. Quando si inizia a digitare un titolo, il valore del campo nome viene generato automaticamente. Puoi modificare il valore suggerito. Il campo nome può contenere solo caratteri alfanumerici, trattini e caratteri di sottolineatura. Tutti gli input non validi vengono sostituiti da un trattino.
    • Percorso: specifica la posizione in cui salvare il modulo adattivo. Puoi salvare il modulo adattivo direttamente all’indirizzo /content/dam/formsanddocuments o creare una cartella di salvataggio come /content/dam/formsanddocuments/adaptiveforms. Assicurati di creare la cartella prima di utilizzarla nel percorso. Il campo Percorso non crea cartelle automaticamente.
  9. Seleziona Crea. Viene creato un modulo adattivo che viene aperto nell’editor di moduli adattivi. L’editor mostra i contenuti disponibili nel modello. In base al tipo di modulo adattivo, gli elementi del modulo presenti nello schema JSON o nel modello dati del modulo (FDM) associato vengono visualizzati nella scheda Oggetti modello dati del Browser contenuti nella barra laterale. Puoi anche trascinare questi elementi per creare il modulo adattivo.

È ora possibile trascinare e rilasciare i componenti core Forms adattivi nel contenitore Forms adattivo per progettare e creare il modulo. Puoi anche visitare https://aemcomponents.dev/ per visualizzare i componenti core disponibili in azione.

Configurare l’azione di invio per un modulo adattivo configure-submit-action-for-form

Un’azione di invio consente di scegliere la destinazione dei dati acquisiti tramite un modulo adattivo. Viene attivato quando un utente fa clic sul pulsante Invia in un modulo adattivo. I moduli adattivi includono alcune azioni di invio pronte all’uso. Puoi anche estendere un’azione di invio predefinita per creare un’azione di invio personalizzata. Per configurare un'azione di invio per il modulo:

  1. Apri il browser Contenuto e seleziona il componente Contenitore guida del modulo adattivo.

  2. Fare clic sull'icona delle proprietà del Contenitore Guida TV Proprietà Guida . Viene visualizzata la finestra di dialogo Contenitore modulo adattivo (Adaptive Form Container).

  3. Fare clic sulla scheda Invio.

    Fai clic sullicona chiave inglese per aprire la finestra di dialogo Contenitore modulo adattivo e configurare unazione di invio

  4. Seleziona e configura un'azione Invia in base alle tue esigenze. Per informazioni dettagliate sulle azioni di invio, consulta Azione di invio modulo adattivo

Reindirizza l’utente a una pagina o mostra un messaggio di ringraziamento all’invio del modulo

All'invio di un modulo è possibile reindirizzare l'utente a un'altra pagina Web o a un messaggio. Per reindirizzare l’utente o configurare il messaggio di ringraziamento:

  1. Apri il browser Contenuto e seleziona il componente Contenitore guida del modulo adattivo.

  2. Fare clic sull'icona delle proprietà del Contenitore Guida TV Proprietà Guida . Viene visualizzata la finestra di dialogo Contenitore modulo adattivo (Adaptive Form Container).

  3. Apri la scheda Invio.

    Fai clic sullicona chiave inglese per aprire la finestra di dialogo Contenitore modulo adattivo e configurare una pagina di reindirizzamento o un messaggio di ringraziamento

    • Per configurare un URL di reindirizzamento, per l'opzione Invia selezionare l'opzione Reindirizza all'URL, quindi sfogliare e selezionare una pagina AEM Sites o specificare l'URL di una pagina esterna.

    • Per configurare un messaggio personalizzato o di ringraziamento, per l'opzione Invia selezionare l'opzione Mostra messaggio e specificare un messaggio nella casella Contenuto messaggio. Si tratta di una casella di testo RTF, è possibile utilizzare l'opzione a schermo intero per visualizzare tutti gli elementi RTF disponibili.

Configurare uno schema o un modello di dati del modulo (FDM) per un modulo adattivo configure-schema-or-data-model-for-form

È possibile utilizzare il modello dati modulo (FDM) per collegare un modulo a un Source dati per inviare e ricevere dati in base alle azioni degli utenti. È possibile anche collegare un modulo a uno schema JSON per ricevere i dati inviati in un formato predefinito. In base al requisito, connetti il modulo a uno schema JSON o a un modello dati modulo (FDM):

Configurare uno schema JSON o un modello dati modulo (FDM) per il modulo

Per configurare uno schema JSON o un modello dati modulo (FDM) per il modulo:

  1. Apri il browser Contenuto e seleziona il componente Contenitore guida del modulo adattivo.

  2. Fare clic sull'icona delle proprietà del Contenitore Guida TV Proprietà Guida . Viene visualizzata la finestra di dialogo Contenitore modulo adattivo (Adaptive Form Container).

  3. Apri la scheda Modello dati.

    Fare clic sullicona chiave inglese per aprire la finestra di dialogo Contenitore modulo adattivo per configurare uno schema JSON o un modello dati modulo (FDM)

  4. Seleziona e configura uno schema JSON o un modello dati modulo (FDM), in base ai requisiti:

    • Quando si seleziona l'opzione Modello modulo, utilizzare l'opzione Seleziona modello dati modulo per selezionare un modello dati modulo (FDM) preconfigurato.
    • Quando selezioni l'opzione Schema, utilizza l'opzione Schema per selezionare uno schema JSON per il modulo.
  5. Fai clic su Fine.

Configurare un servizio di precompilazione configure-prefill-service-for-form

Puoi utilizzare il servizio di precompilazione per compilare automaticamente i campi di un modulo adattivo utilizzando dati esistenti. Quando un utente apre un modulo, i valori di tali campi vengono precompilati. Operazioni disponibili:

Utilizzare il servizio di precompilazione del modello dati modulo per precompilare i campi di un modulo adattivo fdm-prefill-service

È possibile utilizzare il servizio di precompilazione del modello dati modulo per precompilare i campi di un modulo adattivo utilizzando un modello dati modulo o un servizio di precompilazione personalizzato. Il servizio di precompilazione del modello dati modulo utilizza il servizio Get Service del modello dati modulo configurato per recuperare i dati. Per utilizzare il servizio di precompilazione del modello dati modulo per un modulo adattivo:

  1. Apri il browser Contenuto e seleziona il componente Contenitore guida del modulo adattivo.
  2. Fare clic sull'icona delle proprietà del Contenitore Guida TV Proprietà Guida . Viene visualizzata la finestra di dialogo Contenitore modulo adattivo (Adaptive Form Container).
  3. Fai clic sull'icona Proprietà contenitore modulo adattivo Proprietà contenitore modulo adattivo . Viene visualizzata la finestra di dialogo Contenitore modulo adattivo per configurare i modelli dati.
    Fai clic sullicona chiave inglese per aprire la finestra di dialogo Contenitore modulo adattivo e configurare una pagina di reindirizzamento o un messaggio di ringraziamento
  4. Seleziona un modello dati modulo (FDM). Apri la scheda Base. Nel servizio di precompilazione, selezionare Servizio di precompilazione modello dati modulo.
  5. Fai clic su Fine. Il modulo adattivo è ora configurato per l’utilizzo della precompilazione del modello dati del modulo. Ora puoi utilizzare l'editor regole per creare regole per precompilare i campi del modulo.

Modificare le proprietà di un modello di modulo adattivo edit-form-model

  1. Seleziona il modulo adattivo e seleziona Informazioni pagina > Apri proprietà. Viene visualizzata la pagina Proprietà modulo.

  2. Vai alla scheda Modello modulo e scegli un modello di modulo. Se il modulo adattivo non dispone di un modello di modulo, puoi scegliere uno schema JSON o un modello di dati del modulo (FDM). Se invece il modulo adattivo si basa già su un modello di modulo, puoi passare a un altro modello dello stesso tipo. Ad esempio, se il modulo utilizza uno schema JSON, puoi passare facilmente a un altro schema JSON e, analogamente, se il modulo utilizza un modello di dati del modulo (FDM), puoi passare a un altro modello di dati del modulo (FDM).

  3. Seleziona Salva per salvare le proprietà.

Come rinominare un modulo adattivo per l’AEM? rename-an-AEM-Adaptive-Form

Per rinominare un modulo adattivo, effettua le seguenti operazioni:

  1. Seleziona un modulo adattivo nell’interfaccia utente di AEM Forms.
  2. Fai clic su Proprietà nella barra superiore.
  3. Modifica il nome del modulo nella scheda Titolo, come illustrato nell'immagine seguente.
  4. Fare clic su Salva e chiudi.

Rinominare un modulo adattivo AEM

Consulta anche see-also

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