Trabajar con el modelo de datos de formulario (FDM)

Última actualización: 15 de julio de 2024
  • Se aplica a:
  • Experience Manager as a Cloud Service

Creado para:

  • Principiante
  • Intermedio
  • Administrador
  • Usuario
VersiónVínculo del artículo
AEM 6.5Haga clic aquí
AEM as a Cloud ServiceEste artículo

data-integration

El editor del modelo de datos de formulario (FDM) proporciona una interfaz de usuario intuitiva y herramientas para editar y configurar un modelo de datos de formulario (FDM). Con el editor, se pueden agregar y configurar objetos, propiedades y servicios de modelo de datos desde fuentes de datos asociadas en el modelo de datos de formulario (FDM). Además, permite crear objetos y propiedades de modelos de datos sin fuentes de datos y enlazarlos posteriormente con objetos y propiedades de modelos de datos respectivos. También puede generar y editar los datos de ejemplo para las propiedades de objetos del modelo de datos que puede utilizar para rellenar previamente formularios adaptables durante la vista previa. Puede probar los objetos y servicios de modelo de datos configurados en un modelo de datos de formulario (FDM) para asegurarse de que está correctamente integrado con las fuentes de datos.

Si acaba de empezar con la integración de datos de Forms y no ha configurado una fuente de datos o creado un modelo de datos de formulario (FDM), consulte los temas siguientes:

Continúe leyendo para obtener más información sobre las diversas tareas y configuraciones que puede realizar con el editor del modelo de datos de formulario.

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

Agregar objetos y servicios del modelo de datos

Si ha creado un modelo de datos de formulario (FDM) con fuentes de datos, puede utilizar el editor del modelo de datos de formulario para añadir objetos y servicios de modelo de datos, configurar sus propiedades, crear asociaciones entre los objetos del modelo de datos y probar el modelo de datos de formulario y los servicios.

Puede agregar objetos y servicios de modelo de datos desde fuentes de datos disponibles en el modelo de datos de formulario (FDM). Cuando los objetos del modelo de datos agregados aparecen en la pestaña Modelo, los servicios que se hayan añadido aparecen en la pestaña Servicios.

Para agregar objetos y servicios del modelo de datos:

  1. Inicie sesión en la instancia de autor de Experience Manager, vaya a Formularios > Integraciones de datos y abra el modelo de datos de formulario en el que desea añadir objetos del modelo de datos.

  2. En el panel Fuentes de datos, expanda las fuentes de datos para ver los objetos y servicios del modelo de datos disponibles.

  3. Seleccione los objetos y servicios de modelo de datos que desea agregar al modelo de datos de formulario (FDM) y seleccione Agregar selección.

    selected-objects

    Objetos y servicios del modelo de datos seleccionado

    La pestaña Modelo muestra una representación gráfica de todos los objetos del modelo de datos y sus propiedades agregadas al modelo de datos de formulario (FDM). Cada objeto del modelo de datos se representa mediante un cuadro en el modelo de datos de formulario (FDM).

    model-tab

    La pestaña Modelo muestra los objetos del modelo de datos agregados

    NOTA
    Puede mantener y arrastrar cuadros de objetos del modelo de datos alrededor para organizarlos en el área de contenido. Todos los objetos del modelo de datos agregados en el modelo de datos de formulario (FDM) aparecen atenuados en el panel Fuentes de datos.

    La pestaña Servicios enumera los servicios añadidos.

    services-tab

    La pestaña Servicios muestra los servicios del modelo de datos

    NOTA
    Además de los objetos y servicios del modelo de datos, el documento de metadatos del servicio OData incluye propiedades de navegación que definen la asociación entre dos objetos del modelo de datos. Para obtener más información, consulte Uso de las propiedades de navegación de los servicios de OData.

  4. Selecciona Guardar para guardar el objeto del modelo de formulario.

    NOTA
    Puede invocar los servicios que configuró en la pestaña Servicios de un modelo de datos de formulario (FDM) mediante las reglas de los formularios adaptables. Los servicios configurados están disponibles en la acción Invocar servicios del editor de reglas. Para obtener más información sobre el uso de estos servicios en las reglas de los formularios adaptables, consulte las reglas Invoke service y Set Value Of en el editor de reglas.

Crear objetos del modelo de datos y propiedades secundarias

Crear objetos del modelo de datos

Aunque puede agregar objetos de modelo de datos desde fuentes de datos configuradas, también puede crear objetos o entidades de modelo de datos sin fuentes de datos. Resulta útil, especialmente si no se han configurado fuentes de datos en el modelo de datos de formulario (FDM).

Para crear un objeto de modelo de datos sin fuentes de datos, haga lo siguiente:

  1. Inicie sesión en la instancia de autor de Experience Manager, vaya a Forms > Integraciones de datos y abra el modelo de datos de formulario (FDM) en el que desea crear un objeto o entidad de modelo de datos.

  2. Selecciona Crear entidad.

  3. En el cuadro de diálogo Crear modelo de datos, especifica un nombre para el objeto del modelo de datos y selecciona Agregar. Se añade un objeto de modelo de datos al modelo de datos de formulario (FDM). El objeto del modelo de datos recién agregado no está enlazado a una fuente de datos y no tiene propiedades como se muestra en la siguiente imagen.

    new-entity

A continuación, puede agregar propiedades secundarias en objetos del modelo de datos no enlazados.

Agregar propiedades secundarias

El editor del modelo de datos de formulario permite crear propiedades secundarias en un objeto del modelo de datos. La propiedad cuando se crea no está enlazada a ninguna propiedad de una fuente de datos. Posteriormente, puede enlazar la propiedad secundaria con otra propiedad del objeto del modelo de datos que la contiene.

Para crear una propiedad secundaria:

  1. En un modelo de datos de formulario, selecciona un objeto de modelo de datos y selecciona Crear propiedad secundaria.

  2. En el cuadro de diálogo Crear propiedad secundaria, especifique un nombre y un tipo de datos para la propiedad en los campos Nombre y Tipo, respectivamente. Si lo desea, puede especificar un título y una descripción para la propiedad.

  3. Habilite la opción Calculada si la propiedad es una propiedad calculada. El valor de una propiedad calculada se evalúa en función de una regla o una expresión. Para obtener más información, consulte Editar propiedades.

  4. Si el objeto del modelo de datos está enlazado a una fuente de datos, la propiedad secundaria agregada se enlazará automáticamente a la propiedad del objeto del modelo de datos principal con el mismo nombre y tipo de datos.

    Para enlazar manualmente una propiedad secundaria con una propiedad de objeto del modelo de datos, selecciona el icono de examinar situado junto al campo Referencia de enlace. El cuadro de diálogo Seleccionar objeto enumera todas las propiedades del objeto del modelo de datos principal. Selecciona una propiedad con la que enlazar el objeto y selecciona el icono del tic. Solo puede seleccionar una propiedad del mismo tipo de datos que la propiedad secundaria.

  5. Seleccione Listo para guardar la propiedad secundaria y Guardar para el modelo de datos de formulario (FDM). La propiedad secundaria se agrega ahora al objeto del modelo de datos.

Después de crear objetos y propiedades de modelo de datos, puede seguir creando formularios adaptables basados en el modelo de datos de formulario (FDM). Posteriormente, cuando haya fuentes de datos disponibles y configuradas, puede enlazar el modelo de datos de formulario (FDM) con ellas. El enlace se actualiza automáticamente en los formularios adaptables asociados . Para obtener más información sobre la creación de formularios adaptables mediante el modelo de datos de formulario (FDM) consulte Uso del modelo de datos de formulario.

Enlazar objetos y propiedades del modelo de datos

Cuando las fuentes de datos que desea integrar con el modelo de datos de formulario estén disponibles, puede añadirlas al modelo tal y como se describe en Actualizar fuentes de datos. A continuación, haga lo siguiente para enlazar los objetos y propiedades del modelo de datos independiente:

  1. En el modelo de datos de formulario, seleccione la fuente de datos independiente que desea enlazar con una fuente de datos.

  2. Selecciona Editar propiedades.

  3. En el panel Editar propiedades, selecciona el icono de examinar situado junto al campo Enlace. Abra el cuadro de diálogo Seleccionar objeto que enumera las fuentes de datos añadidas en el modelo de datos de formulario (FDM).

    select-object

  4. Despliega el árbol de fuentes de datos, selecciona un objeto del modelo de datos con el que enlazar y selecciona el icono del tic.

  5. Selecciona Listo para guardar las propiedades y, a continuación, selecciona Guardar para guardar el modelo de datos de formulario. El objeto del modelo de datos ahora está enlazado con una fuente de datos. Observe que el objeto del modelo de datos ya no está marcado como No enlazado.

    bound-model-object

Configurar servicios

Para leer y escribir para un objeto de modelo de datos, haga lo siguiente para configurar los servicios de lectura y escritura:

  1. Selecciona la casilla de verificación situada en la parte superior de un objeto del modelo de datos para seleccionarlo y seleccione Editar propiedades.

    edit-properties

    Editar propiedades para configurar los servicios de lectura y escritura de un objeto de modelo de datos

    Se abre el cuadro de diálogo Editar propiedades.

    edit-properties-2

    Cuadro de diálogo Editar propiedades

    NOTA
    Además de los objetos y servicios del modelo de datos, el documento de metadatos del servicio OData incluye propiedades de navegación que definen la asociación entre dos objetos del modelo de datos. Cuando se añade una fuente de datos del servicio OData a un modelo de datos de formulario (FDM), hay un servicio disponible en el modelo de datos de formulario (FDM) para todas las propiedades de navegación de un objeto de modelo de datos. Puede utilizar este servicio para leer las propiedades de navegación del objeto del modelo de datos correspondiente.
    Para obtener más información sobre el uso del servicio, consulte Uso de las propiedades de navegación de los servicios de OData.

  2. Cambie a Objeto de nivel superior para especificar si el objeto del modelo de datos es de nivel superior.

    Los objetos del modelo de datos configurados en un modelo de datos de formulario (FDM) están a su disposición en la pestaña Objetos del modelo de datos del Explorador de contenido de un formulario adaptable basado en el modelo de datos de formulario (FDM). Cuando se agrega una asociación entre dos objetos del modelo de datos, el objeto del modelo de datos con el que se asocia se anida en el objeto del modelo de datos que se asocia en la pestaña Objetos del modelo de datos. Si el modelo de datos anidado es un objeto de nivel superior, también aparece por separado en la pestaña Objetos del modelo de datos. Por lo tanto, se ven dos entradas, una dentro y otra fuera de la jerarquía anidada, que pueden confundir a los autores del formulario. Para que el objeto del modelo de datos asociado aparezca solo en la jerarquía anidada, desactive la propiedad Objeto de nivel superior.

  3. Seleccione los servicios de lectura y escritura para los objetos del modelo de datos seleccionado. Aparecen los argumentos de los servicios.

    read-write-services

    Servicios de lectura y escritura configurados para la fuente de datos de los empleados

  4. Selecciona aem_6_3_edit en el argumento de servicio de lectura para enlazar el argumento a un atributo de perfil de usuario, atributo de solicitud o valor literal y especifica el valor de enlace.

  5. Seleccione Listo para guardar el argumento, Listo para guardar las propiedades y, a continuación, Guardar para guardar el modelo de datos de formulario (FDM).

Vincular argumentos del servicio de lectura

Enlace el argumento del servicio de lectura a un atributo de perfil de usuario, atributo de solicitud o valor literal basado en un valor de enlace. El valor se pasa al servicio como un argumento para recuperar detalles asociados con el valor especificado de la fuente de datos.

Valor literal

Seleccione Literal en el menú desplegable Enlace a e indique un valor en el campo Valor de enlace. Los detalles asociados con el valor se recuperan de la fuente de datos. Utilice esta opción para recuperar los detalles asociados a un valor estático.

En este ejemplo, los detalles asociados con 4367655678, como el valor del argumento mobilenum, se recuperan de la fuente de datos. Los detalles asociados si transfiere el valor de un argumento de número móvil pueden incluir propiedades como nombre de cliente, dirección de cliente y ciudad.

Valor literal

Atributo de perfil de usuario

Seleccione Atributo de perfil de usuario del menú desplegable Enlace a e indique el nombre del atributo en el campo Valor de enlace. Los detalles del usuario que ha iniciado sesión en la instancia de Experience Manager se recuperan de la fuente de datos en función del nombre del atributo.

El nombre de atributo especificado en el campo Valor de enlace debe incluir la ruta de enlace completa hasta el nombre del atributo del usuario. Abra la siguiente URL para acceder a los detalles del usuario sobre CRXDE:

https://[server-name]:[port]/crx/de/index.jsp#/home/users/

Perfil de usuario

En este ejemplo, especifique profile.empid en el campo Valor de enlace para el usuario grios.

Editar argumento

El argumento id toma el valor del atributo empid del perfil de usuario y lo pasa como argumento al servicio de lectura. Lee y devuelve valores de propiedades asociadas a partir del objeto del modelo de datos de empleado para empid asociado al usuario que ha iniciado sesión.