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.
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á:
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
Antes de empezar, asegúrese de que dispone de lo siguiente:
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.
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:
Instale el controlador JDBC para la base de datos MySQL como un paquete OSGi:
Configure la base de datos MySQL como fuente de datos:
Vaya a AEM consola web en http://localhost:4502/system/console/configMgr.
Localizar Fuente de datos obtenida de una conexión Apache Sling configuración. Pulse para abrir la configuración en modo de edición.
En el cuadro de diálogo de configuración, especifique los siguientes detalles:
jdbc:mysql://[server]:3306/teleca?autoReconnect=true&useUnicode=true&characterEncoding=utf-8
Deje otras propiedades con el valor predeterminado values y toque Guardar.
Se crea una configuración similar a la siguiente.
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:
En AEM instancia de autor, vaya a Forms > Integraciones de datos.
Toque Crear > Modelo de datos de formulario.
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.
La pantalla seleccionar fuente de datos enumera todas las fuentes de datos configuradas. Select MySQL fuente de datos y toque Crear.
Haga clic en Listo. La variable FDM_Create_First_IC se crea el modelo de datos de formulario.
La configuración del modelo de datos de formulario incluye:
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.
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.
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:
Servicios:
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 .
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:
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.
En el Crear propiedad secundaria panel:
Toque Editar regla para abrir el Editor de reglas.
Pulse Crear. La variable Definir valor se abre la ventana de regla.
En la lista desplegable Seleccionar opción, elija Expresión matemática.
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:
Pulse Listo. La regla se crea en el Editor de reglas.
Toque Cerrar para cerrar la ventana Editor de reglas.
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:
Asociación | Objetos del modelo de datos |
---|---|
1:n | cliente:llamadas (se pueden asociar varias llamadas a un cliente en una factura mensual) |
1:1 | cliente:facturas (una factura está asociada a un cliente para un mes en particular) |
Siga estos pasos para crear asociaciones entre objetos del modelo de datos:
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.
En el Agregar asociación panel:
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.
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.
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.
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:
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.
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.
Especifique cliente como el Objeto Modelo de nivel superior.
Select get de la variable Leer servicio lista desplegable.
En el Argumentos sección:
Select actualizar de la variable Escritura Lista desplegable Servicio .
En el Argumentos sección:
Toque Listo para guardar las propiedades.
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.
Desactive el Objeto Modelo de nivel superior para llamadas objeto del modelo de datos.
Pulse Listo.
Repita los pasos 8 a 10 para configurar las propiedades de letras objeto del modelo de datos.
Vaya a la Servicios pestaña .
Seleccione el get servicio y toque Editar propiedades. La variable Editar propiedades se abre el panel.
En el Editar propiedades panel:
Seleccione el actualizar servicio y toque Editar propiedades. La variable Editar propiedades se abre el panel.
En el Editar propiedades panel:
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:
Vaya a la Modelo , seleccione cliente objeto del modelo de datos y toque Objeto de modelo de prueba.
En el Modelo de datos de formulario de prueba ventana, seleccione Objeto de modelo de lectura de la variable Seleccionar modelo/servicio lista desplegable.
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.
Vaya a la Servicios pestaña .
Seleccione el get servicio y toque Servicio de prueba.
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.
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:
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.
En la ventana Editar datos de ejemplo, edite los datos, según sea necesario, y pulse Guardar. Cierre la ventana.