mantis manual

Mantis: Manual de UsuarioDirigido a usuariosVERSIN

1.1CLIENTE

.PROYECTO

.

2008 Net2u_. Todos los derechos reservados. Estrictamente confidencial. La presente informacin esta dirigida a los destinatarios y nicamente puede ser utilizada a los efectos que se indican en la portada del documento. Si el receptor no es la persona a la que va dirigida esta comunicacin confidencial, se le notifica que la distribucin o copias de esta comunicacin est terminantemente prohibida.

Mantis: Manual de Usuario

Versin 1.1

CONTROL DOCUMENTALProyecto: Entidad de destino: Ttulo: Versin: Fecha edicin: Fichero: Autor(es): Resumen: . . Mantis: Manual de Usuario 1.1 05/06/2008 Mantis_Manual.doc Michael Brussow Manual de usuario que funcionamiento de Mantis describe y explica detalladamente el

PANEL DE FIRMASAutor Revisado Aprobado

Firma Nombre Cargo Entidad Fecha Net2u_ 05/06/2008 Michael Brussow

CONTROL DE MODIFICACIONES POR CAMBIO DE VERSINVersin 1.00 Fecha 03/06/2008 Mdulos N/A Descripcin del cambio Documento original

Cliente Proyecto Modificado

. . 03/06/2008

Pgina 2 de 24Mod.MU


Versin 1.1

NDICE1 2 3 Objetivo del Documento ................................................................................. 4 mbito del Documento ................................................................................... 5 Introduccin.................................................................................................. 63.1 3.2 Solicitar una cuenta nueva................................................................................. 6 Recordar contrasea ......................................................................................... 7 Men superior .................................................................................................. 84.1.1 4.1.2 4.1.3 Usuario ............................................................................................................8 Seleccionar proyecto..........................................................................................8 Saltar a bug .....................................................................................................8 Esquema de flujos de estados en mantis ..............................................................9

4

Funcionalidades bsicas.................................................................................. 84.1

4.2

Estado de los bugs............................................................................................ 84.2.1

5

Pgina principal ........................................................................................... 105.1 5.2 5.3 Bugs abiertos y asignados a m ........................................................................ 10 Bugs abiertos y reportados por m .................................................................... 10 noticias ......................................................................................................... 10

6 7

Mi Vista ...................................................................................................... 11 Ver Incidencias............................................................................................ 127.1 Filtros ........................................................................................................... 127.1.1 7.1.2 restaurar filtro ................................................................................................13 filtro avanzado ................................................................................................13

7.2 7.3

Listado .......................................................................................................... 14 Vista detalle de un bug.................................................................................... 157.3.1 7.3.2 7.3.3 Cabecera de la vista detalle de un bug ...............................................................16 Notas.............................................................................................................17 Historial .........................................................................................................17

8 9 10 11

Informar de bug .......................................................................................... Log de Cambios ........................................................................................... Documentos................................................................................................ Mi Cuenta ...................................................................................................11.1 11.2 11.3

19 21 22 23

Mi cuenta....................................................................................................... 23 Preferencias ................................................................................................... 24 Perfiles .......................................................................................................... 24


. . 03/06/2008

Pgina 3 de 24Mod.MU


Versin 1.1

1

OBJETIVO DEL DOCUMENTO

El objetivo del presente documento es mostrar y servir de ayuda a los usuarios actualizador del Mantis. Este manual pretende convertirse en una herramienta de consulta prctica y efectiva que facilite y ayude al uso y manejo de dicha aplicacin. De esta manera, con este manual se quiere explicar, lgica y descriptivamente, todas y cada una de las acciones que se pueden realizar y/o gestionar as como la manera mas eficaz y practica de utilizar todas las opciones que ofrece la aplicacin del Mantis de


. . 03/06/2008

Pgina 4 de 24Mod.MU


Versin 1.1

2

MBITO DEL DOCUMENTO

El presente documento va dirigido a los usuarios actualizadores de la aplicacin Mantis. El manual describe las diferentes funcionalidades de dicha aplicacin e identifica los diferentes casos de uso que el sistema puede soportar. Cada caso de uso reflejar una descripcin detallada de las reacciones por parte del actor y del sistema a la hora de formalizar la accin, e ir acompaado por imgenes de los interfaces que definirn la interaccin del usuario con el sistema. Para cada tipo de usuario habr manuales especficos, por lo que el presente es nica y exclusivamente dedicado al tipo de usuarios indicado.


. . 03/06/2008

Pgina 5 de 24Mod.MU


Versin 1.1

3

INTRODUCCIN

Para acceder a la aplicacin del Mantis se debe introducir en el navegador la url del mismo tras lo cual nos aparecer una pantalla que nos pedir que introduzcamos nuestro nombre de usuario y nuestra contrasea.

3.1 SOLICITAR UNA CUENTA NUEVASi no dispone de una cuenta, desde esta pantalla de identificacin tiene la posibilidad de Solicitar una Cuenta Nueva. Para ello, deber pulsar el enlace que aparece bajo el formulario de identificacin, el cual le conducir a una nueva pgina en la que le aparecer el siguiente formulario: En este formulario deber introducir el nombre de usuario que contendr las cuatro primeras letras de su nombre seguido de las cuatro primeras letras de su primer apellido y su direccin de correo electrnico, as como el cdigo de seguridad que aparece. Una vez haya realizado estos pasos y pulsado el botn de Suscribirse recibir un email en la direccin de correo electrnico que haya especificado, mediante el cual podr activar su nueva cuenta.


. . 03/06/2008

Pgina 6 de 24Mod.MU


Versin 1.1

3.2 RECORDAR CONTRASEASi ha olvidado la contrasea asociada a su usuario, la aplicacin le permite recuperarla. Para ello, desde la pantalla de identificacin deber pulsar el enlace Olvidaste la contrasea?, el cual le conducir a una nueva pgina en la que le aparecer el siguiente formulario: En este formulario deber introducir su nombre de usuario y la direccin de correo electrnico con la que se dio de alta. Una vez haya rellenado estos campos y pulsado el botn de Enviar, la aplicacin le enviar un email con una url que le permitir cambiar su contrasea y volver a tener acceso a la aplicacin del Mantis.


. . 03/06/2008

Pgina 7 de 24Mod.MU

Mantis: Manual de Usuario 4 FUNCIONALIDADES BSICAS

Versin 1.1

4.1 MEN SUPERIORA travs del men superior, la aplicacin le permitir ir a las diferentes secciones y funcionalidades, al tiempo que le ofrece cierta informacin y funcionalidades adicionales.

4.1.1 USUARIO En la parte superior izquierda del men, la aplicacin le muestra el usuario con el que se ha conectado, as como el rol del mismo. Se trata de una funcionalidad meramente informativa que servir para que, en caso de que una persona disponga de varios usuarios, sepa en todo momento con cual de ellos ha accedido a la aplicacin. 4.1.2 SELECCIONAR PROYECTO En la parte superior derecha del men se encuentra un desplegable mediante el cual podr seleccionar uno de los proyectos dados de alta en el Mantis, al tiempo que le da la posibilidad de verlos todos al mismo tiempo. La utilidad de esta funcionalidad radica en la posibilidad de filtrar las incidencias por proyectos, de tal manera que si usted es usuario actualizador del proyecto web podr seleccionar ver slo las de ste. Por defecto, la primera vez que entremos al Mantis, estar seleccionado Todos los Proyectos. Si se desea cambiarlo, deber seleccionar el proyecto que quiera en este desplegable y, a continuacin, pulsar el botn de cambiar. A partir de este momento slo ver las incidencias asociadas al proyecto seleccionado. La aplicacin le permite cambiar este filtro en cualquier momento y todas las veces que sea necesario. 4.1.3 SALTAR A BUG A la derecha del men encontrar esta funcionalidad que le permite introducir un nmero de incidencia (tambin denominada bug) para que, al pulsar el enlace Saltar a bug, la aplicacin le conduzca directamente al detalle de la misma.

4.2 ESTADO DE LOS BUGSUn bug se puede encontrar en los siguientes estados:


. . 03/06/2008

Pgina 8 de 24Mod.MU


Versin 1.1

Nuevo: En el momento en que un usuario informa de un bug en la aplicacin, ste quedar marcado con el estado de nuevo. Abierto: Este estado indica que el bug ha sido asignado a quien se encargar de resolverlo y se encuentra pendiente de correccin. Se necesitan ms datos: Si la persona que tiene asignado el bug o un administrador considera que la informacin que se ha introducido para la descripcin del bug es insuficiente, deber marcado con este estado para que el usuario que haya reportado el bug aada ms informacin. En proceso: Este estado indica que el encargado de corregir el bug ha comenzado su trabajo en l. Terminado: Este estado indica que el bug ha sido corregido pero no se encuentra disponible para la comprobacin por parte del informador. Est pendiente de actualizar el entorno de pruebas del informador. Pendiente de validar: Una vez que el bug ha sido llevado al entorno de pruebas del informador, el bug se marcar con este estado. Cerrado: Si el informador, tras verificar el funcionamiento, considera que el bug est corregido, lo marcar con este estado. 4.2.1 ESQUEMA DE FLUJOS DE ESTADOS EN MANTIS


. . 03/06/2008

Pgina 9 de 24Mod.MU


Versin 1.1

5

PGINA PRINCIPAL

Nada ms identificarse en la aplicacin, acceder a la pgina principal de la misma:

5.1 BUGS ABIERTOS Y ASIGNADOS A MBajo el men, en la parte izquierda, la aplicacin le mostrar el nmero de bugs (incidencias) que en ese momento se encuentran abiertas y que estn asignadas a su usuario. Dicho nmero es, al mismo tiempo, un enlace que, al pulsarlo, le conducir a la pgina Ver Bugs con los filtros oportunos para que slo le muestre el listado de bugs que cumplen las caractersticas antes mencionadas.

5.2 BUGS ABIERTOS Y REPORTADOS POR MBajo el men, en la parte derecha, la aplicacin le mostrar el nmero de bugs (incidencias) que en ese momento se encuentran abiertas y que han sido reportadas por su usuario. Dicho nmero es, al mismo tiempo, un enlace que, al pulsarlo, le conducir a la pgina Ver Bugs con los filtros oportunos para que slo le muestre el listado de bugs que cumplen las caractersticas antes mencionadas.

5.3

NOTICIAS

En esta pgina se mostrar tambin un listado con las ltimas noticias que se hayan dado de alta en el proyecto en el que usted se encuentre en ese momento. Asimismo la aplicacin le mostrar un enlace para ver el listado de todas las noticias y la posibilidad de suscribirse mediante RSS a las noticias de la aplicacin.


. . 03/06/2008

Pgina 10 de 24Mod.MU

Mantis: Manual de Usuario 6 MI VISTA

Versin 1.1

La pgina de Mi Vista muestra listados de bugs (incidencias) segmentados por diferentes filtros predefinidos en la aplicacin: No asignados: Mostrar el listado de bugs nuevos que estn pendientes de ser asignados a algn usuario del proyecto. Resueltos: Mostrar el listado de los ltimos bugs que hayan sido resueltos. Monitorizados por m: Mostrar el listado de aquellas incidencias que, aunque su usuario no haya participado en ningn estado de las mismas, la aplicacin le enva un mail cada vez que haya un cambio en la misma. Informados por m: Mostrar el listado de los ltimos bugs que su usuario haya dado de alta en la aplicacin. Modificado recientemente: Mostrar un listado de los ltimos bugs que se hayan modificado recientemente en la aplicacin

Bajo estos listados, la aplicacin le muestra, a modo informativo, el cdigo de colores que se utilizan para los diferentes estados en que se puede encontrar un bug o incidencia.


. . 03/06/2008


Mantis: Manual de Usuario 7 VER INCIDENCIAS

Versin 1.1

La pgina Ver Incidencias muestra un listado de todos los bugs presentes en la aplicacin, al cual se le pueden aplicar diferentes filtros que explicaremos a continuacin. Adems, en la parte inferior de esta pgina, la aplicacin le muestra, a modo informativo, el cdigo de colores que se utilizan para los diferentes estados en que se puede encontrar un bug o incidencia.

7.1 FILTROSEn la parte superior de la pgina de Ver bug se encuentra una tabla con una serie de filtros que se le puede aplicar al listado inferior y que nos permitir seleccionar las condiciones que deben cumplir los bugs que se muestran en el listado. Para poder modificar un filtro se debe pulsar sobre el nombre del mismo (en azul y subrayado). Al hacerlo se le desplegar la tabla de filtros, que quedar de la siguiente manera:

Los filtros que se pueden aplicar son los siguientes: Mostrar slo los bugs informados por un determinado usuario Mostrar slo los bugs monitorizados por un determinado usuario Mostrar slo los bugs asignados a un determinado usuario Mostrar slo los bugs de una categora concreta


. . 03/06/2008


Mantis: Manual de Usuario Mostrar slo los bugs de una determinada gravedad Mostrar slo los bugs que estn en un determinado estado de resolucin Mostrar slo los bugs que estn en un determinado estado Ocultar los bugs que estn en un determinado estado Mostrar slo los bugs que tengan una determinada prioridad

Versin 1.1

Seleccionar el nmero de bugs por pgina que desea que se muestren en el listado Mostrar slo los bugs con un determinado estado de acceso Mostrar slo los bugs que hayan cambiado en un determinado nmero de horas Mostrar los bugs entre determinadas fechas Mostrar slo los bugs que tengan una determinada relacin con otros Mostrar slo los bugs publicados entre determinadas fechas

Una vez haya seleccionado todos los filtros que desee deber pulsar el botn Filtrar que encontrar en la parte inferior derecha de la tabla de filtros. Al hacerlo, la aplicacin guardar los cambios, volver a plegar la tabla de filtros y le mostrar el listado de bugs aplicando el filtro seleccionado. 7.1.1 RESTAURAR FILTRO Este botn le permite eliminar todos los filtros seleccionados y volver al filtro preestablecido. 7.1.2 FILTRO AVANZADO Este botn le conducir a una nueva pgina en la que podr administrar ms ampliamente todos los filtros que le proporciona la aplicacin. Dicha pgina tendr una vista similar a la que muestra bajo este texto pero su funcionamiento es prcticamente igual que el sistema de filtros explicado anteriormente.


. . 03/06/2008


Mantis: Manual de Usuario 7.2 LISTADO

Versin 1.1

Tras la tabla de filtros, la aplicacin le mostrar el listado de bugs, cada uno con el fondo del color del estado en el que se encuentra. Este listado muestra la siguiente informacin de cada bug: Modificar: El smbolo del lpiz permite acceder al formulario de actualizacin del bug P [prioridad]: Permite, al pulsarlo, ordenar los bugs segn su prioridad. La prioridad se mostrar con unas flechitas rojas ID: Indica el identificador nico del bug, permitiendo ordenarlos por este campo. Adems, al pulsar sobre el identificador de cada uno de los bugs la aplicacin le mostrar la vista en detalle del bug en cuestin. #: En este campo se mostrar, si las hay, el nmero de notas que contiene el bug. Categora: Muestra la categora a la que pertenece el bug, permitiendo al mismo tiempo ordenar los bugs por este campo. Gravedad: Muestra la gravedad asignada a cada uno de los bugs, permitiendo al mismo tiempo ordenar los bugs por este campo. Estado: Muestra el estado en que se encuentra cada uno de los bugs (tambin indicado por el color de fondo), permitiendo al mismo tiempo ordenar los bugs por este campo. Actualizado: Muestra la ltima fecha en que cada uno de los bugs fue actualizado, permitiendo tambin ordenar los bugs por este campo Resumen: Muestra el texto introducido en el campo resumen de un bug, permitiendo al mismo tiempo ordenar el listado de bugs por este campo.

Adems, en este listado tambin podr realizar las siguientes acciones: Imprimir informes: Al pulsar este botn la aplicacin le mostrar una pantalla con el listado de bugs, desde la cual podr realizar las siguientes operaciones:


. . 03/06/2008


Mantis: Manual de Usuarioo o o o Exportar el listado a Excel. Exportar el listado a Word. Seleccionar una serie de bugs y mostrar slo esos. Imprimir el listado.

Versin 1.1

Exportar a CSV: Mediante este botn podr exportar el listado de bugs a CSV. Al pulsar dicho botn la aplicacin le mostrar una ventana indicando si desea ver CSV o guardarlo en su ordenador. Seleccionar todos: Le permite seleccionar todos los bugs del listado (mediante el checkbox que hay junto a cada bug puede seleccionar slo los que desee) para realizar sobre todos los seleccionados una de las acciones que muestra el desplegable que hay junto a l.

7.3 VISTA DETALLE DE UN BUG

Si desde el listado de bugs pulsa sobre el ID de uno de ellos, la aplicacin le conducir a la vista detalle del mismo. Esta vista le mostrar, adems toda la informacin introducida en el reporte del bug, las siguientes acciones: Actualizar bug: Le conducir a una nueva pantalla desde la que podr modificar todos los campos del bug.


. . 03/06/2008



Versin 1.1

Asignar a: Mediante un desplegable le permitir asignar el bug a la persona que deba realizarlo. Esta accin debe ser realizada siempre por un usuario administrador de la aplicacin. Cambiar estado a: Permite cambiar el estado actual de bug. Monitorizar incidencia: Al pulsar este enlace la aplicacin le enviar un email cada vez que se produzca un cambio en el bug en cuestin. Create Clone: Mediante este enlace podr duplicar el bug. Antes de que esta accin se realice, la aplicacin le mostrar el formulario de actualizacin del bug por si quiere realizar algn cambio en la copia que va a crear. Mover incidencia: Permite cambiar el bug de categora. Eliminar incidencia: Elimina el bug en cuestin. Relaciones: Permite relacionar el bug con otro que se encuentre en la aplicacin por alguno de los siguientes motivos: o o o o Estn relacionados. Depende uno de otro. Bloquea a otro bug. Estn duplicados.

Subir archivo: Permite subir un archivo que aada informacin sobre el bug como, por ejemplo, una captura de pantalla explicativa o un documento con un texto a introducir. Agregar nota: Permite agregar una nota explicativa al bug en cuestin. Acceso: Permite privatizar el bug para que slo tengan acceso a l las personas implicadas en el mismo.

7.3.1 CABECERA DE LA VISTA DETALLE DE UN BUG En la parte superior de la vista detalle de un bug encontrar las siguientes acciones: Saltar a notas: Le permite ir directamente a las notas que los diferentes usuarios hayan dejado en el bug en el que se encuentra.


. . 03/06/2008



Versin 1.1

Enviar un recordatorio: Esta accin le permite enviar un recordatorio a un determinado usuario. Al pulsar el botn, la aplicacin le mostrar un listado de usuarios en el que deber seleccionar aquel al que desee enviarle el recordatorio. Junto a este listado, aparecer un campo de texto donde podr escribir aquello que desee que le llegue al usuario seleccionado. Cambiar a vista avanzada: Esta accin le permitir cambiar a la vista avanzada de un bug en la que se muestran ms campos e informacin sobre el mismo. Habitualmente la vista simple es suficiente para trabajar adecuadamente con el bug. Historial del Bug: Le permite ir directamente al historial del bug en el que se muestra un listado de las diferentes acciones realizadas por los usuarios sobre el bug en el que se encuentre. Imprimir: Este botn le permitir imprimir el detalle del bug en el que se encuentre

7.3.2 NOTAS Bajo la vista detalle de un bug encontrar una seccin denominada Notas en la que podr ver todas las notas que los diferentes usuarios de la aplicacin han dejado en relacin con dicho bug. Como se puede observar en la imagen superior, este listado de notas le mostrar el usuario que ha escrito la nota, el da, la hora y el contenido de la nota. En aquellas notas que hayan sido escritas por su usuario encontrar dos acciones: . Editar: Le permitir modificar el contenido de la nota. Eliminar: Le permitir eliminar la nota.

7.3.3 HISTORIAL

Bajo las notas de un bug, si las hay, encontrar un breve historial del bug que le mostrar los diferentes cambios que se han realizado sobre l indicando la fecha y hora


. . 03/06/2008



Versin 1.1

del cambio y el usuario que lo ha realizado. Las acciones que se mostrarn en este listado son: Momento en que se dio de alta la incidencia Asignacin de la incidencia a un usuario Cambios de estado Notas aadidas


. . 03/06/2008


Mantis: Manual de Usuario 8 INFORMAR DE BUG

Versin 1.1

Este apartado permite introducir un nuevo bug en la aplicacin.

A la hora de crear un nuevo bug encontrar los siguientes campos: Categora: Desplegable que le permitir seleccionar la categora a la que pertenece el bug. Reproducible: Desplegable que permite indicar en qu casos se produce el bug. Al tratarse de actualizaciones de contenidos es mejor que en este campo se use la opcin Siempre. Gravedad: Esta opcin sirve para indicar la gravedad del bug a travs de los siguientes estados: o Funcionalidad: Este estado sirve para indicar que lo que falla es una funcionalidad de la aplicacin por lo que, en este caso, al tratarse de actualizaciones de contenidos, no deber usarse. Trivial: Este estado indica que el error no tiene mucha importancia. Texto: Este estado es el que deber usarse por defecto ya que indica que la incidencia que se est reportando hace referencia a un texto.

o o


. . 03/06/2008


Mantis: Manual de Usuarioo

Versin 1.1

Ajuste: Este estado indica que el bug en cuestin es un simple ajuste y no una modificacin o error grave. Menor: Este estado indica que la incidencia que se est reportando, a pesar de tratarse de un error, tiene una importancia relativa. Mayor: Este estado indica que el error que se reporta en el bug es importante, por lo que se le debe dar prioridad. Cuelgue: Este estado sirve para indicar que el bug que se est reportando es un fallo que no permite realizar a la aplicacin su funcionamiento habitual. Se utilizar en pocas ocasiones pero, por ejemplo, se podra dar cuando un enlace estuviera mal hecho y condujera a una pgina de error. Bloqueo: Este estado indica que el bug que se est reportando es un fallo que bloquea la aplicacin por lo que, en este caso, al tratarse de actualizaciones de contenidos, no deber usarse.

o

o

o

o

Resumen (obligatorio): Frase descriptiva del bug. Descripcin (obligatorio): Descripcin detallada del bug. Informacin adicional: Campo que permite aadir ms informacin al bug.. Archivo: Permite subir un archivo que aada informacin sobre el bug como, por ejemplo, una captura de pantalla explicativa o un documento con un texto a introducir. En este formulario podr subir un nico archivo. Si desea subir ms de un archivo a un mismo bug deber guardarlo y, a continuacin, volver a acceder a l para modificarlo.

Acceso: Permite privatizar el bug para que slo tengan acceso a l las personas implicadas en el mismo. . Continuar informando: Al marcar esta casilla y guardar el bug, el sistema le conducir de nuevo al formulario de creacin de un nuevo bug.

Adems de estos campos, existe la posibilidad de ir al Informa Avanzado que es el mismo informe pero con algunos campos aadidos que le permitirn indicar informacin ms detallada del mismo. No obstante, no ser necesaria la utilizacin de esta opcin.


. . 03/06/2008


Mantis: Manual de Usuario 9 LOG DE CAMBIOS

Versin 1.1

Esta seccin es un apartado reservado para mostrar informacin relativa a las diferentes actualizaciones de la aplicacin.


. . 03/06/2008


Mantis: Manual de Usuario 10 DOCUMENTOS

Versin 1.1

En esta seccin se puede consultar informacin y documentacin relacionada con el proyecto que los usuarios administradores hayan subido previamente.


. . 03/06/2008


Mantis: Manual de Usuario 11 MI CUENTAEsta seccin permite modificar los datos del usuario con el que se haya logueado.

Versin 1.1

11.1 MI CUENTA

En primer lugar, la aplicacin le mostrar el formulario de edicin de su cuenta permitindole cambiar los siguientes campos: su contrasea el email en el que recibe las notificaciones su nombre real


. . 03/06/2008


Mantis: Manual de Usuario 11.2 PREFERENCIAS

Versin 1.1

En la seccin de Preferencias podr configurar determinados parmetros de la aplicacin para su usuario, tanto para todos los proyectos como para uno en particular. As, podr configurar el envo de mails, el tipo de informes, etc.

11.3 PERFILESEn la seccin de perfiles podr administrar (crear y modificar) los diferentes perfiles que tendr su usuario de la aplicacin.


. . 03/06/2008


mantis manual

Documents