Creación de fragmentos de formulario en el editor universal
Los fragmentos de formulario son componentes reutilizables que eliminan el trabajo de desarrollo repetitivo y garantizan la coherencia en los formularios de la organización. En lugar de volver a crear secciones comunes como información de contacto, detalles de direcciones o acuerdos de consentimiento para cada formulario, puede generar estos elementos una vez como fragmentos y reutilizarlos en varios formularios.
Objetivos de este artículo:
- Comprender el valor empresarial y las capacidades técnicas de los fragmentos de formulario
- Crear fragmentos de formulario reutilizables mediante el editor universal
- Integrar fragmentos en formularios existentes con la configuración adecuada
- Administrar el ciclo vital de los fragmentos y mantener la coherencia en todos los formularios
Beneficios para empresas:
- Tiempo de desarrollo reducido: genere secciones de formulario comunes una vez y reutilícelas en todas partes
- Coherencia mejorada: diseños y contenido estandarizados en todos los formularios
- Mantenimiento simplificado: actualice un fragmento una vez para reflejar los cambios en todos los formularios que lo utilicen
- Cumplimiento mejorado: asegúrese de que las secciones normativas sigan siendo coherentes y estén actualizadas
Los fragmentos de formulario de Edge Delivery Services admiten funciones avanzadas que incluyen fragmentos anidados, varias instancias dentro de un solo formulario e integración perfecta con fuentes de datos.
Comprensión de los fragmentos de formulario
Los fragmentos de formulario de Edge Delivery Services ofrecen potentes funciones para el desarrollo de formularios modulares:
Funciones principales:
- Administración de coherencia: los fragmentos mantienen diseños y contenido idénticos en varios formularios. Con un enfoque “cambiar una vez, reflejar en todas partes”, las actualizaciones realizadas en un fragmento se aplican automáticamente a todos los formularios en modo Previsualización.
- Uso múltiple: añada el mismo fragmento varias veces dentro de un solo formulario, cada vez con enlaces de datos independientes a diferentes fuentes de datos o elementos de esquema.
- Estructuras anidadas: cree jerarquías complejas incrustando fragmentos dentro de otros fragmentos para arquitecturas de formulario sofisticadas.
Requisitos técnicos:
- Coherencia de URL de GitHub: tanto el fragmento como cualquier formulario que lo utilice deben especificar la misma URL de repositorio de GitHub
- Edición independiente: los fragmentos solo se pueden modificar en su formulario independiente; no se pueden realizar cambios en el formulario host
Comportamiento de publicación:
Requisitos previos
Requisitos de configuración técnica:
- Repositorio de GitHub configurado con conexión establecida entre su entorno de AEM y el repositorio de GitHub
- Último bloque de formularios adaptables añadido a su repositorio de GitHub (para proyectos de Edge Delivery Services existentes)
- Instancia de autor de AEM Forms con plantilla de Edge Delivery Services disponible
- Acceso a la URL de instancia de autor de AEM Forms as a Cloud Service y a la URL del repositorio de GitHub
Conocimientos y permisos requeridos:
- Comprensión básica de los conceptos de diseño de formulario y la jerarquía de componentes
- Familiaridad con la interfaz del editor universal y los flujos de trabajo de creación de formularios
- Permisos de nivel de autor en AEM Forms para crear y administrar recursos de formulario
- Comprensión de los estándares de formularios de su organización y los requisitos de componentes reutilizables
Uso de fragmentos de formulario de Edge Delivery Services
Puede crear fragmentos de formulario de Edge Delivery Services en el editor universal y añadir los fragmentos creados a los formularios de Edge Delivery Services. Puede realizar las siguientes acciones con fragmentos de formulario de Edge Delivery Services:
Para crear un fragmento de formulario en el editor universal, realice los siguientes pasos:
-
Inicie sesión en su instancia de autor de AEM Forms as a Cloud Service.
-
Seleccione Adobe Experience Manager > Formularios > Formularios y documentos.
-
Haga clic en Crear > fragmento de formulario adaptable.
Aparece el asistente Crear fragmento de formulario adaptable.
-
Seleccione la plantilla basada en Edge Delivery Services en la pestaña Seleccionar plantilla y haga clic en Siguiente.
-
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á.
-
Especifique la URL de GitHub. Por ejemplo, si el repositorio de GitHub se llama
edsforms, está ubicado en la cuentawkndformsy la URL eshttps://github.com/wkndforms/edsforms.
-
(Opcional) Haga clic para abrir la pestaña modelo de formulario y desde el menú desplegable Seleccionar de, seleccione uno de los siguientes modelos para el fragmento:
-
Modelo de datos de formulario (FDM): integre objetos y servicios de modelo de datos desde las fuentes de datos en su fragmento. Elija Modelo de datos de formulario (FDM) si el formulario requiere leer y escribir datos de varias fuentes.
-
Esquema JSON: integre su formulario con un sistema back-end asociando un esquema JSON que defina la estructura de datos. Le permite añadir contenido dinámico mediante los elementos de esquema.
-
Ninguno: especifica que se cree el fragmento desde cero sin usar ningún modelo de formulario.
note note NOTE Para aprender a integrar formularios o fragmentos con un modelo de datos de formulario (FDM) en el editor universal para utilizar diversas fuentes de datos back-end, consulte Integración de formularios con el modelo de datos de formulario en el editor universal. -
-
(Opcional) Especifique la fecha de publicación o la de cancelación de publicación del fragmento en la pestaña Avanzado.
-
Haga clic en Crear para generar el fragmento. Aparecerá un cuadro de diálogo de éxito con opciones de edición.
-
Haga clic en Editar para abrir el fragmento en el editor universal con la plantilla predeterminada aplicada.
-
Diseñar el contenido del fragmento: añada componentes de formulario (campos de texto, listas desplegables, casillas de verificación) para generar la sección reutilizable. Para obtener instrucciones detalladas sobre los componentes, consulte Introducción a Edge Delivery Services para AEM Forms con el editor universal (WYSIWYG).
-
Configurar propiedades del componente: establezca los nombres de los campos, las reglas de validación y los valores predeterminados según sea necesario para su caso de uso.
-
Guardar y previsualizar: guarde el fragmento y use el modo Previsualización para comprobar el diseño y la funcionalidad.
Punto de comprobación de validación:
- Cargas de fragmentos sin errores en el editor universal
- Todos los componentes del formulario se representan correctamente
- Las propiedades de campo y las reglas de validación funcionan según lo esperado
- El fragmento se guardará y estará disponible en la consola Formularios y documentos
Una vez completado el fragmento, puede integrarlo en cualquier formulario de Edge Delivery Services.
En este ejemplo se muestra la creación de un formulario Employee Details que utiliza el fragmento Contact Details para las secciones de información de empleados y supervisores. Este enfoque garantiza una recopilación de datos coherente y reduce los esfuerzos de desarrollo.
Para integrar un fragmento de formulario en el formulario:
-
Abra el formulario en modo de edición.
-
Añada el componente Fragmento de formulario al formulario.
-
Abra el explorador de contenido y vaya al componente Formulario adaptable en el Árbol de contenido.
-
Vaya a la sección, donde desea añadir un fragmento. Por ejemplo, vaya al panel Detalles del empleado.
-
Haga clic en el icono de Añadir y añada el componente Fragmento de formulario en la lista Componentes de formularios adaptables.
Al seleccionar el componente Fragmento de formulario, el fragmento se añade a su formulario. Puede configurar las propiedades del fragmento añadido abriendo sus Propiedades. Por ejemplo, oculte el título del fragmento de sus propiedades.
-
Seleccione la Referencia de fragmento en la pestaña Básico. Aparecerán todos los fragmentos disponibles para su formulario, según el modelo del formulario.
Por ejemplo, vaya a
/content/forms/afy seleccione el fragmentoContact Details.
-
Haga clic en Seleccionar.
El fragmento de formulario se añade por referencia al formulario y permanece sincronizado con el fragmento de formulario independiente.
note note NOTE El botón Editar fragmento permite a los usuarios navegar directamente al fragmento de formulario para editarlo. Puede obtener una vista previa del formulario para ver cómo aparece en el modo Vista previa.
Del mismo modo, puede repetir los pasos 3 al 7 para insertar el fragmento
Contact Detailspara el panelSupervisor Details.
Puede realizar varias operaciones en los fragmentos de formulario mediante la interfaz de usuario de AEM Forms.
-
Inicie sesión en su instancia de autor de AEM Forms as a Cloud Service.
-
Seleccione Adobe Experience Manager > Formularios > Formularios y documentos.
-
Seleccione un fragmento de formulario y la barra de herramientas mostrará las siguientes operaciones que puede realizar en el fragmento seleccionado.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 html-authored no-header Operación Descripción Editar Abre el fragmento de formulario en el modo de edición. Propiedades Proporciona opciones para modificar las propiedades del fragmento de formulario. Copiar Proporciona opciones para copiar el fragmento de formulario y pegarlo en la ubicación deseada. Vista previa Proporciona opciones para previsualizar el fragmento como HTML o realizar una vista previa personalizada combinando los datos de un archivo XML con el fragmento. Descargar Descarga el fragmento seleccionado. Iniciar revisión y Administrar revisión Permite iniciar y administrar una revisión del fragmento seleccionado. Publicar o cancelar la publicación Publica/cancela la publicación del fragmento seleccionado. Eliminar Elimina el fragmento seleccionado. Comparar Compara dos fragmentos de formulario diferentes para obtener una vista previa.
Prácticas recomendadas
Diseño y nombre del fragmento:
- Usar nombres descriptivos y únicos: elija nombres que indiquen claramente el propósito del fragmento (por ejemplo, “detalles de contacto con validación” en lugar de “fragmento1”)
- Plan de reutilización: diseñe fragmentos para que sean independientes del contexto y funcionen en diferentes tipos de formularios
- Mantener los fragmentos centrados: cree fragmentos de un solo propósito en lugar de componentes complejos multifunción
Flujo de trabajo de desarrollo:
- Probar fragmentos de forma independiente: compruebe la funcionalidad del fragmento antes de integrarlo en los formularios
- Mantener URL de GitHub coherentes: asegúrese de que se utiliza la misma URL de repositorio en todos los fragmentos y formularios relacionados
- Propósito del fragmento de documento: incluya descripciones y etiquetas claras para ayudar a los integrantes del equipo a comprender cuándo usar cada fragmento
Publicación y mantenimiento:
- Coordinar publicación: al actualizar fragmentos, planee volver a publicar todos los formularios dependientes simultáneamente
- Control de versiones: use mensajes de confirmación significativos al actualizar fragmentos para realizar un seguimiento de los cambios a lo largo del tiempo
- Monitorizar dependencias: haga un seguimiento de qué formularios utilizan cada fragmento para evaluar el impacto de la actualización
Resumen
Ha aprendido correctamente a aprovechar los fragmentos de formulario en Edge Delivery Services para mejorar la eficacia del desarrollo y mantener la coherencia en los formularios de su organización.
Logros clave:
- Comprensión: se ha comprendido el valor comercial y las capacidades técnicas de los fragmentos de formulario
- Creación: fragmentos de formulario reutilizables creados usando el editor universal con la configuración adecuada
- Integración: se añadieron fragmentos a los formularios con la configuración de referencia y de propiedad correctas
- Administración: operaciones de ciclo de vida de fragmento exploradas y flujos de trabajo de mantenimiento
Próximos pasos:
- Cree una biblioteca de fragmentos de uso común para su organización.
- Establezca convenciones de nomenclatura y políticas de gobernanza para el uso de fragmentos.
- Explorar la integración avanzada con modelos de datos de formulario para fragmentos dinámicos impulsados por datos
- Implemente plantillas de formulario basadas en fragmentos para lograr experiencias de usuario coherentes.
Ahora, sus formularios se benefician de una arquitectura modular y fácil de mantener que se adapta de manera eficiente a todos los proyectos, al tiempo que garantiza experiencias de usuario coherentes.