Configuración del servicio de rellenado previo en formularios adaptables mediante Edge Delivery Services

Fase 1: Configuración del modelo de datos de formulario

Paso 1: Crear un modelo de datos de formulario

1. Iniciar sesión en la instancia de AEM Forms as a Cloud Service

2. Ir a Adobe Experience Manager > Formularios > Integraciones de datos

3. Seleccione  Crear > Modelo de datos de formulario.

4. Elegir la información pertinente en Configuración de fuente de datos y seleccionar la opción Fuente de datos configurada

   

   note tip
   TIP
   Para obtener instrucciones detalladas sobre la creación de modelos de datos de formulario, consulte Crear modelo de datos de formulario.

Paso 2: Configurar los servicios de FDM

1. Ir a Adobe Experience Manager > Formularios > Integraciones de datos

2. Abrir el modelo de formulario de datos en modo de edición

3. Seleccionar un objeto de modelo de datos y haga clic en Editar propiedades

4. Configurar los servicios Lectura y Escritura para los objetos del modelo de datos seleccionados

   

5. Configure los argumentos del servicio:

   • Hacer clic en el icono de edición del argumento del servicio de lectura
   • Enlazar el argumento a un atributo de perfil de usuario, atributo de solicitud o valor literal
   • Especificar el valor del enlace (por ejemplo, petid para un formulario de registro de mascota)

   

6. Hacer clic en Listo para guardar el argumento y en Guardar para guardar el FDM

   note note
   NOTE
   Obtenga más información acerca de la configuración de servicios FDM en Trabajar con el modelo de datos de formulario (FDM).

Fase 2: Creación y configuración del formulario adaptable

Paso 3: Crear un formulario adaptable

1. Ir a Adobe Experience Manager > Formularios > Formularios y documentos

2. Seleccionar Crear > Formularios adaptables

3. En la pestaña Fuente, seleccione una plantilla basada en Edge Delivery Services:

   

4. Hacer clic en Crear para abrir el asistente de Crear formulario

5. Especifique los detalles del formulario:

   • Nombre: escribir un nombre descriptivo para el formulario
   • Título: proporcionar un título descriptivo
   • URL de GitHub: escribir la URL del repositorio (por ejemplo, https://github.com/wkndforms/edsforms)

6. Haga clic en Crear

   

El formulario se abre en el editor universal para la creación.

Paso 4: Configurar la fuente de datos de formulario

1. Seleccionar el formulario y hacer clic en Propiedades

   

2. Abrir la pestaña Modelo de formulario

3. En la lista desplegable Seleccionar de, elegir Modelo de datos de formulario (FDM)

4. Seleccionar el modelo de datos de formulario creado (por ejemplo, PetFDM) en la lista desplegable

   

5. Hacer clic en Guardar y cerrar

6. Abrir el formulario para editarlo en el editor universal

Los elementos de formulario del FDM aparecen en la pestaña Fuente de datos de Explorador de contenido.

Paso 5: Añadir el enlace de datos a los campos de formulario

1. Seleccionar elementos de datos de la pestaña Fuente de datos

2. Hacer clic en Añadir o arrastrar y soltar elementos para crear el formulario

   

3. Añada enlace de datos a los campos del formulario:

   • Seleccionar un campo de formulario

   • En el panel Propiedades, buscar la propiedad Referencia de enlace

   • Seleccionar la referencia de enlace de datos adecuada

     

Fase 3: Configuración del servicio de rellenado previo

Paso 6: Habilitar las extensiones necesarias

Asegúrese de que estas extensiones estén habilitadas en el editor universal:

1. Extensión de propiedades de formularios AEM

   • Abrir Extension Manager en el editor universal
   • Habilitar la extensión Propiedades de formulario AEM

   

2. Extensión de fuente de datos

   • Habilitar la extensión Fuente de datos si no ve el icono Fuentes de datos

   

   note tip
   TIP
   Para obtener instrucciones detalladas sobre la administración de extensiones, consulte Características destacadas de las funciones de Extension Manager.

Paso 7: Configurar el servicio de rellenado previo

1. Abrir el formulario adaptable en el editor universal

2. Hacer clic en el icono de extensión Propiedades de formulario AEM

   

3. Hacer clic en la pestaña Prerrellenar.

4. Seleccionar Servicio de rellenado previo del modelo de datos de formulario

   

5. Hacer clic en Guardar y cerrar

Fase 4: Prueba de la configuración de rellenado previo

Paso 8: Previsualizar y probar

1. Ir a Formularios > Formularios y documentos

2. Seleccionar el formulario adaptable

3. Elegir Vista previa como HTML

4. Pruebe el rellenado previo añadiendo parámetros a la URL:

   https://your-preview-url.com?<bindreferencefield>=<value>

   Ejemplo:

   https://your-preview-url.com?petid=12345

   

El formulario debe rellenarse automáticamente con datos basados en el parámetro proporcionado.

Problemas comunes y soluciones

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3
Problema	Causa posible	Solución
Los campos de formulario no se rellenan previamente	Valores bindRef incorrectos	Verificar que bindRef coincida exactamente con los nombres de campo de FDM
Errores de formato de datos	Estructura de datos no coincidente	Asegurarse de que los datos de rellenado previo coincidan con el esquema del modelo de formulario
No se ha encontrado el servicio	Problemas de configuración de FDM	Comprobar que los servicios de FDM estén correctamente configurados y guardados
Errores de autenticación	Conectividad de fuente de datos	Verificar las credenciales y la conectividad de la fuente de datos
Carga parcial de datos	Faltan asignaciones de campo	Asegurarse de que todos los campos obligatorios tengan enlaces de datos adecuados

Pasos de depuración

1. Verificar configuración de FDM:

   • Comprobar si los servicios están correctamente configurados
   • Probar los servicios FDM de forma independiente
   • Validar conectividad de fuente de datos

2. Comprobar configuración del formulario:

   • Confirmar que el formulario está asociado al FDM correcto
   • Comprobar valores bindRef de campo
   • Probar formulario sin rellenado previo primero

3. Flujo de datos de prueba:

   • Utilizar las herramientas para desarrolladores de exploradores para inspeccionar solicitudes de red
   • Buscar errores de JavaScript en la consola
   • Validar formato de datos de respuesta

4. Mensajes de error comunes:

   • “Servicio de rellenado previo no encontrado”: comprobar la configuración del servicio
   • “Error en el enlace de datos”: verificar la precisión de bindRef
   • “Formato de datos no válido”: asegurarse de que los datos coincidan con el esquema

Prácticas recomendadas de configuración

• Usar nombres descriptivos: asignar un nombre claro a FDM y servicios
• Validar esquemas de datos: asegurarse de que la estructura de datos coincida con los requisitos del formulario
• Probar de forma incremental: configurar y probar un campo a la vez
• Asignaciones de documentos: realizar un seguimiento de las asignaciones de campo a datos

Optimización del rendimiento

• Minimizar el volumen de datos: rellenar previamente solo los campos necesarios
• Usar almacenamiento en caché: configurar el almacenamiento en caché apropiado para los datos a los que se accede con frecuencia
• Optimizar consultas: asegurarse de que las consultas de base de datos sean eficientes
• Monitorizar el rendimiento: hacer un seguimiento de los tiempos de carga de los formularios con el rellenado previo habilitado

Consideraciones sobre la seguridad

• Validar parámetros de entrada: validar siempre los parámetros de URL
• Sanear los datos: limpiar los datos antes de rellenar previamente los formularios
• Implementar controles de acceso: asegurarse de que los usuarios solo puedan acceder a sus propios datos
• Usar HTTPS: usar siempre conexiones seguras para la transmisión de datos

Directrices sobre la experiencia del usuario

• Proporcionar comentarios: mostrar indicadores de carga durante la captura de datos
• Controlar correctamente los errores: mostrar mensajes de error útiles
• Permitir invalidaciones: permitir que los usuarios modifiquen los datos rellenados previamente
• Mantener coherencia: utilizar un comportamiento de rellenado previo coherente en todos los formularios

¿Cómo puedo probar si el rellenado previo funciona correctamente?

Obtenga una vista previa del formulario y anexe parámetros de rellenado previo a la URL con este formato: ?<bindreferencefield>=<value>. Asegúrese de que el campo tenga un bindRef válido que coincida con la estructura de datos. Utilice las herramientas para desarrolladores de explorador para inspeccionar las solicitudes de red y comprobar que los datos se recuperan correctamente.

¿Qué formatos de datos se admiten para rellenar previamente formularios adaptables?

Los formularios adaptables admiten varios formatos según el modelo de formulario:

• Formularios XFA: XML que coincide con el esquema XFA
• Formularios de esquema JSON: los datos JSON cumplen con el esquema
• Formularios FDM: JSON que se asigna a la estructura del modelo de datos
• Formularios de esquema XML: XML que coincide con la estructura de esquema

¿Puedo rellenar previamente tanto los campos enlazados como los no enlazados?

Sí, puede rellenar previamente ambos tipos de campos. Los campos enlazados utilizan la sección afBoundData y deben coincidir con el esquema del modelo de formulario. Los campos no enlazados utilizan la sección afUnBoundData y pueden contener cualquier dato adicional.

¿Qué debo hacer si solo se rellenan previamente algunos campos?

Compruebe que todos los campos tengan valores bindRef correctos que coincidan exactamente con el FDM. Verifique que la fuente de datos contenga todos los campos obligatorios y que la estructura de datos coincida con el esquema del modelo de formulario.

¿Puedo utilizar varios servicios de rellenado previo en un formulario?

Puede configurar un servicio de rellenado previo principal por formulario. Sin embargo, puede combinar diferentes fuentes de datos dentro de un solo modelo de datos de formulario para lograr una funcionalidad similar.

¿Cómo manipulo la autenticación para los servicios de rellenado previo?

La autenticación depende de la configuración de la fuente de datos. Para el rellenado previo basado en FDM, configure la autenticación en la configuración de la fuente de datos. Para rellenar previamente borradores, los usuarios suelen tener que iniciar sesión para acceder a los borradores guardados.