manual de mantis bug tracker - usuario 1

A2-B A

MANUAL DE USUARIO DE MANTIS BUG TRACKER

2010Casa Central: + 54 0351 4817951 - Tel Bs As Argentina: 011 53685847 - Tel Londres UK: 00442033183814 Tel San Francisco. EEUU: 001 14157041515 - E-mail: [email protected]

Av. Rafael Nez 3612 2do piso Oficina 11. Crdoba Argentina. TEL: 0054 - 0351 - 4817951

ndice1. Descripciones ...................................................................................................................................................3 1.1 Pgina de logueo ............................................................................................................................................... 3 2. Pantalla principal ..............................................................................................................................................6 2.1 Pgina Principal Main Page ............................................................................................................................ 6 3. Vistas ................................................................................................................................................................8 3.1 Mi vista My View ............................................................................................................................................ 8 3.2 Vista de la pgina de bugs View Bugs Page .................................................................................................... 8 3.3 Vista detallada del bug .................................................................................................................................... 12 3.3.1 Pgina de Bugs con vista simple/avanzada Bug view simple/advanced page ........................................ 14 3.3.2 Actualizar Incidencia Simple/Avanzada Bug Upload Simple/Advanced page ......................................... 15 3.3.3 Pgina de cambio de estado del bug Bug Change Status Page ............................................................... 15 3.3.4 Monitorear Incidencias Monitor Issues .................................................................................................. 16 3.3.5 Reabrir Incidencias Reopen Issue ........................................................................................................... 16 3.3.6 Eliminar Incidencias Delete Bug .............................................................................................................. 16 3.3.7 Cerrar Bug Close Bug .............................................................................................................................. 16 3.3.8 Asignar a Assign to .................................................................................................................................. 17 3.3.9 Resolver Bug Resolve bub ....................................................................................................................... 17 3.3.10 Clonar Incidencia Create Clone ............................................................................................................. 17 3.3.11 Mover Incidencia Move Issue ............................................................................................................... 17 4. Reportar Bugs .................................................................................................................................................18 4.1 Reportar Incidencia Report Issue ................................................................................................................. 18 4.2 Vista Avanzada de Reportar Issues.................................................................................................................. 19 5. Registro de cambios Change Log ..................................................................................................................20 6. Plan de trabajo Roadmap .............................................................................................................................23 7. Resumen Summary ......................................................................................................................................25 8. Documentacin Docs ...................................................................................................................................27 8.1 Documentacin del usuario - User documentation ........................................................................................ 27 8.2 Documentacin del proyecto - Project documentation .................................................................................. 27 8.3 Agregar archivo - Add file ................................................................................................................................ 28 9. Administracin - Manage ................................................................................................................................29 9.1 Administrar Usuarios - Manage Users ............................................................................................................. 29 9.2 Administrar proyectos - Manage Projects ....................................................................................................... 31 9.3 Administrar campos personalizados - Manage Custom Fields ........................................................................ 33 9.4 Administrar perfiles globales - Manage Global Profiles .................................................................................. 36 9.5 Administrar configuracin - Manage Configuration ........................................................................................ 37 9.5.1 Reporte de Configuracin - Configuration Report ..................................................................................... 37 9.5.2 Informe de permisos - Permissions Report ............................................................................................... 38 9.5.3 Lmites de flujo de trabajo - Workflow Thresholds.................................................................................... 38 9.5.4 Transicin de estados - Workflow Transitions ........................................................................................... 39 9.5.5 Notificaciones por Correo - E-mail Notifications ........................................................................................ 40 10. Editar noticias Edit News............................................................................................................................41 11. Mi cuenta My Account ...............................................................................................................................42 11.1 Mi cuenta - My Account ................................................................................................................................ 42 11.2 Preferencias - Preferences ............................................................................................................................ 42 11.3 Perfiles - Profiles ............................................................................................................................................ 43

2


1. Descripciones1.1 Pgina de logueo Para ingresar al sitio, debe introducir el nombre de usuario, contrasea y pulse el botn Login. Tambin, puede seleccionar la opcin Guardar sesin (Save login). Es necesario que tenga las cookies correspondientes habilitadas para ingresar. Si la cuenta no existe, est desactivada o la contrasea es incorrecta se mostrar el siguiente mensaje de error: Su cuenta puede ser inhabilitada, bloqueada o el nombre de usuario/contrasea que ingres es invlido (Your account may be disabled or blocked or the username/password you entered is incorrect). El administrador puede permitir que los usuarios se suscriban a sus propias cuentas. De ser as, se mostrar el link Inscrbase. Tambin es posible que haya seleccionado que se permita el acceso a usuarios annimos, estos iniciaran sesin bajo una cuenta comn. Luego de iniciar sesin, podr seleccionar un proyecto para trabajar, la eleccin puede ser, por defecto, en la pantalla de seleccin de proyectos o en opciones de la cuenta.

Si hace click en el nmero de la versin (del lado izquierdo, en el pie del sitio) o en el logo de Mantis que se encuentra en la parte inferior del sitio (del lado derecho) se deriva al sitio oficial de Mantis (http://www.mantisbt.org/). Cuando sea necesario se colocar debajo de la versin el correo electrnico del webmaster. Estos tres conos detallados estarn presentes en todo momento en la parte inferior del sitio, sin importar en qu seccin se encuentre. Inscrbase Signup En esta opcin puede registrarse para obtener una nueva cuenta. Es necesario que coloque una direccin de correo electrnico vlida y seleccione un nombre de usuario (debe ser nico). Tambin, se colocar un cdigo que deber ser copiado en el campo correspondiente y luego debe hacer click en el botn Signup. La contrasea es generada al azar y ser enviada al e-mail detallado. Si Mantis se configura de modo que la contrasea no debe ser enviada por correo se le asignar una contrasea vaca. La pantalla tambin cuenta con las opciones de Login (regresa a la pantalla anterior) y Olvid su contrasea? (deriva a la pantalla correspondiente, donde podr resetear la contrasea).

3


Olvid su contrasea? Lost your password? Para restablecer la contrasea, es necesario que coloque el nombre de usuario y la direccin de e-mail registrada, una vez completos estos campos debe hacer click en el botn Submit. Si los datos corresponden a una cuenta vlida, ser enviado en un correo electrnico con una URL especial que contiene un cdigo de validacin para su cuenta. sta pantalla contiene una opcin de Login (regresa a la pantalla de logueo, punto 1.1 Pgina de logueo, pgina 3) e Inscrbase (se re direcciona a la pantalla mencionada anteriormente para crear un nuevo usuario, ver punto Inscrbase en la pgina 3).

Las pantallas detallas son en ingls, luego de ingresar al sitio se mostrar en el idioma elegido. La siguiente imagen muestra en detalle los componentes de la parte superior de la pantalla luego del logueo. Estos se estarn activos y visibles mientras el usuario se encuentre logueado, sin importar la seccin en la que se encuentre.

4


A- Nombre de usuario, nombre, apellido y perfil de usuario. B- Fecha y hora actual. C- Proyecto: Es un men desplegable con el nombre de todos los proyectos vigentes, una vez seleccionado el que se desea para ir a la vista correspondiente al mismo se debe hacer click en el botn Cambiar (Switch). Luego, se mostrar all el nombre del proyecto elegido. D- RSS: Al hacer click en este botn se deriva al sitio RSS. E- Incidencia# (Issue#): para buscar una issue en especial, si se conoce el nmero, se debe colocar en ese campo el ID y pulsar en Ir a Incidencia (Jump) para efectuar la bsqueda. F- Logo Mantis: Al clickear en este logo se deriva al sitio http://www.bugzilla.com.ar/mantis. G- Men superior: Este men se encuentra siempre visible, y se desarrollar cada opcin en los puntos siguientes. H- Cerrar Sesin: Al hacer click en esta opcin se cerrar la sesin del usuario en forma segura (logout).

5


2. Pantalla principal2.1 Pgina Principal Main Page Es la primera pantalla que se muestra al iniciar sesin. Contiene las ltimas actualizaciones del bugtracker. Es un mdulo sencillo de noticias y es utilizado para mantener informados a los usuarios de los cambios en el bugtracker o en el proyecto. Algunos anuncios son especficos del proyecto y otros son globales (del sitio entero). Esto se establece en el momento de publicar en el punto 10. Editar Noticias Edit News (ver pgina 41). El nmero de vistas de noticias est controlado por una variable global. Cuando la cantidad de publicaciones supera ese lmite, se mostrar el link Mostrar noticias anteriores en la parte inferior. Del mismo modo una Nueva noticia se muestra al hacer click en Noticias Anteriores. En la opcin Archivos, en la parte inferior del sitio, podr ver todos los listados. A esta seccin se accede tambin, haciendo click en la opcin Principal del men superior.

Archivo de Noticias Archive Al hacer click en esta opcin se muestran un listado de todos los artculos y el detalle de cada uno: el ttulo, fecha, usuario creador y si es pblico o privado. Haciendo click en el enlace (ttulo) se mostrar el artculo especificado. En la lista, se encuentran los elementos que son globales o especficos para el proyecto seleccionado.

6


RSS Al hacer click en esta opcin se deriva a la siguiente pantalla donde se muestra el detalle de la noticia, el destinatario y tiene la posibilidad de suscribirse al canal. Si pulsa sobre el ttulo se derivar a la pantalla de Mantis que contiene la noticia ampliada.

7


3. Vistas3.1 Mi vista My View Esta opcin muestra resumidamente los bugs que han sido modificados o cambiados de estado en el ltimo tiempo para un proyecto en especial seleccionado en el men superior. Se encuentran separados segn: No asignadas, Reportadas por m, Resultas, Modificadas recientemente y Monitorizadas por m, en cada cuadro se muestran los bugs correspondientes y la cantidad que contenga depender de los ltimos cambios, por defecto son hasta 10. Las filas se encuentran de un color diferente en base a la situacin en que est el bug. Se muestra el nmero de bug, el Resumen o Summary, la fecha y hora de la modificacin. Al hacer click en el nmero del bug mostrar el contenido completo del bug (ver el punto 3.3.1 Pgina de bugs con vista simple/avanzada Bug View simple/advanced page, pgina 14). Si desea modificar el proyecto a visualizar, debe seleccionar el deseado en el men desplegable que se encuentra por encima del men superior y hacer click en el botn Cambiar. En la siguiente foto se muestran, excepcionalmente, todos los bugs en estado Nuevos (New).

3.2 Vista de la pgina de bugs View Bugs Page Es la tercera opcin del men superior. Aqu se muestra un listado de los bugs que han sido reportados en el proyecto elegido en el men desplegable. La cantidad de bugs a visualizar por pantalla va a depender de las configuraciones que haya elegido el administrador, por defecto, se presentan hasta 50 bugs por pantalla (en la imagen mostrada ms abajo se colocan menos). Debajo del men principal, del lado derecho se coloca el nmero del ltimo/s bug visto. Y en el costado izquierdo, en negrita se informa la cantidad de issues mostradas en la pantalla (por ejemplo: 1 50 / 70 indica que se muestra desde el bug 1 hasta el 50 y /70 marca la cantidad de bugs totales que pertenecen a este proyecto). La pgina contiene un conjunto de visualizacin de filtros en la parte superior y los bugs se enumeran por debajo. A continuacin se muestra un modelo de la pantalla perteneciente a esta seccin.

8


Filtros Los filtros se guardan entre sesiones pero, actualmente, no conservan el orden ni la direccin. Si el nmero de bugs supera la muestra (Show) que, por defecto son 50 por pantalla, se mostrar en el costado superior derecho (debajo del men principal) un filtro de navegacin para ir a la Primera, ltima, Anterior, Siguiente y el nmero de pginas para seleccionar una en especial (First, Last, Previous, Next), al hacer click en cualquiera de estas opciones se mostrar la pgina seleccionada con los bugs. Todas poseen el mismo diseo. Los bugs se muestran en una tabla y los atributos se enumeran en el siguiente orden: prioridad (P), ID, Nmero de bugnotes (#), Categora, Severidad, Estado, Actualizada por ltima vez (Updated) y Resumen (Summary). Cada columna es un filtro, ya que al hacer click en el ttulo de la misma, excepto de bugnotes, se modifica el orden en que aparece la informacin de ascendente a descendente y pulsando de nuevo invierte la direccin. El valor predeterminado es ordenar por la ltima modificacin (el bug que fue modificado por ltimo es el primero que se muestra en la parte superior de la tabla). Para seleccionar uno o ms bugs en especial se debe clickear en el cuadro que se encuentra en la primer columna de la izquierda o utilizando la opcin Seleccionar todos (Select All) que se encuentra en la parte inferior del sitio. Si se desea volver a la configuracin predeterminada, en la parte superior del sitio se muestra el botn Reiniciar Filtros (Reset Filter), y para guardarlos debe hacer click en Guardar Filtro Actual (Save Current Filter). Bsqueda Search El campo de bsqueda es para buscar una palabra clave en el resumen, la descripcin, los pasos para reproducir, la informacin adicional, el ID del bug o el bug. No busca a travs de las bugnotes. Una vez detallado el texto a buscar debe hacer click en el botn Filtrar (Apply Filter). A la izquierda de Buscar se encuentra un botn que puede ser el signo menos (-) o ms (+), esto indica si est cerrada (+) o abierta (-) la bsqueda avanzada. Esta es un cuadro con diversas opciones por ejemplo Reportado por, Monitoreado por, OS, entre otras. Se muestran en dos renglones, el ttulo por encima y la opcin elegida por debajo. Si se hace click en el ttulo se mostrar un men desplegable para poder modificar la eleccin.

9


Lista de bugs La informacin que se muestra de cada bug es la correspondiente a las columnas indicadas anteriormente en el punto Filtros (ver pgina 9). El ID es un link que conduce al informe detallado sobre el bug y, dependiendo de lo definido en Preferencias de la cuenta, se le mostrar una vista simple o avanzada. Tambin se pueden aadir bugnotes aqu. Cada fila de la tabla est codificada por colores segn el estado en que se encuentre la issue. Los colores se pueden personalizar a travs de la configuracin de Mantis. El texto de las columnas se colocar en negrita cuando: Se agrega una nueva bugnote, en ese caso se coloca el nmero de la Bugnote en negrita. Cuando no hay ninguna para ese bug, esta columna se encuentra vaca. Cuando la gravedad es mayor, fallo o bloqueante y el bug no se resuelve, el texto de la columna Severidad se coloca en negrita. Si el bug ha cambiado en las ltimas horas, en la columna Updated. Niveles de gravedad Bloqueante Block: Por causa de este bug no se puede seguir trabajando o ejecutando. Fallo Crash: Se produjo un accidente en la aplicacin o sistema que se est testeando. Mayor Major: Es un bug grave, vara su descripcin dependiendo del objeto testeado. Menor Minor: Son bugs con una gravedad leve. Texto Text: Bugs que se encuentran en los textos, por ejemplo errores de ortografa. Triviales Trivial: Bugs con gravedad ms baja que Menor, generalmente no funcionales. Funcionalidad Feature: Para solicitar una nueva funcin o caracterstica. Estado Pasando el mouse sobre el nombre del estado se mostrar la resolucin correspondiente. En algunos navegadores se ver como una burbuja o como un texto de la lnea de estado. Los estados de los bugs pueden ser: Nueva New: Es el primer estado en que se encuentra el bug, es luego de la creacin. Necesita ms datos Feedback: El bug requiere ms informacin (retroalimentacin). Aceptada Acknowledged: El bug fue observado (reconocido) pero no confirmado o asignado. 10


Confirmada Confirmed: El bug pudo ser reproducido, generalmente lo marcan los desarrolladores. Asignada Assigned: El bug est asignado a un desarrollador para su solucin. Resuelta Resolved: El bug est resuelto pero se necesita la confirmacin de ello. Cerrada Closed: El bug est cerrado, no se produce ms o por indicacin del cliente. En la parte inferior del sitio se muestra una barra de colores que all indica el estado del bug segn el color de la fila. Opciones En la parte superior del sitio se muestran los siguientes links: Filtros Avanzados Advanced Filters: Se utiliza para realizar una bsqueda avanzada. Crear enlace permanente Create Permalink: Para crear un link con los filtros creados de manera permanente. Al hacer click all se deriva a una pantalla donde se muestra el link creado con la leyenda: El siguiente es un enlace permanente para el filtro actualmente definido (Following is a permanent link to the currently configured filter). Exportar a CVS CVS Export: se abrir un pop-up para que el usuario seleccione si desea solamente abrir el archivo como Documento de Texto o guardarlo en la computadora. Imprimir Informes Print Reports: En esta opcin se mostrar la tabla correspondiente al listado de bugs (no importa la cantidad, todos se visualizan en la misma pantalla) con las opciones de importar estos en un archivo Excel, Word o de Internet Explorer. Solamente se debe hacer click en el cono perteneciente a cada opcin y confirmar su ubicacin. Las filas se encuentran separadas por colores pero solamente para ayudar a la visualizacin por parte del usuario y no segn el estado. En la parte inferior se muestra el botn Mostrar slo seleccionados (Display selected only) ya que se pueden elegir los bugs a visualizar marcando los deseados en la primer columna de la izquierda y luego haciendo click en este botn. En la parte inferior, a la derecha del ttulo Mostrando incidencias, se indica la cantidad de bugs visualizados. Nota: La tabla mostrada es similar a que se encuentra en View Issues, por lo tanto los filtros y el nmero de issue cumplen las mismas funciones detalladas en este punto.

Men desplegable Luego de la lista de bugs, se encuentra un men desplegable con las opciones: Mover, Copiar, Asignar, Cerrar, Eliminar, Resolver, Fijar/Desfijar, Cambiar Prioridad, Cambiar Estado, Cambiar Categora, Cambiar Visibilidad, Aadir nota, Adjuntar Etiquetas, Actualizar Resuelta en versin 11


y Actualizar Previsto para versin (Move, Copy, Assing, Close, Delete, Resolve, Set/Unset Sicky, Update Priority, Update Status, Update Category, Update View Status, Add Note, Attach Tags, Update Fixed in Version, Update Target Version). Primero, el usuario debe seleccionar uno, ms o todos los bugs, marcando el cuadro que se encuentra en la primera columna (a la izquierda del nmero de issue) o en Seleccionar todos, luego elegir la opcin deseada de este men y clickear en el botn Aceptar (OK). Al hacerlo se derivar a otra pantalla donde debe confirmar su decisin. Alli, se muestra en la parte inferior un men desplegable con los proyectos disponibles, el botn para hacer efectiva la accin (cambia el nombre dependiendo la accin solicitada por el usuario) y en la parte inferior se muestra el Resumen del bug y su nmero (pulsndolo lo llevar a la vista detalla del bug). A continuacin se muestra la pantalla correspondiente, luego de haber elegido una accin.

Editar En la segunda columna se encuentra el cono , al hacer click all, se derivar a la pantalla del detalle del bug. En ella el usuario puede modificar la informacin introducida previamente en el bug. El formulario que se muestra es el mismo que el utilizado en el momento de la creacin del bug, solamente que se visualizan los campos con la informacin previamente incorporada. Para saber cmo crear un bug ver punto 4. Reportar Bugs (pgina 18).

3.3 Vista detallada del bug Cuando se hace click en el nmero del bug se muestra la siguiente pantalla:

12


Opciones: Visitadas recientemente Recently Visited: Se muestra el nmero de los ltimos bugs vistos. Imprimir Print: Deriva a la vista de impresin del bug. Cambiar a Vista Simple View Simple: Al hacer click aqu se cambia de vista avanzada a simple, cuando sucede esto, la opcin cambia a Cambiar a Vista avanzada (View Advanced). Ver punto 3.3.1 Pgina de vista simple/avanzada (pgina 14). Flechas >> y siguiente y

manual de mantis bug tracker - usuario 1

Documents

bug bug change status

cerrar bug close bug

mantis bug tracker

bugs view bugs page

reportar bugs

resolver bug resolve

pgina principal main

vista avanzada