Fragmentos de formulario adaptables

Aunque cada formulario está diseñado para un propósito específico, hay algunos segmentos comunes en la mayoría de las formas, como proporcionar detalles personales como nombre y dirección, detalles de familia, 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 en formularios adaptables. Estos segmentos reutilizables e independientes se denominan fragmentos de formulario adaptables.

Creación de un fragmento

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

Crear fragmento desde cero

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

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

  3. Especifique el título, el nombre, la descripción y las etiquetas del fragmento.

    NOTA

    Asegúrese de especificar un nombre único para el fragmento. Si ya existe otro fragmento con el mismo nombre, el fragmento no se crea.

  4. Haga clic para abrir la ficha Modelo de formulario y, en 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.
    • 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.

    Creación de un formulario adaptable utilizando una plantilla de formulario como modelo

    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 en la lista desplegable.

    Seleccionar subformularios de la plantilla de formulario especificada

    Además, puede crear un fragmento de formulario adaptable utilizando subformularios que no estén marcados como fragmentos en la plantilla de formulario especificando 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.

    Crear un fragmento de formulario adaptable basado en un esquema XML como modelo

    También puede crear un fragmento de formulario adaptable seleccionando un complexType presente en el esquema seleccionado en el cuadro desplegable.

    Seleccionar un tipo complejo del modelo de esquema XML especificado

  5. Haga clic en Crear y, a continuación, haga clic en Abrir para abrir el fragmento, con una plantilla predeterminada, en modo de edición.

En el modo de edición, puede arrastrar y soltar cualquier componente de formulario adaptable de la barra de tareas AEM en el fragmento. Para obtener información sobre los componentes de formulario 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, aparece una nueva ficha que muestra la jerarquía del modelo de formulario en el buscador de contenido. Permite arrastrar y soltar elementos del modelo de formulario en el fragmento. Los elementos del modelo de formulario añadidos se convierten en componentes de formulario, al tiempo que se conservan las propiedades originales del XDP o XSD asociado.

Guardar panel como fragmento

  1. Abra un formulario adaptable que contenga el panel que desee guardar como fragmento de formulario adaptable.

  2. En la barra de herramientas del panel, haga clic en Guardar como fragmento. Se abre el cuadro de diálogo Guardar como fragmento.

    NOTA

    Si el panel que está guardando como fragmento contiene un panel secundario, el fragmento resultante los incluirá.

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

      NOTA

      Asegúrese de especificar un nombre único para el fragmento. Si ya existe otro fragmento con el mismo nombre, el fragmento no se crea.

    • Título: Título del fragmento. El valor predeterminado es el título del panel.

    • Descripción: Descripción del fragmento.

    • Etiquetas: Etiqueta metadatos para el fragmento.

    • Ruta de destino: Ruta del repositorio en la que se guardará el fragmento. Si no especifica una ruta, se crea un nodo con el mismo nombre que el del fragmento junto al nodo que contiene el formulario adaptable. El fragmento se guarda en este nodo.

    • Modelo de formulario: Según el 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 de fragmento: Solo aparece en formularios adaptables basados en XSD. Especifica la raíz del modelo de fragmento. Puede elegir / o el tipo de complejo XSD de la lista desplegable. Tenga en cuenta que 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 puede ver en la pestaña del modelo de datos de formulario adaptable. Para una raíz de modelo de fragmento de tipo complejo, solo los descendientes del tipo complejo seleccionado están visibles en la pestaña del modelo de datos de formulario adaptable.

    • XSD Ref: Solo aparece en formularios adaptables basados en XSD. Muestra la ubicación del esquema XML.

    • Ref XDP: Solo aparece en formularios adaptables basados en XDP. Muestra la ubicación de la plantilla de formulario XDP.

    save-fragment
    Figura: Cuadro de diálogo Guardar como fragmento

  4. Haga clic en Aceptar.

    El panel se guarda en la ubicación especificada o predeterminada del repositorio. En el formulario adaptable, el panel se sustituye por una instantánea del fragmento. Como se muestra a continuación, el panel Información general y sus paneles secundarios, Información personal y Dirección, se guardan 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 ficha o ventana en modo de edición.

    Edición de fragmentos

Uso de fragmentos

Configurar el aspecto del fragmento

Cualquier fragmento que inserte en los formularios adaptables aparecerá como 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 que muestre el fragmento completo en lugar de la imagen del marcador de posición.

Realice los siguientes pasos para mostrar fragmentos completos en formularios:

  1. Vaya a AEM página de configuración de la consola web en https:[host]:[port]/system/console/configMgr.
  2. Busque y haga clic en Adaptive Form and Interactive Communication Web Channel Configuration para abrirlo en modo de edición.
  3. Deshabilite la casilla Habilitar marcador de posición en lugar de Fragmento para mostrar fragmentos completos en lugar de la imagen de marcador de posición.

Insertar un fragmento en un formulario adaptable

Los fragmentos de formulario adaptables que cree aparecerán en la ficha Fragmentos de formulario adaptables del buscador de contenido de AEM. Inserción de un fragmento de formulario adaptable en un formulario adaptable:

  1. Abra el formulario adaptable, en modo de edición, en el que desea insertar un fragmento de formulario adaptable.

  2. Haga clic en Assets assets-browser en la barra lateral. En el navegador de recursos, seleccione Fragmentos de formulario adaptables en la lista desplegable.

    También puede elegir mostrar todos los fragmentos de formulario adaptables o filtrar según su modelo de formulario: Plantilla de formulario, Esquema XML o Básico.

  3. Arrastre y suelte un fragmento de formulario adaptable en el formulario adaptable.

    NOTA

    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 de la forma opuesta.

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, cuando se actualiza el fragmento de formulario adaptable, los cambios se reflejan en todos los formularios adaptables en los que se utiliza el fragmento.

Incrustar un fragmento en formato adaptable

Puede incrustar un fragmento de formulario adaptable en un formulario adaptable haciendo clic en **Incrustar recurso: Botón *fragmentName ***​en la barra de herramientas del panel del fragmento añadido, como se muestra en la siguiente imagen de ejemplo.

Incrustar un fragmento de formulario en un formulario adaptable

NOTA

El fragmento incrustado ya no está vinculado al fragmento independiente. Puede editar los componentes del fragmento incrustado desde el formulario adaptable.

Uso de fragmentos dentro de fragmentos

Puede crear fragmentos de formulario adaptables anidados, lo que significa que puede arrastrar y soltar un fragmento en otro fragmento y puede tener una estructura de fragmento anidada.

Cambiar fragmentos

Puede reemplazar o cambiar un fragmento de formulario adaptable por otro fragmento utilizando la propiedad Select Fragment asset en el cuadro de diálogo Editar componente para un panel de fragmento de formulario adaptable.

Asignación automática de fragmentos para enlace de datos

Cuando se crea un fragmento de formulario adaptable utilizando una plantilla de formulario XFA o un tipo complejo XSD y se arrastra y suelta el fragmento en un formulario adaptable, el fragmento XFA o el tipo complejo XSD se reemplaza automáticamente por el fragmento de formulario adaptable correspondiente cuya raíz del modelo de fragmento está asignada al fragmento XFA o al tipo complejo XSD.

Puede cambiar el recurso de fragmento y sus enlaces desde el cuadro de diálogo Editar componente.

NOTA

También puede arrastrar y soltar un fragmento de formulario adaptable enlazado desde la biblioteca de fragmentos de formulario adaptable en AEM buscador de contenido y proporcionar la referencia de enlace correcta desde el cuadro de diálogo Editar componente del panel de fragmentos de formulario adaptable.

Administrar fragmentos

Puede realizar varias operaciones en fragmentos de formulario adaptables mediante la IU de AEM Forms.

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

  2. Haga clic en Select en la barra de herramientas de la interfaz de usuario 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

Abra

Abre el fragmento de formulario adaptable seleccionado en modo de edición.

Ver propiedades

Abre el panel Propiedades. Desde el panel Propiedades, puede ver y editar propiedades, generar una vista previa y cargar una imagen en miniatura para el fragmento seleccionado. Para obtener más información, consulte Administración de metadatos.

Copiar

Copia el fragmento seleccionado. El botón Pegar aparece en la barra de herramientas.

Descargar

Descarga el fragmento seleccionado.

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 Vista previa de un formulario.

Iniciar revisión/Administrar revisión

Permite iniciar y administrar una revisión del fragmento seleccionado. Para obtener más información, consulte Creación y administración de revisiones.

Crear diccionario

Genera un diccionario para localizar el fragmento seleccionado. Para obtener más información, consulte Localización de formularios adaptables.

Publicar o cancelar la publicación

Publica/cancela la publicación del fragmento seleccionado.

Eliminar

Elimina el fragmento seleccionado.

Localización de formularios adaptables que contienen fragmentos

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.

NOTA

Las claves de localización del fragmento no aparecerán en el archivo XLIFF para un formulario adaptable.

Puntos clave que se deben recordar al trabajar con fragmentos

  • Asegúrese de que el nombre del fragmento sea único. El fragmento no se crea 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. En el caso de 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, similar al nodo guideContainer para un formulario adaptable, en CRXDe Lite.

  • No se admite un fragmento en 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 viceversa.

  • Los fragmentos de formulario adaptables están disponibles para su uso a través de la ficha Fragmentos de formulario adaptables en AEM buscador de contenido.

  • Cualquier expresión, secuencia de comandos o estilo de un fragmento de formulario adaptable independiente se conserva cuando se inserta por referencia o se incrusta en un formulario adaptable.

  • No se puede editar un fragmento de formulario adaptable, que se inserta por referencia, desde un formulario adaptable. Para editarlo, edite el fragmento de formulario adaptable independiente o incruste el fragmento en el formulario adaptable.

  • Cuando publica un formulario adaptable, debe publicar los fragmentos de formulario adaptable independientes insertados por referencia en el formulario adaptable.

  • Cuando vuelve a publicar un fragmento de formulario adaptable actualizado, los cambios se reflejan en las instancias publicadas del formulario adaptable en el que se utiliza el fragmento.

  • El formulario adaptable que contiene el componente Verificar no admite usuarios anónimos. Además, no se recomienda utilizar el componente Verificar en un fragmento de formulario adaptable.

  • (Mac only) Para asegurarse de que la funcionalidad de los fragmentos de formulario funciona perfectamente en todos los casos, 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

Los fragmentos de formulario adaptables de referencia que se pueden utilizar para crear el formulario están disponibles. Para obtener más información, consulte Fragmentos de referencia.

En esta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now