Fragmentos de formularios adaptables adaptive-form-fragments
Adobe recomienda utilizar la captura de datos moderna y ampliable Componentes principalespara crear un nuevo Formularios adaptableso adición de 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.
Aunque cada formulario está diseñado para un propósito específico, hay algunos segmentos comunes en la mayoría de las formas, como para proporcionar detalles personales como nombre y dirección, detalles familiares y detalles de ingresos. Los desarrolladores de formularios deben crear estos segmentos comunes cada vez que se crea un nuevo formulario.
Los formularios adaptables proporcionan un mecanismo cómodo para crear segmentos de formulario como un panel o un grupo de campos solo una vez y reutilizarlos. Estos segmentos reutilizables e independientes se denominan fragmentos de formulario adaptables.
Creación de un fragmento create-a-fragment
Puede crear un fragmento de formulario adaptable desde cero o guardar un panel en un formulario adaptable existente como fragmento.
Crear fragmento desde cero create-fragment-from-scratch
-
Inicie sesión en una instancia de autor de AEM Forms en https://[hostname]:[port]/aem/forms.html.
-
Haga clic en Crear > fragmento de formulario adaptable.
-
Especifique el título, el nombre, la descripción y las etiquetas del fragmento.
note note NOTE Asegúrese de especificar un nombre único para el fragmento. Si existe otro fragmento con el mismo nombre, el fragmento no se creará. -
Haga clic para abrir el modelo de formulario y desde el menú desplegable Seleccionar desde, seleccione uno de los siguientes modelos para el fragmento:
-
Ninguno: Especifica que se cree el fragmento desde cero sin usar ningún modelo de formulario.
note note NOTE En Forms adaptable basado en componentes principales, puede utilizar un solo fragmento de formulario varias veces en un formulario. Admite fragmentos de formulario basados en ninguno y en esquema. -
Plantilla de formulario: especifica la creación del fragmento mediante una plantilla XDP cargada en AEM Forms. Seleccione la plantilla XDP adecuada como modelo de formulario para el fragmento.
También se muestran los subformularios marcados como fragmentos en la plantilla de formulario seleccionada. Puede seleccionar un subformulario para el fragmento de formulario adaptable de la lista desplegable.
Además, puede crear un fragmento de formulario adaptable mediante subformularios que no estén marcados como fragmentos en la plantilla de formulario al especificar la expresión SOM para el subformulario en el cuadro desplegable.
- Esquema XML: especifica que se crea el fragmento con un esquema XML cargado en AEM Forms. Puede cargar o seleccionar entre los esquemas XML disponibles como modelo de formulario para el fragmento.
También puede crear un fragmento de formulario adaptable si selecciona un complexType presente en el esquema seleccionado del cuadro desplegable.
-
-
Haga clic en Crear y luego haga clic en Abrir para abrir el fragmento, con una plantilla predeterminada, en el modo de edición.
En el modo de edición, puede arrastrar y soltar cualquier componente del formulario adaptable de la barra de tareas de AEM en el fragmento. Para obtener información sobre los componentes de formularios adaptables, consulte Introducción a la creación de formularios adaptables.
Además, si ha seleccionado un esquema XML o una plantilla de formulario XDP como modelo de formulario para el fragmento, aparecerá una nueva pestaña que mostrará la jerarquía del modelo de formulario en el buscador de contenido. Permite arrastrar y soltar los elementos del modelo de formulario en el fragmento. Los elementos del modelo de formulario agregados se convierten en componentes de formulario, al tiempo que se conservan las propiedades originales del XDP o XSD asociado.
Guardar panel como fragmento save-panel-as-a-fragment
-
Abra un formulario adaptable que contenga el panel que desea guardar como fragmento de formulario adaptable.
-
En la barra de herramientas del panel, haga clic en Guardar como fragmento. Se abrirá el cuadro de diálogo Guardar como fragmento.
note note NOTE Si el panel que está guardando como fragmento contiene un panel secundario, el fragmento resultante lo incluirá. -
En el cuadro de diálogo Creación de fragmentos, especifique la siguiente información:
-
Nombre: Nombre del fragmento. El valor predeterminado es el nombre de elemento del panel. Es un campo obligatorio.
note note NOTE Asegúrese de especificar un nombre único para el fragmento. Si existe otro fragmento con el mismo nombre, el fragmento no se creará. -
Título: Título del fragmento. El valor predeterminado es el título del panel.
-
Descripción: Descripción del fragmento.
-
Etiquetas: Etiquetas de metadatos para el fragmento.
-
Ruta del público destinatario: ruta del repositorio en la que se guarda el fragmento. Si no especifica una ruta, se creará un nodo con el mismo nombre que el del fragmento junto al nodo que contiene el formulario adaptable. El fragmento se guardará en este nodo.
-
Modelo de formulario: en función del modelo de formulario para el formulario adaptable, este campo muestra el Esquema XML, la Plantilla de formulario o Ninguno. Es un campo no editable.
-
Raíz del modelo del fragmento: solo aparece en formularios adaptables basados en XSD. Especifica la raíz del modelo de fragmento. Puede elegir / o el tipo complejo XSD de la lista desplegable. Solo puede reutilizar el fragmento en otro formulario adaptable si selecciona el tipo complejo como raíz del modelo de fragmento.
Si elige / como raíz del modelo de fragmento, el árbol XSD completo de la raíz se podrá ver en la pestaña Modelo de datos del formulario adaptable. Para una raíz de modelo de fragmento de tipo complejo, solo los descendientes del tipo complejo seleccionado serán visibles en la pestaña Modelo de datos de formulario adaptable. Si crea un fragmento y elige un tipo complejo como Raíz del modelo de fragmento, puede utilizarlo siempre que se utilice ese tipo complejo, ya sea en el mismo formulario o en varios. -
XSD Ref: solo aparece en formularios adaptables basados en XSD. Muestra la ubicación del esquema XML.
-
XDP Ref: solo aparece en formularios adaptables basados en XDP. Muestra la ubicación de la plantilla de formulario XDP.
Guardar como diálogo de fragmento
-
-
Haz clic en OK.
El panel se guardará en la ubicación especificada o predeterminada del repositorio. En el formulario adaptable, el panel se reemplazará por una captura del fragmento. Como se muestra a continuación, el panel Información general y sus paneles secundarios, Información personal y Dirección, se guardarán como un fragmento.
Para editar el fragmento, haga clic en Editar recurso en la barra de herramientas del panel. El fragmento se abre en una nueva pestaña o ventana en modo de edición.
Trabajar con fragmentos working-with-fragments
Configurar el aspecto del fragmento configure-fragment-appearance
Cualquier fragmento que inserte en formularios adaptables aparecerá como una imagen de marcador de posición. El marcador de posición muestra títulos de hasta un máximo de diez paneles secundarios en el fragmento. Puede configurar AEM Forms para mostrar el fragmento completo en lugar de la imagen del marcador de posición.
Realice los siguientes pasos para mostrar fragmentos completos en formularios:
-
Vaya a la página de configuración de la consola web de AEM en https:[host]:[port]/system/console/configMgr.
-
Busque y seleccione Configuración del canal web de comunicaciones interactivas y formularios adaptables para abrirlo en modo de edición.
-
Deshabilite Habilitar marcador de posición en lugar de fragmento para que pueda mostrar fragmentos completos en lugar de la imagen del marcador de posición.
Insertar un fragmento en un formulario adaptable insert-a-fragment-in-an-adaptive-form
Los fragmentos de formulario adaptable que cree aparecerán en la pestaña Fragmentos de formularios adaptables del buscador de contenido de AEM. Para insertar un fragmento de formulario adaptable en un formulario adaptable, haga lo siguiente:
-
Abra en modo de edición el formulario adaptable en el que desea insertar un fragmento de formulario adaptable.
-
Haga clic en Recursos
También puede elegir mostrar todos los fragmentos de formularios adaptables o filtrar según su modelo de formulario: plantilla de formulario, esquema XML o básico.
-
Arrastre y suelte un fragmento de formulario adaptable en el formulario adaptable.
note note NOTE El fragmento de formulario adaptable no está habilitado para la creación desde el formulario adaptable. Además, no puede utilizar un fragmento basado en XSD en un formulario adaptable basado en JSON y viceversa.
El fragmento de formulario adaptable se inserta por referencia en el formulario adaptable y se sincroniza con el fragmento de formulario adaptable independiente. Significa que, al actualizar el fragmento de formulario adaptable, los cambios se reflejarán en todos los formularios adaptables donde se utilice el fragmento.
Incrustar un fragmento en formularios adaptables embed-a-fragment-in-adaptive-form
Puede incrustar un fragmento de formulario adaptable en un formulario adaptable si hace clic en el botón Incrustar recurso: <fragmentName> de la barra de herramientas del panel del fragmento agregado, como se muestra en la siguiente imagen de ejemplo.
Usar fragmentos dentro de fragmentos using-fragments-within-fragments
Puede crear fragmentos de formulario adaptable anidados, lo que significa que puede arrastrar y soltar un fragmento en otro fragmento y tener una estructura anidada.
Cambiar fragmentos change-fragments
Puede reemplazar o cambiar un fragmento de formulario adaptable por otro mediante la propiedad Seleccionar recurso de fragmento en el cuadro de diálogo Editar componente para un panel de fragmento de formulario adaptable.
Generar documento de registro para el fragmento de formulario adaptable generate-DOR-for-fragments
El documento de registro (DOR) le ayuda a mantener la información de los formularios en formato impreso o de documento. De este modo, le ayuda a realizar un seguimiento de la información sobre sus clientes en cualquier momento posterior y también puede utilizar el documento de registro para archivar formularios y contenido en formato PDF. Aprenda a generar el documento de registro para los fragmentos de formularios adaptables.
Uso de un fragmento de formulario varias veces en un formulario adaptable using-form-fragment-mutiple-times-in-af
Puede utilizar un fragmento de formulario basado en esquemas varias veces en un formulario adaptable para guardar datos de forma única para cada campo de fragmento de formulario. Por ejemplo, puede utilizar un fragmento de formulario de dirección para recopilar detalles de dirección para direcciones permanentes, de comunicación y actuales en un formulario de solicitud de préstamo.
- Si utiliza fragmentos de formulario basados en ninguno varias veces en un formulario adaptable, se produce la sincronización de datos entre los campos de los fragmentos. El problema de sincronización de datos no se produce en fragmentos de formulario basados en componentes principales, donde puede utilizar un fragmento basado en esquemas o en ninguno varias veces en un formulario.
Asignar automáticamente fragmentos para enlazar datos auto-mapping-of-fragments-for-data-binding
Cuando crea un fragmento de formulario adaptable mediante una plantilla de formulario XFA o un tipo complejo XSD y arrastra y suelta el fragmento en un formulario adaptable, el fragmento XFA o el tipo complejo XSD se reemplazará automáticamente por el fragmento de formulario adaptable correspondiente cuya raíz del modelo de fragmento estará asignada al fragmento XFA o al tipo complejo XSD.
Puede cambiar el recurso del fragmento y sus enlaces desde el cuadro de diálogo Editar componente.
Administrar fragmentos manage-fragments
Puede realizar varias operaciones en los fragmentos de formularios adaptables mediante la interfaz de usuario de AEM Forms.
-
Vaya a
https://[hostname]:'port'/aem/forms.html. -
Haga clic en Seleccionar en la barra de herramientas de la IU de AEM Forms y seleccione un fragmento de formulario adaptable. La barra de herramientas muestra las siguientes operaciones que puede realizar en el fragmento de formulario adaptable seleccionado.
Localizar el formulario adaptable que contiene fragmentos localizing-adaptive-form-containing-fragments
Para localizar un formulario adaptable que contenga fragmentos de formulario adaptables, debe localizar el fragmento y el formulario por separado. La idea es localizar un fragmento una vez y reutilizarlo en varios formularios adaptables.
Puntos clave que se deben recordar al trabajar con fragmentos key-points-to-remember-when-working-with-fragments
- Asegúrese de que el nombre del fragmento sea único. El fragmento no se creará si hay un fragmento existente con el mismo nombre.
- En un formulario adaptable basado en XDP, si guarda un panel como fragmento que incluye otro fragmento XDP, el fragmento resultante se enlazará automáticamente al fragmento XDP secundario. Si hay un formulario adaptable basado en XSD, el fragmento resultante se enlazará a la raíz del esquema.
- Cuando se crea un fragmento de formulario adaptable, se crea un nodo de fragmento en CRXDE Lite, similar al nodo guideContainer para un formulario adaptable.
- No se admite un fragmento de un formulario adaptable que utilice un modelo de datos de formulario diferente. Por ejemplo, un fragmento basado en XDP no es compatible con un formulario adaptable basado en XSD y, a la inversa.
- Los fragmentos de formularios adaptables están disponibles para utilizarlos a través de la pestaña Fragmentos de formularios adaptables en el buscador de contenido de AEM.
- Cualquier expresión, script o estilo de un fragmento de formulario adaptable independiente se conservará cuando se inserte por referencia o se incruste en un formulario adaptable.
- No puede editar un fragmento de formulario adaptable, que se inserte por referencia, desde un formulario adaptable. Para editarlo, edite el fragmento de formulario adaptable independiente o incrústelo en el formulario adaptable.
- Al publicar un formulario adaptable, debe publicar los fragmentos de formulario adaptable independientes insertados por referencia en el formulario adaptable.
- Cuando vuelva a publicar un fragmento de formulario adaptable actualizado, los cambios se reflejarán en las instancias publicadas del formulario adaptable en el que se utilice el fragmento.
- El formulario adaptable que contenga el componente Verificar no admitirá usuarios anónimos. Además, no se recomienda utilizar el componente Verificar en un fragmento de formulario adaptable.
- (Solo Mac) Para asegurarse de que la funcionalidad de los fragmentos del formulario funciona perfectamente en todas las situaciones, agregue la siguiente entrada al archivo /private/etc/hosts:
127.0.0.1 <Host machine>Equipo host: el equipo Mac de Apple en el que está implementado AEM Forms.
Fragmentos de referencia reference-fragments
Los fragmentos de formularios adaptables de referencia que se pueden usar para crear el formulario están disponibles. Para obtener más información, consulte Usar fragmentos de referencia.