Show Menu
TEMAS×

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 dirección 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 HTML5 requiere la apertura del servicio de envío "/content/xfaforms/submit/default" para los usuarios de formularios HTML5. Expone los servidores 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 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 viajes al 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 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 POST al servidor.
Topologías proxy de servicio de formularios HTML5
Los formularios HTML5 se conectan a los servidores de AEM para ejecutar secuencias de comandos, servicios Web y envíos de servidor. El tiempo de ejecución XFA de los formularios HTML5 utiliza llamadas de Ajax en el punto final "/bin/xfaforms/submitaction" con varios parámetros para conectarse a los servidores AEM. Los formularios HTML5 conectan los servidores AEM para realizar las siguientes operaciones:

Ejecutar secuencias de comandos y servicios Web por parte del servidor

Las secuencias de comandos marcadas para ejecutarse en el servidor se conocen como secuencias de comandos del lado del servidor. La siguiente tabla lista todos los parámetros utilizados en las secuencias de comandos de servidor y los servicios Web.
Parámetro
Descripción
activity
Actividad contiene los eventos que activan la solicitud. Tales como clic, salir o cambiar
contextSom
contextSom contiene la expresión SOM del objeto donde se ejecutan eventos.
Plantilla
La 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 HTML5 envían datos al servidor. La siguiente tabla lista todos los parámetros que los formularios HTML5 envían al servidor.
Parámetro
Descripción
Plantilla
Plantilla utilizada para procesar el formulario.
contentRoot
directorio raíz de plantilla utilizado para procesar el formulario.
Datos
bytes de datos utilizados para procesar el formulario.
formDom
DOM del formulario HTML5 en formato JSON.
sumiturl
Dirección URL en la que se publica el XML de datos.
debugDir
El directorio de depuración utilizado para procesar el formulario.

¿Cómo funciona el proxy de envío?

El proxy de servicio de envío actúa como una transferencia si el envío no está presente en el parámetro de solicitud. Actúa como un paso. Envía la solicitud al punto final /bin/xfaforms/submitaction y envía la respuesta al tiempo de ejecución de XFA.
El proxy de 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 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.
  • Si el proxy publica los datos, el servicio proxy pasa todos los parámetros excepto submitUrl al punto final /bin/xfaforms/submit 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 POST) a un servidor, los formularios HTML5 comprueban la conectividad y disponibilidad del servidor. Para verificar 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 envía datos (solicitud POST) al servidor. Si el servidor no está disponible, se muestra 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 controla la solicitud de encabezado y no emite excepción.