Creare un modulo utilizzando il Blocco moduli adattivi
AEM Forms Edge Delivery fornisce un blocco, noto come Blocco moduli adattivi, per facilitare la creazione di moduli per l’acquisizione e l’archiviazione dei dati acquisiti. È possibile creare un nuovo progetto AEM preconfigurato con Blocco moduli adattivi o aggiungere il Blocco moduli adattivi a un progetto AEM esistente.
Questi moduli inviano i dati direttamente a un file Microsoft Excel o Fogli Google, consentendo di utilizzare un ecosistema dinamico e API affidabili di Fogli Google, Microsoft Excel e Microsoft SharePoint per elaborare facilmente i dati inviati o avviare un flusso di lavoro aziendale esistente.
Prerequisiti
Prima di iniziare, assicurati di aver completato i seguenti passaggi:
- Configurare un Progetto AEM utilizzando AEM Forms standard o Blocco moduli adattivi aggiunto al progetto AEM esistente e clona l’archivio GitHub corrispondente sul computer locale.
In questo documento, la cartella locale del progetto Edge Delivery Services (EDS) viene indicata come[EDS Project repository]
. - Assicurati di avere accesso a Fogli Google o Microsoft SharePoint. Per impostare Microsoft SharePoint come origine di contenuto, vedi Come usare SharePoint.
Creare un modulo
Invece di navigare attraverso processi complessi, la creazione di un modulo può essere ottenuta facilmente utilizzando un foglio di calcolo. È possibile definire le righe e le colonne che costituiranno la struttura del modulo. Ogni riga rappresenta un singolo utente campo modulo e le intestazioni di colonna definiscono le corrispondenti proprietà campo.
Ad esempio, considera il seguente foglio di calcolo in cui le righe contornano i campi per un modulo enquiry
e le intestazioni di colonna definiscono le relative proprietà:
Per procedere con la creazione del modulo:
-
Accedi alla cartella del progetto AEM Edge Delivery su Microsoft SharePoint o Google Drive.
-
Crea una cartella di lavoro di Microsoft Excel o un foglio di Google ovunque all’interno della directory di progetto AEM Edge Delivery. Ad esempio, crea un foglio di calcolo denominato
enquiry
nella directory del progetto AEM Edge Delivery su Google Drive. -
Assicurati che il foglio sia condiviso con l’utente AEM appropriato (ad esempio
helix@adobe.com
) in base alle configurazioni specificate per il progetto. Concedi all’utente l’autorizzazione di modifica per il foglio. -
Apri il foglio di calcolo creato e rinomina il foglio predefinito in “shared-default”.
-
Per aggiungere i campi modulo, inserire le righe e le intestazioni di colonna nel foglio “shared-default”. Ogni riga deve rappresentare un campo modulo, con intestazioni di colonna che definiscono il campo corrispondente proprietà.
Per un avvio rapido, considera copiare il contenuto del Foglio di calcolo interrogazione nel proprio foglio di calcolo. Dopo aver copiato il contenuto, salva il foglio di calcolo.
embed -
Utilizza AEM Sidekick per visualizzare l’anteprima del foglio.
In anteprima, nelle nuove schede del browser il contenuto del foglio viene visualizzato in formato JSON. Assicurati di acquisire l’URL di anteprima, in quanto è necessario per il rendering del modulo nella sezione successiva. Il formato dell’URL è attualmente il seguente:
code language-json https://<branch>--<repository>--<owner>.hlx.live/<form-path>/<form-file-name>.json
<branch>
fa riferimento al ramo dell’archivio GitHub.<repository>
denota l’archivio GitHub.<owner>
fa riferimento al nome utente dell’account GitHub che ospita l’archivio GitHub.
Ad esempio, se l’archivio del progetto è denominato “portal”, si trova sotto l’account “wkndforms” e stai utilizzando il ramo “main”, l’URL avrà l’aspetto seguente:
https://main--portal--wkndforms.hlx.page/enquiry.json
Finora è stata preparata la struttura del modulo. Ora, per visualizzare in anteprima il modulo:
-
Apri l’account Microsoft SharePoint o Google Drive e passa alla directory del progetto AEM Edge Delivery.
-
apri un file di documento (ad esempio un file index) per incorporare il modulo. In alternativa, puoi creare un nuovo documento.
-
Spostati nella posizione desiderata all’interno del documento in cui desideri aggiungere il modulo.
-
Creare un blocco del modulo per il rendering del modulo. Seleziona Inserisci > Tabella e crea una tabella a una colonna e due righe. Denomina la tabella “Modulo” e incolla l’URL di anteprima nella seconda riga. Accertati che l’URL sia formattato come collegamento ipertestuale, non come testo normale, come illustrato di seguito:
table 0-row-1 1-row-1 Modulo https://main–wefinance–wkndforms.hlx.live/enquiry.json Questo blocco funge da segnaposto in cui è incorporato il modulo. Nella seconda riga del blocco, aggiungi l’URL di anteprima del file
<form>.json
come collegamento ipertestuale.note important IMPORTANT Verifica che l’URL sia formattato come collegamento ipertestuale anziché essere visualizzato come testo normale. -
Utilizza AEM Sidekick per visualizzare in anteprima il documento. Nella pagina viene ora visualizzato il modulo. Ad esempio, questo è il modulo basato sul foglio di calcolo di richiesta:
A questo punto, compila il modulo e fai clic sul pulsante Invia. Riscontrerai un errore simile al seguente, perché il foglio di calcolo non è ancora impostato per accettare i dati.
Passaggio successivo
Preparare il foglio di calcolo per iniziare ad accettare i dati al momento dell’invio del modulo.
Consulta anche
- Guida introduttiva a Edge Delivery Services per AEM Forms
- Creare un modulo utilizzando Google Sheets o Microsoft Excel
- Impostare i fogli di Google o i file di Microsoft Excel per iniziare ad accettare i dati
- Pubblicare il modulo e iniziare a raccogliere i dati
- Personalizzare l’aspetto dei moduli
- Aggiungere sezioni ripetibili a un modulo
- Mostra un messaggio di ringraziamento personalizzato dopo l’invio del modulo
- Componenti del blocco modulo adattivo e relative proprietà