BACK TO DEISER.COM

EN | ES

Menu
Free Pack
Buy Now

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

Leo Díaz
06-abr-2016 13:19:00

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.
Support Pack Expiration Date

 

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:

listado de bolsas de horas

 

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:

Support Pack Info 2

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.

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

url de Jira Profields


¿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:

bolsa de hora caducada
 

2 - En caso de que no le queden horas:

bolsa de horas sin 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.

Reserva una reunión con nuestro equipo e infórmate.


Reserva una llamada
con nuestro equipo

Elige un día y una hora para que podamos llamarte y responder a todas tus dudas sobre el cambio de precios de Atlassian.

RESERVAR LLAMADA

No Comments Yet

Let us know what you think

Subscribe by Email