Cómo gestionar bolsas de horas de servicio con Jira,  Profields y Scriptrunner

Historia

Hace poco más de un año contábamos cómo gestionamos en DEISER las bolsas de horas, explicábamos cómo desde Jira y con la ayuda de Profields almacenamos toda la información referente a la bolsas como por ejemplo el total de horas contratadas, productos soportados en la bolsa, comentarios de facturación, usuarios implicados por parte del cliente, fecha de finalización de la bolsa, etc.

Después de unos cuantos años con la configuración prácticamente "sin tocar", y debido principalmente a la incorporación de nuevos compañeros y al establecimiento de un nuevo equipo de soporte especializado (pronto hablaremos más de esto) dedicado en exclusiva a la resolución y seguimiento de peticiones llegadas desde las bolsas de horas, nos hemos visto en la necesidad de automatizar el control de las peticiones que han entrado en bolsas que no tienen horas o que bien se han caducado, vamos a aprovechar este post para contar ¡cómo lo hemos hecho!

Antes de empezar

Para identificar las peticiones en bolsas caducadas o sin horas además de Profields y el propio Jira necesitamos hacer uso de Script Runner, actualmente las versiones que nosotros tenemos instaladas son las siguientes:

• Jira v7.0.9
• Profields v4.4.0
• Script Runner v4.2.0.5
  
  

La configuración

Hasta ahora el control que hacíamos era muy manual con los campos y un gadget de Profields, los campos principales son:

• Support Pack Size: Aquí guardamos el total de horas contratadas.
• Support Pack Expiration Date: Aquí guardamos la fecha en la que finaliza el soporte.

Para el control de las horas restantes, disponemos de un dashboard donde se puede ver el cálculo automático de los días restantes mediante un gadget de Profields:

Para el control de la expiración disponíamos de un campo de Profields de tipo Script en el que se podía ver en cada proyectos si está expirado o no:

Para agilizar la gestión y que fuera mucho más fácil hemos creado un custom field de tipo Script llamado Support Pack Info.

En la configuración de Script Runner el campo tiene el siguiente script:

import com.atlassian.jira.bc.issue.worklog.TimeTrackingConfiguration 
import com.atlassian.jira.component.ComponentAccessor 
import com.atlassian.jira.issue.Issue 
import com.atlassian.jira.issue.MutableIssue 
import com.atlassian.jira.project.Project 
import com.atlassian.jira.util.JiraDurationUtils 
import com.deiser.jira.profields.api.field.DatetimeField 
import com.deiser.jira.profields.api.field.FieldService 
import com.deiser.jira.profields.api.field.OriginalEstimateField 
import com.onresolve.scriptrunner.runner.customisers.PluginModule 
import com.onresolve.scriptrunner.runner.customisers.WithPlugin 
import java.text.SimpleDateFormat

@WithPlugin("com.deiser.jira.profields")
@PluginModule
FieldService fieldService

def SUPPORT_PACK_EXPIRATION_DATE_ID = 10 
def SUPPORT_PACK_SIZE_ID = 1

Calendar getCalendarWithoutTime(Date date) { 
 Calendar calendar = new GregorianCalendar()
 calendar.setTime(date)
 calendar.set(calendar.get(Calendar.YEAR), calendar.get(Calendar.MONTH), calendar.get(Calendar.DAY_OF_MONTH), 0, 0, 0)
 calendar.set(Calendar.MILLISECOND, 0)
 return calendar;
}

String isExpired(Date expirationDate) { 
 if (expirationDate == null) {
 return false
 }
 def expiration = getCalendarWithoutTime(expirationDate)
 def actual = getCalendarWithoutTime(new Date())
 if (actual.compareTo(expiration) > 0) {
 def simpleDateFormat = new SimpleDateFormat("dd/MM/yyyy")
 return String.format('''
 <p>Expired.</p>
 <blockquote>Expiration date: %s</blockquote>
 '''
 , simpleDateFormat.format(expirationDate))
 }
 return null
}

String hasRemaining(Project project, Long total) { 
 def issueManager = ComponentAccessor.issueManager
 def timeTrackingConfiguration = ComponentAccessor.getOSGiComponentInstanceOfType(TimeTrackingConfiguration.class)
 def jiraAuthenticationContext = ComponentAccessor.jiraAuthenticationContext
 def prettyDurationFormatter = new JiraDurationUtils.PrettyDurationFormatter(
 timeTrackingConfiguration.hoursPerDay,
 timeTrackingConfiguration.daysPerWeek,
 jiraAuthenticationContext.i18nHelper)
 Long timeSpent = (Long)issueManager.getIssueIdsForProject(project.id).sum { issueManager.getIssueObject((Long)it).timeSpent ?: 0L }
 total = total ? (Long)(total / 1000L) : 0L
 timeSpent = timeSpent ?: 0L
 if (total <= timeSpent) {
 return String.format('''
 <p>No available hours</p>
 <blockquote>
 Total hours: %s</br>
 Time spent: %s
 </blockquote>
 '''
 , prettyDurationFormatter.format(total, jiraAuthenticationContext.locale)
 , prettyDurationFormatter.format(timeSpent, jiraAuthenticationContext.locale))
 }
 return null
}

try{ 
 Issue currentIssue = issue

 def supportPackExpirationDateField = (DatetimeField) fieldService.get(SUPPORT_PACK_EXPIRATION_DATE_ID)
 def supportPackSizeField = (OriginalEstimateField) fieldService.get(SUPPORT_PACK_SIZE_ID)
 def supportPackExpirationDate = supportPackExpirationDateField.getValueInProject(currentIssue.projectObject)
 def supportPackSize = supportPackSizeField.getValueInProject(currentIssue.projectObject)

 def expired = isExpired(supportPackExpirationDate)
 def hasHours = hasRemaining(currentIssue.projectObject, supportPackSize)
 def message = '''
 <div class="aui-message aui-message-warning">
 <p class="title"><strong>%s!</strong></p>
 %s
 </div>
 '''

 if (expired && !hasHours) {
 return String.format(message, "Warning!", expired)
 } else if (!expired && hasHours) {
 return String.format(message, "Warning!", hasHours)
 } else if (expired && hasHours) {
 return String.format(message, "Warning!", expired + hasHours)
 } else {
 return null
 }
} catch(def e){
 log.error("Error while calculating support pack info: " + e.getClass().getName())
}

Las variables SUPPORT_PACK_EXPIRATION_DATE_ID y SUPPORT_PACK_SIZE_ID tienen el ID de los campos de control.

Para extraer los IDs de los campos de Profields al igual que con JIRA verificar la URL en la edición del campo

¿Y qué es lo que hemos ganado?

Pues aquí está el quid de la cuestión, con esta nueva configuración cada vez que un cliente nos hace una petición en una bolsa de horas si bien está caducada o no tiene horas el sistema automáticamente nos devolverá un mensaje:

1 - En caso de que esté caducada:

2 - En caso de que no le queden horas:

Con esto evitamos tener que monitorizar manualmente las bolsas, saber si ha caducado o si no le quedan horas está al alcance no sólo del equipo si no también del cliente!

Éste es sólo un ejemplo de cómo Jira nos hace más fácil nuestro día a día. Si en tu caso tienes claro todo que te gustaría hacer con tu instancia de Jira pero no tienes el tiempo suficiente para hacerlo por ti mismo, puedes contar con nosotros siempre que lo necesites, somos Atlassian Platinum Solution Partner Enterprise y podemos adaptar Jira o cualquier producto Atlassian a las necesidades específicas de tu empresa.