Moduli

Creare una cartella di lavoro di Excel o un foglio di Google in un punto qualsiasi della directory del progetto. In questo documento viene utilizzato un foglio in OneDrive denominato email-form.xlsx nella radice di un progetto AEM.

Assicurati che l’utente AEM (ad esempio helix@adobe.com) configurato per il progetto ha autorizzazione di modifica sul foglio.

Aprire la cartella di lavoro creata e rinominare il foglio predefinito in incoming.


Nota: L'AEM non invierà alcun dato a questa cartella di lavoro se incoming Il foglio non esiste.

Visualizza l’anteprima del foglio nella barra laterale.
Nota: Anche se un foglio è stato visualizzato in anteprima in precedenza, deve essere visualizzato di nuovo dopo aver creato incoming per la prima volta.

Imposta il foglio con le intestazioni che corrispondono ai dati che vengono acquisiti. Puoi eseguire questa operazione manualmente o inviando una richiesta POST al percorso del modulo nel servizio di amministrazione dell’AEM. Il servizio di amministrazione esamina i dati nel corpo del POST e crea le intestazioni, le tabelle e i fogli necessari per acquisire i dati e ottenere il massimo dal servizio forms.
Per informazioni dettagliate sul formato della richiesta POST di impostazione del foglio, vedere Admin API e il seguente esempio:

Richiesta:

POST /form/{owner}/{repo}/{ref}/en/email-form.json HTTP/1.1
{"data":{"firstName":"test"}}

Risposta:

HTTP/1.1 200 OK
{"rowCount":2,"columns":["firstName"]}

Per effettuare questa richiesta POST, puoi utilizzare uno strumento come curl o Postman. Ad esempio:

curl -s -i -X POST 'https://admin.hlx.page/form/{owner}/{repo}/{ref}/en/email-form.json' \
--header 'Content-Type: application/json' \
--data '{"data":{"firstName":"test"}}'

Tramite la richiesta POST di cui sopra, forniamo dati di esempio, ovvero i campi del modulo e i valori di esempio che verranno utilizzati dal servizio di amministrazione per impostare il modulo.
Si consiglia di impostare il foglio da parte del servizio di amministrazione, ma se desideri creare le intestazioni manualmente, consulta il documento Impostazione manuale foglio Forms.

Dopo l’invio POST richiesta al servizio di amministrazione verranno visualizzate le seguenti modifiche alla cartella di lavoro.

1. Un foglio denominato helix-default viene creato. I dati in questo foglio sono quelli che verranno restituiti quando un GET richiesta al foglio. Questa è un'ottima posizione per utilizzare le formule dei fogli di calcolo per riepilogare i dati da incoming fogli destinati ad altri usi.
   
   Nota: Il helix-default il foglio non deve mai contenere informazioni personali o altri dati di cui non si è certi di essere pubblicamente accessibili.

2. Un foglio denominato slack creato. Qui puoi impostare notifiche automatiche a un canale di Slack ogni volta che i dati vengono acquisiti nel foglio di calcolo. Attualmente l'AEM supporta solo le notifiche all'organizzazione Slack Engineering dell'AEM e all'organizzazione Adobe Enterprise Support.

   1. Per impostare le notifiche di Slack, immettere teamId dell'area di lavoro di Slack e channel nome o ID. Puoi anche chiedere al backbot (con il debug ) per il teamId e channel ID Utilizzo di channel L’ID invece del nome è da preferire, in quanto sopravvive alle ridenominazioni dei canali.
      
      Nota: I moduli più vecchi non avevano il teamId colonna. Il teamId è stato incluso nel channel colonna, separata da una # o /.
   2. Inserisci qualsiasi titolo vuoi e sotto campi immettere i nomi dei campi da visualizzare nella notifica di Slack. Ogni intestazione deve essere separata da una virgola (ad es. name, email).