Pubblicare un modulo adattivo in Edge Delivery Services

Questa funzione è disponibile tramite il programma per i primi utilizzatori. Per richiedere l’accesso, invia un’e-mail con il nome dell’organizzazione e il nome dell’archivio GitHub dall’indirizzo ufficiale a aem-forms-ea@adobe.com. Ad esempio, se l’URL dell’archivio è https://github.com/adobe/abc, il nome dell’organizzazione è adobe e il nome dell’archivio è abc.

Quando un modulo è finalizzato e pronto per l’uso, puoi pubblicarlo per renderlo accessibile ai tuoi clienti per la raccolta e l’invio di dati. Una volta pubblicato, il modulo diventa disponibile su Edge Delivery e gli utenti possono interagire direttamente con esso. Questo processo consente ai clienti di compilare e inviare il modulo in tempo reale, rende più efficiente l’acquisizione dei dati e ne semplifica l’elaborazione.

Prerequisiti

Pubblicare il modulo

Puoi pubblicare qualsiasi modulo adattivo basato su EDS in Edge Delivery seguendo questi passaggi:

Abilitare l’invio di moduli su Edge Delivery configurando un filtro Referrer per AEM Publisher

Per garantire l’invio sicuro dei moduli, è necessario configurare un filtro referrer in AEM Publish. Questo filtro garantisce che solo le richieste autorizzate da Edge Delivery possano eseguire operazioni di scrittura (POST, PUT, DELETE, COPY, MOVE), impedendo modifiche non autorizzate. Di seguito sono riportati i passaggi necessari per configurare un filtro Referrer per AEM Publish:

Aggiornare l’URL dell’istanza di AEM in Edge Delivery

Modifica il valore submitBaseUrl nel file constant.js all’interno del blocco del modulo per specificare l’URL dell’istanza di AEM:

Per la configurazione cloud:

export const submitBaseUrl = 'https://publish-p120-e12.adobeaemcloud.com';

Per lo sviluppo locale:

export const submitBaseUrl = 'http://localhost:4503';

Modificare la configurazione CORS

Regola le impostazioni CORS per consentire le richieste di invio di moduli dai domini Edge Delivery. Per informazioni, consulta la Guida alla configurazione CORS.

Configurazione CORS di esempio:

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

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

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

Per lo sviluppo locale, consulta la documentazione per abilitare CORS dall’URL host dell’interfaccia utente di sviluppo.

Configurare il filtro Referrer

Configura il filtro Referrer in AEM Cloud Service tramite Cloud Manager. Ulteriori informazioni sulla configurazione del filtro referrer in un’istanza di AEM Cloud Service tramite Cloud Manager.

Configurazione JSON per il filtro Referrer:

{
  "allow.empty": false,
  "allow.hosts": [],
  "allow.hosts.regexp": [
    "https://.*\\.hlx\\.page:443",
    "https://.*\\.hlx\\.live:443"
  ],
  "filter.methods": [
    "POST",
    "PUT",
    "DELETE",
    "COPY",
    "MOVE"
  ],
  "exclude.agents.regexp": [
    ""
  ]
}

Questa configurazione specifica quali metodi HTTP vengono filtrati, quali referrer sono consentiti e quali agenti utente sono esclusi dal filtro. Implementando queste configurazioni, gli invii di moduli tramite Edge Delivery saranno protetti e limitati alle sole origini autorizzate.

Accedere al modulo adattivo pubblicato

Il modulo adattivo è ora accessibile tramite Edge Delivery utilizzando il seguente formato URL:

https://<branch>--<repo>--<owner>.aem.page/content/forms/af/<form_name>

Ad esempio, l’URL per Wknd-Form è:

https://main--universaleditor--wkndforms.aem.live/content/forms/af/wknd-form

Consulta anche