Proxy de servicio de formularios HTML5

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

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

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

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

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?

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.

En esta página