Download - Manual_MantisBT_v1.pdf
Guía de Uso
Mantis Bug Tracker
Fecha: 20/07/2012
Versión: 1.0
Guía de Uso
Mantis Bug Tracker
Copyright © 2012, GeneXus Consulting, todos los derechos reservados. Página 2 de 11
Registro de Actualizaciones
N° de Versión Fecha Realizado por Detalle de la Actualización
1.0 20/07/2012 Guillermo Skrilec Creación del documento
Guía de Uso
Mantis Bug Tracker
Copyright © 2012, GeneXus Consulting, todos los derechos reservados. Página 3 de 11
1. Introducción ............................................................................................. 4
1.1. Inicio de sesión ....................................................................................... 4
1.2. Menú principal ........................................................................................ 4
2. Flujo de trabajo ........................................................................................ 5
3. Reporte de incidencias ............................................................................. 7
4. Consulta de incidencias ............................................................................ 7
4.1. Filtros .................................................................................................... 7
5. Cambio de estados ................................................................................... 7
5.1. Resolución de incidencias ......................................................................... 8
6. Manejo de versiones ................................................................................. 8
6.1. Roadmap ............................................................................................... 8
6.2. Registro de cambios ................................................................................ 8
7. Perfiles ..................................................................................................... 9
7.1. Permisos ................................................................................................ 9
8. Preferencias de usuario .......................................................................... 10
9. Administración ....................................................................................... 10
9.1. Usuarios .............................................................................................. 10
9.2. Proyecto .............................................................................................. 10
9.3. Etiquetas ............................................................................................. 11
9.4. Campos personalizados ......................................................................... 11
Guía de Uso
Mantis Bug Tracker
Copyright © 2012, GeneXus Consulting, todos los derechos reservados. Página 4 de 11
1. Introducción
Mantis Bug Tracker es una herramienta de gestión y seguimiento de incidencias para
los proyectos de consultoría.
El acceso a la misma se realiza a través de la siguiente dirección:
http://qa.genexusconsulting.com/mantisbt/
Para acceder deberá contar con una cuenta de usuario, o de lo contrario deberá
solicitar la creación de una cuenta al responsable del proyecto.
1.1. Inicio de sesión
Para acceder al sistema deberá ingresar el nombre de usuario y contraseña como se
muestra en la siguiente pantalla.
1.2. Menú principal
Una vez dentro de la aplicación, si el usuario se encuentra asignado en distintos
proyectos, deberá seleccionar el proyecto con el cual desea trabajar. Para esto
deberá elegir el mismo de la lista de selección que se muestra arriba a la derecha.
Si el usuario se encuentra asignado a un único proyecto, la lista de selección no se
mostrará.
En la primera sección de la pantalla se presenta el menú de la aplicación, dentro de
las principales opciones se encuentran:
Principal: Página donde se pueden compartir publicaciones del proyecto.
Guía de Uso
Mantis Bug Tracker
Copyright © 2012, GeneXus Consulting, todos los derechos reservados. Página 5 de 11
Mi Vista: Vista rápida de las últimas incidencias que han sido actualizados.
Ver Incidencias: Trabajar con las incidencias del proyecto.
Reportar Incidencia: Ingreso de nuevas incidencias.
Registro de cambios: Consulta de las incidencias resueltas en cada versión.
Roadmap: Consulta de las incidencias planificadas en cada versión.
Resumen: Estadísticas de las incidencias reportadas.
Documentos: Subir y consulta de archivos del proyecto.
Mi Cuenta: Configuración de los datos personales y preferencias de usuario.
Al final del menú principal existe un campo que permite acceder de forma rápida a
una incidencia a través del número de la misma.
2. Flujo de trabajo
A continuación se presenta el flujo de trabajo definido en la herramienta. El mismo
se compone de un conjunto de estados por los que pasan las incidencias reportadas.
Los estados se agrupan en 3 grupos diferentes, de manera de obtener fácilmente
estadísticas y visualizar el estado de las versiones.
Abiertas: Incidencias que aún no han sido resueltas.
Resueltas: Incidencias que han sido corregidas y aún faltan las pruebas.
Cerradas: Incidencias que han sido corregidas y pasaron las pruebas.
Nota: En algunos proyectos podrá limitarse el uso de algunos estados, por lo tanto
no serán visibles en el mismo.
Guía de Uso
Mantis Bug Tracker
Copyright © 2012, GeneXus Consulting, todos los derechos reservados. Página 6 de 11
Guía de Uso
Mantis Bug Tracker
Copyright © 2012, GeneXus Consulting, todos los derechos reservados. Página 7 de 11
3. Reporte de incidencias
Para reportar una incidencia seleccionar la opción “Reportar Incidencia”. La
herramienta despliega el formulario de ingreso con lo siguientes campos relevantes:
Categoría (obligatorio)
Reproducibilidad
Severidad
Prioridad
Versión del producto (se muestra si existen versiones definidas en el
proyecto)
Asignar a
Previsto para versión (se muestra si existen versiones definidas en el
proyecto)
Resumen (obligatorio)
Descripción (obligatorio)
Pasos para reproducir
Información adicional
4. Consulta de incidencias
4.1. Filtros
Para realizar una consulta en el listado de incidencias existe un conjunto de filtros
que pueden ser combinados.
Existen dos tipos de filtros, por defecto se cargan los filtros simples que permiten
seleccionar un único valor por cada campo, mientras que los filtros avanzados
permiten seleccionar más de un valor por cada campo.
También existe la posibilidad de buscar por un texto libre, para esto utilizar el campo
“Buscar”.
Una vez definido un filtro, se puede guardar el mismo utilizando el botón “Guardar
filtro actual”. Se deberá indicar un nombre para el filtro y si el mismo es público
(para todos los integrantes del proyecto) o privado (solamente para el usuario).
5. Cambio de estados
Para cambiar el estado de una incidencia se deberá visualizar la misma y seleccionar
“Cambiar estado a:”, habiendo seleccionado previamente el estado al que se desea
Guía de Uso
Mantis Bug Tracker
Copyright © 2012, GeneXus Consulting, todos los derechos reservados. Página 8 de 11
cambiar. De esta forma se despliega una pantalla donde se puede ingresar una nota
relacionada al cambio de estado.
5.1. Resolución de incidencias
Cuando se resuelve una incidencia, se deberá indicar la resolución de la misma.
Por defecto cuando se ingresa una incidencia, la resolución es abierta. Cuando se
resuelve la misma (luego que pasa las pruebas), se deberá cambiar la resolución.
En algunos casos, por ejemplo al rechazar una incidencia que se encuentra a
corregir, también será posible modificar la resolución de la misma.
6. Manejo de versiones
La herramienta permite realizar el manejo de versiones de cada proyecto. Para esto
se utilizan 3 campos diferentes en cada incidencia.
Versión del producto: Indica en que versión del sistema se encontró la incidencia.
Previsto para versión: Indica la versión planificada para la resolución de la incidencia.
Resuelta en versión: Indica en que versión del sistema se resolvió la incidencia.
Nota: Para hacer uso del manejo de versiones se deberán configurar las mismas en
el proyecto.
6.1. Roadmap
Este listado permite ver las incidencias previstas para las futuras versiones.
Solamente se mostrarán las incidencias que tienen asignado el campo “Previsto para
Versión”. Las incidencias que se encuentran cerradas se mostrarán tachadas.
El porcentaje de avance de la versión se calcula dividiendo la cantidad de incidencias
cerradas sobre el total de las incidencias planificadas en la versión.
Nota: Solamente se muestran las versiones que aún no se liberaron.
6.2. Registro de cambios
Este listado muestra todas las incidencias cerradas de cada versión. Solamente se
mostrarán las incidencias que tienen asignado el campo “Resuelto en Versión” y
resolución “corregido”.
Nota: Solamente se muestran las versiones liberadas.
Guía de Uso
Mantis Bug Tracker
Copyright © 2012, GeneXus Consulting, todos los derechos reservados. Página 9 de 11
7. Perfiles
Se definió el siguiente conjunto de perfiles en la herramienta.
(E) Espectador: Solamente puede ver las incidencias públicas.
(I) Informador: Permite reportar incidencias y gestionar las mismas. Accede a las
incidencias privadas. (Integrantes del equipo de test deberían tener este perfil)
(A) Actualizador: Permite reportar incidencias y gestionar las mismas. No accede a
las incidencias privadas. (Usuarios externos deberían tener este perfil)
(D) Desarrollador: Permite reportar incidencias y gestionar las mismas. Accede a las
incidencias privadas. (Integrantes del equipo de desarrollo deberían tener este perfil)
(M) Manager: Permite gestionar la configuración del proyecto y agregar nuevos
usuarios. (El encargado del proyecto debería tener este perfil)
7.1. Permisos
A continuación se puede ver el detalle de los permisos de cada uno de los perfiles.
Permiso E I A D M
Ver incidencias públicas X X X X X
Ver y descargar adjuntos X X X X X
Ver documentos del proyecto X X X X X
Ver noticias privadas X X X X
Subir y borrar adjuntos X X X X
Guardar filtros X X X X
Usar filtros guardados X X X X
Enviar recordatorios X X X X
Añadir perfiles X X X X
Reportar y modificar incidencia X X X X
Monitorizar incidencia X X X X
Asignar incidencia X X X X
Añadir y actualizar notas X X X X
Ver incidencias privadas X X X
Administrar noticias X
Administrar proyectos X
Subir documentos del proyecto X
Guía de Uso
Mantis Bug Tracker
Copyright © 2012, GeneXus Consulting, todos los derechos reservados. Página 10 de 11
Administrar campos personalizados X
Ver resumen X
Administrar usuarios X
Borrar incidencia X
8. Preferencias de usuario
Ingresar al menú Mi Cuenta para actualizar la contraseña, correo electrónico y
nombre.
Dentro del mismo menú, accediendo a la opción Preferencias es posible cambiar la
configuración de envío de mails y otras relacionadas con la cuenta.
Accediendo a la opción Administrar Columnas es posible modificar las columnas que
se muestran al visualizar el listado de incidencias y en los informes de las mismas.
9. Administración
El encargado del proyecto (manager) podrá realizar las tareas de mantenimiento y
administración del proyecto, accediendo a través del menú Administración.
9.1. Usuarios
Seleccionando la opción Administrar Usuarios se podrá crear nuevos usuarios y
reinicializar la contraseña de los existentes.
Nota: Antes de crear un usuario, se deberá verificar que el mismo no se encuentre
registrado en el sistema.
9.2. Proyecto
Seleccionando la opción Administrar Proyectos se podrá cambiar la configuración el
proyecto.
En la primera sección se define el nombre, estado del proyecto, descripción, y la
visibilidad del mismo. También será posible definir la subproyectos.
Nota: Todos los proyectos deben ser privados.
Luego se definen las categorías de incidencias. Se podrá definir un conjunto de
categorías en un proyecto y luego heredar las mismas en los subproyectos.
El manejo de versiones del proyecto se realiza de acuerdo a las versiones definidas
en la siguiente sección. Cada versión tiene nombre, descripción, y se puede marcar
Guía de Uso
Mantis Bug Tracker
Copyright © 2012, GeneXus Consulting, todos los derechos reservados. Página 11 de 11
como liberada (esto permite definir si la versión se muestra en el registro de cambios
o en el roadmap).
Nota: En la fecha de la versión se recomienda poner la fecha de liberación de la
misma, ya que aparecerá en el listado correspondiente.
En cada proyecto es posible asociar campos personalizados que se encuentren
definidos en la herramienta.
Finalmente es posible administrar los usuarios que forman el proyecto y el nivel de
acceso de cada uno de ellos.
9.3. Etiquetas
Seleccionando la opción Administrar Etiquetas se podrán crear nuevas etiquetas para
el proyecto y gestionar las existentes.
9.4. Campos personalizados
Seleccionando la opción Administrar Campos Personalizados se podrán crear nuevos
campos para utilizar en los distintos proyectos.
Luego de crear el mismo se deberá asociar al proyecto.