Show Menu
TEMAS×

Tutorial: Create form data model

Este tutorial es un paso de la serie Crear su primer formulario adaptable. Se recomienda seguir la serie en secuencia cronológica para comprender, realizar y demostrar el caso de uso completo del tutorial.

Acerca del tutorial

AEM Forms módulo de integración de datos le permite crear un modelo de datos de formulario a partir de orígenes de datos de back-end dispares, como AEM perfil del usuario, servicios web RESTful, servicios web basados en SOAP, servicios OData y bases de datos relacionales. Puede configurar objetos y servicios de modelo de datos en un modelo de datos de formulario y asociarlo a un formulario adaptable. Los campos de formulario adaptables están enlazados a las propiedades del objeto del modelo de datos. Los servicios permiten rellenar previamente el formulario adaptable y escribir los datos del formulario enviados en el objeto del modelo de datos.
Para obtener más información sobre la integración de datos de formularios y el modelo de datos de formularios, consulte Integración de datos de AEM Forms.
Este tutorial lo acompaña a través de los pasos para preparar, crear, configurar y asociar un modelo de datos de formulario con un formulario adaptable. Al final de este tutorial, podrá:
El modelo de datos de formulario tendrá un aspecto similar al siguiente:
A. Fuentes de datos B configuradas. Esquemas de fuentes de datos C. Servicios disponibles D. Objetos del modelo de datos E. Servicios configurados

Requisitos previos

Antes de empezar, asegúrese de que dispone de lo siguiente:

Paso 1: Configurar la base de datos MySQL como fuente de datos

Puede configurar distintos tipos de orígenes de datos para crear un modelo de datos de formulario. Para este tutorial, configuraremos la base de datos MySQL que configuró y llenó con datos de ejemplo. Para obtener información sobre otras fuentes de datos admitidas y cómo configurarlas, consulte Integración de datos de AEM Forms.
Para configurar la MySQL base de datos, haga lo siguiente:
  1. Instale el controlador JDBC para la MySQL base de datos como un paquete OSGi:
    1. Inicie sesión en AEM instancia Forms de creación como administrador y vaya a AEM paquetes de consola web. La dirección URL predeterminada es https://localhost:4502/system/console/bundles .
    2. Toque Instalar/Actualizar . Aparece el cuadro de diálogo Cargar e instalar paquetes .
    3. Toque Elegir archivo para examinar y seleccionar el paquete OSGi del controlador MySQL JDBC. Seleccione Paquete Inicio y Actualizar paquetes , y toque Instalar o Actualizar . Asegúrese de que el controlador Oracle Corporation's JDBC para MySQL está activo. El controlador está instalado.
  2. Configure MySQL la base de datos como un origen de datos:
    1. Localice la configuración de Apache Sling Connection Pooled DataSource . Toque para abrir la configuración en modo de edición.
    2. En el cuadro de diálogo de configuración, especifique los siguientes detalles:
      • Nombre del origen de datos: Puede especificar cualquier nombre. Por ejemplo, especifique WeRetailMySQL .
      • Nombre de propiedad del servicio DataSource: Especifique el nombre de la propiedad de servicio que contiene el nombre de DataSource. Se especifica al registrar la instancia del origen de datos como servicio OSGi. Por ejemplo, datasource.name .
      • Clase de controlador JDBC: Especifique el nombre de clase Java del controlador JDBC. Para MySQL la base de datos, especifique com.mysql.jdbc.Driver .
      • URI de conexión JDBC: Especifique la dirección URL de conexión de la base de datos. Para MySQL la base de datos que se ejecuta en el puerto 3306 y el weretail de esquema, la dirección URL es: jdbc:mysql://'server':3306/weretail?autoReconnect=true&useUnicode=true&characterEncoding=utf-8
      • Nombre de usuario: Nombre de usuario de la base de datos. Es necesario habilitar el controlador JDBC para establecer una conexión con la base de datos.
      • Contraseña: Contraseña de la base de datos. Es necesario habilitar el controlador JDBC para establecer una conexión con la base de datos.
      • Prueba a tomar prestado: Habilite la opción Probar en préstamo .
      • Prueba al regresar: Active la opción Prueba al regresar .
      • Consulta de validación: Especifique una consulta SQL SELECT para validar las conexiones del grupo. La consulta debe devolver al menos una fila. Por ejemplo, seleccione * en los detalles del cliente .
      • Aislamiento de transacciones: Establezca el valor en READ_COMMITTED .
        Deje otras propiedades con los valores predeterminados y toque Guardar .
        Se crea una configuración similar a la siguiente.

Step 2: Create form data model

AEM Forms proporciona una interfaz de usuario intuitiva para crear un modelo de datos de formulario a partir de fuentes de datos configuradas. Puede utilizar varios orígenes de datos en un modelo de datos de formulario. Para nuestro caso de uso, usaremos la fuente MySQL de datos configurada.
Para crear el modelo de datos de formulario, haga lo siguiente:
  1. En AEM instancia de autor, vaya a Forms > Integraciones de datos .
  2. Tap Create > Form Data Model .
  3. En el cuadro de diálogo Crear modelo de datos de formulario, especifique un nombre para el modelo de datos de formulario. Por ejemplo, cliente-envío-facturación-detalles . Puntee Siguiente .
  4. La pantalla Seleccionar origen de datos lista todas las fuentes de datos configuradas. Seleccione la fuente de datos WeRetailMySQL y toque Crear .
Se crea el modelo de datos de formulario cliente-envío-facturación-detalles .

Paso 3: Configurar modelo de datos de formulario

La configuración del modelo de datos de formulario implica:
  • adición de objetos y servicios del modelo de datos
  • configuración de servicios de lectura y escritura para objetos del modelo de datos
Para configurar el modelo de datos de formulario, haga lo siguiente:
  1. En AEM instancia de autor, vaya a Forms > Integraciones de datos . La dirección URL predeterminada es https://localhost:4502/aem/forms.html/content/dam/formsanddocuments-fdm .
  2. El modelo de datos de formulario cliente-envío-facturación-detalles que ha creado anteriormente se muestra aquí. Ábralo en modo de edición.
    El origen de datos seleccionado WeRetailMySQL está configurado en el modelo de datos de formulario.
  3. Expanda el árbol de origen de datos WeRailMySQL. Seleccione los siguientes objetos y servicios del modelo de datos en weretail > custom details esquema para formar el modelo de datos:
    • Objetos del modelo de datos:
      • id
      • name
      • ShippingAddress
      • ciudad
      • estado
      • zipcode
    • Servicios:
      • get
      • actualizar
    Toque Añadir seleccionados para agregar objetos y servicios del modelo de datos seleccionado al modelo de datos de formulario.
    Los servicios predeterminados de obtención, actualización e inserción de orígenes de datos JDBC se proporcionan de forma predeterminada con el modelo de datos de formulario.
  4. Configure los servicios de lectura y escritura para el objeto del modelo de datos.
    1. Seleccione el objeto del modelo de datos custom details y toque Editar propiedades .
    2. Seleccione Obtener en la lista desplegable Servicio de lectura. El argumento id , que es la clave principal en el objeto del modelo de datos customDetails, se agrega automáticamente. Toque y configure el argumento como se indica a continuación.
    3. Del mismo modo, seleccione actualizar como servicio de escritura. El objeto customerdetails se agrega automáticamente como argumento. El argumento se configura de la siguiente manera.
      Añada y configure el argumento id de la siguiente manera.
    4. Toque Listo para guardar las propiedades del objeto del modelo de datos. A continuación, toque Guardar para guardar el modelo de datos de formulario.
      Los servicios get y update se agregan como servicios predeterminados para el objeto del modelo de datos.
  5. Vaya a la ficha Servicios y configure get and update services.
    1. Seleccione el servicio get y toque Editar propiedades . Se abre el cuadro de diálogo de propiedades.
    2. Especifique lo siguiente en el cuadro de diálogo Editar propiedades:
      • Título : Especifique el título del servicio. Por ejemplo: Recuperar dirección de envío.
      • Descripción : Especifique una descripción que contenga el funcionamiento detallado del servicio. Por ejemplo:
        Este servicio recupera la dirección de envío y otros detalles del cliente de la MySQL base de datos
      • Objeto de modelo de salida: Seleccione el esquema que contiene los datos del cliente. Por ejemplo:
        esquema de detalles del cliente
      • Matriz de retorno: Desactive la opción Volver matriz .
      • Argumentos : Seleccione un argumento llamado ID .
      Puntee Listo . Servicio para recuperar los detalles del cliente de la base de datos MySQL está configurado.
    3. Seleccione el servicio de actualización y toque Editar propiedades . Se abre el cuadro de diálogo de propiedades.
    4. Especifique lo siguiente en el cuadro de diálogo Editar propiedades :
      • Título : Especifique el título del servicio. Por ejemplo, Actualizar dirección de envío.
      • Descripción : Especifique una descripción que contenga el funcionamiento detallado del servicio. Por ejemplo:
        Este servicio actualiza la dirección de envío y los campos relacionados en la base de datos MySQL
      • Objeto de modelo de entrada: Seleccione el esquema que contiene los datos del cliente. Por ejemplo:
        esquema de detalles del cliente
      • Tipo de salida: Seleccione BOOLEAN .
      • Argumentos : Seleccione un argumento denominado ID y detalles del cliente .
      Puntee Listo . Se ha configurado el servicio de actualización para actualizar los detalles del cliente en la MySQL base de datos.
Se configuran el objeto y los servicios del modelo de datos del formulario. Ahora puede probar el modelo de datos de formulario.

Step 4: Test form data model

Puede probar el objeto y los servicios del modelo de datos para comprobar que el modelo de datos de formulario está configurado correctamente.
Para ejecutar la prueba, haga lo siguiente:
  1. Vaya a la ficha Modelo , seleccione el objeto del modelo de datos detalles del cliente y toque Objeto del modelo de prueba .
  2. En la ventana Modelo de prueba/Servicio , seleccione Leer objeto de modelo en la lista desplegable Seleccionar modelo/servicio .
  3. En la sección Detalles del cliente , especifique un valor para el argumento id que existe en la MySQL base de datos configurada y toque Prueba .
    Los detalles del cliente asociados con la ID especificada se recuperan y se muestran en la sección Salida como se muestra a continuación.
  4. Del mismo modo, puede probar el objeto y los servicios del modelo de escritura.
    En el siguiente ejemplo, el servicio de actualización actualiza correctamente los detalles de dirección del identificador 7102715 de la base de datos.
    Ahora, si vuelve a probar el servicio de modelo de lectura para la identificación 7107215, recuperará y mostrará los detalles actualizados del cliente como se muestra a continuación.