Configure Google Sheets o los archivos de Microsoft Excel para empezar a aceptar datos
Una vez que haya creado y previsualizado el formulario, es hora de permitir que la hoja de cálculo correspondiente comience a recibir datos. Puede hacer lo siguiente:
Habilitar manualmente la hoja de cálculo para que acepte datos
Para permitir que la hoja de cálculo acepte datos
-
Abra la hoja de cálculo que tiene el formulario y anexe una hoja nueva, cambiando el nombre por el de
incoming
. Por ejemplo, el libro de Microsotf Excel del formulario de consulta.note warning WARNING Si la hoja incoming
no está presente, AEM no envía ningún dato a la hoja de cálculo. -
En esta hoja, inserte una tabla denominada "intake_form". Seleccione el número de columnas necesarias para hacer coincidir los nombres de los campos de formulario. A continuación, en la barra de herramientas, vaya a Insertar > Tabla y haga clic en Aceptar.
-
Cambie el nombre de la tabla por "intake_form". En Microsoft Excel, para cambiar el nombre de la tabla, seleccione la tabla y haga clic en Diseño de tabla.
-
A continuación, añada los nombres de los campos de formulario como encabezados de tabla. Para asegurarse de que los campos son exactamente los mismos, puede copiarlos y pegarlos en la hoja "shared-aem". En la hoja "shared-aem", seleccione y copie los ID de formulario listados en la columna "Nombre", excepto el campo de envío.
-
En la hoja "incoming", seleccione Pegado especial > Transponer filas a columnas para copiar los ID de campo como encabezados de columna en esta nueva hoja. Mantener solo los campos cuyos datos necesitan capturar otros datos se puede ignorar.
Cada valor de la columna
Name
de la hojashared-aem
, excluyendo el botón de envío, puede servir como encabezado en la hojaincoming
. Por ejemplo, considere la siguiente imagen que ilustra los encabezados de un formulario de "consulta": -
Utilice la extensión de AEM Sidekick para obtener una vista previa de las actualizaciones del formulario. La hoja ya está lista para aceptar los envíos de formulario entrantes.
note note NOTE Incluso si ya ha previsualizado la hoja anteriormente, debe volver a previsualizarla después de crear la hoja incoming
por primera vez.
Una vez añadidos los nombres de campo a la hoja incoming
, el formulario estará listo para aceptar envíos. Puede obtener una vista previa del formulario y enviar datos a la hoja utilizándolo.
Una vez configurada la hoja para recibir datos, puede previsualizar el formulario para empezar a enviar datos a la hoja.
Utilice las API de administrador para habilitar la aceptación de datos en la hoja de cálculo
También puede enviar una petición POST al formulario para habilitarla para que acepte datos y configurar los encabezados de la hoja incoming
. Al recibir la petición POST, el servicio analiza el cuerpo de la solicitud y genera de forma autónoma los encabezados y hojas esenciales necesarios para la ingesta de datos.
Para utilizar las API de administrador para habilitar una hoja de cálculo que acepte datos:
-
Abra el libro que ha creado y cambie el nombre de la hoja predeterminada a
incoming
.note warning WARNING Si la hoja incoming
no existe, AEM no enviará ningún dato a este libro de trabajo. -
Previsualice la hoja en la barra de tareas.
note note NOTE Incluso si ya ha previsualizado la hoja anteriormente, debe volver a previsualizarla después de crear la hoja incoming
por primera vez. -
Envíe la petición POST para generar los encabezados adecuados en la hoja
incoming
y añada las hojasshared-default
a la hoja de cálculo, si no existe todavía.Para saber cómo dar formato a la petición POST para configurar la hoja, consulte la Documentación de API de administrador. Puede ver el ejemplo que se proporciona a continuación:
Petición
code language-json POST 'https://admin.aem.page/form/{owner}/{repo}/{branch}/contact-us.json' \ --header 'Content-Type: application/json' \ --data '{ "data": { "Email": "john@wknd.com", "Name": "John", "Subject": "Regarding Product Inquiry", "Message": "I have some questions about your products.", "Phone": "123-456-7890", "Company": "Adobe Inc.", "Country": "United States", "PreferredContactMethod": "Email", "SubscribeToNewsletter": true } }'
Respuesta
code language-json HTTP/2 200 content-type: application/json x-invocation-id: 1b3bd30a-8cfb-4f85-a662-4b1f7cf367c5 cache-control: no-store, private, must-revalidate accept-ranges: bytes date: Sat, 10 Feb 2024 09:26:48 GMT via: 1.1 varnish x-served-by: cache-del21736-DEL x-cache: MISS x-cache-hits: 0 x-timer: S1707557205.094883,VS0,VE3799 strict-transport-security: max-age=31557600 content-length: 138 {"rowCount":2,"columns":["Email","Name","Subject","Message","Phone","Company","Country", "PreferredContactMethod","SubscribeToNewsletter"]}%
Puede utilizar herramientas como cURL o Postman para ejecutar esta petición POST, como se muestra a continuación:
code language-json curl -s -i -X POST 'https://admin.aem.page/form/wkndform/wefinance/main/contact-us.json' \ --header 'Content-Type: application/json' \ --data '{ "data": { "Email": "john@wknd.com", "Name": "John", "Subject": "Regarding Product Inquiry", "Message": "I have some questions about your products.", "Phone": "123-456-7890", "Company": "Wknd Inc.", "Country": "United States", "PreferredContactMethod": "Email", "SubscribeToNewsletter": true } }'
La petición POST mencionada anteriormente proporciona datos de muestra, incluidos los campos de formulario y sus respectivos valores de ejemplo. El servicio de administración utiliza estos datos para configurar el formulario.
El formulario ahora está habilitado para aceptar datos. También observará los siguientes cambios en la hoja de cálculo:
Cambios automáticos en la hoja una vez que está habilitada para aceptar datos.
Una vez que la hoja está configurada para recibir datos, se observan los siguientes cambios en la hoja de cálculo:
Se agrega una hoja denominada “Slack” al libro de Excel o a la hoja de Google Sheets. En esta hoja, puede configurar las notificaciones automáticas para un canal de Slack designado cada vez que se incorporen nuevos datos en la hoja de cálculo. En la actualidad, AEM admite notificaciones únicamente a las organizaciones AEM Engineering Slack y Adobe Enterprise Support.
-
Para configurar las notificaciones de Slack, escriba “teamId” en el espacio de trabajo de Slack y el nombre del canal o “ID”. También puede solicitar al bot de Slack (con el comando debug) para el “teamId” y “channel ID”. Es preferible utilizar el “ID de canal” en lugar del “nombre de canal”, ya que se mantiene después de cambiar el nombre del canal.
note note NOTE Los formularios anteriores no tenían la columna “teamId”. El “teamId” se incluía en la columna del canal, separado por “#” o “/”. -
Introduzca el título que desee y en los campos escriba los nombres de los campos que desea ver en la notificación de Slack. Cada encabezado debe separarse con una coma (por ejemplo, nombre, correo electrónico).
note warning WARNING Las hojas "shared-default" nunca deben contener información personal identificable o datos confidenciales con los que no se sienta cómodo si tienen acceso público.
A continuación, puede personalizar el mensaje de agradecimiento.
Ver 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