Sincronizar formularios adaptables con plantillas de formularios XFA synchronizing-adaptive-forms-with-xfa-form-templates

Introducción introduction

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.

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

Requisitos previos prerequisites

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 sample-package

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:

Agregar contenido al formulario adaptable add-content-to-adaptive-form-br

Detectar cambios en el archivo XDP detecting-changes-in-xdp-file

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:

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.

Sincronizar formularios adaptables con el archivo XDP más reciente synchronizing-adaptive-forms-with-the-latest-xdp-file

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.

Actualizar las propiedades updating-the-properties

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.

Agregar campos nuevos del archivo XDP al formulario adaptable   adding-new-fields-from-xdp-file-to-adaptive-form-nbsp

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 deleted-fields-in-xdp-file

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:

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

Descargas downloads

Paquete de contenido para el ejemplo en este artículo

Obtener archivo