Compatibilidad con XFA en formularios adaptables basados en XDP

Introducción

Los formularios adaptables son compatibles con varios eventos, propiedades, secuencias de comandos y validaciones XFA definidos en un archivo XDP, incluidos:

Ejecución de secuencias de comandos definidas en los eventos del archivo XDP.
Captura de los valores predeterminados y las propiedades de comportamiento para los campos del archivo XDP.
Ejecución de secuencias de comandos de validación definidas 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 IU de creación de formularios. Sin embargo, los autores de formularios pueden anular algunos de estos elementos para crear una experiencia alternativa.

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

Elementos XFA compatibles y su asignación en formularios adaptables

Fields

Cuando se crea un formulario adaptable utilizando un archivo XDP, se puede arrastrar y soltar un campo XFA en el formulario adaptable. La tabla siguiente muestra cómo se asignan los campos XFA a los campos de formulario adaptables.

Campo o contenedor XFA	Componente de 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
Scribble de firma	Firma a mano alzada
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 captura cómo se comportan los distintos scripts XFA definidos en los archivos XDP en los formularios adaptables.

Propiedades de componentes XFA	Comportamiento correspondiente en formularios adaptables
somExpression	Asignado a la propiedad Bind reference (bindRef) en forma adaptativa.
presence	Asignado a la propiedad visible en forma adaptable. Puede anularlo utilizando la expresión Visibilidad .
access	Asignado a la propiedad enabled en forma adaptable. Puede anularlo utilizando la expresión Access .
Accesibilidad: función	Asignado a la propiedad role en forma adaptable.
Accesibilidad: speakPriority	Asignado a la propiedad speakPriority en forma adaptativa.
Accesibilidad: speakText	Asignado al texto de accesibilidad personalizado en forma adaptable.
Accesibilidad: toolTip	Asignado a la propiedad short description en forma adaptable.
caption (todos los tipos de campo)	Asignado a la propiedad Título en forma adaptable.
displayFormat (todos los tipos de campo)	Asignado al patrón de visualización en forma 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 forma adaptable. Puede anularlo utilizando la expresión Options .
maxChar (Campo de texto)	Asignado a la propiedad Maximum character allowed en un formulario adaptable.
multilínea (campo de texto)	Asignado a la propiedad Permitir líneas múltiples en forma adaptable.
fracDigit (Campo numérico, Campo decimal)	Asignado a la propiedad Frac digit en forma adaptable.
leadDigit (Campo numérico, Campo decimal)	Asignado a la propiedad Dígitos de posible cliente en forma adaptativa.
multiSelect (cuadro de lista)	Asignado a la propiedad Permite selección múltiple en forma adaptable.

Secuencias de comandos

La siguiente tabla captura cómo se comportan los distintos scripts XFA definidos en el archivo XDP en formularios adaptables.

Eventos de script XFA	Comportamiento correspondiente en formularios adaptables
initialize	Esta secuencia de comandos se ejecuta durante la ejecución y no se puede anular en forma adaptativa.
calculate	Asignado a la expresión Calculate en forma adaptable.
validate	Asignado a la expresión Validación en forma adaptable.
validationState	Esta secuencia de comandos se ejecuta en tiempo de ejecución y no se puede anular en forma adaptable.
exit	Esta secuencia de comandos se ejecuta durante la ejecución y no se puede anular en forma adaptativa.
click (campos de botón)	Asignado a la expresión Click del botón.
Compatibilidad con scripts del lado del servidor	Esta secuencia de comandos se ejecuta durante la ejecución y no se puede anular en forma adaptativa.
Compatibilidad con servicios web	Esta secuencia de comandos se ejecuta durante la ejecución y no se puede anular en forma adaptativa.
Cambio (campo de anotaciones, botón de opción, casilla de verificación)	Esta secuencia de comandos se ejecuta durante la ejecución y no se puede anular en forma adaptativa.

Validaciones

La siguiente tabla captura cómo se asignan las validaciones XFA a las validaciones en formularios adaptables.

Validación XFA	Validación correspondiente en forma adaptable
Patrón de validación (formatTest)	validatePictureClause
Mensaje del patrón de validación (formatTestMessage)	validatePictureMessage
Requerido (nullTest )	obligatorio
Mensaje vacío (nullTestMessage)	mandatoryMessage
Validar secuencia de comandos (scriptTest)	validateExp
Mensaje de la secuencia de comandos de validación (scriptTestMessage)	validateMessage

NOTA

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