Introducción a JTrac
En este tutorial vamos a hablar de una herramienta llamada JTrac
para el seguimiento de errores (bugtracking). JTrac
es una aplicación web de gestión y seguimiento de incidencias
similar a Bugzilla, Eventum,
Mantis, etc. Es una herramienta «open
source» escrita en Java bajo licencia V2.0. de Apache.Utiliza Apache
Wicket, Spring y Hibernate. Su instalación es sorprendentemente sencilla
y rápida y posee una gran capacidad de personalización (campos,
workflow, roles, etc.).
Por debajo JTrac utiliza un servidor Jetty
y un DBMS HSQLDB.
Instalación
Lo primero que vamos a hacer es instalar la herramienta en nuestro
entorno (Windows) e ir viendo poco a poco sus funcionalidades. El único
requisito que hay que cumplir es tener Java 5 instalado en la máquina.
En la página oficial de JTrac (http://www.jtrac.info)
podemos descarganos su última versión. Una vez descargado en nuestra
máquina el zip, lo tenemos que descomprimir, hacer doble click
en el fichero start.bat (arranca el servidor Jetty sobre el
puerto 80) y ¡¡¡ ya tenemos instalado JTrac !!!
Para comprobarlo introducir en la barra de direcciones de tu navegador
la siguiente url: http://localhost/jtrac
Inicialmente hay creado un usuario admin con
password admin. Lo introducimos en la pantalla de login
y ya hemos entrado en la aplicación.
En la parte superior derecha de la pantalla está la seccion
de «Opciones» desde donde se podrá configurar parte
de la aplicación. Permite editar el perfil propio del usuario, crear
nuevos usuarios, crear nuevos proyectos, asignar usuarios a proyectos, gestionar
la configuración de JTrac, etc.
Características
A continuación vamos a ir viendo las principales características
y opciones que nos proporciona JTrac
Creación de un nuevo proyecto
Si entramos en la opción de «Gestión de proyecto»
de la sección de «Opciones» podemos ver todos los
proyectos creados. Para poder crear un nuevo proyecto solo tenemos que pulsar
sobre el enlace de «Crear un proyecto» y seguir los pasos
que se indican.
Introducimos los datos básicos del proyecyo y damos
a «Siguiente«. Una opción muy interesante es la
de poder copiar la configuración y datos principales de un proyecto,
así solo con editar ciertos campos, usuarios, roles, etc. podrás
tener tu proyecto totalmente configurado en menos tiempo.En la siguiente pantalla se podrán personalizar que
campos (nombre, tipos y valores) formarán nuestro proyecto. En nuestro
ejemplo solo hemos creado dos campos de tipo texto y lista desplegable como
se puede ver en la imagen inferior.En la siguiente pantalla podremos añadir y/o editar
roles asignados al proyecto y su workflow.Por último damos el botón de «Guardar»
y nos vamos a la página donde seleccionaremos los usuarios (y sus
roles) que van a participar en el proyecto.
Crear nuevas incidencias
Una vez creado el proyecto podemos ver sus características
en la «Portada» de la aplicación. Allí se
podrá ir dando de alta nuevas incidencias o issue al proyecto.Para la creación de incidencias tendrás que rellenar
los campos originales como Resumen, Descripción, Asignar a, etc, además
como se ve en la imagen inferior también nos aparecen los nuevos campos
creados anteriormente cuando hemos creado el proyecto.
Existe la posibilidad de relacionar varias incidencias entre
sí y de exportar las incidencias a un fichero Excel (que nunca
viene mal).
Gestión de configuración
Dentro de la sección de «Opciones»
existe la posibilidad de modificar la configuración inicial de la herramienta
pulsando sobre la opción de «Gestión de configuración«.
Allí se podrán modificar valores relacionados con el sistema
de notificación por emails, tiempo de sesión, locale
de la aplicación, etc.
Usar una base de datos diferente
Además existe la posibilidad de cambiar la base de datos
que usará la herramienta modificando el fichero jtrac.properties.
Nosotros vamos a hacer un ejemplo cambiando la base de datos a una
MySQL. Lo primero que tenemos que hacer es editar el fichero
jtrac.properties con los datos correctos de
configuración para nuestra base de datos MySQL (driver, url, usuario,
password, etc.)
Una vez configurado el fichero tenemos que descargarnos, si
no lo tenemos ya, el driver JDBC para MySQL (http://dev.mysql.com/downloads/connector/j/5.1.html)
y meterlo en el siguiente path: «JTRAC_HOME\work\Jetty_0_0_0_0_80_jtrac.war__jtrac__qk44r3\webapp\WEB-INF\lib».
Ahora solo nos queda arrancar la aplicación usando el start.bat
y automáticamente se conectará a la nueva base de datos y creará
el nuevo schema con todas sus tablas y objetos.Este cambio de base de datos se recomienda que se haga al principio,
ya que si se hace con datos ya ingresados en la herramienta se deberá
hacer un proceso de migración de la base de datos
original a la nueva para no perder estos (http://www.jtrac.info/doc/html/upgrading.html).
Instalación como servicio de Windows
Otra posibilidad que nos ofrece JTrac es poder
instalarse como un servicio de Windows de manera que se iniciará
cada vez que se arranque la máquina. JTrac usa el Java Service
Wrapper para poder ser instalado como servicio de Windows, lo primero
que tenemos que hacer es descargarnos el Java
Service Wrapper en nuestra máquina y copiar algunos ficheros en
nuestro directorio de JTrac. Tendremos que copiar el wrapper.exe del
directorio «/bin» a nuestro directorio JTRAC_HOME.
Además tendremos que copiar los ficheros wrapper.jar y
wrapper.dll del directorio «/lib» a nuestra
carpeta «JTRA_HOME/etc«.Una vez hecho esto tenemos que abrir una consola de línea
de comandos, posicionarnos en nuestro directorio JTRAC_HOME y ejecutar
la instrucción «wrapper.exe -i etc/wrapper.conf«.
Ya tenemos instalado JTrac como servicio (con nombre JTrac-Jetty).
Roadmap
Siempre es insteresante ver en cada proyecto cual es su roadmap
para así poder ver que cosas van a ir apareciendo en las siguientes versiones
del producto. Entre las más interesantes de JTrac están la posibilidad
de personalizar validaciones sobre los datos introducidos por el usuario, personalizar
una serie de tareas programadas, integración con Subversion, integración
con Eclipse Mylyn, etc…
Conclusión
En la actualidad parece imprescindible usar herramientas de bugtracking
para el desarrollo de aplicaciones informáticas. Antes de empezar cualquier
proyecto del tipo que sea merece la pena pararse a pensar y analizar que herramientras
de bugtracking se adaptan mejor a nuestro negocio, que beneficios nos
aportan respecto a otras y de que manera vamos a poder aprovechar toda la funcionalidad
que nos ofrecen. Este tutorial solo pretende ser una pequeña introducción
de esta nueva herramienta, que aun tiene cosas que mejorar para estar tal vez
al nivel de Bugzilla, Eventum o JIRA, pero que a su vez aporta cosas muy interesantes
como ser open source, sencillez de instalación y uso, personalización
de campos, workflow, etc.
Hola, quisiera hacer una consulta… cómo puedo scar BK de todos los proyectos? así mismo, el día de ayer he creado un proyecto y no hubo ningún problema, hoy voy acceder al proyecto y resulta que ya no existía, es como si lo hubiesen eliminado todo el proyecto, usuarios, etc. Cómo podría hacer para salvar la data y esta no se pierda??