toggl to jira

Toggl.track a Jira

Es una pequeña aplicación que se puede ejecutar manualmente o mediante crontab. Esta aplicación exportará su informe toggl.track durante el período de tiempo seleccionado a los registros de trabajo de su proyecto Jira. Escribí esta aplicación porque, desde mi punto de vista, la interfaz de usuario del registro de trabajo de Jira no es útil. Puede instalar la extensión del navegador toggl.track y será mucho mejor que el formulario de entrada de "registro de trabajo" de Jira.

Requisitos

Como cada aplicación, mi aplicación también requiere que se hagan algunas cosas antes de la ejecución.

1. Debes tener una cuenta en Jira para poder crear el token de autenticación de Jira. Haga clic aquí para ver cómo.
2. Cree el token de API toggl.track. Haga clic aquí para ver cómo.

Instalación

1. Ir a la página de lanzamientos
2. Descargue el archivo llamado release.zip , descomprímalo y seleccione el binario para su sistema operativo de la carpeta bin y cópielo en la carpeta ~/toggl-to-jira de su sistema. Por supuesto, depende de usted qué tipo de carpeta seleccione.
3. Asegúrese de que todas las variables de entorno requeridas se hayan configurado en .env
4. Usando la herramienta de línea de comando, vaya a ~/toggl-to-jira (o su ruta) y ejecute el siguiente comando:

    ./toggl-to-jira-{system}
   

   Tenga en cuenta que, después del inicio, la aplicación intentará recuperar las entradas de tiempo de la API de toggl y enviarlas a la API de Jira. En mi caso no había entradas de tiempo para poner en Jira, así que esto es lo que vi: Hecho.

Configuración del entorno

La recomendación es copiar el contenido de .env.example al archivo .env en la carpeta ~/toggl-to-jira (o su ruta)

En este contenido ficticio puedes ver las siguientes variables:

Para Toggl.pista

• TOGGL_API_TOKEN : vea aquí cómo crear el token
• TOGGL_API_URL : la URL de API https://api.track.toggl.com
• TOGGL_DEFAULT_WORKSPACE_ID : simplemente vaya a su cuenta toggl.track y visite la página Informes; allí, en la dirección URL, verá el ID. Aquí hay un ejemplo https://track.toggl.com/reports/summary/{WORKSPACE_ID}/period/thisWeek

Para Jira

• JIRA_APP_TOKEN : haga clic aquí para ver cómo generar el token
• JIRA_EMAIL : correo electrónico de tu cuenta de Jira
• JIRA_BASE_URL : la URL del espacio de trabajo https://your-company.atlassian.net

como funciona

El enfoque principal es:

1. Recuperamos los datos de la API toggl.track usando /reports/api/v2/details?workspace_id={workspace_id}&user_agent={user_agent}&since={date_from}&until={date_to}
2. Para cada entrada de tiempo intentamos obtener la cantidad de minutos y enviar el registro de trabajo.

Por favor, eche también un vistazo al diagrama de flujo:

Argumentos disponibles

1. date_from : la fecha de inicio de la exportación del filtro. Utilice el siguiente formato: AAAA-MM-DD (predeterminado "2021-03-27")
2. date_to : la fecha de finalización de la exportación del filtro. Utilice el siguiente formato: AAAA-MM-DD (predeterminado "2021-03-27")
3. workspace_id : el ID del espacio de trabajo que se debe utilizar para la generación del informe de datos toggl.track. De forma predeterminada, se utilizará el ID de la variable de entorno TOGGL_DEFAULT_WORKSPACE_ID.

Utilice --help para obtener más detalles.

¿Cuándo la aplicación ignora las entradas de tiempo de toggl.track?

Existen condiciones en las que la aplicación ignora la entrada de tiempo recibida:

1. La aplicación ya procesó la entrada de tiempo.
2. En la descripción de la entrada de tiempo no pudimos encontrar la clave Jira Task. El ejemplo de clave de tarea KEY-1100
3. El número de minutos invertidos es menor que 1

Solución de problemas

No se puede ejecutar la aplicación en MacOS Big Sur

1. Asegúrese de permitir la ejecución de la aplicación en la configuración de Security & Privacy
2. Asegúrese de mover su aplicación a la carpeta fuera de las carpetas del sistema base. Por ejemplo: ~/Downloads es una carpeta del sistema. Cree una nueva carpeta en ~/ ruta y ejecute la aplicación desde allí.

Recibo el error "Parece que hay problemas con la configuración. Deje de ejecutar el script". Asegúrese de haber definido todas las variables de entorno requeridas. Puede encontrar la lista de ellos en .env.example .

Mi configuración

Recomendaría utilizar esta aplicación con una combinación de la extensión del navegador toggl.track, que puede encontrar aquí. Y también recomendaría configurar el evento crontab para la ejecución de su aplicación, de modo que ya no le importe la sincronización del registro de trabajo.

Lo mismo hice en mi PC. Instalé la aplicación en crontab para enviar el informe de Jira cada 2 horas, para no bombardear las API de Jira y Toggl.track. Además, en mi navegador instalé la extensión de navegador Toggl.track y habilité en la configuración de la extensión la compatibilidad con Jira como en la imagen a continuación: Al final, para todas las tareas en Jira tengo un botón para iniciar/detener el cronómetro y todas mis horas de trabajo están sincronizadas. Es gratis y muy útil.