Servizio di invio Forms con Edge Delivery Services Forms
Questa funzionalità è disponibile tramite il programma di accesso anticipato. Per richiedere l'accesso, invia un'e-mail con il nome dell'organizzazione GitHub e il nome dell'archivio dall'indirizzo ufficiale a aem-forms-ea@adobe.com . Ad esempio, se l'URL del repository è https://github.com/adobe/abc, il nome dell'organizzazione è adobe e il nome del repository è abc.
Il servizio di invio di Forms consente di memorizzare i dati degli invii di moduli in qualsiasi foglio di calcolo, ad esempio OneDrive, SharePoint o Google Sheets, consentendo di accedere e gestire facilmente i dati dei moduli nella piattaforma di fogli di calcolo preferita.
Vantaggi dell'utilizzo del servizio di invio Forms
Alcuni vantaggi dell’utilizzo del servizio di invio Forms con i fogli di calcolo sono:
- Integrazione diretta: è possibile configurare i moduli per inviare i dati direttamente a un foglio di calcolo specificato, eliminando la necessità di trasferimento manuale dei dati.
- Struttura dati: quando si imposta l'invio, è possibile mappare i campi modulo alle colonne corrispondenti del foglio di calcolo per l'archiviazione organizzata dei dati.
- Controllo dell'accesso: è possibile sfruttare le autorizzazioni esistenti per controllare gli utenti che possono accedere e modificare i dati del modulo inviati, a seconda del servizio foglio di calcolo scelto.
Prerequisiti
Di seguito sono riportati i prerequisiti per l’utilizzo del servizio Forms Submission:
- Assicurati che nel progetto AEM sia presente il blocco di moduli adattivi più recente.
- Assicurati che l’archivio Git sia aggiunto al inserisco nell'elenco Consentiti di per utilizzare il servizio di invio Forms. mailto:aem-forms-ea@adobe.com con il nome dell'organizzazione GitHub e il nome dell'archivio per aggiungerli al elenco Consentiti di per l'utilizzo del servizio di invio Forms.
Configurare il servizio di invio Forms
Crea un nuovo progetto AEM configurato con il blocco Forms adattivo. Per informazioni su come creare un nuovo progetto AEM, consulta l'articolo Guida introduttiva - Esercitazione per sviluppatori. Aggiorna il file fstab.yaml nel progetto. Sostituire il riferimento esistente con il percorso della cartella condivisa con forms@adobe.com.
È possibile configurare il servizio di invio di Forms manualmente o configurare il servizio di invio di Forms utilizzando l'API.
Configurazione manuale del servizio di invio Forms
1. Creare un modulo utilizzando una definizione di modulo
Creare un modulo utilizzando Google Sheets o Microsoft Excel. Per informazioni su come creare un modulo utilizzando una definizione di modulo in Microsoft Excel o Google Sheets, fare clic qui.
La schermata seguente mostra la definizione del modulo utilizzata per creare il modulo:
2. Abilitare il foglio di calcolo per accettare i dati.
Dopo aver creato e visualizzato in anteprima il modulo, abilita il foglio di calcolo corrispondente per iniziare a ricevere i dati. aggiungere un nuovo foglio come incoming. È possibile abilitare manualmente il foglio di calcolo per accettare i dati.
WARNINGincoming non esiste, AEM non invierà alcun dato a questa cartella di lavoro.3. Condividi il foglio di calcolo e genera un collegamento.
Per condividere il foglio di calcolo con l'account forms@adobe.com e generare un collegamento, effettuare le seguenti operazioni:
-
In Excel o Google Sheets, fai clic sul pulsante Condividi in alto a destra.
-
Aggiungi l'account
forms@adobe.come
fai clic sull'icona a forma di occhio, seleziona l'accesso Modifica e fai clic su Invia.
-
Per copiare il collegamento del foglio di calcolo, fare clic sul pulsante Condividi nell'angolo superiore destro e selezionare Copia collegamento.
4. Collegare il foglio di calcolo nella definizione del modulo
Per configurare il servizio Invio di Forms con Google Sheets o Microsoft Excel, effettuare le seguenti operazioni:
-
Aprire il foglio di calcolo contenente la definizione del modulo.
-
Nella riga corrispondente al campo Invia, incolla il collegamento del foglio di calcolo copiato nella colonna Azione.
-
Visualizza l'anteprima e pubblica il foglio utilizzando AEM Sidekick con il servizio di invio modulo aggiornato.
NOTEConfigurazione del servizio di invio Forms tramite API
È inoltre possibile inviare una richiesta POST al modulo per aggiornare il foglio incoming con i dati.
NOTE- Se il foglio
incomingnon esiste, AEM non invierà alcun dato a questa cartella di lavoro. - Condividi il foglio
incomingcon Adobe Experience Managerforms@adobe.come concedi l'accesso di modifica. - Visualizza l'anteprima e pubblica il foglio
incomingnella barra laterale.
Per informazioni su come formattare la richiesta POST per la configurazione del foglio, consulta la documentazione API. Osserva l’esempio fornito di seguito:
Puoi utilizzare strumenti come curl o Postman per eseguire questa richiesta POST, come dimostrato di seguito.
- Utilizzo di Postman:
Ad esempio, invia la richiesta seguente in Postman dopo la sostituzione:
-
{id}con il tuo ID modulo -
site or repositorycon il tuo archivio GitHub o nome sito -
organizationcon il tuo nome utente GitHubPOST 'https://forms.adobe.com/adobe/forms/af/submit/{id}' \ --header 'Content-Type: application/json' \ --header 'x-adobe-routing: tier=live,bucket=main--[site/repository]--[organization]' \ --data '{ "data": { "startDate": "2025-01-10", "endDate": "2025-01-25", "destination": "Australia", "class": "First Class", "budget": "2000", "amount": "1000000", "name": "Mary", "age": "35", "subscribe": null, "email": "mary@gmail.com" } }'
Facendo clic sul pulsante Invia in Postman viene restituita una risposta 201 Created e il foglio incoming viene aggiornato con i dati inviati.
- Utilizzo del comando Curl:
Ad esempio, esegui il comando seguente nel terminale o nel prompt dei comandi dopo la sostituzione:
{id}con il tuo ID modulosite or repositorycon il tuo archivio GitHub o nome sitoorganizationcon il tuo nome utente GitHub
"json
curl -X POST "https://forms.adobe.com/adobe/forms/af/submit/{id}" \
—header "Content-Type: application/json" \
—header "x-adobe-routing: tier=live,bucket=main—[site/repository]—[organization]" \
—data "{
"data": {
"startDate": "2025-01-10",
"endDate": "2025-01-25",
"destination": "Australia",
"classe": "Prima classe",
"budget": "2000",
"importo": "1000000",
"nome": "Joe",
"età": "35",
"abbonamento": null,
"e-mail": "mary@gmail.com"
}
}'
"
"json
curl -X POST "https://forms.adobe.com/adobe/forms/af/submit/{id}" ^
—header "Content-Type: application/json" ^
—header "x-adobe-routing: tier=live,bucket=main—[site/repository]—[organization]" ^
—data "{\"data\": {\"startDate\": \"2025-01-10\", \"endDate\": \"2025-01-25\", \"destinazione\": \"Australia\", \"classe\": \"Prima classe\", \"budget\": \"2000\", \"importo\": \"1000000\", \"nome\": \"Joe\", \"età\": \"35\", \"sottoscrizione\": null, \"e-mail\": \"mary@gmail.com\"}}"
"
La richiesta POST sopra indicata aggiorna il foglio incoming con la seguente risposta:
< HTTP/1.1 201 Created
< Connection: keep-alive
< Content-Length: 0
< X-Request-Id: 02a53839-2340-56a5-b238-67c23ec28f9f
< X-Message-Id: 42ecb4dd-b63a-4674-8f1a-05a4a5b0372c
< Accept-Ranges: bytes
< Date: Fri, 10 Jan 2025 13:06:10 GMT
< Via: 1.1 varnish
< Access-Control-Allow-Origin: *
< X-Served-By: cache-del21750-DEL
< X-Cache: MISS
< X-Cache-Hits: 0
< X-Timer: S1736514370.704084,VS0,VE1234
Nella schermata seguente viene visualizzata la schermata del foglio incoming aggiornato dall'invio di dati tramite API:
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à
- Utilizzo del servizio di invio moduli