Formulario definido en AEM Forms

Información general

A menudo, los clientes deben enviar varios formularios para solicitar un servicio o beneficio. Se trata de encontrar todas las formas pertinentes; y cumplimentarlas, enviarlas y rastrearlas por separado. Además, deben rellenar detalles comunes varias veces en distintos formularios. Todo el proceso resulta engorroso y propenso a errores si se trata de un gran número de formularios. La función de conjunto de formularios de AEM Forms puede ayudar a simplificar la experiencia del usuario en estos casos.

Un conjunto de formularios es una colección de formularios HTML5 agrupados y presentados como un único conjunto de formularios para los usuarios finales. Cuando los usuarios finales inicios en rellenar un conjunto de formularios, se realizan transiciones sin problemas de un formulario a otro. Al final, pueden enviar todos los formularios con un solo clic.

AEM Forms proporciona a los autores de formularios una interfaz de usuario intuitiva para crear, configurar y administrar conjuntos de formularios. Como autor, puede ordenar los formularios en una secuencia determinada que desee que sigan los usuarios finales. Además, puede aplicar condiciones o expresiones de elegibilidad en formularios individuales para controlar su visibilidad en función de las entradas del usuario. Por ejemplo, puede configurar el formulario de detalles del cónyuge para que aparezca solamente cuando el estado civil especifique como Casado.

Además, puede configurar campos comunes en diferentes formularios para compartir enlaces de datos comunes. Con los enlaces de datos adecuados establecidos, los usuarios finales deben rellenar la información común solo una vez que se rellene automáticamente en los formularios posteriores.

Los conjuntos de formularios también son compatibles con la aplicación de AEM Forms, lo que permite que el personal de campo tenga un conjunto de formularios sin conexión, visite a los clientes, introduzca datos y sincronice posteriormente con el servidor de AEM Forms para enviar datos de formularios a procesos empresariales.

Creación y administración del conjunto de formularios

Puede asociar varios XDP o plantillas de formulario, creados con Designer, a un conjunto de formularios. Los conjuntos de formularios se pueden utilizar para procesar de forma selectiva los XDP en función de los valores introducidos por los usuarios en los formularios iniciales y sus perfiles.

Utilice interfaz de usuario de AEM Forms para administrar todos los formularios, conjuntos de formularios y recursos relacionados.

Crear un conjunto de formularios

Para crear un conjunto de formularios, haga lo siguiente:

1. Seleccione Forms > Forms y Documentos.

2. Seleccione Crear > Conjunto de formularios.

3. En la página Añadir propiedades, agregue los siguientes detalles y haga clic en Siguiente.

   • Título: Especifica el título del documento. El título ayuda a identificar el conjunto de formularios en la interfaz de usuario de AEM Forms.
   • Descripción: Especifica la información detallada sobre el documento.
   • Etiquetas: Especifica etiquetas para identificar de forma exclusiva el conjunto de formularios. Las etiquetas ayudan a buscar en el conjunto de formularios. Para crear etiquetas, escriba nuevos nombres de etiquetas en el cuadro Etiquetas.
   • Enviar URL: Especifica la dirección URL en la que se publican los datos enviados para el caso de una representación independiente del conjunto de formularios (caso de uso de una aplicación que no es de AEM Forms). Los datos se envían a este extremo como multipart/formdata con el siguiente parámetro de solicitud:
   • dataXML: Este parámetro contiene una representación XML de los datos del conjunto de formularios enviados. Si todos los formularios del conjunto de formularios utilizan un esquema común, el XML se genera según ese esquema. De lo contrario, la etiqueta raíz XML contiene una etiqueta secundaria para cada formulario rellenado en el conjunto de formularios que contiene datos para los datos adjuntos del formulario.
   • formsetPath: Ruta del formulario en CRXDE, que se ha enviado.
   • PERFIL de procesamiento HTML: Puede configurar determinadas opciones, como campos flotantes, archivos adjuntos y compatibilidad con borradores (para la representación de conjuntos de formularios independientes) para personalizar el aspecto, el comportamiento y las interacciones del conjunto de formularios. Puede personalizar o ampliar el perfil existente para cambiar cualquier configuración de perfil de formulario HTML.

   

4. La pantalla Seleccionar formularios muestra los formularios XDP o archivos XDP disponibles. Busque y seleccione los formularios que desea incluir en el conjunto de formularios y, a continuación, haga clic en Añadir en conjunto de formularios. Si es necesario, vuelva a buscar formularios para agregarlos. Después de agregar todos los formularios al conjunto de formularios, haga clic en Siguiente.

   NOTA

   Asegúrese de que los nombres de campo de los formularios XDP no contienen el carácter de punto. De lo contrario, las secuencias de comandos que intenten resolver los campos, que tengan caracteres de punto, no podrán resolverlos.

5. En la página Configurar formularios, puede hacer lo siguiente:

   • Orden del formulario: Arrastre y suelte los formularios para reordenarlos. El orden del formulario define el orden en que se muestran los formularios al usuario final en la aplicación de AEM Forms y en la representación independiente.
   • Identificador de formulario: Especifica una identidad única para los formularios que se utilizarán en las expresiones de elegibilidad.
   • Raíz de datos: Para cada formulario del conjunto de formularios, Autor puede configurar el XPATH donde los datos de ese formulario en particular se colocan en el XML enviado. El valor predeterminado es /. Si todos los formularios del conjunto de formularios están enlazados a esquema y comparten el mismo esquema XML, puede cambiar este valor. Se recomienda que cada campo del formulario tenga el enlace de datos correcto especificado en el XDP. Si dos campos de dos formularios diferentes comparten el enlace de datos común, el campo del segundo formulario muestra valores prerellenados del primer formulario. No enlazar dos subformularios con el mismo contenido interno al mismo nodo XML. Para obtener más información sobre la estructura XML del conjunto de formularios, consulte Rellenar XML para el conjunto de formularios.
   • Expresión de elegibilidad: Especifica una expresión de JavaScript que evalúa un valor booleano e indica si se puede rellenar un formulario en un conjunto de formularios. Si es false, no se pregunta al usuario ni se muestra el formulario que se va a rellenar. Normalmente, la expresión se basa en los valores de los campos capturados antes de este formulario. Las expresiones también contienen llamadas a la API fs.valueOf del conjunto de formularios para extraer los valores rellenados por el usuario en un campo de un formulario del conjunto de formularios:

   fs.valueOf(<form Identifier="">, <fieldsom expression="">) > <value>

   Por ejemplo, si tiene dos formularios en el conjunto de formularios: gastos de negocios y gastos de viaje, puede agregar un fragmento de JavaScript en el campo Expresión de elegibilidad de ambos formularios para comprobar los datos introducidos por el usuario para el tipo de gasto en un formulario. Si el usuario elige Gastos comerciales, el formulario Gastos comerciales se procesa para el usuario final. O si el usuario elige gastos de viaje, se procesa un formulario diferente para el usuario final. Para obtener más información, consulte Expresión de elegibilidad.

   Además, el autor también puede elegir quitar un formulario del conjunto de formularios utilizando el icono Eliminar que se encuentra en la esquina derecha de cada fila o agregar otro conjunto de formularios utilizando el icono '+' de la barra de herramientas. Este icono '+' dirige al usuario al paso anterior del asistente, que se utilizó para 'Seleccionar formularios'. Las selecciones existentes se mantienen y cualquier selección adicional realizada se debe agregar al conjunto de formularios utilizando el icono Añadir a conjunto de formularios en esa página.

   

   NOTA

   La interfaz de usuario de AEM Forms administra todos los formularios que se utilizan en el conjunto de formularios.

Administración de un conjunto de formularios

Una vez creado un conjunto de formularios, puede realizar las siguientes acciones en ese conjunto de formularios:

• Un solo clic: Cuando se crea un conjunto de formularios y se enumera en la página de recursos principal, puede hacer clic en el conjunto de formularios para vista. Se abre un conjunto de formularios que muestra todas las plantillas de formulario (XDP) de ese conjunto de formularios.
• Editar: Al hacer clic en Editar después de seleccionar un conjunto de formularios, se abre la pantalla Configurar formulario que se muestra arriba en Pasos para crear un conjunto de formularios. Puede llevar a cabo todas las funcionalidades que se describen en este punto.
• Copiar + Pegar: Esto le permite copiar todo el conjunto de formularios desde una ubicación y pegarlo en la misma ubicación o en cualquier otra carpeta.
• Descargar: Puede descargar el conjunto de formularios con todas sus dependencias.
• Inicio/Administrar revisión: Una vez creado el conjunto de formularios, puede configurar su revisión haciendo clic en Revisión de Inicio. Una vez iniciada la revisión de un conjunto de formularios, la opción Administrar revisión se muestra al usuario. En la pantalla Administrar revisión, puede actualizar o finalizar la revisión. Para las revisiones que agregó, puede comprobar la revisión y agregar comentarios, si es necesario.
• Eliminar: Elimina el conjunto de formularios completo. Los formularios del conjunto de formularios eliminado permanecen en el repositorio.
• Publicar/Cancelar la publicación: De este modo, se publica o deja de publicar el conjunto de formularios junto con todos los formularios que contiene y los recursos relacionados de estos formularios.
• Previsualización: Previsualización ofrece dos opciones: Previsualización como HTML (sin datos) y previsualización personalizada con datos de ejemplo.
• Propiedades de vista/edición: Puede editar o vista las propiedades de metadatos de un conjunto de formularios seleccionado.

Editar un conjunto de formularios

Para editar un conjunto de formularios, haga lo siguiente:

1. Seleccione Forms > Forms y Documentos.

2. Busque el conjunto de formularios que desee editar. Pase el ratón por encima y seleccione Editar ( ).

3. En la página Configurar formularios, puede editar lo siguiente:

   • Orden del formulario
   • Formulario Identificador
   • Raíz de datos
   • Expresión de elegibilidad

   También puede hacer clic en el icono Eliminar correspondiente para eliminar el formulario del conjunto de formularios.

Conjunto de formularios en Process Management

Una vez creado un conjunto de formularios mediante la interfaz de usuario de AEM Forms Management, puede utilizar el conjunto de formularios en un punto de Inicio o asignar actividad de Tarea mediante Workbench.

Uso del conjunto de formularios en el punto de Tarea o Inicio

1. Al diseñar un proceso, en la sección Presentación y datos de Asignar punto de Tarea/Inicio, seleccione usar un recurso CRX. Aparece el navegador de recursos CRX.

   

2. Seleccione el conjunto de formularios para filtrar el conjunto de formularios en AEM repositorio (CRX).

   

3. Selecciona un conjunto de formularios y hace clic en Aceptar.

Expresiones de elegibilidad

Las expresiones de elegibilidad de un conjunto de formularios se utilizan para definir y controlar dinámicamente los formularios que se muestran al usuario. Por ejemplo, para mostrar un formulario concreto solo si el usuario pertenece a un grupo de edad concreto. Especifique y edite una expresión de elegibilidad con el administrador de formularios.

Una expresión de elegibilidad puede ser cualquier instrucción JavaScript válida que devuelva un valor booleano. La última instrucción del fragmento de código JavaScript se trata como un valor booleano que determina la elegibilidad del formulario en función del procesamiento en el resto (líneas anteriores) del fragmento de código JavaScript. Si el valor de la expresión es true, el formulario puede mostrarse al usuario. Estos formularios se conocen como formularios admisibles.

Además de las funciones estándar de JavaScript, el conjunto de formularios también expone la API fs.valueOf que proporciona acceso al valor de un campo de un formulario en un conjunto de formularios. Utilice esta API para acceder al valor de un campo de formulario en un conjunto de formularios. La sintaxis de la API es fs.valueOf (formUid, fieldSOM), donde:

• formUid (cadena): ID exclusivo de un formulario en el conjunto de formularios. Puede especificarlo al crear el conjunto de formularios en la interfaz de usuario del administrador de formularios. De forma predeterminada, es el nombre del formulario.
• fieldSOM (cadena): Una expresión SOM del campo en el formulario especificado por formUid. La expresión SOM o la expresión del Modelo de objetos de secuencias de comandos se utilizan para hacer referencia a valores, propiedades y métodos dentro de un modelo de objetos de documento (DOM) concreto. Puede vista en el Diseñador de formularios en la ficha Secuencias de comandos mientras el campo está seleccionado.

Ejemplos

Uso válido de la API:

fs.valueOf("form1", "xfa.form.form1.subform1.field1")

Uso no válido de la API:

var formUid = "form1";
 var fieldSOM = “xfa.form.form1.subform1.field1"; fs.valueOf(formUid, fieldSOM);

Rellenar XML para conjunto de formularios

El conjunto de formularios es una colección de varios formularios HTML5 que tienen esquemas comunes o diferentes. El conjunto de formularios admite el rellenado previo de campos de formulario mediante un archivo XML. Puede asociar un archivo XML con un conjunto de formularios para que, al abrir un formulario en el conjunto de formularios, algunos de los campos del formulario se precalculen.

El archivo XML de relleno previo se especifica mediante el parámetro dataRef de la dirección URL del conjunto de formularios. El parámetro dataRef especifica la ruta absoluta del archivo XML de datos que se combina con el conjunto de formularios.

Por ejemplo, tiene tres formularios (formulario1, formulario2 y formulario3), en el conjunto de formularios con la siguiente estructura:

form1

field
form1field

form2

field
form2field

form3

field
form3field

Cada formulario tiene un campo con nombre común, denominado "field" y un campo con nombre exclusivo llamado "form<i>field".

Puede rellenar previamente este conjunto de formularios utilizando un XML con la siguiente estructura:

<?xml version="1.0" encoding="UTF-8" ?>
<formSetRootTag>
 <field>common field value</field>
 <form1field>value1</form1field>
 <form2field>value2</form2field>
 <form3field>value3</form3field>
</formSetRootTag>

El fragmento XML anterior muestra que el XML de relleno previo para el conjunto de formularios es una unión de los fragmentos XML de relleno previo de los formularios individuales. Si ciertos campos de los distintos formularios tienen jerarquía de datos o esquema similar entre sí, los campos se rellenan previamente con los mismos valores. En este ejemplo, los tres formularios se rellenan previamente con el mismo valor para el campo común, "field". Se trata de una forma sencilla de transferir datos de un formulario al siguiente. Esto también se puede lograr enlazando los campos al mismo esquema o referencia de datos. Si desea separar los datos del conjunto de formularios en función del esquema de los formularios. Esto se puede lograr especificando el atributo "raíz de datos" del formulario, durante la creación del conjunto de formularios (el valor predeterminado es "/", que se asigna a la etiqueta raíz del conjunto de formularios).

En el ejemplo anterior, si especifica las raíces de datos: "/form1", "/form2" y "/form3" respectivamente para los tres formularios, debe utilizar un XML de relleno previo de la siguiente estructura:

<?xml version="1.0" encoding="UTF-8" ?>
<formSetRootTag>
 <form1>
  <field>field value1</field>
  <form1field>value1</form1field>
 </form1>
 <form2>
  <field>field value2</field>
  <form2field>value2</form2field>
 </form2>
 <form3>
  <field>field value3</field>
  <form3field>value3</form3field>
 </form3>
</formSetRootTag>

En un conjunto de formularios, el XML definió un esquema XML con la siguiente sintaxis:

<formset>
 <fs_data>
  <xdp:xdp xmlns:xdp="https://ns.adobe.com/xdp/">
  <xfa:datasets xmlns:xfa="https://www.xfa.org/schema/xfa-data/1.0/">
   <xfa:data>
   <rootElement>
    ... data ....
   </rootElement>
   </xfa:data>
  </xfa:datasets>
  </xdp:xdp>
 </fs_data>
 <fs_draft>
  ... private data...
 </fs_draft>
</formset>

Descripción de elementos XML de relleno previo

Reglas de sintaxis para crear un archivo XML de relleno previo:

• elementos principales: elemento(s) que puede ser su elemento principal, donde null indica que el elemento puede estar en la raíz del XML.
• cardinalidad: representa el número de veces que se puede utilizar el elemento dentro de su elemento principal.
• submitXML: indica si el elemento siempre está presente § u opcional (O) en el envío de XML.
• prefillXML: indica si el elemento es obligatorio® u opcional(O) en el XML de relleno previo.
• niños: indica qué elementos pueden ser sus elementos secundarios.

FORMSET

parent elements:

null

cardinality: [0,1]

submitXML: P

prefillXML: O

children: fs_data

Elemento raíz del conjunto de formularios XML. Se recomienda no utilizar esta palabra como nombre de rootSubform de ningún formulario del conjunto de formularios.

FS_DATA

parent elements:

formset

cardinalidad: [1]

submitXML: P

prefillXML: O

children: xdp:xdp/rootElement

El subárbol indica los datos de los formularios en el conjunto de formularios. El elemento es opcional en XML de relleno previo solo si el elemento del conjunto de formularios no está presente

XDP:XDP

parent elements: fs_data/null

cardinality: [0,1]

submitXML: O

prefillXML: O

children: xfa:datasets

Esta etiqueta indica el inicio de HTML5 Form XML. Esto se agrega en el archivo XML de envío si está presente en el archivo XML de relleno previo o si no hay ningún archivo XML de relleno previo. Esta etiqueta se puede quitar del XML de relleno previo.

XFA:DATASETS

parent elements: xdp:xdp

cardinality: [1]

submitXML: O

prefillXML: O

children: xfa:data

XFA:DATA

parent elements: xfa:datasets

cardinality: [1]

submitXML: O

prefillXML: O

children: rootElement

ROOTELEMENT

parent elements: xfa:datasets/fs_data/null

cardinality: [0,1]

submitXML: P

prefillXML: O

children: controlled by the Forms in Form set

El nombre rootElement es sólo un marcador de posición. El nombre real se selecciona de los formularios utilizados en el conjunto de formularios. El subárbol que inicio con rootElement contiene los datos de los campos y subformularios dentro del Forms en el conjunto de formularios. Hay varios factores que determinan la estructura de rootElement y sus elementos secundarios.

En XML de relleno previo, esta etiqueta es opcional, pero si falta, se ignora todo el XML.

NOMBRE DE LA ETIQUETA ELEMENTO RAÍZ

Si hay un elemento raíz en el XML de relleno previo, el nombre de ese elemento también se toma en el XML de envío. En los casos en los que no hay un xml de relleno previo, el nombre del elemento raíz es el nombre del subformulario raíz del primer formulario del conjunto de formularios que tiene una propiedad dataRoot establecida en "/". Si no hay tal formulario, el nombre de rootElement es fs_dummy_root, que es una palabra clave reservada.

Formulario definido en la aplicación de AEM Forms

La aplicación de AEM Forms permite a los trabajadores de campo sincronizar sus dispositivos móviles con un servidor AEM Forms y trabajar en sus tareas. La aplicación funciona incluso cuando el dispositivo está sin conexión al guardar datos localmente en el dispositivo. Mediante las funciones de anotación, como las fotografías, los trabajadores sobre el terreno pueden proporcionar información precisa para integrarla en los procesos empresariales.

Para obtener más información sobre la aplicación de AEM Forms, consulte Aplicación de AEM Forms.

Limitaciones conocidas: patrones no totalmente admitidos en el conjunto de formularios

Los siguientes patrones de datos no son totalmente compatibles con el conjunto de formularios:

Patrón no totalmente admitido en el conjunto de formularios	Ejemplo
El tamaño de entrada y el tamaño del patrón no coinciden	When pattern= num{z,zzz} Y input= 12,345 o 1,23
Patrones de cláusula de imagen con corchetes "(" ")"	num{(zz,zzz)}
Varios patrones de datos	num{zz,zzz} | num{z,zzz,zzz}
Patrones abreviados	num.integer{}, num.decimal{}, num.percent{}, o num.currency{}