Configurar la acción de envío configuring-the-submit-action

Adobe recomienda utilizar la captura de datos moderna y ampliable Componentes principalespara crear un nuevo formulario adaptableo añadir formularios adaptables a páginas de AEM Sites. Estos componentes representan un avance significativo en la creación de formularios adaptables, lo que garantiza experiencias de usuario impresionantes. Este artículo describe un enfoque más antiguo para crear Formularios adaptables con componentes de base.

Introducción al envío de acciones introduction-to-submit-actions

Se activa una acción de envío cuando un usuario hace clic en el botón Enviar en un formulario adaptable. Puede configurar la acción de envío en el formulario adaptable. Los formularios adaptables proporcionan algunas acciones de envío listas para usar. También puede copiar y ampliar las acciones de envío predeterminadas para crear la suya propia. Sin embargo, según sus necesidades, puede escribir y registrar su propia acción de envío para procesar los datos en el formulario enviado. Una acción de envío puede utilizar el envío sincrónico o asincrónico.

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.

Configurar la acción de envío

Las acciones de envío predeterminadas disponibles con los formularios adaptables son las siguientes:

Puede escribir una acción de envío personalizada para formularios adaptables para que cumplan con su caso de uso. Para obtener más información, consulte Escribir una acción de envío personalizada para formularios adaptables.

Enviar al punto final REST submit-to-rest-endpoint

La opció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 Experience Manager que aloja el formulario, utilice una ruta relativa correspondiente a la ruta raíz del servidor de Experience Manager. Por ejemplo, /content/forms/af/SampleForm.html. Para enviar datos a cualquier otro servidor, utilice la ruta absoluta.

Configurar la acción de envío del punto final de REST.

Publicar datos enviados en un recurso o punto final REST externo  post-submitted-data-to-a-resource-or-external-rest-end-point-nbsp

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 dirección URL es 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.

Enviar correo electrónico send-email

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.

Enviar PDF por correo electrónico send-pdf-via-email

La acción de envío Enviar PDF por correo electrónico envía un mensaje de correo electrónico con un PDF que contiene datos del formulario a uno o varios destinatarios cuando el formulario se envía correctamente.

Invocar un flujo de trabajo de formularios invoke-a-forms-workflow

La acción de envío Enviar al flujo de trabajo de Forms envía un xml de datos y archivos adjuntos (si los hay) a un Adobe LiveCycle existente o a AEM Forms en un proceso JEE.

Para obtener información sobre cómo configurar la acción Enviar a la acción de envío del flujo de trabajo de Forms, consulte Enviar y procesar los datos del formulario mediante flujos de trabajo de formulario.

Enviar mediante modelo de datos de formulario submit-using-form-data-model

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 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 y un documento de registro (DoR).

Para obtener información sobre el modelo de datos de formulario, consulte Integración de datos de AEM Forms.

Acción de envío de portal de formularios forms-portal-submit-action

La opción Acción de envío del portal de formularios hace que los datos de formulario estén disponibles a través del portal de AEM Forms.

Para obtener más información sobre el portal de formularios y la acción de envío, consulte Componente Borradores y presentaciones.

Invocar un flujo de trabajo de AEM invoke-an-aem-workflow

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 de 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 para almacenar datos externos, estará disponible la opción de variable y no la de carga útil. 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.

Antes de usar la acción de envío Invocar un flujo de trabajo de AEM, configure el DS de Experience Manager. Para obtener información sobre crear un flujo de trabajo de AEM, consulte Flujos de trabajo centrados en formularios en OSGi.

La acción de envío coloca lo siguiente en la ubicación de carga útil del flujo de trabajo. Sin embargo, tenga en cuenta que solo se mostrará la opción Variable si el modelo de flujo de trabajo está marcado para almacenar datos externos y no para la opción de carga útil.

Enviar a Power Automate microsoft-power-automate

Puede configurar un formulario adaptable para ejecutar un flujo de nube de Microsoft® Power Automate en el envío. El formulario adaptable configurado envía los datos capturados, los archivos adjuntos y el documento de registro al flujo de nube de Power Automate para su procesamiento. Le ayuda a crear una experiencia de captura de datos personalizados mientras aprovecha el poder de Microsoft® Power Automate para crear lógicas empresariales en torno a los datos capturados y automatizar los flujos de trabajo de los clientes. A continuación se muestran algunos ejemplos de lo que puede hacer después de integrar un formulario adaptable con Microsoft® Power Automate:

El editor de formularios adaptables ofrece la acción de envío Invocar un flujo de Microsoft® Power Automate para enviar datos de formularios adaptables, archivos adjuntos y documentos de registro a flujos de nube de Power Automate. Para usar la acción Enviar para enviar los datos capturados a Microsoft® Power Automate, Conecte la instancia de AEM Forms con Microsoft® Power Automate

Después de una configuración correcta, utilice la acción de envío Invocar un flujo de Microsoft® Power Automate para enviar datos a un flujo de Power Automate.

Enviar a la lista de Microsoft® SharePoint submit-to-sharedrive

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.

Conectar un formulario adaptable a la lista de Microsoft® SharePoint connect-af-sharepoint-list

Para conectar un formulario adaptable a la lista de Microsoft® SharePoint:

Crear configuración de lista de SharePoint create-sharepoint-list-configuration

Para conectar AEM Forms a su lista de Sharepoint de Microsoft®:

Usar la acción de envío Enviar con el modelo de datos de formulario en un formulario adaptable use-submit-using-fdm

Puede utilizar la configuración de lista de SharePoint creada en un formulario adaptable para guardar datos o el documento de registro generado en una lista de SharePoint. Siga estos pasos para usar una configuración de almacenamiento de lista de SharePoint en un formulario adaptable como:

Al enviar el formulario, los datos se guardan en el almacenamiento de lista de Sharepoint de Microsoft® especificado.

Revalidación del lado del servidor en formularios adaptables server-side-revalidation-in-adaptive-form

Normalmente, en cualquier sistema de captura de datos en línea, los desarrolladores colocan algunas validaciones de JavaScript en el lado del cliente para aplicar algunas reglas empresariales. Sin embargo, en los exploradores modernos, los usuarios finales tienen la forma de evitar esas validaciones y realizar envíos manualmente mediante diversas técnicas, como la consola de desarrolladores del explorador web. Estas técnicas también son válidas para formularios adaptables. Un desarrollador de formularios puede crear varias lógicas de validación, pero técnicamente, los usuarios finales pueden omitir esas lógicas de validación y enviar datos no válidos al servidor. Los datos no válidos romperían las reglas empresariales que ha impuesto un autor de formularios.

La característica de revalidación del lado del servidor permite ejecutar también las validaciones que ha proporcionado un autor de formularios adaptables al diseñar un formulario adaptable en el servidor. Evita cualquier posible compromiso en el envíos de datos y violaciones de reglas empresariales representadas en términos de validaciones de formularios.

¿Qué se debe validar en el servidor? what-to-validate-on-server-br

Todas las validaciones de campo listas para usar de un formulario adaptable que se vuelven a ejecutar en el servidor son las siguientes:

Habilitar la validación del lado del servidor enabling-server-side-validation-br

Utilice Revalidar en el servidor en el contenedor de formularios adaptables en la barra lateral para habilitar o deshabilitar la validación del lado del servidor para el formulario actual.

Habilitar la validación del lado del servidor

Si el usuario final omite esas validaciones y envía los formularios, el servidor volverá a realizar la validación. Si la validación falla al final del servidor, se detendrá la transacción del envío. Al usuario final se le volverá a presentar el formulario original. Los datos capturados y enviados se presentarán al usuario como un error.

Compatibilidad con funciones personalizadas en expresiones de validación supporting-custom-functions-in-validation-expressions-br

A veces, si hay reglas de validación complejas, el script de validación exacta reside en funciones personalizadas y el autor llama a estas funciones personalizadas desde la expresión de validación de campo. Para que esta biblioteca de funciones personalizadas sea conocida y esté disponible mientras se realizan las validaciones del lado del servidor, el autor del formulario puede configurar el nombre de la biblioteca de cliente de AEM en la pestaña Básico de las propiedades del contenedor del formulario adaptable como se muestra a continuación.

Compatibilidad con funciones personalizadas en expresiones de validación

El autor puede configurar la biblioteca customJavaScript para formularios adaptables. En la biblioteca, mantenga solo las funciones reutilizables, que dependen de las bibliotecas de terceros jquery y underscore.js.

Tratar errores en la acción de envío error-handling-on-submit-action

Como parte de las directrices de seguridad y endurecimiento de Experience Manager, configure páginas de error personalizadas como, 404.jsp y 500.jsp. Se llama a estos controladores cuando aparecen errores 404 o 500 al enviar un formulario. También se llama a los controladores cuando estos códigos de error se activan en el nodo Publish.

Para obtener más información, consulte Personalizar páginas que muestra el Controlador de errores.