Acción de envío de un formulario adaptable
| Versión | Vínculo del artículo |
|---|---|
| AEM 6.5 | Haga clic aquí |
| AEM as a Cloud Service (componentes principales) | Haga clic aquí |
| AEM as a Cloud Service (componentes de base) | Este artículo |
Se aplica a: ✔️ los componentes de base de formulario adaptable. ❌ Componentes principales del Formulario adaptable. Adobe recomienda utilizar los componentes principales para añadir Formularios adaptables a una página de AEM Sites o para crear Formularios adaptables independientes.
Se activa una acción de envío cuando un usuario hace clic en el botón Enviar en un formulario adaptable. Forms as a Cloud Service proporciona las siguientes acciones de envío listas para usar.
También puede ampliar las acciones de envío predeterminadas para crear su propia acción de envío.
Puede configurar una acción de envío en la sección Envío de las propiedades del contenedor del formulario adaptable, en la barra lateral.
Enviar al punto final REST
Utilice la acción Enviar al punto final REST para publicar los datos enviados en una URL de REST. La URL puede ser de un servidor interno (el servidor en el que se procesa el formulario) o externo.
Para enviar datos a un servidor interno, proporcione la ruta del recurso. Los datos se publican en la ruta del recurso. Por ejemplo, /content/restEndPoint. Para esas peticiones POST se utiliza la información de autenticación de la solicitud de envío.
Para enviar datos a un servidor externo, proporcione una URL. El formato de la URL es el siguiente https://host:port/path_to_rest_end_point. Asegúrese de configurar la ruta para controlar la petición POST de forma anónima.
En el ejemplo anterior, el usuario ha escrito información en textbox y se captura mediante el parámetro param1. La sintaxis para anunciar datos capturados con param1 es la siguiente:
String data=request.getParameter("param1");
Del mismo modo, los parámetros que utiliza para publicar datos XML y archivos adjuntos son dataXml y attachments.
Por ejemplo, utiliza estos dos parámetros en el script para analizar los datos en un punto final de REST. Se utiliza la siguiente sintaxis para almacenar y analizar los datos:
String data=request.getParameter("dataXml");String att=request.getParameter("attachments");
En este ejemplo, data almacena los datos XML y att almacena datos adjuntos.
La acción de envío Enviar al punto final REST envía los datos rellenados en el formulario a una página de confirmación configurada como parte de la petición HTTP GET. Puede agregar el nombre de los campos que desea solicitar. El formato de la solicitud es el siguiente:
{fieldName}={request parameter name}
Como se muestra en la siguiente imagen, param1 y param2 se pasan como parámetros con valores copiados de los campos cuadro de texto y del cuadro numérico para la siguiente acción.
También puede Habilitar la petición POST y proporcionar una URL para publicar la solicitud. Para enviar datos al servidor de AEM que aloja el formulario, utilice una ruta relativa correspondiente a la ruta raíz del servidor de AEM. Por ejemplo, /content/forms/af/SampleForm.html. Para enviar datos a cualquier otro servidor, utilice la ruta absoluta.
NOTAEnviar correo electrónico
Puede usar la acción de envío Enviar correo electrónico para enviar un correo electrónico a uno o varios destinatarios cuando el formulario se haya enviado correctamente. El correo electrónico generado puede contener datos de formulario en un formato predefinido. Por ejemplo, en la siguiente plantilla, el nombre del cliente, la dirección de envío, el nombre del estado y el código postal se recuperan de los datos del formulario enviado.
```
Hola, ${customer_Name},
La siguiente se establece como su dirección de envío predeterminada:
${customer_Name},
${customer_Shipping_Address},
${customer_State},
${customer_ZIPCode}
Un saludo,
WKND
```
- Todos los campos del formulario deben tener nombres de elemento diferentes, incluso si se colocan en paneles diferentes de un formulario adaptable.
- AEM as a Cloud Service requiere que el correo saliente esté cifrado. De forma predeterminada, el correo electrónico saliente está deshabilitado. Para habilitarlo, envíe un ticket de asistencia a Solicitar acceso.
También puede incluir archivos adjuntos y un documento de registro (DoR) en el correo electrónico. Para habilitar la opción Adjuntar documento de registro, configure el formulario adaptable para generar un documento de registro (DoR). Puede habilitar la opción para generar un documento de registro a partir de las propiedades del formulario adaptable.
Enviar mediante el modelo de datos de formulario (FDM)
La acción de envío Enviar mediante el modelo de datos de formulario escribe los datos del formulario adaptable enviados para el objeto del modelo de datos especificado en un modelo de datos de formulario (FDM) en su fuente de datos. Al configurar la acción de envío, puede elegir un objeto de modelo de datos cuyos datos enviados desee volver a escribir en su fuente de datos.
Además, puede enviar a la fuente de datos un archivo adjunto de formulario mediante un modelo de datos de formulario (FDM) y un documento de registro (DoR). Para obtener información sobre el modelo de datos de formulario (FDM), consulte integración de datos de AEM Forms.
Invocar un flujo de trabajo de AEM
La acción de envío Invocar un flujo de trabajo de AEM asocia un formulario adaptable con un Flujo de trabajo de AEM. Cuando se envía un formulario, el flujo de trabajo asociado se inicia automáticamente en la instancia Autor. Puede guardar el archivo de datos, los archivos adjuntos y el documento de registro en la ubicación de carga útil del flujo de trabajo o en una variable. Si el flujo de trabajo está marcado y configurado para el almacenamiento de datos externo, solo estará disponible la opción de variable. Puede seleccionar de la lista de variables disponibles para el modelo de flujo de trabajo. Si el flujo de trabajo está marcado para el almacenamiento de datos externos en una fase posterior y no en el momento de la creación del flujo de trabajo, asegúrese de que las configuraciones de variables requeridas estén establecidas.
La acción de envío coloca lo siguiente en la ubicación de carga útil del flujo de trabajo, o la variable si el flujo de trabajo está marcado para el almacenamiento de datos externos:
-
Archivo de datos: Contiene datos enviados al formulario adaptable. Puede usar la opción Ruta del archivo de datos para especificar el nombre y la ruta del archivo en relación con la carga útil. Por ejemplo, la ruta
/addresschange/data.xmlcrea una carpeta llamadaaddresschangey la coloca en relación a la carga útil. También puede especificar únicamentedata.xmlpara enviar solo los datos enviados sin crear una jerarquía de carpetas. Si el flujo de trabajo está marcado para el almacenamiento de datos externos, utilice la opción de variable y seleccione la variable de la lista de variables disponibles para el modelo de flujo de trabajo. -
Archivos adjuntos: Puede usar la opción Ruta de archivos adjuntos para especificar el nombre de la carpeta en la que se almacenarán los archivos adjuntos cargados en el formulario adaptable. La carpeta se creará en relación con la carga útil. Si el flujo de trabajo está marcado para el almacenamiento de datos externos, utilice la opción de variable y seleccione la variable de la lista de variables disponibles para el modelo de flujo de trabajo.
-
Documento de registro: Contiene el documento de registro generado para el formulario adaptable. Puede usar la opción Ruta del documento de registro para especificar el nombre y la ruta del documento de registro en relación con la carga útil. Por ejemplo, la ruta
/addresschange/DoR.pdfcrea una carpeta llamadaaddresschangeen relación con la carga útil y colocaDoR.pdfen relación con la carga útil. También puede especificar únicamenteDoR.pdfpara guardar solo el documento de registro sin crear una jerarquía de carpetas. Si el flujo de trabajo está marcado para el almacenamiento de datos externos, utilice la opción de variable y seleccione la variable de la lista de variables disponibles para el modelo de flujo de trabajo.
Antes de usar la acción de envío Invocar un flujo de trabajo de AEM, configure lo siguiente en la configuración del Servicio de configuración de AEM DS:
-
URL del servidor de procesamiento: El servidor de procesamiento es el servidor en el que se activa Forms o AEM Workflow. Puede ser la misma que la URL de la instancia Autor de AEM u otro servidor.
-
Nombre de usuario del servidor de procesamiento: Nombre del usuario del flujo de trabajo
-
Contraseña del servidor de procesamiento: contraseña del usuario del flujo de trabajo
Enviar a SharePoint
La acción de envío Enviar a SharePoint conecta un formulario adaptable con un almacenamiento de Microsoft® SharePoint. Puede enviar el archivo de datos de formulario, los archivos adjuntos o el documento de registro al almacenamiento de Microsoft® SharePoint conectado.
Con Enviar a SharePoint, puede hacer lo siguiente:
Conectar un formulario adaptable a la biblioteca de documentos de SharePoint
Para usar la acción de envío Enviar a Biblioteca de documentos de SharePoint en un formulario adaptable:
- Crear una configuración de Biblioteca de documentos de SharePoint: conecta AEM Forms a su almacenamiento de Microsoft® SharePoint.
- Utilice la acción de envío Enviar a SharePoint en un formulario adaptable: conecta el formulario adaptable al Microsoft® SharePoint configurado.
Crear configuración de biblioteca de documentos de SharePoint
Para conectar AEM Forms a su almacenamiento de Biblioteca de documentos de Microsoft® Sharepoint:
-
Vaya a su instancia de AEM Forms Author > Herramientas > Cloud Services > Microsoft® SharePoint.
-
Una vez seleccionada la variable Microsoft® SharePoint, se le redirigirá a Explorador SharePoint.
-
Seleccione un Contenedor de configuración. La configuración se almacena en el contenedor de configuración seleccionado.
-
Haga clic en Crear > Biblioteca de documentos de SharePoint en la lista desplegable. Aparecerá el asistente de configuración de SharePoint.
-
Especifique el Título, ID de cliente, Secreto del cliente y URL de OAuth. Para obtener información sobre cómo recuperar el ID de cliente, el secreto de cliente o el ID de inquilino para la URL de OAuth, consulte Documentación de Microsoft®.
- Puede recuperar la variable
Client IDyClient Secretde su aplicación desde el portal de Microsoft® Azure. - En el portal de Microsoft® Azure, añada el URI de redireccionamiento como
https://[author-instance]/libs/cq/sharepoint/content/configurations/wizard.html. Reemplace[author-instance]por la URL de su instancia de autor. - Añada los permisos de API
offline_accessySites.Manage.Allpara proporcionar permisos de lectura y escritura. - Use la URL de OAuth:
https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorize. Reemplace<tenant-id>por eltenant-idde su aplicación desde el portal de Microsoft® Azure.
NOTAEl campo secreto de cliente es obligatorio u opcional dependiendo de su configuración de la aplicación de Azure Active Directory. Si la aplicación está configurada para utilizar un secreto de cliente, es obligatorio proporcionar dicho secreto. - Puede recuperar la variable
-
Haga clic en Conectar. Si la conexión se realiza correctamente, aparece el mensaje
Connection Successful. -
Ahora, seleccione Sitio de SharePoint > Biblioteca de documentos > Carpeta de SharePoint, para guardar los datos.
NOTA- De forma predeterminada,
forms-ootb-storage-adaptive-forms-submissionestá presente en el sitio de SharePoint seleccionado. - Cree una carpeta como
forms-ootb-storage-adaptive-forms-submissionsi no está presente en la bibliotecaDocumentsdel sitio de SharePoint seleccionado haciendo clic en Crear carpeta.
- De forma predeterminada,
Ahora puede utilizar esta configuración de SharePoint Sites para la acción de envío en un formulario adaptable.
Uso de la configuración de la biblioteca de documentos de SharePoint en un formulario adaptable
Puede utilizar la configuración de la biblioteca de documentos de SharePoint creada en un formulario adaptable para guardar datos o el documento de registro generado en una carpeta de SharePoint. Siga estos pasos para usar una configuración de almacenamiento de la biblioteca de documentos de SharePoint en un formulario adaptable como el siguiente:
-
Crear un Formulario adaptable.
NOTA- Seleccione el mismo Contenedor de configuración para un formulario adaptable, donde haya creado su almacenamiento de la biblioteca de documentos de SharePoint.
- Si no se selecciona ningún Contenedor de configuración, a continuación, las carpetas globales Configuración de almacenamiento aparecen en la ventana de propiedades de la acción de envío.
-
Seleccionar Acción de envío como Enviar a SharePoint.
-
Seleccione la Configuración de almacenamiento, donde desee guardar los datos.
-
Haga clic en Guardar para guardar la configuración de envío.
Al enviar el formulario, los datos se guardan en el almacenamiento especificado de la biblioteca de documentos de Microsoft® SharePoint.
La estructura de carpetas para guardar datos es /folder_name/form_name/year/month/date/submission_id/data.
NOTA/folder_name/form_name/year/month/date/submission_id/data. Sin embargo, si selecciona Guardar archivos adjuntos con el nombre original, los archivos adjuntos se almacenarán en la carpeta utilizando sus nombres de archivo originales.
