Ejecución de scripts Groovy con Adaptavist ScriptRunner para Jira

Jira es una de las herramientas para el seguimiento de errores e incidencias y gestión de proyectos más utilizada por un gran número de empresas. Sin embargo, si eres usuario de Jira, muchas veces habrás querido hacer una pequeña funcionalidad que ampliara la base de tu instancia de Jira y mejorara el trabajo del día a día.

¿Te gustaría hacer una migración de una instancia de Jira a otra? ¿O de otro sistema de incidencias a Jira? O posiblemente quieras añadir una validación compleja en una posfunción. Todos estos casos de uso, y muchos más que puedas necesitar, pueden ser resueltos gracias al plugin de Adaptavist ScriptRunner para Jira.

Aparte de los ejemplos vistos anteriormente, este plugin nos permite ampliar la funcionalidad de Jira en los siguientes aspectos:

• Extender y automatizar Jira gracias a los scripts personalizados o los ya integrados: Permite extender las JQL, mejorar los workflows o automatizar Jira con escalamiento de servicios. Además, facilita la administración de Jira.
• Extender las capacidades de informes de Jira: Mejora la consulta de Jira con funciones extendidas como búsqueda por incidencias con ficheros adjuntos, con comentarios, etc.
• Mejorar los workflows: Mejora los workflows gracias a los scripts ya integrados o personalizados para condiciones, validaciones o posfunciones.
• Añadir scripts a campos personalizados: Añade scripts de Groovy a tus campos personalizados.
• Administrar todos tus proyectos de Jira: Puedes utilizar cualquiera de los scripts ya integrados para ampliar la administración de proyectos o generar uno nuevo.
• Definir cómo se comporta un campo personalizado: A través del uso de «Behaviours» se puede definir cómo se va a comportar un campo personalizado en un proyecto o incidencia dada, tanto en la pantalla de creación como edición de una incidencia. Se pueden configurar campos como obligatorios o solo de lectura dependiendo de los datos introducidos en el formulario de la incidencia. E incluso se pueden realizar validaciones en el lado servidor de los datos de un campo, antes de que la incidencia sea enviada a Jira.
• Escalar eventos de Jira: Se puede crear un servicio de escalamiento para escalar automáticamente la prioridad de incidencias.

Como se ha comentado en los puntos anterior, ScriptRunner tiene muchos scripts ya integrados para hacer operaciones habituales como poder simular a un usuario, copiar un proyecto, enviar un correo electrónico personalizado en una posfunción y ¡muchos más! Os animo a echar un vistazo a la página de estos scripts integrados para ver la potencia del plugin.

También cabe destacar los ejemplos que Adaptavist proporciona, con el código del script Groovy y una breve explicación para que la acción de crear nuestro propio script sea mucho más llevadera.

Una vez añadido, se pulsa sobre «Fields», en donde podremos relacionar un campo personalizado con un script de «Behaviours» en concreto:

En el espacio con fondo en color azul es donde se podrá añadir el script de Groovy correspondiente al campo personalizado que hemos seleccionado. En el ejemplo anterior, se va añadir un script al campo personalizado llamado «Proyecto».

Por lo tanto, si queremos añadir nuestro pequeño script para mostrar un mensaje al seleccionar el valor «Proyecto 1» en nuestro campo personalizado «Proyecto», se debería incluir el siguiente script:

import com.onresolve.Jira.groovy.user.FormField FormField field = getFieldById(getFieldChanged()) if(field.value == ‘Proyecto 1’) field.setOverlay(«Error message»)

De esta manera, al seleccionar dicho valor en el campo «Proyecto» del formulario de creación o edición de una incidencia, saldría un mensaje similar al siguiente:

Como se ha podido comprobar, con un simple script de ¡tan solo 3 líneas! se ha podido aumentar la funcionalidad de Jira a nuestras necesidades.

Por todo ello, creo que merece la pena darle una oportunidad al plugin y «trastear» con él tanto como puedas.