Configurare le azioni di invio per i moduli adattivi.

Il servizio di invio dei moduli è un endpoint ospitato da Adobe ideale per scenari di acquisizione dati semplici.

Destinazioni supportate

• Fogli di calcolo: fogli Google, Microsoft Excel (OneDrive/SharePoint)
• E-mail: invia i dati del modulo agli indirizzi e-mail specificati

Passaggi di configurazione

1. Configurare l’accesso alla destinazione

   • Per i fogli di calcolo: concedere l’autorizzazione di modifica a forms@adobe.com nel foglio di calcolo di destinazione
   • Per l’e-mail: verificare che gli indirizzi e-mail dei destinatari siano accessibili

2. Configurare l’invio del modulo

   • Aprire il modulo nell’ambiente di authoring
   • Impostare l’azione di invio su “Servizo di invio dei moduli”
   • Specificare gli indirizzi e-mail o l’URL del foglio di calcolo di destinazione
   • Salvare e pubblicare il modulo

3. Invio di prova

   • Inviare i dati di prova tramite il modulo
   • Verificare che i dati vengano visualizzati nella destinazione target
   • Controllare i registri di errore in caso di invio non riuscito

Note importanti

• L’account del servizio forms@adobe.com richiede l’accesso in modifica ai fogli di calcolo di destinazione
• Le notifiche e-mail vengono inviate subito dopo l’invio del modulo
• La convalida dei dati avviene a livello di servizio

Invia i dati del modulo direttamente all’istanza Publish di AEM as a Cloud Service per elaborazioni complesse.

Quando utilizzare AEM Publish

• Flussi di lavoro AEM personalizzati richiesti dopo l’invio
• Integrazione del modello dati modulo (FDM) con i database
• Integrazioni di servizi di terze parti (Marketo, Power Automate, Workfront Fusion)
• Archiviazione BLOB di Azure o librerie di documenti SharePoint
• Logica di elaborazione o convalida complessa lato server

Azioni di invio disponibili

• Inviare all’endpoint REST
• Inviare e-mail utilizzando i servizi di posta di AEM
• Inviare utilizzando il modello dati modulo
• Richiamare il flusso di lavoro AEM
• Inviare a SharePoint
• Inviare a OneDrive
• Inviare all’archiviazione Blob di Azure
• Inviare a iMicrosoft Power Automate
• Inviare a Adobe Workfront Fusion
• Inviare a Adobe Marketo Engage

Requisiti di configurazione

​1. Aggiornare l’URL dell’istanza di AEM in Edge Delivery

Aggiorna l’URL dell’istanza di AEM Cloud Service nel file constant.js all’interno del blocco form di submitBaseUrl. È possibile configurare l’URL in base al proprio ambiente:

Per l’istanza di Cloud Service

export const submitBaseUrl = '<aem-publish-instance-URL>';

Per lo sviluppo locale

export const submitBaseUrl = 'http://localhost:<port-number>';

​2. Filtro referrer OSGi

Configura il filtro Referrer per consentire i domini specifici del tuo sito Edge Delivery:

1. Crea o aggiorna il file di configurazione OSGi: org.apache.sling.security.impl.ReferrerFilter.cfg.json

2. Aggiungi la seguente configurazione ai domini specifici del tuo sito:

   code language-json
   { "allow.empty": false, "allow.hosts": [ "main--abc--adobe.aem.live", "main--abc1--adobe.aem.live" ], "allow.hosts.regexp": [ "https://.*\\.aem\\.live:443", "https://.*\\.aem\\.page:443", "https://.*\\.hlx\\.page:443", "https://.*\\.hlx\\.live:443" ], "filter.methods": [ "POST", "PUT", "DELETE", "COPY", "MOVE" ], "exclude.agents.regexp": [ "" ] }

3. Distribuisci la configurazione tramite Cloud Manager

Per informazioni dettagliate sulla configurazione del filtro OSGi Referrer, consulta la guida del filtro Referrer.

​3. Problemi relativi a CORS (Cross-Origin Resource Sharing)

Configura le impostazioni CORS in AEM per consentire richieste dai domini specifici del tuo sito Edge Delivery:

Localhost sviluppatore

SetEnvIfExpr "env('CORSProcessing') == 'true' && req_novary('Origin') =~ m#(http://localhost(:\d+)?$)#" CORSTrusted=true

Siti Edge Delivery - Aggiungi ogni dominio del sito singolarmente

SetEnvIfExpr "env('CORSProcessing') == 'true' && req_novary('Origin') =~ m#(https://main--abc--adobe\.aem\.live$)#" CORSTrusted=true
SetEnvIfExpr "env('CORSProcessing') == 'true' && req_novary('Origin') =~ m#(https://main--abc1--adobe\.aem\.live$)#" CORSTrusted=true

Domini Franklin precedenti (se ancora in uso)

SetEnvIfExpr "env('CORSProcessing') == 'true' && req_novary('Origin') =~ m#(https://.*\.hlx\.page$)#" CORSTrusted=true
SetEnvIfExpr "env('CORSProcessing') == 'true' && req_novary('Origin') =~ m#(https://.*\.hlx\.live$)#" CORSTrusted=true

Per informazioni dettagliate sulla configurazione CORS, consulta la Guida alla configurazione CORS.

Per abilitare CORS per l’ambiente di sviluppo locale, consulta l’articolo Informazioni su CORS.

​4. Configurazione modulo

1. Creare un modulo nell’editor universale
2. Configurare l’azione di invio per eseguire il targeting dell’azione AEM Forms
3. Specificare il percorso dell’endpoint di invio
4. Pubblicare il modulo sul sito Edge Delivery

1. Creare una struttura di modulo in Google Docs/Sheets
2. Configurare l’endpoint del servizio di invio dei moduli
3. Concedere a forms@adobe.com l’accesso in modifica al foglio di calcolo di destinazione
4. Pubblica il documento sul sito Edge Delivery.
5. Invio di moduli di prova e flusso di dati

1. Creare un modulo nell’editor universale
2. Configurare l’azione di invio per “richiamare il flusso di lavoro AEM”
3. Configurare Dispatcher e il filtro referrer su AEM Publish
4. Configurare le regole di routing CDN
5. Pubblicare un modulo e testare l’esecuzione del flusso di lavoro