Los formularios HTML5 tienen la noción de Perfiles que se exponen como puntos de conexión REST para permitir el procesamiento móvil de plantillas de formulario. Estos perfiles tienen asociado Procesador de perfiles. Son páginas JSP responsables de generar la representación HTML del formulario llamando al servicio OSGi de Forms. La ruta JCR del nodo Perfil determina la dirección URL del punto final de procesamiento. El punto final de procesamiento predeterminado del formulario que señala al perfil "predeterminado" tiene este aspecto:
https://<host:<puerto>/content/xfaforms/profiles/default.html?contentRoot=<ruta de la carpeta que contiene el formulario xdp&template=<nombre del xdp>
Por ejemplo, http://localhost:4502/content/xfaforms/profiles/default.html?contentRoot=c:/xdps&template=sampleForm.xdp
Para un perfil personalizado, el punto final cambia en consecuencia. Por ejemplo, el punto final del perfil personalizado con el nombre formularios es:
http://localhost:4502/content/xfaforms/profiles/hrforms.html?contentRoot=c:/xdps&template=sampleForm.xdp
Si la plantilla reside en el repositorio AEM en una aplicación llamada FormSubmission, el URI es:
http://localhost:4502/content/xfaforms/profiles/default.html?
contentRoot=crx:///content/dam/formsanddocuments/FormSubmission/1.0
&template=sampleForm.xdp
Los parámetros de solicitud admitidos al procesar el formulario como HTML son:
Parámetro | Descripción |
---|---|
template |
Este parámetro especifica el nombre del archivo de plantilla. |
contentRoot |
Este parámetro especifica la ruta donde residen la plantilla y los recursos asociados. Esta ruta puede ser la ruta del sistema de archivos del servidor o una ruta del repositorio o http o una ruta ftp. |
submitUrl |
Este parámetro especifica la dirección url a la que se publica el xml de datos del formulario. |
Parámetro | Descripción |
---|---|
dataRef | Este parámetro especifica ruta absoluta del archivo de datos que se combina con la plantilla. Este parámetro puede ser una URL a un servicio de descanso que devuelva los datos en formato xml. |
data | Este parámetro especifica los bytes de datos codificados UTF-8 que se combinan con la plantilla. Si se especifica este parámetro, el formulario HTML5 ignora el parámetro dataRef. |
Los formularios HTML5 admiten tres métodos para pasar los parámetros de procesamiento. Puede pasar parámetros a través de direcciones URL, pares clave-valor y nodo de perfil. En el parámetro de renderización, el par clave-valor tiene la prioridad más alta seguida del nodo de perfil. El parámetro de solicitud de URL tiene la menor prioridad.
Parámetros de solicitud de URL: Puede especificar los parámetros de renderización en la URL. En los parámetros de solicitud de URL, los parámetros son visibles para el usuario final. Por ejemplo, la siguiente URL de envío contiene un parámetro de plantilla en la URL: http://localhost:4502/content/xfaforms/profiles/default.html?contentRoot=/Applications/FormSubmission/1.0&template=sampleForm.xdp
Parámetros de solicitud de SetAttribute: Puede especificar los parámetros de renderización como un par clave-valor. En los parámetros de solicitud de SetAttribute, el usuario final no puede ver los parámetros. Puede reenviar una solicitud de cualquier otro JSP al JSP del procesador de perfiles de formulario HTML5 y utilizar setAttribute en el objeto de solicitud para pasar todos los parámetros de procesamiento. Este método tiene la prioridad más alta.
Parámetros de solicitud de nodo de perfil: Puede especificar los parámetros de renderización como propiedades de nodo de un nodo de perfil. En los parámetros de solicitud del nodo de perfil, el usuario final no puede ver los parámetros. El nodo de perfil es el nodo al que se envía la solicitud. Para especificar parámetros como propiedades de nodo, utilice CRXDE lite.
los formularios HTML5 envían datos; ejecutar scripts del lado del servidor y servicios web en servidores AEM. Para obtener información detallada sobre los parámetros utilizados para ejecutar secuencias de comandos del lado del servidor y servicios web en servidores AEM, consulte HTML5 forms Service Proxy.