relman CLI: Tasks & Bugs

← Volver al resumen de comandos de la CLI de relman

Tareas y errores

Las tareas se encuentran bajo un proyecto; los errores se encuentran bajo una tarea y solo se puede acceder a ellos a través de esta; no existe un atajo para «mostrar todos los errores de un proyecto».

list tasks <org-token> <pg-token> <project-token> (alias: task, t)

Recupera el identificador y el nombre de todas las tareas que pertenecen al proyecto identificado por <identificador-del-proyecto>. Las tareas se enumeran de forma plana, no como el árbol de padres e hijos que muestra la interfaz de usuario web; este comando solo necesita saber «qué tareas tiene este proyecto», no su jerarquía.

describe task <org-token> <pg-token> <project-token> <task-token> (alias: tasks, t)

Recupera y muestra el nombre de la tarea, los archivos efectivamente permitidos (los paquetes de restricciones del proyecto, filtrados por la lista blanca de la propia tarea si dispone de ella), la descripción en todas las configuraciones regionales traducidas, la definición de «Listo», la fase, la prioridad, las historias de usuario, los valores de los campos personalizados, los requisitos de seguridad y cualquier traducción automática de la descripción que aún esté pendiente o haya fallado.

list bugs <org-token> <pg-token> <project-token> <task-token> (alias: bug, b)

Recupera el ID y el nombre de todos los errores de la tarea identificada por <task-token>. Solo se puede buscar un error de esta manera; no existe un comando «list bugs» para todo un proyecto.

describe bug <org-token> <pg-token> <project-token> <task-token> <bug-token> (alias: b)

Recupera y muestra el nombre del error y los archivos efectivamente permitidos (los paquetes de restricciones del proyecto, filtrados primero por la lista blanca de la tarea y luego por la del propio error, cada uno de ellos solo si existe).

añadir error <token-org> <token-pg> <token-proyecto> <token-tarea> <nombre> <definición-del-nombre-de-finalización> [<nombre-fase>] (alias: b)

Crea un nuevo error y lo vincula a la tarea identificada por <task-token>; <name> se convierte en el nombre de laboratorio del error. <definition-of-done-name> es obligatorio y debe coincidir con un nombre dentro del proyecto; consulta «definitionsOfDone» del proyecto para ver los valores disponibles. [<nombre-de-fase>] es opcional y se compara por nombre dentro de la organización del proyecto; consulta la sección «ticketPhases» del proyecto; omítelo para dejar la fase del error sin establecer.

Ejemplos

1. Listado de las tareas de un proyecto

Se da por hecho que los indicadores globales (--domain/--cert) están configurados mediante variables de entorno y, por lo tanto, se omiten a continuación; véase Utilidades e indicadores globales.

$ relman list tasks o-4kNc8Q pg-8mZ2Lx p-Qv73Tn
- id: t-Nc2Xp8
  nombre: Rediseño del proceso de pago
- id: t-Wq91Zk
  nombre: Corregir la navegación en dispositivos móviles

Caso especial: las tareas se muestran de forma plana, no como el árbol de tareas principales y secundarias que muestra la interfaz de usuario web; aquí, una subtarea aparece en su propia fila sin indicación alguna de su tarea principal.

2. Descripción de una tarea

$ relman describe task o-4kNc8Q pg-8mZ2Lx p-Qv73Tn t-Nc2Xp8
nombre: Rediseño del proceso de pago
fase: En curso
prioridad: 3,5
definición de «listo»: Maquetas aprobadas
descripciones:
  - configuración regional: en-US
    texto: Rediseñar el flujo de pago para dispositivos móviles.
historias de usuario: []
campos personalizados: []
requisitos de seguridad: []
traducciones pendientes: []

Caso especial: «traducciones pendientes» enumera cualquier traducción automática de descripciones que aún esté pendiente o haya fallado, indicando el motivo del fallo; una lista vacía significa que todas las traducciones se han realizado correctamente (o que nunca se solicitó ninguna), no que la traducción esté desactivada.

3. Crear un error

$ relman add bug o-4kNc8Q pg-8mZ2Lx p-Qv73Tn t-Nc2Xp8 «El precio total parpadea al cargarse» «Probado en el entorno de staging» QA
id: b-P4tRj9

Caso especial: «Probado en el entorno de pruebas» y QA deben coincidir exactamente con una entradade definitionsOfDone/ticketPhases del proyecto describe (véase la página «Organizaciones y proyectos» ); omite por completo el argumento de fase final para dejar la fase del error sin definir, en lugar de pasar una cadena vacía.