Trabajar con el modelo de datos de formulario work-with-form-data-model

Inicie sesión en la instancia de autor de AEM, vaya a Formularios > Integraciones de datos y abra el modelo de datos de formulario en el que desea agregar objetos.

En el panel Fuentes de datos, amplíe las opciones para ver los objetos y servicios disponibles del modelo de datos.

Seleccione los objetos y servicios del modelo de datos que desea agregar al modelo de datos de formulario y pulse Agregar selección.

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. Cada objeto del modelo de datos se representa mediante un cuadro en el modelo de datos de formulario.

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

Pulse Guardar para guardar el objeto del modelo de formulario.

Inicie sesión en la instancia de autor de AEM, vaya a Formularios > Integraciones de datos y abra el modelo de datos de formulario en el que desea crear una entidad u objeto del modelo de datos.

Pulse Crear entidad.

En el cuadro de diálogo Crear modelo de datos, especifique un nombre para el objeto del modelo de datos y haga clic en Agregar. Se agrega un objeto de modelo de datos al modelo de datos del formulario. Tenga en cuenta que 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.

En un modelo de datos de formulario, seleccione un objeto de modelo de datos y pulse Crear propiedad secundaria.

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.

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.

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, pulse 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. Seleccione una propiedad con la que enlazar el objeto y pulse el icono del tic. Tenga en cuenta que solo puede seleccionar una propiedad del mismo tipo de datos que la propiedad secundaria.

Pulse Listo para guardar la propiedad secundaria y pulse Guardar para guardar el modelo de datos del formulario. La propiedad secundaria se agrega ahora al objeto del modelo de datos.

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

Pulse Editar propiedades.

En el panel Editar propiedades, pulse el icono de examinar situado junto al campo Enlace. Abre el cuadro de diálogo Seleccionar objeto que enumera las fuentes de datos agregadas en el modelo de datos de formulario.

Despliegue el árbol de fuentes de datos y seleccione un objeto del modelo de datos con el que enlazar y pulse el icono del tic.

Pulse Listo para guardar las propiedades y, a continuación, pulse 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.

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

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.

Cuadro de diálogo Editar propiedades

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

Los objetos de modelo de datos configurados en un modelo de datos de formulario están disponibles para su uso en la pestaña Objetos del modelo de datos del explorador de contenido de un formulario adaptable basado en el modelo de datos del formulario. 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 aparecerá por separado en la pestaña Objetos del modelo de datos. Por lo tanto, se verán 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.

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

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

Pulse 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 especifique el valor de enlace. Vincula el argumento del servicio al atributo del enlace o el valor literal especificado, el cual se pasa al servicio como argumento para recuperar datos asociados con el valor especificado de la fuente de datos.

En este ejemplo, la variable id tomará el valor de la variable empid del perfil de usuario y pasarlo como argumento al servicio de lectura. Leerá y devolverá valores de propiedades asociadas desde la variable employee objeto del modelo de datos para el objeto especificado empid. Por lo tanto, si especifica 00250 en la variable empid en el formulario, el servicio de lectura leerá los detalles del empleado con el id de empleado 00250.

Además, puede hacer que un argumento sea obligatorio u opcional.

Enlace del argumento id al atributo empid de AEM perfil de usuario

Pulse Listo para guardar el argumento, Listo para guardar las propiedades y, a continuación, Guardar para guardar el modelo de datos de formulario.

Seleccione la casilla de verificación situada en la parte superior de un objeto del modelo de datos para seleccionarlo y pulse Agregar asociación. Se abre el cuadro de diálogo Agregar asociación.

Se abre el cuadro de diálogo Agregar asociación.

Cuadro de diálogo Agregar asociación

En el panel Agregar asociación:

• Especifique un título para la asociación.
• Seleccione el tipo de asociación — Uno a uno o Uno a varios.
• Seleccione el objeto del modelo de datos que desea asociar.
• Seleccione el servicio de lectura para leer los datos del objeto de modelo seleccionado. Aparece el argumento de servicio de lectura. Edite para cambiar el argumento, si es necesario, y enlácelo a la propiedad del objeto del modelo de datos que desea asociar.

En el siguiente ejemplo, el argumento predeterminado para el servicio de lectura del objeto del modelo de datos de Dependents (dependientes) es dependentid.

El argumento predeterminado para el servicio de lectura de dependientes es dependentid.

Sin embargo, el argumento debe ser una propiedad común entre el objeto del modelo de datos asociado, que en este ejemplo es Employeeid. Por lo tanto, el argumento Employeeid debe enlazarse a la propiedad id del objeto del modelo de datos Employee (empleado) para recuperar los detalles de dependientes asociados del objeto del modelo de datos Dependents.

Argumento y enlace actualizados

Pulse Listo para guardar el argumento.

Pulse Listo para guardar la asociación y, a continuación, Guardar para guardar el modelo de datos de formulario.

Repita los pasos para crear más asociaciones según sea necesario.

Active la casilla de verificación situada junto a un objeto de modelo de datos, una propiedad o un servicio del modelo de datos de formulario.

Pulse Editar propiedades. Se abre el panel Editar propiedades del objeto, de la propiedad o del servicio del modelo seleccionado.

• Objeto del modelo de datos: especifique los servicios de lectura y escritura y edite los argumentos.
• Propiedad: especifique el tipo, subtipo y formato de la propiedad. También puede especificar si la propiedad seleccionada es la clave principal del objeto del modelo de datos.
• Servicio: especifique el objeto del modelo de entrada, el tipo de salida y los argumentos del servicio. Para un servicio Get-Service, puede especificar si se espera que devuelva una matriz.

Cuadro de diálogo Editar propiedades para Get-Service

Pulse Listo para guardar las propiedades y, a continuación, Guardar para guardar el modelo de datos de formulario.

Cree una nueva propiedad con el nombre FullName cuyo tipo de datos es Cadena.

Habilite la opción Calculada y pulse Listo para crear la propiedad.

Se crea la propiedad calculada FullName. Fíjese en el icono que aparece junto a la propiedad para mostrar una propiedad calculada.

Seleccione la propiedad FullName y pulse Editar regla. Se abre una ventana del editor de reglas.

En la ventana del editor de reglas, pulse Crear. Se abre una ventana de la regla Set Value.

En la lista desplegable Seleccionar opción, elija Expresión matemática. Otras opciones disponibles son Objeto Modelo de datos de formulario y Cadena.

En la expresión matemática, seleccione FirstName y LastName en los objetos primero y segundo, respectivamente. Seleccione más como operador.

Pulse Listo y, a continuación, pulse Cerrar para cerrar la ventana del editor de reglas. La regla presenta un aspecto similar al siguiente.

En el modelo de datos de formulario, pulse Guardar. La propiedad calculada está configurada.

Abra un modelo de datos de formulario y pulse Editar datos de ejemplo. Genera y muestra los datos de ejemplo en la ventana Editar datos de ejemplo.

En la ventana Editar datos de ejemplo, edite los datos, según sea necesario, y pulse Guardar.

Seleccione un objeto del modelo de datos o un servicio en el modelo de datos de formulario y pulse Objeto de modelo de prueba o Servicio de prueba, respectivamente.

Se abre la ventana Modelo de datos de formulario de prueba.

En la ventana Modelo de datos de formulario de prueba, seleccione el objeto o servicio del modelo de datos que desea probar en el panel Entrada.

Especifique un valor de argumento en el código de prueba y pulse Prueba. Una prueba que funcione correctamente devuelve el resultado en el panel Salida.