proxy de servicio de formularios HTML5

HTML5 forms Service Proxy 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 submitServiceProxy.

Ventajas del proxy de servicio

El proxy de servicio elimina lo siguiente:

El flujo de trabajo de formularios de HTML5 requiere la apertura del servicio de envío "/content/xfaforms/submit/default" para los usuarios de formularios de HTML5. Expone AEM servidores 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 de HTML5 envían datos en la solicitud del POST en lugar de en la solicitud del 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 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 del servicio de formularios HTML5

Los formularios de HTML5 se conectan a los servidores de AEM para ejecutar secuencias de comandos, 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 AEM. Los formularios de HTML5 conectan AEM servidores para realizar las siguientes operaciones:

Ejecución de scripts y servicios web del lado del servidor

Las secuencias de comandos marcadas para ejecutarse en el servidor se conocen como secuencias de comandos del lado del servidor. En la tabla siguiente se enumeran todos los parámetros utilizados en secuencias de comandos del lado del servidor y Web Services.

Parámetro	Descripción
activity	Activity contiene los eventos que configuran el déclencheur de la solicitud. Como clic, salida o cambio
contextSom	contextSom contiene la expresión SOM del objeto donde se ejecutan los eventos.
Plantilla	Plantilla contiene la plantilla utilizada para procesar el formulario.
contentRoot	contentRoot contiene el directorio raíz de la plantilla utilizado para procesar el formulario.
Datos	Los datos contienen bytes de datos utilizados para procesar el formulario.
formDom	formDom contiene DOM del formulario HTML5 en formato JSON.
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 de envío, los formularios de HTML5 envían datos al servidor. En la tabla siguiente se enumeran todos los parámetros que los formularios de HTML5 envían al servidor.

Parámetro	Descripción
Plantilla	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	El 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 el envío no está presente en el parámetro de 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 AEM servidores publican los datos, el servicio proxy actúa 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 /bin/xfaforms/submitaction punto final 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 (solicitud del POST) a un servidor, los formularios de HTML5 comprueban la conectividad y disponibilidad del servidor. Para comprobar la conectividad y la disponibilidad, los formularios de HTML envían una solicitud de encabezado vacía al servidor. Si el servidor está disponible, el formulario HTML5 envía datos (solicitud del POST) al servidor. Si el servidor no está disponible, aparece un mensaje de error, No se pudo conectar al servidor, se muestra. La detección avanzada evita que los usuarios tengan que rellenar el formulario. El servlet proxy gestiona la solicitud del encabezado y no emite una excepción.