Tutorial: Crear modelo de datos de formulario

Creación de un modelo de datos de formulario para la comunicación interactiva

Este tutorial es un paso en la Cree su primera comunicación interactiva serie. Se recomienda seguir la serie en secuencia cronológica para comprender, realizar y demostrar el caso de uso completo del tutorial.

Acerca del tutorial

El módulo de integración de datos de AEM Forms le permite crear un modelo de datos de formulario a partir de fuentes de datos backend dispares, como AEM perfil de usuario, servicios web RESTful, servicios web basados en SOAP, servicios OData y bases de datos relacionales. Puede configurar objetos y servicios del 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 de objeto del modelo de datos. Los servicios permiten rellenar previamente el formulario adaptable y escribir los datos de formulario enviados en el objeto del modelo de datos.

Para obtener más información sobre la integración de datos de formulario y el modelo de datos de formulario, consulte Integración de datos de AEM Forms.

Este tutorial lo acompaña durante los pasos para preparar, crear, configurar y asociar un modelo de datos de formulario con una comunicación interactiva. Al final de este tutorial, podrá:

• Configuración de la base de datos
• Configurar la base de datos MySQL como fuente de datos
• Crear modelo de datos de formulario
• Configuración del modelo de datos de formulario
• Probar modelo de datos de formulario

El modelo de datos de formulario tiene un aspecto similar al siguiente:

A. Fuentes de datos configuradas B. 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:

• Base de datos MySQL con datos de ejemplo como se indica en la Configuración de la base de datos para obtener más información.
• Paquete OSGi para el controlador JDBC MySQL como se explica en Agrupación del controlador de base de datos JDBC

Paso 1: Configuración de la base de datos

Una base de datos es esencial para crear una comunicación interactiva. Este tutorial utiliza una base de datos para mostrar el Modelo de datos de formulario y las capacidades de persistencia de las comunicaciones interactivas. Configure una base de datos que contenga tablas cliente, facturas y llamadas.
La siguiente imagen ilustra datos de ejemplo para la tabla de clientes:

Utilice la siguiente instrucción DDL para crear la variable cliente en la base de datos.

CREATE TABLE `customer` (
   `mobilenum` int(11) NOT NULL,
   `name` varchar(45) NOT NULL,
   `address` varchar(45) NOT NULL,
   `alternatemobilenumber` int(11) DEFAULT NULL,
   `relationshipnumber` int(11) DEFAULT NULL,
   `customerplan` varchar(45) DEFAULT NULL,
   PRIMARY KEY (`mobilenum`),
   UNIQUE KEY `mobilenum_UNIQUE` (`mobilenum`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8

Utilice la siguiente instrucción DDL para crear la variable letras en la base de datos.

CREATE TABLE `bills` (
   `billplan` varchar(45) NOT NULL,
   `latepayment` decimal(4,2) NOT NULL,
   `monthlycharges` decimal(4,2) NOT NULL,
   `billdate` date NOT NULL,
   `billperiod` varchar(45) NOT NULL,
   `prevbal` decimal(4,2) NOT NULL,
   `callcharges` decimal(4,2) NOT NULL,
   `confcallcharges` decimal(4,2) NOT NULL,
   `smscharges` decimal(4,2) NOT NULL,
   `internetcharges` decimal(4,2) NOT NULL,
   `roamingnational` decimal(4,2) NOT NULL,
   `roamingintnl` decimal(4,2) NOT NULL,
   `vas` decimal(4,2) NOT NULL,
   `discounts` decimal(4,2) NOT NULL,
   `tax` decimal(4,2) NOT NULL,
   PRIMARY KEY (`billplan`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8

Utilice la siguiente instrucción DDL para crear la variable llamadas en la base de datos.

CREATE TABLE `calls` (
   `mobilenum` int(11) DEFAULT NULL,
   `calldate` date DEFAULT NULL,
   `calltime` varchar(45) DEFAULT NULL,
   `callnumber` int(11) DEFAULT NULL,
   `callduration` varchar(45) DEFAULT NULL,
   `callcharges` decimal(4,2) DEFAULT NULL,
   `calltype` varchar(45) DEFAULT NULL
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8

La variable llamadas incluye los detalles de la llamada, como la fecha de la llamada, la hora de la llamada, el número de llamada, la duración de la llamada y los cargos por llamada. La variable cliente está vinculada a la tabla de llamadas mediante el campo Número móvil (mobilenum) . Para cada número de móvil enumerado en la variable cliente , hay varios registros en la tabla llamadas tabla. Por ejemplo, puede recuperar los detalles de la llamada para la variable 1457892541 número de móvil haciendo referencia a la variable llamadas tabla.

La variable letras incluye los detalles de la factura, como la fecha de factura, el período de factura, los cargos mensuales y los cargos por llamada. La variable cliente está vinculada al letras utilizando el campo Plan de Facturación. Hay un plan asociado a cada cliente en la variable cliente tabla. La variable letras incluye los detalles de precios de todos los planes existentes. Por ejemplo, puede recuperar los detalles del plan para Sarah de la variable cliente y utilice estos detalles para recuperar los detalles de precios de la variable letras tabla.

Paso 2: 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, configurará la base de datos MySQL que está configurada y llena con datos de ejemplo. Para obtener información sobre otras fuentes de datos compatibles y cómo configurarlas, consulte Integración de datos de AEM Forms.

Haga lo siguiente para configurar la base de datos MySQL:

1. Instale el controlador JDBC para la base de datos MySQL como un paquete OSGi:

   1. Inicie sesión en la instancia de autor de AEM Forms como administrador y vaya a AEM paquetes de consola web. La dirección URL predeterminada es http://localhost:4502/system/console/bundles.
   2. Toque Instalar/actualizar. Un Cargar e instalar paquetes se abre.
   3. Toque Elegir archivo para buscar y seleccionar el paquete OSGi del controlador JDBC de MySQL. Select Iniciar paquete y Actualizar paquetes y toque Instalar o Actualizar. Asegúrese de que el controlador JDBC de Oracle Corporation para MySQL esté activo. El controlador está instalado.

2. Configure la base de datos MySQL como fuente de datos:

   1. Vaya a AEM consola web en http://localhost:4502/system/console/configMgr.

   2. Localizar Fuente de datos obtenida de una conexión Apache Sling configuración. Pulse para abrir la configuración en modo de edición.

   3. 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 MySQL.
      • 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 de origen de datos como servicio OSGi. Por ejemplo, datasource.name.
      • Clase de controlador JDBC: Especifique el nombre de clase Java del controlador JDBC. Para la base de datos MySQL, especifique com.mysql.jdbc.Driver.
      • URI de conexión JDBC: Especifique la dirección URL de conexión de la base de datos. Para la base de datos MySQL que se ejecuta en el puerto 3306 y en el esquema teleca, la URL es: jdbc:mysql://[server]:3306/teleca?autoReconnect=true&useUnicode=true&characterEncoding=utf-8
      • Nombre de usuario: Nombre de usuario de la base de datos. Es necesario permitir que el controlador JDBC establezca una conexión con la base de datos.
      • Contraseña: Contraseña de la base de datos. Es necesario permitir que el controlador JDBC establezca una conexión con la base de datos.
      • Pruebas con prestatario: Active la variable Prueba a la vista previa .
      • Prueba tras retorno: Active la variable Prueba a la vuelta .
      • Consulta de validación: Especifique una consulta SQL SELECT para validar conexiones desde el grupo. La consulta debe devolver al menos una fila. Por ejemplo, seleccionar &último; del cliente.
      • Aislamiento de transacciones: Establezca el valor en READ_COMMITTED.

   Deje otras propiedades con el valor predeterminado values y toque Guardar.

   Se crea una configuración similar a la siguiente.

   

Paso 3: Crear modelo de datos de formulario

AEM Forms proporciona una interfaz de usuario intuitiva para crear un modo de datos de formulariol de fuentes de datos configuradas. Puede utilizar varios orígenes de datos en un modelo de datos de formulario. Para el caso de uso de este tutorial, utilizará MySQL como fuente de datos.

Para crear el modelo de datos de formulario, haga lo siguiente:

1. En AEM instancia de autor, vaya a Forms > Integraciones de datos.

2. Toque Crear > Modelo de datos de formulario.

3. En el asistente Crear modelo de datos de formulario , especifique un name para el modelo de datos de formulario. Por ejemplo, FDM_Create_First_IC. Pulse Siguiente.

4. La pantalla seleccionar fuente de datos enumera todas las fuentes de datos configuradas. Select MySQL fuente de datos y toque Crear.

   

5. Haga clic en Listo. La variable FDM_Create_First_IC se crea el modelo de datos de formulario.

Paso 4: Configuración del modelo de datos de formulario

La configuración del modelo de datos de formulario incluye:

• adición de objetos y servicios del modelo de datos
• creación de propiedades secundarias calculadas para el objeto del modelo de datos
• adición de asociaciones entre objetos del modelo de datos
• edición de propiedades de objeto del modelo de datos
• configuración de servicios para objetos del modelo de datos

Agregar objetos y servicios del modelo de datos

1. En AEM instancia de autor, vaya a Forms > Integraciones de datos. La dirección URL predeterminada es http://localhost:4502/aem/forms.html/content/dam/formsanddocuments-fdm.

2. La variable FDM_Create_First_IC el modelo de datos de formulario creado anteriormente se muestra aquí. Selecciónelo y pulse Editar.

   La fuente de datos seleccionada MySQL se muestra en la variable Fuentes de datos panel.

   

3. Expanda el MySQL árbol de fuentes de datos. Seleccione los siguientes objetos y servicios del modelo de datos teleca esquema:

   • Objetos del modelo de datos:

     • letras
     • llamadas
     • cliente

   • Servicios:

     • get
     • actualizar

   Toque Agregar selección para agregar objetos y servicios del modelo de datos seleccionado al modelo de datos de formulario.

   

   Los objetos de los modelos de listas, llamadas y datos del cliente se muestran en el panel derecho del Modelo pestaña . Los servicios get y update se muestran en la Servicios pestaña .

   

Crear propiedades secundarias calculadas para el objeto del modelo de datos

Una propiedad calculada es aquella cuyo valor se calcula en función de una regla o una expresión. Con una regla, puede establecer el valor de una propiedad calculada en una cadena literal, un número, el resultado de una expresión matemática o el valor de otra propiedad en el modelo de datos del formulario.

En función del caso de uso, cree la variable usagecharges propiedad calculada secundaria en la variable letras objeto del modelo de datos utilizando la siguiente expresión matemática:

• tarifas de uso = gastos de llamada + gastos de llamada de conferencia + gastos de SMS + gastos de internet móvil + itinerancia nacional + itinerancia internacional + VAS (todas estas propiedades existen en el objeto del modelo de datos de facturas)

  Para obtener más información sobre usagecharges propiedad calculada secundaria, consulte Planificar la comunicación interactiva.

Ejecute los siguientes pasos para crear propiedades secundarias calculadas para el objeto del modelo de datos de listas:

1. Seleccione la casilla de verificación situada en la parte superior del letras objeto del modelo de datos para seleccionarlo y tocar Crear propiedad secundaria.

2. En el Crear propiedad secundaria panel:

   1. Entrar usagecharges como nombre de la propiedad secundaria.
   2. Habilitar Calculado.
   3. Select Flotante como tipo y pulse Listo para agregar la propiedad secundaria a la variable letras objeto del modelo de datos.

   

3. Toque Editar regla para abrir el Editor de reglas.

4. Pulse Crear. La variable Definir valor se abre la ventana de regla.

5. En la lista desplegable Seleccionar opción, elija Expresión matemática.

   

6. En la expresión matemática, seleccione cargas y recargos como objetos primero y segundo, respectivamente. Seleccione más como operador. Pulse dentro de la expresión matemática y pulse Extensión de expresión para agregar smscharge, internetones, itinerante nacional, roamingintnl y lienzo objetos a la expresión.

   La siguiente imagen representa la expresión matemática en el editor de reglas:

   

7. Pulse Listo. La regla se crea en el Editor de reglas.

8. Toque Cerrar para cerrar la ventana Editor de reglas.

Añadir asociaciones entre objetos del modelo de datos

Una vez definidos los objetos del modelo de datos, puede crear asociaciones entre ellos. La asociación puede ser de uno a uno o de uno a varios. Por ejemplo, puede haber varios dependientes asociados a un empleado. Se denomina asociación "uno a varios" y se representa mediante 1:n en la línea que conecta los objetos del modelo de datos asociados. Sin embargo, si una asociación devuelve un nombre de empleado único para un ID de empleado determinado, se denomina asociación uno a uno.

Cuando se agregan objetos del modelo de datos asociados en una fuente de datos a un modelo de datos de formulario, sus asociaciones se retienen y se muestran como conectadas mediante líneas de flecha.

En función del caso de uso, cree las siguientes asociaciones entre los objetos del modelo de datos:

Siga estos pasos para crear asociaciones entre objetos del modelo de datos:

1. Seleccione la casilla de verificación situada en la parte superior del cliente objeto del modelo de datos para seleccionarlo y tocar Agregar asociación. La variable Agregar asociación se abre el panel de propiedades.

2. En el Agregar asociación panel:

   • Especifique un título para la asociación. Es un campo opcional.
   • Select Uno a muchos de la variable Tipo lista desplegable.
   • Select llamadas de la variable Objeto Modelo lista desplegable.
   • Select get de la variable Servicio lista desplegable.
   • Toque Agregar para vincular la variable cliente objeto del modelo de datos a llamadas objeto del modelo de datos mediante una propiedad. En función del caso de uso, el objeto del modelo de datos de llamadas debe estar vinculado a la propiedad número móvil del objeto del modelo de datos del cliente. La variable Agregar argumento se abre.

   

3. En el Agregar argumento cuadro de diálogo:

   • Select mobilenum de la variable Nombre lista desplegable. La propiedad mobile number es una propiedad común que está disponible en el cliente y llama a los objetos del modelo de datos. Como resultado, se utiliza para crear una asociación entre el cliente y los objetos del modelo de datos de llamadas.

     Para cada número móvil disponible en el objeto del modelo de datos del cliente, hay varios registros de llamada disponibles en la tabla de llamadas.

   • Especifique un título y una descripción opcionales para el argumento.

   • Select cliente de la variable Enlace a lista desplegable.

   • Select mobilenum de la variable Valor de enlace lista desplegable.

   • Toque Agregar.

   

   La propiedad mobilenum se muestra en la variable Argumentos para obtener más información.

   

4. Toque Listo para crear una asociación 1:n entre el cliente y los objetos del modelo de datos de llamadas.

   Una vez que haya creado una asociación entre los objetos del modelo de datos de cliente y de llamadas, cree una asociación 1:1 entre los objetos del modelo de datos del cliente y de la factura.

5. Seleccione la casilla de verificación situada en la parte superior del cliente objeto del modelo de datos para seleccionarlo y tocar Agregar asociación. La variable Agregar asociación se abre el panel de propiedades.

6. En el Agregar asociación panel:

   • Especifique un título para la asociación. Es un campo opcional.

   • Select Uno a uno de la variable Tipo lista desplegable.

   • Select letras de la variable Objeto Modelo lista desplegable.

   • Select get de la variable Servicio lista desplegable. La variable plan de facturación , que es la clave principal de la tabla de listas, ya está disponible en la variable Argumentos para obtener más información.

     Los objetos de los modelos de facturas y datos del cliente se vinculan mediante las propiedades plan de facturación (facturas) y plan del cliente (cliente), respectivamente. Cree un enlace entre estas propiedades para recuperar los detalles del plan para cualquier cliente disponible en la base de datos MySQL.

   • Select cliente de la variable Enlace a lista desplegable.

   • Select customerplan de la variable Valor de enlace lista desplegable.

   • Toque Listo para crear un enlace entre las propiedades de plan de facturación y plan de cliente.

   

   La siguiente imagen muestra las asociaciones entre los objetos del modelo de datos y las propiedades utilizadas para crear asociaciones entre ellos:

   

Edición de las propiedades del objeto del modelo de datos

Después de crear asociaciones entre el cliente y otros objetos del modelo de datos, edite las propiedades del cliente para definir la propiedad en función de la cual se recuperan los datos del objeto del modelo de datos. En función del caso de uso, el número móvil se utiliza como propiedad para recuperar datos del objeto del modelo de datos del cliente.

1. Seleccione la casilla de verificación situada en la parte superior del cliente objeto del modelo de datos para seleccionarlo y tocar Editar propiedades. La variable Editar propiedades se abre el panel.

2. Especifique cliente como el Objeto Modelo de nivel superior.

3. Select get de la variable Leer servicio lista desplegable.

4. En el Argumentos sección:

   • Select Atributo de solicitud de la variable Enlace a lista desplegable.
   • Especifique mobilenum como valor de enlace.

5. Select actualizar de la variable Escritura Lista desplegable Servicio .

6. En el Argumentos sección:

   • Para mobilenum propiedad, seleccionar cliente de la variable Enlace a lista desplegable.
   • Select mobilenum de la variable Valor de enlace lista desplegable.

7. Toque Listo para guardar las propiedades.

   

8. Seleccione la casilla de verificación situada en la parte superior del llamadas objeto del modelo de datos para seleccionarlo y tocar Editar propiedades. La variable Editar propiedades se abre el panel.

9. Desactive el Objeto Modelo de nivel superior para llamadas objeto del modelo de datos.

10. Pulse Listo.

    Repita los pasos 8 a 10 para configurar las propiedades de letras objeto del modelo de datos.

Configurar servicios

1. Vaya a la Servicios pestaña .

2. Seleccione el get servicio y toque Editar propiedades. La variable Editar propiedades se abre el panel.

3. En el Editar propiedades panel:

   • Introduzca un título y una descripción opcionales.
   • Select cliente de la variable Objeto de modelo de salida lista desplegable.
   • Toque Listo para guardar las propiedades.

   

4. Seleccione el actualizar servicio y toque Editar propiedades. La variable Editar propiedades se abre el panel.

5. En el Editar propiedades panel:

   • Introduzca un título y una descripción opcionales.
   • Select cliente de la variable Objeto de modelo de entrada lista desplegable.
   • Pulse Listo.
   • Pulse Guardar para guardar el modelo de datos de formulario.

   

Paso 5: Probar el modelo y los servicios de datos de formulario

Puede probar el objeto y los servicios del modelo de datos para comprobar que el modelo de datos del formulario está configurado correctamente.

Haga lo siguiente para ejecutar la prueba:

1. Vaya a la Modelo , seleccione cliente objeto del modelo de datos y toque Objeto de modelo de prueba.

2. En el Modelo de datos de formulario de prueba ventana, seleccione Objeto de modelo de lectura de la variable Seleccionar modelo/servicio lista desplegable.

3. En el Entrada , especifique un valor para mobilenum propiedad que existe en la base de datos MySQL configurada y pulse Prueba.

   Los detalles del cliente asociados con la propiedad mobilenum especificada se recuperan y se muestran en la sección Salida como se muestra a continuación. Cierre el cuadro de diálogo.

   

4. Vaya a la Servicios pestaña .

5. Seleccione el get servicio y toque Servicio de prueba.

6. En el Entrada , especifique un valor para mobilenum propiedad que existe en la base de datos MySQL configurada y pulse Prueba.

   Los detalles del cliente asociados con la propiedad mobilenum especificada se recuperan y se muestran en la sección Salida como se muestra a continuación. Cierre el cuadro de diálogo.

   

Editar y guardar datos de ejemplo

El editor del modelo de datos de formulario permite generar datos de ejemplo para todas las propiedades de objetos del modelo de datos, incluidas las propiedades calculadas, en un modelo de datos de formulario. Es un conjunto de valores aleatorios que cumplen con el tipo de datos configurado para cada propiedad. También puede editar y guardar datos, que se conservan incluso si se regeneran los datos de ejemplo.

Para generar, editar y guardar datos de ejemplo, haga lo siguiente:

1. En la página del modelo de datos de formulario, pulse Editar datos de ejemplo. Genera y muestra los datos de ejemplo en la ventana Editar datos de ejemplo.

   

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

Recursos de Business.Adobe.com