Compatibilidad con XFA en formularios adaptables basados en XDP

Introducción

Adobe recomienda utilizar la captura de datos moderna y ampliable Componentes principales para crear un nuevo Forms adaptable o adición de Forms adaptable a páginas de AEM Sites. Estos componentes representan un avance significativo en la creación de Forms adaptable, lo que garantiza experiencias de usuario impresionantes. Este artículo describe un enfoque más antiguo para crear Forms adaptable mediante componentes de base.

Los formularios adaptables son compatibles con varios eventos, propiedades, scripts y validaciones XFA definidos en un archivo XDP, incluidos los siguientes:

ejecución de los scripts definidos en los eventos del archivo XDP;
captura de los valores y las propiedades de comportamiento predeterminados para los campos del archivo XDP;
ejecución de los scripts de validación definidos en el archivo XDP.

Cuando se crea un formulario adaptable basado en un archivo XDP, las propiedades, los eventos y las validaciones se rellenan automáticamente en la interfaz de usuario de Autor del formulario. Sin embargo, los autores de formularios pueden invalidar algunos de estos elementos para crear una experiencia alternativa.

Este artículo enumera los eventos, las propiedades y las validaciones XFA admitidos en los formularios adaptables, y explica cómo anularlos.

Elementos XFA compatibles y su asignación en formularios adaptables

Campos

Cuando se crea un formulario adaptable con un archivo XDP, se puede arrastrar y colocar un campo XFA en él. En la tabla siguiente se muestra cómo se asignan los campos XFA a los campos de formulario adaptable.

Campo o contenedor XFA	Componente del formulario adaptable correspondiente
Botón	Botón
Casilla de verificación	Casilla de verificación
Cuadro de lista	Lista desplegable
Campo de fecha y hora	Selector de fecha
Firma manuscrita	Firma manuscrita
Campo numérico	Cuadro numérico
Campo decimal	Cuadro numérico
Campo de texto	Cuadro de texto
Campo de contraseña	Cuadro de contraseña
Imagen	Imagen
Texto	Texto
Subformulario	Panel
Área (grupo)	Panel
Conjunto de subformularios	Panel

Propiedades

La siguiente tabla muestra cómo se comportan los distintos scripts XFA definidos en archivos XDP en los formularios adaptables.

Propiedades de los componentes XFA	Comportamiento correspondiente en formularios adaptables
somExpression	Asignado a la propiedad Bind reference (bindRef) en el formulario adaptable.
presence	Asignado a la propiedad visible en el formulario adaptable. Puede anularlo utilizando la expresión Visibility.
access	Asignado a la propiedad enabled en el formulario adaptable. Puede anularlo utilizando la expresión Access.
Accesibilidad: función	Asignado a la propiedad role en el formulario adaptable.
Accesibilidad: speakPriority	Asignado a la propiedad speakPriority en el formulario adaptable.
Accesibilidad: speakText	Asignado al texto de accesibilidad personalizado en el formulario adaptable.
Accesibilidad: toolTip	Asignado a la propiedad Short description en el formulario adaptable.
caption (Todos los tipos de campo)	Asignado a la propiedad Title en Formulario adaptable.
displayFormat (Todos los tipos de campo)	Asignado al patrón de visualización en el formulario adaptable.
rawValue (Todos los tipos de campo)	Asignado a la propiedad value en el formulario adaptable.
items (Cuadro de lista, casilla de verificación)	Asignado a la propiedad options en el formulario adaptable. Puede anularlo utilizando la expresión Options.
maxChar (Campo de texto)	Asignado a la propiedad Maximum character allowed en el formulario adaptable.
multiline (Campo de texto)	Asignado a la propiedad Allow multiple lines en el formulario adaptable.
fracDigit (Campo numérico, Campo decimal)	Asignado a la propiedad Frac digit en el formulario adaptable.
leadDigit (Campo numérico, Campo decimal)	Asignado a la propiedad Lead digits en el formulario adaptable.
multiSelect (Cuadro de lista)	Asignado a la propiedad Allows multiple selection en el formulario adaptable.

Scripts

La siguiente tabla muestra cómo se comportan los distintos scripts XFA definidos en archivos XDP en los formularios adaptables.

Eventos de script XFA	Comportamiento correspondiente en formularios adaptables
initialize	Este script se ejecuta durante el tiempo de ejecución y no se puede anular en el formulario adaptable.
calculate	Asignado a la expresión Calculate en el formulario adaptable.
validate	Asignado a la expresión Validation en el formulario adaptable.
validationState	Este script se ejecuta durante el tiempo de ejecución y no se puede anular en el formulario adaptable.
exit	Este script se ejecuta durante el tiempo de ejecución y no se puede anular en el formulario adaptable.
click (Campos de botón)	Asignado a la expresión Click del botón.
Compatibilidad con scripts del lado del servidor	Este script se ejecuta durante el tiempo de ejecución y no se puede anular en el formulario adaptable.
Compatibilidad con servicios web	Este script se ejecuta durante el tiempo de ejecución y no se puede anular en el formulario adaptable.
change (Campo de anotaciones, botón de opción, casilla de verificación)	Este script se ejecuta durante el tiempo de ejecución y no se puede anular en el formulario adaptable.

Validaciones

La siguiente tabla muestra cómo se asignan las validaciones XFA a las validaciones de los formularios adaptables.

Validación XFA	Validación correspondiente en el formulario adaptable
Patrón de validación (formatTest)	validatePictureClause
Mensaje del patrón de validación (formatTestMessage)	validatePictureMessage
Obligatorio (nullTest)	mandatory
Mensaje vacío (nullTestMessage)	mandatoryMessage
Validar script (scriptTest)	validateExp
Mensaje del script de validación (scriptTestMessage)	validateMessage

NOTA

No se puede anular la propiedad mandatory del grupo de botones de opción y de casillas de verificación del formulario adaptable enlazados a los botones de verificación XFA.