Proxy de servicio de formularios HTML5 html-forms-service-proxy

El proxy de servicio de formularios HTML5 es una configuración para registrar un proxy para el servicio de envío. Para configurar el proxy de servicio, especifique la URL del servicio de envío mediante el parámetro de solicitud submissionServiceProxy.

Ventajas del proxy de servicio benefits-of-service-proxy-br

El proxy de servicio elimina lo siguiente:

  • El flujo de trabajo de formularios HTML5 requiere la apertura del servicio de envío “/content/xfaforms/submission/default” para los usuarios de formularios HTML5. Expone servidores de AEM a una audiencia no deseada más amplia.
  • La URL del servicio está incrustada en el modelo de tiempo de ejecución del formulario. No es posible cambiar la ruta de la URL del servicio.
  • El envío es un proceso de dos pasos. Para enviar los datos del formulario, el envío requiere al menos dos recorridos para el servidor. Por lo tanto, aumenta la carga en el servidor.
  • Los formularios HTML5 envían datos en la solicitud POST en lugar de en la solicitud PDF. Para el flujo de trabajo que incluye formularios PDF y HTML5, se requieren dos métodos diferentes de procesamiento de los envíos.

Topologías topologies-br

Los formularios HTML5 pueden utilizar las siguientes topologías para conectarse a los servidores de AEM.

  • Topología en la que los formularios de AEM Server o HTML5 envían datos mediante POST al servidor.
  • Topología en la que el servidor proxy envía datos de POST al servidor.

Topologías de proxy de servicio de formularios HTML5

Topologías de proxy de servicio de formularios HTML5

Los formularios HTML5 se conectan a los servidores de AEM para ejecutar scripts, servicios web y envíos del lado del servidor. El tiempo de ejecución XFA de los formularios HTML5 utiliza llamadas Ajax en el punto final “/bin/xfaforms/submitaction” con varios parámetros para conectarse a los servidores de AEM. Los formularios HTML5 conectan servidores de AEM para realizar las siguientes operaciones:

Ejecutar scripts y servicios web del lado del servidor execute-server-sided-scripts-and-web-services

Los scripts marcados para ejecutarse en el servidor se conocen como scripts del lado del servidor. En la siguiente tabla se enumeran todos los parámetros utilizados en scripts del lado del servidor y servicios web.

Parámetro
Descripción
activity
Activity contiene los eventos que configuran el activador de la solicitud. Como clic, salida o cambio
contextSom
contextSom contiene la expresión SOM del objeto donde se ejecutan los eventos.
Template
Template contiene la plantilla utilizada para procesar el formulario.
contentRoot
contentRoot contiene el directorio raíz de la plantilla utilizado para procesar el formulario.
Data
Data contiene bytes de datos utilizados para procesar el formulario.
formDom
formDom contiene el DOM del formulario HTML5 en formato JSON.
packet
packet se especifica como formulario.
debugDir
debugDir contiene el directorio de depuración utilizado para procesar el formulario.

Enviar datos submit-data

Al hacer clic en el botón Enviar, los formularios HTML5 envían datos al servidor. En la siguiente tabla se enumeran todos los parámetros que envían los formularios HTML5 al servidor.

Parámetro
Descripción
Template
Plantilla utilizada para procesar el formulario.
contentRoot
directorio raíz de plantilla que se utiliza para procesar el formulario.
Datos
bytes de datos utilizados para procesar el formulario.
formDom
DOM del formulario HTML5 en formato JSON.
submiturl
Dirección URL donde se publican los datos XML.
debugDir
Directorio de depuración utilizado para procesar el formulario.

¿Cómo funciona el proxy de envío? how-nbsp-the-nbsp-submit-proxy-works

El proxy del servicio de envío actúa como un paso a través si submiturl no está presente en el parámetro de la solicitud. Actúa como una transmisión. Envía la solicitud al punto final /bin/xfaforms/submitaction y envía la respuesta al tiempo de ejecución de XFA.

El proxy del servicio de envío selecciona una topología si el envío está presente en el parámetro de solicitud.

  • Si los servidores de AEM publican los datos, el servicio proxy actuará como un paso a través. Envía la solicitud al punto final /bin/xfaforms/submitaction y envía la respuesta al tiempo de ejecución de XFA.

  • Si el proxy publica los datos, el servicio proxy pasa todos los parámetros excepto submitUrl al punto final /bin/xfaforms/submitaction y recibe bytes xml en el flujo de respuesta. A continuación, el servicio proxy envía los bytes xml de datos a submitUrl para su procesamiento.

  • Antes de enviar datos (petición POST) a un servidor, los formularios HTML5 comprueban la conectividad y disponibilidad del servidor. Para comprobar la conectividad y la disponibilidad, los formularios HTML envían una solicitud de encabezado vacía al servidor. Si el servidor está disponible, el formulario HTML5 enviará datos (petición POST) al servidor. Si el servidor no está disponible, aparecerá un mensaje de error, No se pudo conectar al servidor. La detección avanzada evita que los usuarios tengan que rellenar el formulario. El servlet proxy administra la solicitud del encabezado y no emite excepciones.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2