Crear y utilizar fragmentos de Formularios adaptables en un formulario adaptable basado en componentes principales adaptive-form-fragments

Versión
Vínculo del artículo
AEM as a Cloud Service (componentes principales)
Este artículo
AEM as a Cloud Service (componentes de base)
Haga clic aquí
AEM 6.5
Haga clic aquí

Aunque cada formulario está diseñado para un propósito específico, hay algunos segmentos comunes en la mayoría de los formularios, como para proporcionar detalles personales como nombre y dirección, detalles familiares, detalles de ingresos, etc. 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.

Los fragmentos de formulario se integran perfectamente en varios formularios, lo que optimiza la creación de formularios coherentes y de aspecto profesional. Los fragmentos de formulario garantizan la reutilización, la estandarización y la coherencia de la marca mediante la funcionalidad “cambiar una vez y reflejar en todas partes”. Experimente una mayor capacidad de mantenimiento y eficacia, ya que las actualizaciones realizadas en un solo lugar se propagan automáticamente a todos los formularios que utilizan estos fragmentos.

Puede agregar un fragmento varias veces a un documento y utilizar las propiedades de enlace de datos de sus componentes para vincularlo a diferentes fuentes de datos o esquemas. Por ejemplo, puede utilizar el mismo fragmento de dirección para la dirección permanente, de comunicación y de facturación y conectarlo a diferentes campos de un origen de datos o esquema.

NOTE
Puede personalizar fácilmente la experiencia del fragmento para los usuarios con el cuadro de diálogo Configurar y el cuadro de diálogo Diseño del componente Fragmento de formulario.

Crear un fragmento de formulario adaptable create-a-fragment

Puede crear un fragmento de formulario adaptable desde cero o guardar un panel en un formulario adaptable existente como un fragmento. Para crear un fragmento de formulario:

  1. Inicie sesión en una instancia de AEM Forms en https://[hostname]:[port]/aem/forms.html.

  2. Haga clic en Crear > fragmento de formulario adaptable.

    Crear fragmento de formulario adaptable

  3. Especifique el título, el nombre, la descripción y las etiquetas del fragmento. Asegúrese de especificar un nombre único para el fragmento. Si ya existe otro fragmento con el mismo nombre, el fragmento no se creará.

  4. Seleccione una plantilla de formulario. Puede crear un fragmento de formulario para formularios adaptables basados en componentes principales o formularios adaptables basados en componentes de base. Para crear un fragmento de formulario para formularios basados en componentes principales, seleccione una plantilla basada en componentes principales.

    Cuando cree un fragmento de formulario para formularios basados en componentes principales, utilice la opción Seleccionar tema de formulario para seleccionar un tema basado en componentes principales.

  5. Haga clic para abrir el modelo de formulario y desde el menú desplegable Seleccionar desde, seleccione uno de los siguientes modelos para el fragmento:

    Muestra el tipo de modelo en la pestaña Modelo de formulario

    • Ninguno: especifica que se cree el fragmento desde cero sin usar ningún modelo de formulario.

      note note
      NOTE
      En Formularios adaptables, puede utilizar un solo fragmento de formulario (basado en componentes principales) varias veces. Admite fragmentos de formulario basados en ninguno y en esquema.
    • Esquema: especifica que se crea el fragmento con un esquema XML o JSON cargado en AEM Forms. Puede cargar o seleccionar entre los esquemas XML disponibles como modelo de formulario para el fragmento. Al seleccionar un esquema XML, también puede crear un fragmento de formulario adaptable seleccionando un complexType presente en el esquema seleccionado del cuadro desplegable Tipo complejo de esquema XML. Al seleccionar un esquema JSON, también puede crear un fragmento de formulario adaptable seleccionando una definición de esquema presente en el esquema seleccionado del cuadro desplegable Definiciones de esquema JSON.

    • Modelo de datos de formulario: especifica que se cree el fragmento mediante un modelo de datos de formulario (FDM). Puede crear un fragmento de formulario adaptable basado en un único objeto de modelo de datos de un modelo de datos de formulario (FDM). Expanda el menú desplegable Definiciones del modelo de datos de formulario (FDM). Esta lista enumera todos los objetos de modelo de datos del modelo de datos de formulario (FDM) especificado. Seleccione un objeto de modelo de datos de la lista.

    Modelo de datos de formulario (FDM)

  6. 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 agregar cualquier componente del formulario adaptable al fragmento.

Una vez creado el fragmento de formulario adaptable basado en un esquema o modelo de datos de formulario (FDM), los elementos del modelo de datos de formulario (FDM o del esquema aparecen en la pestaña Fuentes de datos del Explorador de contenido en el Editor de formularios adaptables. Puede arrastrar y soltar 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 esquema asociado.

Añadir un fragmento a un formulario adaptable insert-a-fragment-in-an-adaptive-form

Para agregar un fragmento de formulario adaptable en un formulario adaptable, haga lo siguiente:

  1. Abra el formulario adaptable en modo de edición.

  2. Añada el componente Fragmento de formulario adaptable al formulario.

  3. Abra el cuadro de diálogo Configuración del componente Fragmento de formulario adaptable.

  4. Seleccione la Referencia de fragmento en la pestaña Básico. Aparecerán todos los fragmentos de Formularios adaptables disponibles para el formulario, según el modelo del formulario.

  5. Seleccione un fragmento de formulario adaptable en el componente Fragmento de formulario adaptable de su formulario adaptable.

    seleccione la opción Fragmentos de formulario adaptable

El fragmento de formulario adaptable se inserta por referencia en el formulario adaptable y se sincroniza con el fragmento de formulario adaptable independiente. Esto implica que cualquier modificación realizada en el fragmento de formulario adaptable se reflejará en todas las instancias en las que el fragmento se incorpore a Formularios adaptables.

Uso de 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.

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 y no basado en esquema 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.

usar varios fragmentos en formularios adaptables

Administrar fragmentos manage-fragments

Puede realizar varias operaciones en los fragmentos de formularios adaptables mediante la interfaz de usuario de AEM Forms.

  1. Vaya a https://[hostname]/aem/forms.html.

  2. 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.

Operación
Descripción
Editar
Abre el fragmento de formulario adaptable seleccionado en el modo de edición.
Vista previa
Proporciona opciones para obtener una vista previa del fragmento como HTML o una vista previa personalizada mediante la combinación de datos de un archivo XML con el fragmento. Para obtener más información, consulte Previsualizar un formulario.
Descargar
Descarga el fragmento seleccionado.
Iniciar revisión/Administrar revisión
Permite iniciar y administrar una revisión del fragmento seleccionado. Para obtener más información, consulte Crear y administrar revisiones.
Agregar diccionario
Genera un diccionario para localizar el fragmento seleccionado. Para obtener más información, consulte Localizar formularios adaptables.
Publicar o cancelar la publicación
Publica/cancela la publicación del fragmento seleccionado.
Eliminar
Elimina el fragmento seleccionado.

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.
  • 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, modifique el fragmento de formulario adaptable independiente.
  • Cuando publique un formulario adaptable, deberá 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.

Fragmentos de referencia reference-fragments

Los fragmentos de formulario adaptables de referencia que se pueden usar para crear el formulario están disponibles.

Ver también see-also

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab