DocumentaciónAEMGuía del usuario

[AEM_Forms]{class="badge positive" title="(Se aplica a AEM Forms)."}

Crear modelo de datos de formulario (FDM) create-form-data-model

Última actualización: 25 de septiembre de 2026
  • Se aplica a:
  • Experience Manager as a Cloud Service

Creado para:

  • Beginner
  • Intermediate
  • User
  • Developer
Versión
Vínculo del artículo
AEM 6.5
Haga clic aquí
AEM as a Cloud Service
Este artículo

Integración de datos

Un Modelo de datos de formulario (FDM) en Experience Manager Forms define cómo se estructuran e intercambian los datos entre los formularios y los sistemas back-end. La integración de datos de Experience Manager Forms ofrece una interfaz de usuario intuitiva para crear y trabajar con modelos de datos de formulario. Un modelo de datos de formulario (FDM) se basa en fuentes de datos para el intercambio de datos; sin embargo, puede crear un modelo de datos de formulario (FDM) con o sin una fuente de datos. Esta flexibilidad le permite empezar a diseñar y probar formularios incluso antes de que la conectividad back-end esté disponible y, después, enlazar fuentes de datos sin volver a crear el modelo.

Existen dos métodos para crear un modelo de datos de formulario (FDM), en función de si ha configurado fuentes de datos:

  • Uso de fuentes de datos preconfiguradas: si ha configurado las fuentes de datos como se describe en Configurar fuentes de datos, puede seleccionarlas al crear un modelo de datos de formulario (FDM). Al seleccionar fuentes de datos configuradas, se obtienen todos los objetos, propiedades y servicios del modelo de datos de las fuentes de datos seleccionadas que se pueden utilizar en el modelo de datos de formulario (FDM). Este método es ideal cuando los extremos de integración ya están establecidos y desea que FDM refleje el esquema, las operaciones y los servicios activos de esos sistemas.

  • Sin fuentes de datos: Si no ha configurado fuentes de datos para su modelo de datos de formulario (FDM), aún puede crear el modelo de datos de formulario (FDM) sin fuentes de datos. Puede utilizar el modelo de datos de formulario (FDM) para crear Forms adaptable y probarlos con datos de ejemplo. Cuando hay fuentes de datos disponibles, puede enlazar el modelo de datos de formulario (FDM) con fuentes de datos y este enlace se propaga automáticamente al Forms adaptable asociado, de modo que los formularios creados con datos de ejemplo siguen funcionando una vez que se agrega la conectividad back-end real.

NOTE
Requisito previo: Debe ser miembro de los grupos fdm-author y forms-user para crear y trabajar con un modelo de datos de formulario (FDM). Sin pertenencia a ambos grupos, las capacidades de creación de FDM no están disponibles. Póngase en contacto con su administrador de Experience Manager para convertirse en miembro de los grupos fdm-author y forms-user.

Crear modelo de datos de formulario (FDM) data-sources

Antes de crear un modelo de datos de formulario (FDM), asegúrese de que ha configurado las fuentes de datos que desea utilizar en el modelo de datos de formulario (FDM) como se describe en Configurar fuentes de datos. Un modelo de datos de formulario (FDM) proporciona una capa unificada que conecta Adobe Experience Manager Forms con una o más fuentes de datos configuradas, lo que le permite enlazar campos de formulario a datos back-end e invocar servicios de fuentes de datos. Para crear un modelo de datos de formulario (FDM) basado en fuentes de datos configuradas, haga lo siguiente:

  1. En la instancia de autor Experience Manager, vaya a Forms > Integraciones de datos.

  2. Seleccione Crear > Modelo de datos de formulario.

  3. En el cuadro de diálogo Crear un modelo de datos de formulario, haga lo siguiente:

    • Especifique un nombre para el modelo de datos de formulario (FDM).
    • (Opcional) Especifique un título, una descripción y etiquetas para el modelo de datos de formulario (FDM).
    • (Opcional y aplicable solo si se configuran fuentes de datos) Seleccione el icono de verificación situado junto al campo Configuración de la fuente de datos y seleccione el nodo de configuración donde residen los servicios en la nube para las fuentes de datos que desea utilizar. Como resultado, la lista de fuentes de datos disponibles para su selección en la página siguiente está restringida a las disponibles en el nodo de configuración seleccionado. Sin embargo, cualquier fuente de datos de perfil de usuario de Experience Manager se enumera de forma predeterminada. Si no selecciona un nodo de configuración, se enumeran las fuentes de datos de todos los nodos de configuración.

  4. Seleccione Siguiente.

  5. (Aplicable únicamente si se configuran orígenes de datos) La pantalla Seleccionar origen de datos enumera los orígenes de datos disponibles. Seleccione las fuentes de datos que desee utilizar en el modelo de datos de formulario.

  6. Seleccione Crear y, en el cuadro de diálogo de confirmación, seleccione Abrir para abrir el editor del modelo de datos de formulario.

    Un modelo de datos de formulario con tres fuentes de datos: un servicio RESTful, un perfil de usuario de Experience Manager y un RDBMS

    La interfaz de usuario del editor del modelo de datos de formulario incluye los siguientes componentes:

    A. Fuentes de datos Enumera las fuentes de datos en un modelo de datos de formulario. Expanda una fuente de datos para ver los servicios y objetos de modelo de datos.

    B. Actualizar definiciones de Source de datos Recupera cualquier cambio en las definiciones de fuentes de datos configuradas y las actualiza en la pestaña Fuentes de datos del editor del modelo de datos de formulario. Esto garantiza que el modelo refleje el estado actual de las fuentes de datos conectadas.

    C. Modelo Área de contenido en la que aparecen los objetos de modelo de datos añadidos.

    D. Servicios Área de contenido en la que aparecen las operaciones o los servicios de las fuentes de datos añadidas.

    E. Barra de herramientas Herramientas para trabajar con el modelo de datos de formulario (FDM). La barra de herramientas muestra más opciones en función del objeto seleccionado en el modelo de datos de formulario (FDM).

    F. Agregar selección Agrega los objetos y servicios del modelo de datos seleccionado al modelo de datos de formulario.

Para obtener más información sobre el editor del modelo de datos de formulario y cómo puede trabajar con él para editar y configurar un modelo de datos de formulario (FDM), consulte Trabajar con el modelo de datos de formulario.

Actualizar fuentes de datos update

Siga estos pasos para agregar, reemplazar o eliminar orígenes de datos en un Modelo de datos de formulario (FDM) existente en Adobe Experience Manager Forms. Mantener las fuentes de datos actualizadas garantiza que el Forms adaptable creado en el modelo siga leyendo desde y escribiendo en los sistemas correctos.

  1. Vaya a Forms > Integraciones de datos, seleccione el Modelo de datos de formulario (FDM) en el que desea agregar o actualizar las fuentes de datos y seleccione Propiedades.

  2. En las propiedades del modelo de datos de formulario, vaya a la pestaña Actualizar fuente.

    En la pestaña Actualizar Source, puede seleccionar un contexto de configuración y luego agregar, reemplazar o eliminar orígenes de datos:

    • Seleccione un contexto de configuración: Seleccione el icono Examinar en el campo Configuración según el contexto y seleccione un nodo de configuración en el que reside la configuración de nube para la fuente de datos que desea agregar. Esto determina qué configuraciones de nube son visibles. Si no selecciona ningún nodo, solo se enumeran las configuraciones de nube que residen en el nodo global al seleccionar Añadir fuentes.

    • Agregar nueva fuente de datos: Seleccione Agregar fuentes y las fuentes de datos que desea agregar al Modelo de datos de formulario (FDM). Se mostrarán todos los orígenes de datos configurados en global y en el nodo de configuración seleccionado, si los hay. Esto agrega las fuentes de datos seleccionadas para que los objetos del modelo de datos estén disponibles para el enlace en el modelo.

    • Reemplazar una fuente de datos existente: Para reemplazar una fuente de datos existente por otra fuente de datos del mismo tipo, seleccione el icono Editar de la fuente de datos y selecciónela en la lista de fuentes de datos disponibles. Si se sustituye por un origen del mismo tipo, se conserva la estructura existente del modelo de datos, por lo que los enlaces dependientes siguen siendo válidos.
      fdm-properties

    • Eliminar un origen de datos existente: Para eliminar un origen de datos existente, seleccione el icono Eliminar del origen de datos. El icono Eliminar está deshabilitado porque ya se ha agregado un objeto de modelo de datos de esa fuente de datos y está en uso en el Modelo de datos de formulario (FDM), lo que impide eliminar las dependencias a las que aún se hace referencia.

  3. Seleccione  Guardar y cerrar  para guardar las actualizaciones.

NOTE
Una vez que agregue nuevas fuentes de datos o actualice las fuentes de datos existentes en un Modelo de datos de formulario (FDM), actualice las referencias de enlace, según corresponda, en el Forms adaptable que use el Modelo de datos de formulario (FDM) actualizado. Esto garantiza que los campos sigan asignándose correctamente y que los datos del formulario se lean y escriban en las fuentes deseadas.

Configuraciones según el contexto para modos de ejecución específicos runmode-specific-context-aware-config

El modelo de datos de formulario (FDM) usa configuraciones según el contexto de Sling para proporcionar diferentes parámetros de origen de datos, lo que permite conexiones a orígenes de datos que varían entre los modos de ejecución de Experience Manager. Esta capacidad permite que un solo destino de implementación establezca puntos finales distintos en función de si se ejecuta en Desarrollo, Fase o Producción.

Cuando Modelo de datos de formulario (FDM) utiliza configuraciones de nube para almacenar parámetros, estos parámetros, cuando se registran e implementan mediante el control de fuente (repositorio GIT de Cloud Manager), crean una sola configuración de nube con parámetros idénticos en todos los modos de ejecución (Desarrollo, fase y producción). Cuando el caso de uso requiera diferentes conjuntos de datos para entornos de prueba y producción, utilice parámetros de fuente de datos (por ejemplo, una dirección URL de fuente de datos) específicos para cada modo de ejecución de Experience Manager.

Para lograrlo, cree una configuración OSGi que contenga pares de parámetro-valor de la fuente de datos. Esto garantiza que los valores de OSGi tengan prioridad, anulando el mismo par de la configuración de nube Modelo de datos de formulario (FDM) en el tiempo de ejecución. Dado que las configuraciones de OSGi admiten estos modos de ejecución de forma predeterminada, puede anular un parámetro de fuente de datos en un valor diferente según el modo de ejecución, lo que permite que cada entorno se resuelva en su propio extremo.

Para habilitar las configuraciones de nube específicas de la implementación en el modelo de datos de formulario (FDM):

  1. Cree una configuración de nube en la instancia de desarrollo local. Para ver los pasos detallados, consulte Cómo configurar las fuentes de datos.

  2. Almacene su configuración de nube en el sistema de archivos.

    1. Cree un paquete con el filtro /conf/{foldername}/settings/cloudconfigs/fdm. Utilice el mismo {foldername} que en el paso 1. Y reemplace fdm con azurestorage para la configuración de almacenamiento de Azure.
    2. Cree y descargue el paquete. Para obtener más información, consulte las acciones de paquete.

  3. Integrar la configuración de nube en un tipo de archivo del proyecto Experience Manager.

    1. Descomprima el paquete descargado.
    2. Copie la carpeta jcr_root y colóquela en ui.content > src > main > content.
    3. Actualice ui.content > src > main > content > META-INF > vault > filter.xml para contener el filtro /conf/{foldername}/settings/cloudconfigs/fdm. Para obtener más información, consulte módulo ui.content de tipo de archivo del proyecto AEM. Cuando este tipo de archivo del proyecto se implementa mediante la canalización de Cloud Manager (CM), se instala la misma configuración de nube en todos los entornos (o modos de ejecución). Para cambiar el valor de los campos (como la URL) de las configuraciones de nube basadas en el entorno, utilice la configuración de OSGi que se describe en el siguiente paso.

  4. Cree una configuración de Apache Sling según el contexto. Para crear la configuración de OSGi:

    1. Establezca los archivos de configuración de OSGi en el tipo de archivo del proyecto Experience Manager.
      Cree los archivos de configuración de fábrica de OSGi con PID org.apache.sling.caconfig.impl.override.OsgiConfigurationOverrideProvider. Cree un archivo con el mismo nombre en cada carpeta del modo de ejecución donde los valores deban cambiarse por modo de ejecución. Esto garantiza que cada modo de ejecución aplique sus propios valores de anulación. Para obtener más información, consulte Configurar OSGi para Adobe Experience Manager.

    2. Establezca el JSON de configuración de OSGi. Configure el proveedor de anulación de configuración de Apache Sling según el contexto para que los valores específicos del entorno se apliquen automáticamente en la implementación. Para utilizar el proveedor de anulación de configuración de Apache Sling según el contexto:

      1. En su instancia de desarrollo local /system/console/configMgr, seleccione la configuración OSGi de fábrica con el nombre Proveedor de anulación de configuración de Apache Sling según el contexto: Configuración OSGi.
      2. Proporcione una descripción.
      3. Seleccione habilitado.
      4. En las anulaciones, indique los campos que deben cambiarse en función del entorno en la sintaxis de anulación de Sling. Para obtener más información, consulte Configuración de Apache Sling según el contexto: Anular. Por ejemplo, cloudconfigs/fdm/{configName}/url="newURL".
        Agregar varias invalidaciones seleccionando +.
      5. Seleccione Guardar.
      6. Para obtener el JSON de configuración de OSGi, siga los pasos en Generación de configuraciones de OSGi mediante el Quickstart de AEM SDK.
      7. Coloque el JSON en los archivos de configuración de fábrica de OSGi creados en el paso anterior.
      8. Cambie el valor de newURL en la configuración de invalidación al valor de destino correcto para cada entorno (o modo de ejecución), de modo que cada entorno se resuelva en su propia URL.
      9. Para cambiar un valor secreto basado en el modo de ejecución, cree una variable secreta usando la API de Cloud Manager (CM) y después haga referencia a ella en la configuración de OSGi.
        Cuando este tipo de archivo del proyecto se implementa mediante la canalización de Cloud Manager (CM), la anulación proporciona valores diferentes en entornos diferentes (o modos de ejecución). Como resultado, un solo código base se resuelve en la configuración específica del entorno durante la ejecución. Esto garantiza que las instancias de desarrollo, ensayo y producción reciban los valores secretos y de URL correctos sin cambios manuales en el código.
      note
      NOTE
      Los usuarios de Adobe Managed Service pueden cifrar los valores secretos usando la compatibilidad con cifrado. Para obtener más información, consulte compatibilidad con cifrado para las propiedades de configuración y coloque el texto cifrado en el valor después de que las configuraciones según el contexto estén disponibles en el Service Pack 6.5.13.0.

  5. Actualice las definiciones de fuentes de datos mediante la opción para actualizar las definiciones de fuentes de datos en el Editor del modelo de datos de formulario para actualizar la caché del modelo de datos de formulario (FDM) a través de la interfaz de usuario (IU) de FDM y obtener la configuración más reciente. Esto garantiza que la caché de FDM refleje los valores de anulación recién aplicados.

Próximos pasos next-steps

Ahora tiene Modelo de datos de formulario (FDM) con fuentes de datos agregadas. Con las fuentes de datos conectadas, el siguiente paso es perfeccionar y ampliar el Modelo de datos de formulario (FDM) para que represente con precisión los datos que el formulario necesita capturar y procesar.

Edite el Modelo de datos de formulario (FDM) para realizar las siguientes tareas:

  • Agregar y configurar objetos y servicios del modelo de datos.
  • Agregue asociaciones entre objetos del modelo de datos para definir cómo se conectan los datos relacionados.
  • Editar propiedades de objetos del modelo de datos existentes.
  • Agregue objetos y propiedades del modelo de datos personalizado a los datos del modelo que no estén disponibles en las fuentes de datos conectadas.
  • Genere datos de ejemplo para probar y previsualizar el comportamiento del modelo de datos de formulario.

Estos pasos de configuración le permiten adaptar Form Data Model (FDM) a sus requisitos comerciales específicos antes de enlazarlo a un formulario.

Para obtener más información, consulte Trabajo con el modelo de datos de formulario.

recommendation-more-help
experience-manager-cloud-service-help-main-toc