Compatibilidad con XFA en formularios adaptables basados en XDP

Última actualización: 2023-12-21

Introducción

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

Los formularios adaptables admiten 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.

En esta página