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.

Servizio di invio Forms

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

Flusso di lavoro per il servizio di invio moduli

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:

Definizione 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.

Foglio in ingresso

WARNING
Se il foglio incoming 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:

  1. In Excel o Google Sheets, fai clic sul pulsante Condividi in alto a destra.

  2. Aggiungi l'account forms@adobe.com e
    fai clic sull'icona a forma di occhio, seleziona l'accesso Modifica e fai clic su Invia.

    Condividi foglio in ingresso

  3. Per copiare il collegamento del foglio di calcolo, fare clic sul pulsante Condividi nell'angolo superiore destro e selezionare Copia collegamento.

    Copia collegamento del foglio in ingresso

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:

  1. Aprire il foglio di calcolo contenente la definizione del modulo.

  2. Nella riga corrispondente al campo Invia, incolla il collegamento del foglio di calcolo copiato nella colonna Azione.

    Collega un foglio di calcolo

  3. Visualizza l'anteprima e pubblica il foglio utilizzando AEM Sidekick con il servizio di invio modulo aggiornato.

NOTE
È possibile fare riferimento al foglio di calcolo per utilizzare il servizio di invio Forms.

Configurazione 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 incoming non esiste, AEM non invierà alcun dato a questa cartella di lavoro.
  • Condividi il foglio incoming con Adobe Experience Manager forms@adobe.com e concedi l'accesso di modifica.
  • Visualizza l'anteprima e pubblica il foglio incoming nella 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 repository con il tuo archivio GitHub o nome sito

  • organization con il tuo nome utente GitHub

    code language-json
    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",
            "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.

schermata postman

  • 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 modulo
  • site or repository con il tuo archivio GitHub o nome sito
  • organization con il tuo nome utente GitHub
Per macOS
code language-none
"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"
}
}'

"
Per Windows OS
code language-none
"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:

foglio aggiornato

Consulta anche

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