Para poner en funcionamiento el sistema de informes se precisan tres elementos:

Transcripción

1 Versión c 25/07/05 Francesc Busquets Contenido 1 Descripción general Configuración del sistema Configuración del sistema con MS-Access Creación de una base de datos MS-Access Configuración del conector ODBC para MS-Access Configuración de JClic Reports con ODBC Configuración del sistema con MySQL Creación de la base de datos MySQL Configuración del conector para MySQL Configuración de JClic reports con MySQL Comprobación del funcionamiento de JClic reports Configuración inicial de la base de datos Configuración de los clientes JClic... 8 Anexo 1: Esquema de tablas de la base de datos Descripción general JClic implementa un sistema de registro, almacenaje y proceso de los resultados de los ejercicios realizados por los alumnos. JClic reports es el módulo encargado de realizar la recopilación de datos y la presentación de los resultados. Para poner en funcionamiento el sistema de informes se precisan tres elementos: Un sistema de bases de datos, en el que se almacenará la información. Debe soportar transacciones SQL y disponer de alguno de los conectores que se - 1 -

2 explican en el apartado siguiente. Hay muchos sistemas, tanto comerciales como de software libre, que cumplen con estos requisitos: MySQL, MS-Access, PostgreSQL, Oracle, etc. Un conector que permita la comunicación entre la base de datos y JClic reports. Los conectores utilizados por las aplicaciones Java son del tipo JDBC, aunque también pueden utilizarse conectores de tipo ODBC. El programa JClic reports, que realiza dos funciones: Por un lado, ofrece a JClic la información necesaria para identificar a los usuarios, iniciar las sesiones de trabajo y recibir los resultados de las actividades que realiza el usuario/a: nombre de la actividad, número de intentos y aciertos, tiempo empleado, etc. JClic reports almacena esta información en la base de datos, con la que se comunica mediante el conector. La segunda función consiste en procesar los datos almacenados y mostrarlos en diversos formatos. Esta consulta se puede realizar desde cualquier navegador web: Firefox, Safari, Internet Explorer, etc. Es importante destacar que en una red con distintos ordenadores solamente es necesario instalar JClic reports en uno de ellos. El programa puede enviar y recibir la información de manera simultanea desde todos los demás. En este esquema se muestran los diversos elementos del sistema y sus interacciones: JClic alumno 1 JClic alumno 2 4 datos JClic reports 3 JClic alumno 3... navegador web resultados conector 2 1 base de datos - 2 -

3 2 Configuración del sistema Configuración del sistema de informes de JClic Para configurar el sistema de informes de JClic deberemos seguir cuatro pasos que afectan a los cuatro elementos que se muestran numerados en el esquema: 1. Crear una base de datos en blanco. 2. Configurar el conector. 3. Configurar JClic reports. 4. Configurar los clientes JClic para que hagan uso del servicio de informes. A continuación se explican los tres primeros pasos para dos bases de datos: MS-Access y MySQL. El cuarto paso es independiente del sistema utilizado, y se explica al final. 2.1 Configuración del sistema con MS-Access MS-Access es un sistema de bases de datos integrado en el paquete Microsoft Office, muy popular en entornos Windows. A pesar de tener unas prestaciones limitadas, puede resultar útil como sistema de almacenaje en organizaciones pequeñas y medianas (hasta 500 usuarios). En organizaciones mayores se recomienda el uso de sistemas profesionales de basos de datos como MySQL, que se explica en el apartado siguiente. Para efectuar las operaciones que se detallan a continuación será necesario que el usuario de Windows con el que se esté operando tenga derechos de administración del sistema y, por supuesto, que esté instalada alguna versión de Access. También será necesario tener instalado el componente de acceso a orígenes de datos ODBC, que es un elemento opcional de Windows Creación de una base de datos MS-Access Ponga en marcha MS-Access, indique que desea crear una nueva base de datos en blanco y localice una carpeta donde guardarla. No es necesario que sea una carpeta pública. Puede darle el nombre que crea conveniente. En este documento le llamaremos JClicReports.mdb. Una vez creada la base de datos ya puede cerrar Access. De momento no será necesario trabajar más con él Configuración del conector ODBC para MS-Access Con MS-Access utilizaremos un conector de tipo ODBC, que es el estándar más utilizado en sistemas Windows. Ponga en marcha el panel de control (Inicio - Configuración - Panel de control - Herramientas administrativas) y busque el icono Orígenes de datos ODBC. Ponga este módulo en marcha y active la pestaña DSN de sistema

4 Haga clic en el botón Agregar... y seleccione en la lista el tipo Microsoft Access Driver (*.mdb). Confirme haciendo clic en el botón Final. Escriba en Nombre del origen de datos la palabra JClic, y en Descripción cualquier texto explicativo, como: Base de datos de informes JClic. Haga clic en Seleccionar... y busque el archivo JClicReports.mdb que hemos creado anteriormente. Haga clic en Aceptar y cierre la ventana de control de ODBC. Con esta operación se habrá creado un conector de tipo ODBC que permitirá a cualquier aplicación acceder a la base de datos que habíamos preparado en el paso anterior Configuración de JClic Reports con ODBC Para poner en marcha JClic puede optar entre hacer clic en el icono que aparece en o utilizar alguno de los iconos que se crearán en el escritorio y en el menú inicio después de haberlo utilizado un par de veces. Haga clic en Configuración... y active la pestaña Base de datos. Escriba en Controlador la expresión: sun.jdbc.odbc.jdbcodbcdriver Escriba en URL la expresión: jdbc:odbc:jclic Es importante escribirlo tal como se indica, teniendo en cuenta los puntos, sin espacios y distinguiendo entre mayúsculas y minúsculas. Deje marcada la casilla Crear tablas si no existen, y deje también el prefijo JCLIC_ para los nombres de las tablas. Confirme la operación en Aceptar. Con eso estará JClic reports preparado para trabajar con la base de datos. 2.2 Configuración del sistema con MySQL MySQL es un sistema libre de bases de datos que funciona en Windows, Linux, Mac OS X, Solaris y otras variantes de Unix. En la web encontrará información sobre como descargarlo, instalarlo y configurarlo en diversas plataformas. MySQL es un sistema mucho más complejo que Access, y utiliza usuarios de la base de datos, que operan con contraseñas y que tienen diversos derechos. Normalmente, el usuario root es el único que puede crear nuevas bases de datos. En las indicaciones que proponemos seguir se contempla la creación de un usuario específico de MySQL (llamado jclic_user) que tendrá plenos derechos sobre la base de datos de informes Creación de la base de datos MySQL Para gestionar el MySQL podemos utilizar directamente sus programas de control (escribiendo las órdenes en una consola), o algún interfaz gráfico como PHPMyAdmin ( que también es software libre

5 Para crear la base de datos desde la linea de órdenes: Configuración del sistema de informes de JClic Primero hay que asegurarse de que el proceso MySQL esté en marcha. Para ello abriremos una consola y escribiremos: mysqld --console A continuación pondremos en marcha una sesión de control del sistema, escribiendo: mysql -h localhost -u root -p mysql El programa nos solicitará la contraseña del usuario root, que es el administrador de MySQL. También podemos utilizar el prefijo -u con cualquier otro usuario de MySQL que tenga derechos para crear nuevas bases de datos. Cuando se haya validado la contraseña nos aparecerá el prompt de la consola de MySQL: mysql> Para crear la base de datos escribiremos: CREATE DATABASE JClicReports; Es importante no olvidar el punto y coma final. Podemos asignar cualquier otro nombre a la base de datos. En este documento supondremos que se llama JClicReports. Podemos comprobar que todo haya ido bien escribiendo: SHOW DATABASES; El programa nos mostrará las bases de datos existentes. Deberá aparecer la que acabamos de crear. A continuación ceraremos un usuario que tendrá pleno acceso a esta base de datos. Le llamaremos jclic_user, y le asignaremos la contraseña jclic_pwd. Por supuesto, puede utilizar cualquier otro nombre y contraseña. Para crear el usuario escribiremos: GRANT ALL PRIVILEGES ON JClicReports.* TO jclic_user IDENTIFIED BY 'jclic_pwd' WITH GRANT OPTION; Observe que cada vez que pulse Retorno se crea una nueva linea con el prompt ->, hasta que se escribe el punto y coma final en la última linea

6 Una vez realizados estos pasos ya podemos salir del programa de control escribiendo exit y pulsando Retorno. Resumiendo: hemos creado una base de datos llamada JClicReports, y un usuario jclic_user, con contraseña jclic_pwd, que tiene plenos derechos sobre ella Configuración del conector para MySQL MySQL se puede comunicar con las aplicaciones Java mediante un conector de tipo JDBC. Los pasos a seguir para que la máquina virtual Java lo reconozca son: Visite el web y seleccione la opción Connector/J. Descargue el formato más adecuado a su entorno operativo (zip para Windows y Mac, o tar.gz para Linux). Descomprima el archivo que acaba de descargar. Debería contener un fichero con el nombre: mysql-connector-java-[version]-bin.jar Donde [version] es una secuencia de cifras. Atención: hay otro archivo con el mismo nombre seguido de la terminación -g que NO vamos a utilizar. Localice la carpeta de extensiones de su sistema Java. Es una carpeta llamada ext ubicada en otra llamada lib que se encuentra en la carpeta principal de Java. En sistemas Windows acostumbra a ser: C:\Archivos de programa\java\jre[version]\lib\ext En sistemas Mac OS X hay dos. Una es propia de cada usuario del sistema, y la otra común a todos los usuarios: /Users/[usuari]/.java/deployment/ext /System/Library/Frameworks/JavaVM.framework/Versions/[ver]/Ho me/lib/ext En Linux puede encontrarse en distintos lugares: /usr/java/lib/ext /usr/lib/java/lib/ext (instalación por defecto de Sun) (Suse Linux) Si no encuentra esta carpeta hay un método más efectivo: ponga en marcha cualquier applet JClic (por ejemplo, el de las actividades de demostración), haga clic en el botón JClic y active la pestaña Sistema. Observe la linea Ubicación de Java. La carpeta de extensiones se encuentra añadiendo lib/ext a la expresión indicada

7 Cuando haya localizado la carpeta de extensiones copie en ella el archivo que se había indicado anteriormente. En sistemas basados en Unix (Linux, Mac OS X, Solaris...) podemos crear un enlace simbólico en lugar de copiar el archivo Configuración de JClic reports con MySQL Para poner en marcha JClic reports puede optar entre hacer clic en el icono situado en o utilizar alguno de los iconos que se crearan en el escritorio y en el menú inicio después de haberlo invocado un par de veces. Haga clic en el botón Configuración... y active la pestaña Base de datos. Escriba en Controlador la expresión: com.mysql.jdbc.driver Es importante escribirla tal como se indica, sin espacios y distinguiendo entre mayúsculas y minúsculas. Escriba en URL la expresión: jdbc:mysql://localhost/jclicreports Escriba en Usuario de la base de datos el nombre (se proponía jclic_user). Escriba en Contraseña la que le haya dado (se proponía jclic_pwd). Deje marcada la casilla Crear tablas si no existen, y deje también el prefijo JCLIC_ para los nombres de tablas. Confirme la operación con Aceptar. Con eso quedará JClic reports preparado para trabajar con al base de datos. 2.3 Comprobación del funcionamiento de JClic reports Hemos preparado un conjunto de datos de demostración que pueden resultar de utilidad para comprobar el funcionamiento de JClic reports. Estos datos incluyen un grupo denominado test, con algunos alumnos y resultados simulados. Los datos de demostración se encuentran disponibles en dos versiones de MS-Access (97 y 2000) y en SQL (formato estándar empleado por MySQL y otros sistemas). En todos los casos, se distribuyen comprimidos en formato ZIP para ahorrar espacio. Datos de demostración en formato MS-Access: Para cargar los datos cierre JClic reports y substituya el archivo MDB creado anteriormente por el que se encuentra dentro del ZIP. Datos de demostración en formato SQL: Para cargar los datos cierre JClic reports y utilice alguna utilidad como PHPMyAdmin, que le permitirá importar el archivo SQL que se encuentra en el ZIP

8 Cuando se hayan cargado los datos de demostración ponga en marcha de nuevo JClic reports, haga clic en Iniciar y, a continuación, en Iniciar el navegador. La contraseña inicial puede dejarse en blanco. Debería poder navegar por los informes de usuario, de grupo y de actividades, así como comprobar las principales funcionalidades del programa. El campo contraseña de la primera pantalla se puede dejar inicialmente en blanco. 3 Configuración inicial de la base de datos Para poner el sistema en funcionamiento conviene realizar una configuración inicial de la base de datos, especialmente si se trata de una red en la que trabajan diversos usuarios: Ponga en marcha JClic reports, active el servicio (botón iniciar), abra el navegador y vaya a Administración de la base de datos. Haga clic en Establecer la contraseña y asigne una palabra de paso, que impedirá que usuarios no autorizados tengan acceso a la información de la base de datos. Conviene también decidir qué política se seguirá en lo referente a la creación de usuarios y grupos. En principio lo más seguro es que el administrador los introduzca directamente, ya sea desde las páginas de administración de grupos que proporciona JClic reports o actuando directamente sobre la base de datos (ver el esquema de tablas en el anexo 1). Otra posibilidad es crear solo los grupos y dejar que los usuarios se den de alta ellos mismos la primera vez que inicien una sesión de trabajo con JClic. En este segundo caso habrá que marcar la casilla Permitir a los usuarios la creación de nuevos usuarios, y dejar desmarcada la opción Permitir a los usuarios crear nuevos grupos. 4 Configuración de los clientes JClic El cuarto paso es independiente del sistema de bases de datos utilizado (Access o MySQL). Deberemos configurar los clientes JClic para que conecten con el servidor JClic reports y le envien información sobre las activiaddes realizadas por los alumnos. Los pasos a seguir son: 1. Asegurarse de que JClic reports esté funcionando en algún ordenador de la red. 2. Averiguar el nombre o la IP del ordenador en el que está funcionando JClic reports. Nos sirve tanto su nombre de red (por ejemplo, servidor ) como su dirección IP (por ejemplo, ). 3. Averigüe también el puerto por el que JClic reports admite la comunicación. Por defecto es el 9000, pero para estar seguro haga clic en el botón Configuración de Jclic reports, vaya a la pestaña Servidor web y observe el valor del campo Puerto. 4. Ponga en marcha JClic desde cualquier ordenador de la red. Puede hacerlo con un clic en el botón que aparece en la página de descarga de JClic, o desde los iconos que se crearan en el escritorio y en el menú Inicio cuando lo haya activado un par de veces. En la sección de preguntas frecuentes encontrará más información sobre la creación de accesos directos para poner en marcha JClic. 5. Vaya al menú Herramientas - Configuración y seleccione la pestaña Informes

9 6. Marque la casilla Guardar los resultados de las actividades en una base de datos. 7. Seleccione la opción Conectarse a un servidor de informes JClic, y escriba en el campo Servidor el nombre o la IP del ordenador en el que esté funcionando, seguido de dos puntos y el número de puerto. Será una expresión parecida a estas: :9000 servidor:9000 servidor.red: Confirme los cambios, salga de JClic y vuelva a ponerlo en marcha. Si todo va bién debería aparecer la pantalla de identificación, y JClic reports debería registrar los resultados de todas las actividades realizadas a partir de ese momento

10 Anexo 1: Esquema de tablas de la base de datos JClic reports utiliza 6 tablas. Los nombres de las tabals acostumbran a llevar el prefijo JCLIC_, para evitar posibles conflictos que se podrían producir si hubieran de convivir en una misma base de datos con tablas de otras aplicaciones. SETTINGS Esta tabla almacena parejas clave-valor que describen diversas características relativas al funcionamiento de la base de datos. SETTING_KEY Texto 255 X Clave SETTING_VALUE Texto 255 Valor GROUPS En principio todos los usuarios de la base de datos deben pertenecer a un grupo. GROUP_ID Texto 50 X Identificador único del grupo GROUP_NAME Texto 80 Nombre del grupo GROUP_DESCRIPTION Texto 255 Descripción (opcional) GROUP_ICON Texto 255 URL que apunta a un archivo gráfico (GIF, PNG o JPG) que identifica al grupo. (opcional) GROUP_CODE Texto 50 Campo no utilizado en la versión actual GROUP_KEYWORDS Texto 255 Campo no utilizado en la versión actual USERS En esta tabla se guardan los datos que permiten la identificación de los usuarios. USER_ID Texto 50 X Identificador único del usuario/a GROUP_ID Texto 50 Identificador del grupo al que pertenece el usuario/a USER_NAME Texto 80 Nombre del usuario/a USER_PWD Texto 255 Contraseña encriptada (opcional) USER_ICON Texto 255 URL que apunta a un archivo gráfico (GIF, PNG o JPG) que identifica al usuario/a. (opcional) USER_CODE Texto 50 Campo no utilizado en la versión actual USER_KEYWORDS Texto 255 Campo no utilizado en la versión actual

11 SESSIONS Cada sesión de trabajo de un usuario con JClic genera un registro en esta tabla. SESSION_ID Texto 50 X Identificador único de la sesión USER_ID Texto 50 Identificador del usuario/a a quien corresponde la sesión SESSIONDATETIME Fecha 14 Fecha y hora en la que se ha iniciado la sesión PROJECT_NAME Texto 100 Nombre del proyecto JClic SESSION_KEY Texto 50 Campo no utilizado en la versión actual SESSION_CODE Texto 50 Campo no utilizado en la versión actual SESSION_CONTEXT Texto 255 Campo no utilizado en la versión actual ACTIVITIES Cada actividad JClic realizada por un usuario genera un registro en esta tabla. SESSION_ID Texto 50 X Código de la sessión ACTIVITY_ID Entero X Identificador único de la actividad en la sesión ACTIVITY_NAME Texto 50 Nombre de la actividad NUM_ACTIONS Entero Nombre de acciones realizadas SCORE Entero Nombre de acciones correctas ACTIVITY_SOLVED Byte Indica si la actividad se ha resuelto (1) o no (0) QUALIFICATION Entero Puntuación obtenida (0-100) TOTAL_TIME Entero Tiempo (segundos) invertido en la actividad ACTIVITY_CODE Texto 50 Campo no utilizado en la versión actual ACTIONS Esta tabla recopila las características de cada una de las acciones individuales que el usuario realiza al efectuar las actividades, siempre que en la creación de la actividad se haya indicado la necesidad de registrar las acciones. La versión actual de JClic reports no utiliza la información almacenada en esta tabla. SESSION_ID Texto 50 X Código de la sesión ACTIVITY_ID Entero X Código de la actividad en la sesión ACTION_ID Entero X Identificador único de la acción en la actividad ACTION_TYPE Texto 20 Tipo de acción realizada ACTION_SOURCE Texto 255 Contenido del objeto (casilla, incógnita...) sobre el que se ha efectuado la acción. ACTION_DEST Texto 255 Cuando la acción sea un emparejamiento, contenido del segundo objeto implicado en ella. ACTION_OK Byte Indica si la acción fue correcta (1) o no (0)