Crear modelo de datos de formulario

Última actualización: 2024-02-07
  • 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

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 se basa en fuentes de datos para el intercambio de datos; sin embargo, puede crear un modelo de datos de formulario con o sin una fuente de datos. Existen dos métodos para crear un modelo de datos de formulario en función de si ha configurado fuentes de datos:

  • Utilizando fuentes de datos preconfiguradas: Si ha configurado las fuentes de datos tal como se describe en Configurar fuentes de datos, puede seleccionarlas al crear un modelo de datos de formulario. Incorpora todos los objetos, propiedades y servicios del modelo de datos de las fuentes de datos seleccionados que se pueden utilizar en el modelo de datos de formulario.

  • Sin fuentes de datos: Si no ha configurado fuentes de datos para su modelo de datos de formulario, puede crearlos sin fuentes de datos. Puede utilizar el modelo de datos de formulario para crear formularios adaptables y probarlos utilizando datos de ejemplo. Cuando hay fuentes de datos disponibles, puede vincular el modelo de datos de formulario con fuentes de datos, lo que se refleja automáticamente en los formularios adaptables asociados.

NOTA

Debe ser miembro de los grupos fdm-author y forms-user para poder crear y trabajar con el modelo de datos de formulario. Póngase en contacto con su Experience Manager administrador para convertirse en miembro de los grupos.

Crear modelo de datos de formulario

Asegúrese de haber configurado las fuentes de datos que desea utilizar en el modelo de datos de formulario como se describe en Configurar fuentes de datos. Para crear un modelo de datos de formulario basado en fuentes de datos configuradas, haga lo siguiente:

  1. En la instancia de autor de Experience Manager, vaya a Formularios > 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:

    • Especifique un nombre para el modelo de datos del formulario.
    • (Opcional) Especifique el título, la descripción y las etiquetas del modelo de datos del formulario.
    • (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. Restringe la lista de fuentes de datos disponibles para su selección en la página siguiente 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 han configurado fuentes de datos). La pantalla Seleccionar fuente de datos enumera las fuentes de datos disponibles, si las hay. 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.

    Revisemos los diferentes componentes de la interfaz de usuario del 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

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

    B. Actualizar definiciones de fuentes 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.

    C. Modelo Área de contenido en la que aparecen los objetos del 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. La barra de herramientas muestra más opciones en función del objeto seleccionado en el modelo de datos de formulario.

    F. Añadir selección Añade 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 el modelo de datos de formulario, consulte Trabajo con el modelo de datos de formulario.

Actualizar fuentes de datos

Haga lo siguiente para agregar o actualizar fuentes de datos a un modelo de datos de formulario existente.

  1. Vaya a Formularios > Integraciones de datos, seleccione el modelo de datos de formulario 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 fuente:

    • 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. Si no selecciona ningún nodo, solo se enumeran las configuraciones de nube que residen en el nodo global al seleccionar Añadir fuentes.

    • Para agregar una fuente de datos nueva, seleccione Añadir fuentes y seleccione las fuentes de datos que desea añadir al modelo de datos de formulario. Se muestran todas las fuentes de datos configuradas en global y el nodo de configuración seleccionado, de haber.

    • Para reemplazar una fuente de datos existente por otra fuente de datos del mismo tipo, seleccione el icono Editar para la fuente de datos y seleccione en la lista de fuentes de datos disponibles.

    • Para eliminar una fuente de datos existente, seleccione el icono Eliminar para la fuente de datos. El icono Eliminar está desactivado si se añade un objeto de modelo de datos en la fuente de datos en el modelo de datos del formulario.

      fdm-properties

  3. Seleccione Guardar y cerrar para guardar las propiedades.

NOTA

Una vez que añada nuevas fuentes de datos o actualice las fuentes de datos existentes en un modelo de datos de formulario, asegúrese de actualizar las referencias de enlace, según corresponda, en los formularios adaptables que utilizan el modelo de datos de formulario actualizado.

Configuraciones según el contexto para modos de ejecución específicos

El modelo de datos de formulario utiliza Configuraciones según el contexto de Sling para ser compatible con distintos parámetros de fuente de datos y conectarse con fuentes de datos para diferentes modos de ejecución de Experience Manager.

Cuando el modelo de datos de formulario utiliza configuraciones de nube para almacenar parámetros, que cuando se registran e implementan mediante el control de fuente (repositorio GIT de Cloud Manager), crea una configuración de nube con los mismos parámetros para todos los modos de ejecución (desarrollo, fase y producción). Sin embargo, en los casos de uso en los que sea necesario tener diferentes conjuntos de datos para entornos de prueba y producción, se utilizan parámetros de fuente de datos (por ejemplo, la URL de la fuente de datos) para diferentes modos de ejecución de Experience Manager.

Para conseguirlo, debe crear una configuración de OSGi que contenga pares de parámetros-valor de la fuente de datos. Esto anula el mismo par de la configuración de nube del modelo de datos de formulario en el momento de ejecución. Como las configuraciones de OSGi son compatibles con estos modos de ejecución de forma predeterminada, puede anular un parámetro de fuente de datos en diferentes valores según el modo de ejecución.

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

  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 CM, la misma configuración de nube se instala 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. Para obtener más información, consulte Configurar OSGi para Adobe Experience Manager.

    2. Establezca el json de configuración de OSGI. Para utilizar el proveedor de anulación de configuración de Apache Sling según el contexto:

      1. En la instancia de desarrollo local /system/console/configMgr, seleccione la configuración de fábrica de OSGi con el nombre Proveedor de anulación de configuración de Apache Sling según el contexto: Configuración de OSGi.
      2. Aporte 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".
        Se pueden agregar varias anulaciones seleccionando +.
      5. Seleccione Guardar.
      6. Para obtener el JSON de configuración de OSGI, siga los pasos en Generar configuraciones de OSGi mediante la iniciación a 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 función del entorno (o modo de ejecución).
      9. Para cambiar el valor secreto en función del modo de ejecución, se puede crear una variable secreta mediante la API de Cloud Manager y más adelante en la sección Configuración de OSGi.
        Cuando este tipo de archivo del proyecto se implementa mediante la canalización de CM, la anulación ofrece valores diferentes en entornos diferentes (o modos de ejecución).
      NOTA

      Los usuarios de Adobe Managed Service pueden cifrar los valores secretos utilizando la compatibilidad con cifrado (para obtener más información, consulte compatibilidad con cifrado para propiedades de configuración y colocar texto cifrado en el valor después de las configuraciones según el contexto están disponibles en 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é de FDM mediante la interfaz de usuario de FDM y obtener la configuración más reciente.

Pasos siguientes

Ahora tiene un modelo de datos de formulario con fuentes de datos añadidas. A continuación, puede editar el modelo de datos de formulario para agregar y configurar objetos y servicios del modelo de datos, añadir asociaciones entre objetos del modelo de datos, editar propiedades, añadir objetos y propiedades del modelo de datos personalizado, generar datos de ejemplo, etc.

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

En esta página