Guía del usuario
El panel de checklist está integrado en la vista de incidencias de Jira para todos los proyectos en los que está habilitado. No hay nada que expandir, ninguna pestaña adicional, ni ningún plugin que ejecutar: abra una incidencia y el checklist ya estará ahí.
Dónde se encuentra el checklist
- Vista de incidencia — se renderiza de forma nativa debajo de la incidencia, con un indicador de progreso
3/5 Doneen la parte superior del panel. - Tarjetas del tablero (Kanban / Scrum) — la finalización se muestra como una insignia de porcentaje numérico a través del campo personalizado Checklist Progress.
- Modal de creación de incidencia — añada y marque elementos mientras crea la incidencia. El estado se mantiene al enviar.
- Modal de transición — los elementos obligatorios se pueden marcar como parte de una transición de flujo de trabajo. El estado se mantiene al enviar.
- Portal del cliente de JSM — vista de solo lectura, cuando lo habilita su administrador.
Checklist Hub
Puede acceder al Checklist Hub directamente desde el menú de navegación superior de Jira. Este panel a página completa actúa como su centro de mando personal para los checklists:
- Mi trabajo incompleto (My Incomplete Work) — Vea hasta 25 incidencias que se le han asignado o con las que ha interactuado y que aún tienen checklists incompletos. La lista muestra la clave de la incidencia (enlace profundo en el que se puede hacer clic), el resumen, el estado y una barra de progreso
marcado / totalpara que sepa exactamente qué está pendiente. - Plantillas recientes (Recent Templates) — Explore una cuadrícula con las seis plantillas globales que ha utilizado más recientemente. Cada tarjeta muestra el nombre de la plantilla, el recuento de elementos y el recuento de incidencias vinculadas, ofreciéndole una vista rápida de los procedimientos estándar disponibles.
Trabajar con elementos
Cualquier persona con el permiso Editar incidencias (Edit Issues) en el proyecto puede gestionar el checklist. Los usuarios con el permiso Explorar proyectos (Browse Projects) solo lo verán en modo de solo lectura.
- Añadir un elemento — escriba en el campo de entrada en la parte inferior del panel y pulse Intro. El texto del elemento está limitado a 500 caracteres; un checklist puede contener hasta 50 elementos.
- Marcar / desmarcar — un solo clic. La barra de progreso se actualiza al instante sin necesidad de recargar la página, y se envía una notificación de Jira a los observadores y al responsable si su administrador ha habilitado la opción Notificar al completar un elemento (Notify on item completed).
- Marcar / desmarcar por lotes — seleccione varios elementos y cambie su estado en una sola operación.
- Edición en línea — haga clic en el texto del elemento para editarlo directamente.
- Eliminar — utilice la acción en línea del elemento.
- Reordenar arrastrando y soltando (Drag-and-drop) — agarre el control y suelte el elemento donde desee.
- Nombres para mostrar — los elementos marcados muestran el nombre del usuario que los marcó, resuelto a partir de su ID de cuenta de Atlassian.
- Filtrar la vista — cambie entre Todos (All), Completados (Completed) e Incompletos (Incomplete) para enfocar la lista.
Markdown y texto enriquecido
Los elementos admiten un subconjunto útil de Markdown para enlazar a runbooks, páginas de Confluence o evidencias externas:
| Sintaxis | Se renderiza como |
|---|---|
**bold** | negrita |
*italic* | cursiva |
`code` | código en línea |
[link](https://example.com) | hipervínculo |
El renderizado está saneado contra ataques XSS; consulte la página de Cumplimiento y Auditoría para obtener detalles de seguridad.
Aplicar una plantilla
- Abra la incidencia y el panel del checklist.
- Elija Aplicar plantilla (Apply Template) en el menú del panel.
- Seleccione una plantilla (por ejemplo,
QA Release Checklist) en el menú desplegable del modal.
Cada plantilla incluye una etiqueta de tipo (type lozenge):
- Hacer-Confirmar (Do-Confirm) — verifique el trabajo completado frente a la lista (por ejemplo, una revisión de preparación para el lanzamiento).
- Leer-Hacer (Read-Do) — ejecute los pasos secuencialmente como indica el procedimiento (por ejemplo, un runbook de respuesta a incidentes).
Las plantillas heredadas sin un tipo asignado siguen siendo compatibles y se renderizan sin tipo.
Si su administrador actualiza posteriormente esa plantilla y la sincroniza, los nuevos elementos se añadirán a su checklist la próxima vez que abra la incidencia. Los elementos que haya editado, reordenado o eliminado localmente se conservan: la sincronización nunca sobrescribe su trabajo.
Guardar su checklist como plantilla
¿Ha creado un checklist útil en una incidencia? Puede promoverlo sin salir de la vista de la incidencia: elija Guardar como plantilla (Save as template), asígnele un nombre (máx. 100 caracteres), seleccione Do-Confirm o Read-Do, y se guardará en la Biblioteca de plantillas globales para que todos puedan reutilizarlo.
Clonación de incidencias
Cuando clona una incidencia:
- El checklist se copia a la nueva incidencia.
- Todos los elementos se restablecen a desmarcados. La clonación normalmente representa un trabajo nuevo, por lo que conservar los estados marcados tergiversaría la finalización.
- El enlace a la plantilla original se conserva, por lo que las futuras sincronizaciones de plantillas también se aplicarán al clon.
Bloqueo de estado — Cuando la incidencia está en Done (Hecho)
Una vez que el estado de la incidencia entra en la categoría Done (Hecho, Cerrado, Resuelto o cualquier estado personalizado asignado a esa categoría), el checklist pasa a ser de solo lectura. Aún puede verlo y exportar el registro de auditoría, pero no puede marcar, desmarcar, editar, eliminar ni reordenar elementos. La misma restricción se aplica en el backend, por lo que las llamadas a la API también serán rechazadas.
Esto es intencionado y necesario para el cumplimiento de SOC 2; consulte Cumplimiento y Auditoría.
Portal de JSM — Visibilidad para los clientes
Si su administrador ha habilitado la visibilidad en el portal de JSM, los clientes que vean su solicitud en el portal del cliente de Jira Service Management verán el checklist en modo de solo lectura. Podrán observar el progreso de los agentes a través de pasos como “Aprovisionando correo electrónico”, “Configurando estación de trabajo” o “Enviando paquete de bienvenida” sin tener que publicar un comentario preguntando “¿cuál es el estado?”. Los clientes nunca pueden marcar, desmarcar ni editar elementos.
JQL — Buscar incidencias por progreso del checklist
Los campos personalizados Checklist Progress (0–100%) y Checklist Audit Log se pueden buscar en JQL, filtros, paneles y tableros. Consultas útiles:
"Checklist Progress" < 100 AND status = "In Review"
"Checklist Progress" = 0 AND assignee = currentUser()
"Checklist Progress" = 100 AND status != Done
Límites de un vistazo
| Límite | Valor |
|---|---|
| Elementos por checklist | 50 |
| Checklists por incidencia | 1 |
| Texto del elemento | 500 caracteres |
| Nombre de la plantilla | 100 caracteres |