Configuración y Administración

Esta guía cubre la instalación, el Panel de Administración, la gestión de plantillas, la habilitación de proyectos, la aplicación de flujos de trabajo, la integración de automatizaciones, la exposición en el portal de JSM, la configuración de aplicación automática y la página del Hub.

1. Instalar la Aplicación

Desde Jira, abra Aplicaciones → Explorar más aplicaciones y busque Enterprise Checklists for Jira, o instálela directamente desde el listado del Atlassian Marketplace.
Una vez instalada, abra Configuración de Jira (⚙) → Aplicaciones del Marketplace → Enterprise Checklists for Jira para acceder al Panel de Administración.
Los administradores que ingresan por primera vez son dirigidos a una página de Primeros Pasos (Getting Started) y a una página de Configuración (Configure) que los guían a través de las cuatro pestañas del panel.

Solo los usuarios con permisos de Administrador del Sitio (Site Admin) o Administrador del Proyecto (Project Admin) de Jira pueden acceder al Panel de Administración. Los permisos diarios de las listas de verificación siguen el esquema de permisos existente del proyecto; consulte el Modelo de Permisos a continuación.

2. Panel de Administración — Cuatro Pestañas

Plantillas

La pestaña de Plantillas es su plano de control para la Biblioteca Global de Plantillas.

Crear / editar / eliminar listas de verificación con nombre (por ejemplo, QA Release Checklist, Bug Triage, Production Deployment). Los nombres de las plantillas están limitados a 100 caracteres.
Previsualizar la lista de verificación renderizada antes de publicarla.
Recuento de incidencias vinculadas: cada fila muestra cuántas incidencias activas hacen referencia actualmente a la plantilla, para que comprenda el radio de impacto antes de sincronizar.
Sincronizar (Sync): distribuye los nuevos elementos de la plantilla a cada incidencia activa y no resuelta que esté vinculada actualmente a esa plantilla. La sincronización es solo de adición (append-only) (consulte Sincronización Dinámica de Plantillas a continuación).
Tipo de lista de verificación: cada plantilla está etiquetada como Do-Confirm (Hacer y Confirmar) o Read-Do (Leer y Hacer) (basado en El Efecto Checklist de Atul Gawande). Utilice Do-Confirm para verificar el trabajo completado frente a una lista, y Read-Do para procedimientos secuenciales ejecutados paso a paso. La etiqueta aparece como una pastilla (lozenge) en la lista de plantillas, la galería de inicio y en el panel de la incidencia. Las plantillas heredadas sin tipo siguen siendo compatibles.

Plantillas de Inicio Integradas

La pestaña de Plantillas también expone un catálogo seleccionado de 11 plantillas de inicio que se incluyen con la aplicación. Explore la galería, previsualice los elementos renderizados y las pastillas de metadatos (categoría, tipo, recuento de elementos) y haga clic en Add to my templates (Agregar a mis plantillas) para copiar una plantilla de inicio en la biblioteca de Plantillas Globales editable de su espacio de trabajo.

Categoría	Plantilla de Inicio
Ingeniería / DevOps	Production Deployment · Production Database Schema Migration
QA / Agile	Sprint Readiness
ITSM	Incident Management · IT Provisioning
Seguridad / Proveedores	Vendor Assessment · Third-Party Data Sharing Request
RR. HH.	Employee Offboarding & Access Revocation
Cumplimiento	Cloud Infrastructure ePHI Baseline (HIPAA) · Financial System ITGC Audit (SOX)
Marketing / General	External Press Release

La adopción crea una copia independiente a través de la ruta estándar createTemplate. Los originales del catálogo son de solo lectura, nunca se aplican automáticamente y nunca sobrescriben su copia personalizada en futuras actualizaciones de la aplicación.

Proyectos

Lista paginada y con función de búsqueda de todos los proyectos de Jira.
Interruptor de Habilitar / Deshabilitar por proyecto. Los proyectos están habilitados por defecto (modelo de exclusión voluntaria u opt-out).
Deshabilitar un proyecto oculta completamente el panel de la lista de verificación de todas las incidencias de ese proyecto (no solo aparece atenuado).

Configuración

Notificar al completar un elemento (Notify on item completed): interruptor global que controla si marcar un elemento activa las notificaciones nativas de Jira para los observadores (watchers) y el responsable (assignee).
Visibilidad en el portal de JSM: interruptor global que controla la exposición de solo lectura de la lista de verificación en el portal del cliente de Jira Service Management. También se puede anular a nivel de proyecto.
Aplicación Automática de Plantillas Predeterminadas (Auto-Apply Default Templates): asigne cualquier Plantilla Global a uno o más tipos de incidencias de Jira. A las nuevas incidencias de ese tipo se les añade la plantilla en el momento de su creación, sin necesidad de ninguna regla de Jira Automation.

Exportar

Exportación masiva en CSV de todas las listas de verificación en un proyecto seleccionado, paginada para entornos grandes.
El resultado está protegido contra la inyección de fórmulas según OWASP y utiliza la clave de incidencia de Jira legible por humanos (por ejemplo, CMSP-7) en la columna Issue Key (Clave de incidencia) para la referencia cruzada directa del auditor.
Las exportaciones por incidencia siguen estando disponibles desde el panel de la incidencia (solo para Administradores de Jira / Administradores de Proyecto).

3. El Hub de Listas de Verificación (Vista de Administrador)

Accesible directamente desde el menú de navegación superior de Jira, el Checklist Hub sirve como un punto de entrada único para todos los usuarios. Mientras que los usuarios finales ven su propio trabajo asignado, los Administradores de Jira y de Proyecto obtienen acceso a funciones de gobernanza adicionales en esta página:

Información de Uso de Plantillas (Template Usage Insights): vea estadísticas agregadas (total de listas de verificación y plantillas) en toda la instancia, junto con una tabla clasificada que muestra exactamente cuántas incidencias están vinculadas a cada plantilla. Utilice esto para identificar los procesos en los que más se confía o para desaprobar los que no se utilizan.
Excepciones de Proyectos (Project Exceptions): audite rápidamente su superficie de configuración con una lista resumida de proyectos que se desvían de los valores predeterminados globales (por ejemplo, la lista de verificación está completamente deshabilitada o se han aplicado anulaciones de visibilidad a nivel de proyecto).
Acciones Rápidas (Quick Actions): enlaces de navegación directa para llevarlo directamente al Panel de Administración o al flujo de incorporación de Primeros Pasos.

4. Modelo de Permisos

Los permisos de las listas de verificación se basan en el esquema de permisos de Jira existente para la incidencia:

Permiso de Jira	Qué pueden hacer
Editar incidencias (Edit Issues)	Crear, editar, eliminar, marcar / desmarcar, reordenar, aplicar plantillas, guardar la lista de verificación actual como plantilla.
Solo Explorar proyectos (Browse Projects)	Ver la lista de verificación en modo de solo lectura.
Administrador de Proyecto (Project Admin)	Todo lo anterior + exportación CSV de auditoría por incidencia.
Administrador de Jira / Sitio (Jira / Site Admin)	Todo lo anterior + Panel de Administración, gestión de Plantillas Globales, interruptores de proyectos, exportación masiva en CSV.

Los clientes del portal de JSM siempre ven la lista de verificación en modo de solo lectura, y solo cuando la visibilidad en el portal de JSM está habilitada.

5. Sincronización Dinámica de Plantillas

Cuando cambia una Plantilla Global y hace clic en Sincronizar (Sync):

La interfaz de usuario de administración muestra un recuento de incidencias afectadas y requiere confirmación explícita antes de continuar.
La sincronización es solo de adición (append-only): los nuevos elementos se agregan al final de la lista de verificación de cada incidencia.
Los elementos existentes (ya sea que se hayan reordenado, editado o incluso eliminado localmente) nunca se sobrescriben ni se vuelven a insertar.
Los duplicados se detectan mediante una coincidencia de texto que no distingue entre mayúsculas y minúsculas y se omiten.
Las sincronizaciones masivas suprimen las notificaciones a los observadores por incidencia para evitar tormentas de correos electrónicos; los usuarios ven los nuevos elementos la próxima vez que abren la incidencia.

6. Aplicación de Flujos de Trabajo — Validador `Checklist Complete`

Bloquee las transiciones hasta que se complete la lista de verificación.

Edite el flujo de trabajo de Jira de destino y seleccione la transición que desea restringir (por ejemplo, In Review → Done).
Agregue Validador → Checklist Complete.
Las incidencias sin lista de verificación pasan el validador (por lo que las incidencias heredadas no se bloquean).

7. Notificaciones Nativas y Automatización

Notificaciones a los observadores: controladas por la configuración Notificar al completar un elemento (Notify on item completed). Cuando está activada, marcar un elemento envía una notificación nativa de Jira a los observadores y al responsable.
Propiedad de automatización: cada acción de marcar / desmarcar escribe en la propiedad de la incidencia enterprise-checklist-event. En Jira Automation, cree reglas con el disparador Issue property changed (Propiedad de la incidencia modificada) y reaccione a la actividad de la lista de verificación (por ejemplo, publicar en Slack, transicionar la incidencia, crear una subtarea).

8. JQL y Campos Personalizados

Se exponen dos campos personalizados de solo lectura para filtros, paneles, tableros y JQL:

Checklist Progress (Progreso de la lista de verificación, 0–100%): utilizable en JQL como "Checklist Progress" < 100 AND status = "In Review". También se muestra como una insignia numérica en las tarjetas de los tableros Kanban / Scrum.
Checklist Audit Log (Registro de auditoría de la lista de verificación): resumen de las entradas de auditoría más recientes, que aparece en la pestaña de Historial de Jira.

9. Aplicación Automática de Plantillas Predeterminadas

En Configuración → Aplicación Automática (Settings → Auto-Apply), asigne cualquier Plantilla Global a uno o más tipos de incidencias de Jira. Cuando un usuario crea una nueva incidencia de ese tipo, la plantilla correspondiente se añade automáticamente. Esto reemplaza las frágiles reglas de Jira Automation del tipo “si el tipo de incidencia = Error, entonces agregar lista de verificación” que la mayoría de los equipos construyen a mano.

10. Visibilidad en el Portal de JSM

Alterne la configuración global en Configuración (Settings) y, opcionalmente, anúlela por proyecto desde la pestaña Proyectos (Projects). Cuando está habilitada, la lista de verificación aparece como de solo lectura en el portal del cliente de Jira Service Management; esto es útil para solicitudes de incorporación de RR. HH. y aprovisionamiento de TI donde el solicitante desea ver el progreso sin tener permisos para editar.

11. Límites Operativos

Restricción	Valor
Elementos máximos por lista de verificación	50
Listas de verificación por incidencia	1
Longitud del texto del elemento	500 caracteres
Longitud del nombre de la plantilla	100 caracteres

Estos límites se aplican tanto en la interfaz de usuario como en el backend.