Cada incidencia en ISO Mate tiene una clave única, que se muestra como su título y se compone de un prefijo y un número secuencial, como PROJ-12 o USR-5. El prefijo proviene del proyecto de la incidencia cuando pertenece a uno y, de lo contrario, del tipo de incidencia. El número aumenta de forma automática para cada prefijo dentro de tu cuenta.
Claves basadas en el proyecto
Cuando creas un proyecto desde la página Proyectos del grupo DevOps, le asignas una clave de 2 a 10 letras o números en mayúsculas. La clave se fija al crearla y no se puede cambiar después. Cada incidencia que creas dentro de ese proyecto toma la clave del proyecto como prefijo, así que un proyecto con la clave PROJ produce PROJ-1, PROJ-2, PROJ-3, etc., sea cual sea el tipo de incidencia. Esto agrupa todo el trabajo de un proyecto bajo un único prefijo reconocible.
Eliges el proyecto de una incidencia en el cuadro de diálogo de creación de incidencias o, más tarde, en el campo Proyecto de la vista de detalle de la incidencia. Si lo dejas en Sin proyecto, la incidencia pasa a usar una clave basada en el tipo.
Claves basadas en el tipo
Cuando una incidencia no está vinculada a un proyecto, ISO Mate construye el prefijo a partir del tipo de incidencia:
- EPC: Épicas, por ejemplo EPC-1, EPC-2, EPC-3.
- USR: Historias, por ejemplo USR-1, USR-2, USR-3.
- TSK: Tareas, por ejemplo TSK-1, TSK-2, TSK-3.
- BUG: Errores, por ejemplo BUG-1, BUG-2, BUG-3.
- SUB: Subtareas, por ejemplo SUB-1, SUB-2, SUB-3.
Cómo funciona la numeración
Cada prefijo tiene su propio contador dentro de la cuenta, así que podrías tener de PROJ-1 a PROJ-20 junto con TSK-1 a TSK-50 y BUG-1 a BUG-12 al mismo tiempo. Una incidencia nueva toma el siguiente número después de la clave más alta que exista para su prefijo.
Las claves son estables
Una incidencia conserva la clave que recibió al crearse. Cambiar una incidencia de Tarea a Error, por ejemplo, no reescribe su clave, por lo que las referencias en mensajes de commit, comentarios, documentación y herramientas externas siguen siendo válidas con el tiempo.
Encontrar incidencias por clave
La clave aparece allí donde se hace referencia a una incidencia: como título de la incidencia, en los enlaces de subtareas, en las tablas de sprints y versiones, y en los nombres de rama de Git generados para la incidencia. Puedes buscar incidencias y filtrar por proyecto para ver todo lo que hay bajo un mismo prefijo de proyecto. A través del servidor MCP de ISO Mate también puedes obtener una incidencia directamente por su clave, como PROJ-7, y filtrar incidencias por una clave exacta o por un prefijo.