Sincronización de Forms adaptable con plantillas de formulario XFA

Introducción

Puede crear un formulario adaptable basado en una plantilla de formulario XFA (archivo *.XDP). Esta reutilización le permite preservar 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, Cree un formulario adaptable basado en una plantilla.

Puede reutilizar campos del archivo XDP en el formulario adaptable. Estos campos se denominan campos enlazados. Las propiedades de los campos enlazados (como secuencias de comandos, 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 proporciona una forma de ayudarle a 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 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 proporciona 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 Downloads de 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 activos:

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

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

Añadir contenido al formulario adaptable

  1. Vaya a https://<server>:<port>/aem/forms.html. Introduzca sus credenciales si se le solicita.
  2. Abra el ejemplo af-xfa para editarlo en modo de autor.
  3. En el navegador de contenido de la barra lateral, seleccione la ficha Objetos del modelo de datos. Arrastre NumericField1 y TextField1 al formulario adaptable.
  4. Cambie el Título del Campo numérico1 de Campo numérico a Campo numérico AF.
NOTA

En los pasos anteriores, se sobrescribió 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.

Detección de cambios en el archivo XDP

Cuando hay algún cambio en un archivo XDP o en un fragmento, la interfaz de usuario de AEM Forms marca 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 marcar los cambios.

Por ejemplo, vamos a actualizar el archivo sample-form.xdp siguiendo estos pasos:

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

  2. Haga clic en la ficha Forms de la izquierda.

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

  4. Abra el archivo sample-form.xdp y cambie el título del campo TextField1 de Text Field a My Text Field.

  5. Vuelva a cargar el archivo sample-form.xdp en la interfaz de usuario de AEM Forms.

Si se actualiza un archivo XDP, verá un icono en el editor al editar 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 para mostrar que el formulario adaptable no está sincronizado con el archivo XDP

Sincronización de formularios adaptables con el último archivo XDP

Cuando se abre un formulario adaptable que no está sincronizado con el archivo XDP para la creación la próxima vez, se muestra el siguiente mensaje:
La plantilla de esquema/formulario del formulario adaptable se ha actualizado. Click Here para volver a basarlo en 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 modo de creación. El mensaje se muestra hacia la parte inferior del formulario adaptable.

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

Actualización de las propiedades

Todas las propiedades que se copiaron del archivo XDP al formulario adaptable se actualizan, excepto las propiedades que el Autor anuló explícitamente en el formulario adaptable (del cuadro de diálogo Componente). 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 (etiquetado "Click Here") del mensaje. El título de TextField1 cambia de Campo de texto a 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, como se describe en Agregar contenido a formularios adaptables.

Adición de nuevos campos del archivo XDP al formulario adaptable  

Todos los campos que se agreguen posteriormente al archivo XDP original aparecen en la ficha Jerarquía del formulario y puede arrastrar los nuevos campos al formulario adaptable.

No es necesario hacer clic en el vínculo del mensaje de error para actualizar los campos en la ficha 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 indicando 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 de esquema/formulario del formulario adaptable. Click Here para volver a basarlo en la nueva versión.

  4. Haga clic en el vínculo (con la etiqueta " Click Here") del 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 del 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 trata como un campo de formulario adaptable normal sin enlazar y se incluye en la sección sin enlazar del archivo XML de salida.

Descargas

Paquete de contenido, por ejemplo, en este artículo

Obtener archivo

En esta página