ScriptRunner Snippets para Jira (Data Center)

Este repositorio contiene una colección de fragmentos de código (snippets) en Groovy para ScriptRunner en Jira Data Center. Aquí encontrarás ejemplos de conditions, behaviors, script fields y fragments, organizados por tipo.

Estructura del repositorio

scriptrunner-snippets/
├── README.md
├── data-center/
│   ├── conditions/       # Condiciones para workflows
│   ├── behaviors/        # Comportamientos de campos
│   ├── script-fields/    # Campos calculados
│   └── fragments/        # Scripts de utilidad y administración
└── cloud/
    └── .gitkeep

Requisitos

• Jira Data Center (versión 8.x o superior recomendada)
• ScriptRunner para Jira Data Center
• Conocimientos básicos de Groovy
• Para scripts REST: librería groovyx.net.http.RESTClient

Uso

Cada script incluye comentarios explicativos sobre su propósito y uso. Antes de usar cualquier script:

1. Lee los comentarios al inicio de cada archivo
2. Personaliza los placeholders:
   • TUBEARERTOKEN → Tu token de autenticación
   • https://jira.tuempresa.com → URL de tu instancia
   • PRJKEY, NEWPRJ1 → Claves de tus proyectos
   • customfield_NNNNN → IDs de tus custom fields
   • IDs de schemes → IDs específicos de tu instancia
3. Prueba en un ambiente de desarrollo antes de producción
4. Ajusta según tu contexto (roles, estados, tipos de issue, etc.)

Categorías de scripts

Conditions (data-center/conditions/)

Condiciones para controlar transiciones en workflows:

• Verificar existencia de subtareas
• Validar estados de subtareas
• Comprobar roles de usuarios

Behaviors (data-center/behaviors/)

Comportamientos dinámicos de campos en pantallas de issue

Script Fields (data-center/script-fields/)

Campos calculados que muestran información derivada

Fragments (data-center/fragments/)

Scripts de utilidad para administración y automatización:

• Gestión de proyectos vía REST API
• Cambio de schemes (workflows, permisos, campos, etc.)
• Limpieza y mantenimiento
• Auditoría y reportes

Disclaimer

⚠️ Importante: Estos scripts son ejemplos educativos y deben ser adaptados a tu entorno específico.

• Prueba siempre en un ambiente de desarrollo primero
• Revisa y entiende el código antes de ejecutarlo
• Los IDs, nombres de campos y configuraciones son ejemplos
• No hay garantía de compatibilidad con todas las versiones de Jira
• El autor no se hace responsable por problemas derivados del uso de estos scripts

¿Cómo contribuir?

¡Las contribuciones son bienvenidas! Para contribuir:

1. Haz un fork del repositorio
2. Crea una rama para tu feature (git checkout -b feature/nuevo-script)
3. Elige la carpeta correspondiente según el tipo de script
4. Usa nombres descriptivos para los archivos (kebab-case)
5. Agrega un comentario al inicio explicando:
   • Propósito del script
   • Contexto de uso
   • Autoría (ej: // Autor: tunombre)
   • Variables/placeholders a personalizar
6. Commit tus cambios (git commit -m 'Agrega script para...')
7. Push a la rama (git push origin feature/nuevo-script)
8. Abre un Pull Request

Documentación adicional

• CONTRIBUTING.md - Guía detallada para contribuir al proyecto
• LICENSE - Licencia MIT del proyecto

Licencia

MIT License - Siéntete libre de usar, modificar y distribuir estos scripts.

Autoría

Actualmente, todos los scripts existentes tienen como autoría: jandorellana (XaviWare).

¡Comparte tus mejores prácticas y ayuda a la comunidad Jira!