Configurar acciones de envío para formularios de AEM Forms

El servicio de envío de formularios es un punto final hospedado en Adobe ideal para situaciones sencillas de captura de datos.

Destinos admitidos

• Hojas de cálculo: Hojas de cálculo de Google, Microsoft Excel (OneDrive/SharePoint)
• Correo electrónico: enviar datos de formulario a direcciones de correo electrónico especificadas

Pasos de configuración

1. Configurar el acceso de destino

   • Para hojas de cálculo: conceder permiso de edición a forms@adobe.com en hoja de cálculo de destino
   • Para correo electrónico: compruebe que se puede acceder a las direcciones de correo electrónico del destinatario

2. Configurar el envío de formularios

   • Abrir el formulario en el entorno de creación
   • Establecer la acción de envío en “Servicio de envío de formularios”
   • Especificar la URL o las direcciones de correo electrónico de la hoja de cálculo de destino
   • Guardar y publicar el formulario

3. Envío de prueba

   • Enviar datos de prueba mediante el formulario
   • Comprobar si los datos aparecen en el destino
   • Comprobar registros de errores si el envío falla

Notas importantes

• La cuenta de servicio forms@adobe.com requiere acceso de edición en las hojas de cálculo de destino
• Las notificaciones por correo electrónico se envían inmediatamente al enviar el formulario
• La validación de datos se produce en el nivel de servicio

Envíe datos de formulario directamente a la instancia de publicación de AEM as a Cloud Service para un procesamiento complejo.

Cuándo se debe utilizar la publicación de AEM

• Flujos de trabajo de AEM personalizados necesarios después del envío
• Integración del modelo de datos de formulario (FDM) con bases de datos
• Integraciones de servicios de terceros (Marketo, Power Automate, Workfront Fusion)
• Bibliotecas de documentos de Azure Blob Storage o SharePoint
• Lógica de procesamiento o validación compleja del lado del servidor

Acciones de envío disponibles

• Enviar al punto final REST
• Enviar correo electrónico a través de servicios de correo de AEM
• Enviar mediante el modelo de datos de formulario
• Invocar el flujo de trabajo de AEM
• Enviar a SharePoint
• Enviar a OneDrive
• Enviar a Azure Blob Storage
• Enviar a Microsoft Power Automate
• Enviar a Adobe Workfront Fusion
• Enviar a Adobe Marketo Engage

Requisitos de configuración

​1. Actualizar la URL de instancia de AEM en Edge Delivery

Actualice la URL de instancia de AEM Cloud Service en el archivo constant.js del bloque form en submitBaseUrl. Puede configurar la URL en función de su entorno:

Para la instancia de Cloud Service

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

Para desarrollo local

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

​2. Filtro de referente de OSGi

Configure el Filtro de referente para permitir los dominios de sitio específicos de Edge Delivery:

1. Crear o actualizar el archivo de configuración de OSGi: org.apache.sling.security.impl.ReferrerFilter.cfg.json

2. Agregue la siguiente configuración con los dominios de sitio específicos:

   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. Implementar la configuración mediante Cloud Manager

Para obtener la configuración detallada del filtro de referente de OSGi, consulte la guía Filtro de referente.

​3. Problemas del CORS (Intercambio de Recursos de Origen Cruzado)

Configure las opciones de CORS en AEM para permitir solicitudes de los dominios de sitio específicos de Edge Delivery:

Host local de desarrollador

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

Sitios de Edge Delivery: agregue cada dominio de sitio individualmente

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

Dominios Franklin heredados (si todavía están en 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

Para obtener información detallada sobre la configuración de CORS, consulte la Guía de configuración de CORS.

Para habilitar CORS para su entorno de desarrollo local, consulte el artículo de Comprender el Intercambio de Recursos de Origen Cruzado (CORS).

​4. Configuración de formularios

1. Crear formulario en el editor universal
2. Configurar la acción de envío para dirigirla a la acción de AEM Forms
3. Especificar ruta de punto final de envío
4. Publicar formulario en el sitio de Edge Delivery

1. Crear estructura de formulario en Hojas de cáclculo o Documentos de Google
2. Configurar punto final de servicio de envío de formularios
3. Conceder acceso de edición de forms@adobe.com a la hoja de cálculo de destino
4. Publicar el documento en el sitio de Edge Delivery.
5. Probar el envío de formularios y el flujo de datos

1. Generar formulario en el editor universal
2. Configurar la acción de envío para “Invocar flujo de trabajo de AEM”
3. Configurar Dispatcher y el filtro de referente en publicación de AEM
4. Configurar reglas de enrutamiento de CDN
5. Publicar formularios y probar la ejecución del flujo de trabajo