Servicio de envío de Forms con Edge Delivery Services Forms
- Temas:
- Edge Delivery Services
Esta característica está disponible a través del programa de acceso anticipado. Para solicitar acceso, envíe un correo electrónico con el nombre de su organización de GitHub y el nombre del repositorio desde su dirección oficial a aem-forms-ea@adobe.com. Por ejemplo, si la dirección URL del repositorio es https://github.com/adobe/abc, el nombre de la organización es adobe y el nombre del repositorio es abc.
El servicio de envío de Forms le permite almacenar datos de los envíos de formularios en cualquier hoja de cálculo, como OneDrive, SharePoint o Hojas de cálculo de Google, lo que le permite acceder y administrar fácilmente los datos del formulario en su plataforma de hoja de cálculo preferida.
Ventajas de utilizar el servicio de envío de Forms
Algunas ventajas de utilizar el servicio de envío de Forms con hojas de cálculo son:
- Integración directa: puede configurar formularios para enviar datos directamente a una hoja de cálculo especificada, lo que elimina la necesidad de transferir datos manualmente.
- Estructura de datos: al configurar el envío, puede asignar campos de formulario a columnas de hoja de cálculo correspondientes para el almacenamiento de datos organizado.
- Control de acceso: puede aprovechar los permisos existentes para controlar quién puede tener acceso a los datos de formulario enviados y modificarlos, en función del servicio de hoja de cálculo elegido.
Requisitos previos
A continuación se muestran los requisitos previos para utilizar el servicio de envío de Forms:
- Asegúrese de que el proyecto de AEM tenga el último bloque de formulario adaptable.
- Asegúrese de que el repositorio de Git se añada a la lista de permitidos para utilizar el servicio de envío de Forms. mailto:aem-forms-ea@adobe.com con su nombre de organización de GitHub y el nombre de repositorio para que se añadan a la lista de permitidos para utilizar el servicio de envío de Forms.
Configuración del servicio de envío de Forms
Cree un nuevo proyecto de AEM configurado con el bloque de Forms adaptable. Consulte el artículo Introducción - Tutorial para desarrolladores para aprender a crear un nuevo proyecto de AEM. Actualice el archivo fstab.yaml en el proyecto. Reemplace la referencia existente por la ruta de acceso a la carpeta que ha compartido con el forms@adobe.com
Puede configurar el servicio de envío de Forms manualmente o configurar el servicio de envío de Forms mediante la API.
Configuración manual del servicio de envío de Forms
1. Crear un formulario con una definición de formulario
Crear un formulario con Hojas de cálculo de Google o Microsoft Excel. Para aprender a crear un formulario con una definición de formulario en Microsoft Excel o Google Sheets, haga clic aquí.
La siguiente captura de pantalla muestra la definición del formulario utilizada para crear el formulario:
2. Active la hoja de cálculo para aceptar datos.
Una vez creado y previsualizado el formulario, habilite la hoja de cálculo correspondiente para que comience a recibir datos. agregar una hoja nueva como incoming. Puede habilitar manualmente la hoja de cálculo para aceptar datos.
WARNINGincoming no existe, AEM no enviará ningún dato a este libro.3. Comparta la hoja de cálculo y genere un vínculo.
Para compartir la hoja de cálculo en la cuenta de forms@adobe.com y generar un vínculo, realice los siguientes pasos:
-
En Excel o Google Sheets, haga clic en el botón Compartir en la esquina superior derecha.
-
Agregue la cuenta de
forms@adobe.comy
haz clic en el icono del ojo, selecciona el acceso de Editar y haz clic en Enviar.
-
Para copiar el vínculo de la hoja de cálculo, haga clic en el botón Compartir en la esquina superior derecha y seleccione Copiar vínculo.
4. Vincule la hoja de cálculo en la definición del formulario
Para configurar el servicio de envío de Forms con Google Sheets o Microsoft Excel, realice los siguientes pasos:
-
Abra la hoja de cálculo que contiene la definición del formulario.
-
En la fila correspondiente al campo Enviar, pegue el vínculo de hoja de cálculo copiado en la columna Acción.
-
Obtenga una vista previa y publique la hoja mediante AEM Sidekick con el servicio de envío de formularios actualizado.
NOTEConfiguración del servicio de envío de Forms mediante API
También puede enviar una solicitud POST al formulario para actualizar la hoja incoming con datos.
NOTE- Si la hoja
incomingno existe, AEM no enviará ningún dato a este libro. - Compartir la hoja
incomingcon Adobe Experience Manager elforms@adobe.comy conceder acceso de edición. - Previsualizar y publicar la hoja
incomingen la barra de tareas.
Para saber cómo dar formato a la petición POST para configurar su hoja, consulte la documentación de API. Puede ver el ejemplo que se proporciona a continuación:
Puede utilizar herramientas como curl o Postman para ejecutar esta petición POST, como se muestra a continuación.
- Usando Postman:
Por ejemplo, envíe la solicitud siguiente en Postman después de reemplazar:
-
{id}con su ID de formulario -
site or repositorycon su nombre de sitio o repositorio de GitHub -
organizationcon su nombre de usuario de 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" } }'
Al hacer clic en el botón Enviar en Postman, se devuelve una respuesta 201 Created y la hoja incoming se actualiza con los datos enviados.
- Usando el comando Curl:
Por ejemplo, ejecute el siguiente comando en el terminal o símbolo del sistema después de reemplazar:
{id}con su ID de formulariosite or repositorycon su nombre de sitio o repositorio de GitHuborganizationcon su nombre de usuario de 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",
"destino": "Australia",
"clase": "Primera clase",
"presupuesto": "2000",
"importe": "1000000",
"nombre": "Joe",
"edad": "35",
"suscribirse": null,
"correo electrónico": "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\", \"destination\": \"Australia\", \"class\": \"First Class\", \"budget\": \"2000\", \"amount\": \"1000000\", \"name\": \"Joe\", \"age\": \"35\", \"subscribe\": null, \"email\": \"mary@gmail.com\"}"
"
La solicitud POST mencionada anteriormente actualiza la hoja incoming con la siguiente respuesta:
< 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
La siguiente pantalla muestra la captura de pantalla de la hoja incoming actualizada por el envío de datos mediante API:
Véase también
- Introducción a Edge Delivery Services para AEM Forms
- Crear un formulario con Google Sheets o Microsoft Excel
- Configurar Google Sheets o los archivos de Microsoft Excel para empezar a aceptar datos
- Publicar el formulario y empezar a recopilar datos
- Personalizar el aspecto de los formularios
- Añadir secciones repetibles a un formulario
- Mostrar un mensaje de agradecimiento personalizado después del envío del formulario
- Componentes de bloque de formulario adaptable y sus propiedades
- Uso del servicio de envío de formularios