Configurar un formulario adaptable para la acción de envío del punto final REST

La capacidad para especificar el punto final REST mediante la configuración es un programa para primeros usuarios y solo se aplica a los componentes principales y a formularios de Edge Delivery Services. Puede escribir a aem-forms-ea@adobe.com desde su ID de correo electrónico oficial para unirse al programa de primeros usuarios y solicitar acceso a esta funcionalidad.

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.

AEM as a Cloud Service ofrece varias acciones de envío predeterminadas para gestionar los envíos de formularios. Puede obtener más información sobre estas opciones en el artículo Acción de envío del formulario adaptable.

Ventajas

Algunas de las ventajas de configurar la acción de envío Enviar al punto final REST para los formularios adaptables son:

  • Permite la integración perfecta de los datos del formulario con los sistemas y servicios externos a través de las API de RESTful.
  • Proporciona flexibilidad para manejar envíos de datos de formularios adaptables, lo que admite estructuras de datos dinámicas y complejas.
  • Admite la asignación dinámica de campos de formulario a parámetros en la dirección URL del punto final REST, lo que permite envíos de datos adaptables y personalizables.

Configurar la acción de envío Enviar al punto final REST steps-to-configure-submit-to-restendpoint-submit-action

Componente base

Para configurar la acción de envío basada en la especificación de API abierta de Swagger para formularios adaptables basados en componentes de base, haga lo siguiente:

  1. Abra el formulario adaptable para editarlo y vaya a la sección Envío de las propiedades del contenedor del formulario adaptable.

  2. En la lista desplegable Acción de envío, seleccione la opción Enviar al punto final REST.

    Configuración de la acción de Enviar a punto final REST

    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 solicitudes POST se utiliza la información de autenticación de la solicitud de envío.
    Esta opción le permite introducir directamente el punto final REST de destino.
    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.
    Asignación de valores de campo pasados como parámetros de la página de agradecimiento

    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 de archivos 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 añadir 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.

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

    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.

  3. Haga clic en Listo.

Componente principal

Para configurar la acción de envío basada en la especificación de API abierta de Swagger para formularios adaptables basados en componentes principales, haga lo siguiente:

  1. Abra el Explorador de contenido y seleccione el componente Contenedor de guía del formulario adaptable.

  2. Haga clic en el icono de propiedades del contenedor de guía Propiedades de guía . Se abre el cuadro de diálogo Contenedor de formulario adaptable.

  3. Haga clic en la pestaña Envío.

  4. En la lista desplegable Acción de envío, seleccione la opción Enviar al punto final REST.

    Configuración del punto final REST

    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 solicitudes POST se utiliza la información de autenticación de la solicitud de envío.

    Tiene dos opciones para especificar el punto final REST:

    accordion
    URL
    Esta opción le permite introducir directamente el punto final REST de destino.

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.

Asignación de valores de campo pasados como parámetros de la página de agradecimiento

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 añadir 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.

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

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.

+++

accordion
Configuración
Esta opción le permite añadir una configuración HTTP predefinida administrada mediante el explorador de configuración de AEM. Puede seleccionar la configuración creada para su tipo de autenticación de punto final REST de servicio y los tipos de contenido. Para obtener más información acerca del tipo de autenticación y los tipos de contenido, visite Configurar fuentes de datos.
  1. Haga clic en Listo.
Editor universal

Para configurar la acción de envío basada en la especificación de la API abierta de Swagger para el formulario adaptable creado en el editor universal, haga lo siguiente:

  1. Abra el formulario adaptable para editarlo.

  2. Haga clic en la extensión Editar propiedades del formulario en el editor.
    Aparece el cuadro de diálogo Propiedades del formulario.

    note note
    NOTE
    • Si no ve el icono Editar propiedades del formulario en la interfaz del editor universal, habilite la extensión Editar propiedades del formulario en Extension Manager.
    • Consulte el artículo Características destacadas de las funciones de Extension Manager para obtener información sobre cómo habilitar y deshabilitar las extensiones del editor universal.

    1. Haga clic en la pestaña **Envío** y seleccione la acción de envío **Enviar al punto final REST**.

    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 solicitudes POST se utiliza la información de autenticación de la solicitud de envío.

    Tiene dos opciones para especificar el punto final REST:

    accordion
    URL
    Esta opción le permite introducir directamente el punto final REST de destino.

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.

Asignación de valores de campo pasados como parámetros de la página de agradecimiento

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 añadir 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.

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

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.

+++

accordion
Configuración
Esta opción le permite añadir una configuración HTTP predefinida administrada mediante el explorador de configuración de AEM. Puede seleccionar la configuración creada para su tipo de autenticación de punto final REST de servicio y los tipos de contenido. Para obtener más información acerca del tipo de autenticación y los tipos de contenido, visite configurar fuentes de datos.
  1. Haga clic en Guardar y cerrar.

Prácticas recomendadas

  • Al publicar datos en un servidor externo, asegúrese de que la dirección URL sea segura y configure la ruta para gestionar la petición POST de forma anónima a fin de proteger la información confidencial.
  • Para pasar los campos como parámetros en una URL REST, todos los campos deben tener nombres de elementos diferentes, incluso si se colocan en paneles diferentes.

Artículos relacionados

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab