Sincronizar formularios adaptables con plantillas de formularios XFA

Última actualización: 2023-12-21

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.

Introducción

Puede crear un formulario adaptable basado en una plantilla de formulario XFA (archivo *.XDP). Esta reutilización le permite conservar su inversión en formularios XFA existentes. Para obtener información sobre cómo utilizar una plantilla de formulario XFA para crear un formulario adaptable, consulte Crear un formulario adaptable basado en una plantilla.

Puede reutilizar campos del archivo XDP en su formulario adaptable. Estos campos se denominan campos vinculados. Las propiedades de los campos vinculados (como scripts, etiquetas y formato de visualización) se copian del archivo XDP. También puede optar por anular el valor de algunas de estas propiedades.

AEM Forms ofrece una forma de mantener los campos de los formularios adaptables sincronizados con cualquier cambio que se realice posteriormente en los campos correspondientes del archivo XDP. Este artículo explica cómo puede habilitar esta sincronización.

Puede arrastrar campos de un formulario XFA a un formulario adaptable

En el entorno de creación de AEM Forms, puede arrastrar campos de un formulario XFA (izquierda) a un formulario adaptable (derecha)

Requisitos previos

Para utilizar la información de este artículo, se recomienda estar familiarizado con las siguientes áreas:

Para utilizar los recursos que muestra el ejemplo en el artículo, descargue el paquete de muestra como se explica en la siguiente sección: Paquete de muestra.

Paquete de muestra

El artículo utiliza un ejemplo para demostrar cómo sincronizar el formulario adaptable con una plantilla de formulario XFA actualizada. Los recursos utilizados en el ejemplo están disponibles en un paquete que se puede descargar de la sección Descargas en este artículo.

Después de cargar el paquete, puede ver estos recursos en la interfaz de usuario de AEM Forms.

Instale el paquete utilizando el administrador de paquetes: https://<server>:<port>/crx/packmgr/index.jsp

El paquete contiene los siguientes recursos:

  1. sample-form.xdp: La plantilla de formulario XFA utilizada como ejemplo

  2. sample-xfa-af: El formulario adaptable basado en el archivo sample-form.xdp. Este formulario adaptable no incluye ningún campo. En el siguiente paso, agregaremos contenido a este formulario adaptable.

Agregar contenido al formulario adaptable

  1. Vaya a https://<server>:<port>/aem/forms.html. Especifique sus credenciales si se le solicita.
  2. Abra sample-af-xfa para editarlo en modo de creación.
  3. En el explorador de contenido de la barra lateral, seleccione la pestaña Objetos del modelo de datos. Arrastre NumericField1 y TextField1 al formulario adaptable.
  4. Cambie el título de NumericField1 de Numeric Field a AF Numeric Field.
NOTA

En los pasos anteriores, sobrescribimos una propiedad de un campo en el archivo XDP. Por lo tanto, esta propiedad no se sincroniza si la propiedad correspondiente del archivo XDP se modifica más adelante.

Detectar cambios en el archivo XDP

Siempre que haya algún cambio en un archivo XDP o en un fragmento, la interfaz de usuario de AEM Forms indica todos los formularios adaptables basados en el archivo XDP o en el fragmento.

Después de actualizar un archivo XDP, debe cargarlo de nuevo en la interfaz de usuario de AEM Forms para que se indiquen los cambios.

Por ejemplo, vamos a actualizar el archivo sample-form.xdp mediante los siguientes pasos:

  1. Vaya a https://<server>:<port>/projects.html.. Especifique sus credenciales si se le solicita.

  2. Haga clic en la pestaña Formularios de la izquierda.

  3. Descargue el archivo sample-form.xdp en su equipo local. El archivo XDP se descarga como un archivo .zip, que se puede extraer utilizando cualquier utilidad de descompresión de archivos.

  4. Abra el archivo sample-form.xdp y cambie el título del campo TextField1 de Campo de texto a Mi campo de texto.

  5. Cargue el archivo sample-form.xdp de nuevo en la interfaz de usuario de AEM Forms.

Si se actualiza un archivo XDP, verá un icono en el editor cuando edite los formularios adaptables basados en el archivo XDP. Este icono indica que el formulario adaptable no está sincronizado con el archivo XDP. En la siguiente imagen, vea el icono que hay junto en la barra lateral.

Icono que indica que el formulario adaptable no está sincronizado con el archivo XDP

Sincronizar formularios adaptables con el archivo XDP más reciente

Cuando se abre un formulario adaptable que no está sincronizado con el archivo XDP para la creación la siguiente vez, se muestra el mensaje: Se ha actualizado la plantilla del esquema/formulario del formulario adaptable. Click Here para volver a basarlo con la nueva versión.

Al hacer clic en el mensaje, se sincronizan los campos del formulario adaptable con los campos correspondientes del archivo XDP.

Para el ejemplo utilizado en este artículo, abra sample-xfa-af en el modo de creación. El mensaje se muestra en la parte inferior del formulario adaptable.

Mensaje que le solicita que sincronice el formulario adaptable con el archivo XDP

Actualizar las propiedades

Todas las propiedades que se copiaron del archivo XDP al formulario adaptable se actualizan, a excepción de las propiedades que el autor anuló explícitamente en el formulario adaptable (del cuadro de diálogo Componentes). La lista de propiedades que se han actualizado está disponible en los registros del servidor.

Para actualizar las propiedades en el formulario adaptable de ejemplo, haga clic en el vínculo (con la etiqueta "Click Here") en el mensaje. El título de TextField1 cambia de Campo de texto a Mi campo de texto.

update-property

NOTA

La etiqueta Campo numérico AF no se ha modificado porque ha anulado esta propiedad del cuadro de diálogo de propiedades del componente, tal como se describe en Agregar contenido al formulario adaptable.

Agregar campos nuevos del archivo XDP al formulario adaptable  

Todos los campos que se agreguen posteriormente al archivo XDP original aparecerán en la pestaña Jerarquía del formulario y puede arrastrar los nuevos campos al formulario adaptable.

No es necesario hacer clic en el enlace del mensaje de error para actualizar los campos en la pestaña Jerarquía del formulario.

Campos eliminados en el archivo XDP

Si un campo que se copió anteriormente en un formulario adaptable se elimina de un archivo XDP, se muestra un mensaje de error en el modo de creación que indica que el campo no existe en el archivo XDP. En estos casos, elimine manualmente el campo del formulario adaptable o borre la propiedad bindRef en el cuadro de diálogo del componente.

Los siguientes pasos ilustran este flujo de uso para los recursos en el ejemplo utilizado en este artículo:

  1. Actualice el archivo sample-form.xdp y elimine NumericField1.

  2. Cargue el archivo sample-form.xdp en la interfaz de usuario de AEM Forms

  3. Abra el formulario adaptable sample-xfa-af para la creación. Se muestra el siguiente mensaje de error: Se ha actualizado la plantilla del esquema/formulario del formulario adaptable. Click Here para volver a basarlo con la nueva versión.

  4. Haga clic en el enlace (con la etiqueta “Click Here”) en el mensaje. Se muestra un mensaje de error indicando que el campo ya no existe en el archivo XDP.

Error que se ve al eliminar un elemento en el archivo XDP

El campo que se ha eliminado también se marca con un icono para indicar un error en el campo.

Icono de error en el campo

NOTA

Los campos del formulario adaptable que tienen un enlace incorrecto (un valor bindRef no válido en el cuadro de diálogo de edición) también se consideran campos eliminados. Si el autor no corrige estos errores y publica el formulario adaptable, el campo se tratará como un campo de formulario adaptable normal sin vincular y se incluye en la sección sin vincular del archivo XML de salida.

Descargas

Paquete de contenido para el ejemplo en este artículo

Obtener archivo

En esta página