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
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:
-
Abra el formulario adaptable para editarlo y vaya a la sección Envío de las propiedades del contenedor del formulario adaptable.
-
En la lista desplegable Acción de envío, seleccione la opción 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.
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 siguientehttps://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ámetroparam1
. La sintaxis para anunciar datos capturados conparam1
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
yattachments
.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 yatt
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
yparam2
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. -
Haga clic en Listo.
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:
-
Abra el Explorador de contenido y seleccione el componente Contenedor de guía del formulario adaptable.
-
Haga clic en el icono de propiedades del contenedor de guía
-
Haga clic en la pestaña Envío.
-
En la lista desplegable Acción de envío, seleccione la opción 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.
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.
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. |
- Haga clic en Listo.
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:
-
Abra el formulario adaptable para editarlo.
-
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.
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.
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. |
- 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
- Enviar correo electrónico
- Enviar a la biblioteca de documentos de SharePoint
- Enviar a la lista de SharePoint
- Enviar mediante el modelo de datos de formulario
- Enviar a Azure Blob Storage
- Enviar al punto final REST
- Enviar a OneDrive
- Invocar un flujo de trabajo de AEM
- Enviar a Power Automate
- Enviar a Workfront Fusion
- Conectar un formulario adaptable a la aplicación de Salesforce
- Conexión de un formulario adaptable a Microsoft
- Conectar un formulario adaptable a Adobe Marketo Engage
- Creación de una acción de envío personalizada