Exportar tus datos de TimeLog de Azure DevOps a Excel
TimeLog de TechsBCN para Azure DevOps
Azure DevOps es una excelente herramienta de Microsoft para administrar proyectos de desarrollo. En TechsBCN es una herramienta para el día a día. Es realmente útil para mantener en sintonía a todas las partes: stakeholders, desarrolladores, testers, etc.
A pesar de las múltiples ventajas de Azure Devops, existen algunas características que no son compatibles de forma nativa, especialmente con respecto al seguimiento del tiempo.
De forma predeterminada, Azure DevOps solo permite a los usuarios informar el tiempo restante y el incremento de tiempo dedicado a una tarea en particular. Esta información, puede ser insuficiente, cuando se requiere un análisis más profundo de la dedicación de los miembros del equipo, que es una tarea común que realizan los gerentes de proyecto o los líderes de equipo.
Afortunadamente, DevOps cuenta con un sistema de gestión de extensiones que permite a los usuarios ampliar las funcionalidades de esta herramienta. Hay muchos proveedores (como 7pace o Harvest) que ofrecen varias soluciones para cubrir esta falta de seguimiento de tiempo que puede tener DevOps. Sin embargo, la mayoría de estas herramientas no son gratuitas y tienen características añadidas que realmente no necesitamos en TechsBCN.
Aprovechando nuestras habilidades de desarrollo, decidimos crear una herramienta gratuita (para siempre), para quienes deseen realizar un seguimiento del tiempo dedicado a DevOps: TimeLog para Azure DevOps. Esta herramienta es realmente fácil de usar y brinda la funcionalidad que nosotros (y probablemente otros) requerimos para satisfacer las necesidades de seguimiento de tiempo.
Exportación de datos a Excel
En TechsBCN sabemos que debe haber varias personas (como jefes de proyecto, jefes de equipo, etc.) a las que les gustaría tener sus datos de seguimiento de tiempo en una hoja de cálculo de Excel, por lo que hemos preparado una guía paso a paso, para explicar cómo se pueden exportar los datos de TimeLog a Excel. Hagámoslo:
1. Crear un token de acceso personal (PAT) de Azure DevOps
El primer paso para recuperar datos de Azure DevOps en nuestra hoja de cálculo de Excel, es crear un token de acceso personal. Este token se puede crear y mantener por un máximo de un año, con pleno acceso, aunque en TechsBCN solo recomendamos crearlo con los permisos necesarios (por seguridad). Los permisos que se necesitarán para seguir esta guía se enumeran a continuación:
- Análisis (Leer)
- Extensión de datos (Leer)
- Gráfico (Leer)
Vamos con la explicación paso a paso:
Ir al menú superior de Azure DevOps para administrar los tokens de acceso personal (PAT)
Crear un nuevo PAT
Configurar el PAT. El plazo máximo de caducidad es de 1 año. Aunque se puede crear con «acceso completo», recomendamos configurarlo solo para los ámbitos requeridos (enumerados anteriormente)
Aquí encontrarás el PAT. Será visible hasta que cierres esta ventana. Siempre puedes crear otros nuevos si lo necesitas.
2. Configura tu hoja de cálculo de Excel
Una vez que tengas el PAT, es hora de configurar la hoja de cálculo de Excel. Utiliza la API de DevOps para recuperar datos del registro de tiempo para la extensión de Azure DevOps. Necesitarás la siguiente URL desde donde se recuperarán los datos:
https://extmgmt.dev.azure.com/{tu-organización}/_apis/ExtensionManagement/InstalledExtensions/TechsBCN/DevOps-TimeLog/Data/Scopes/Default/Current/ Collections/TimeLogData/Documents Repasémoslo
Explicación paso a paso:
En Excel, dirígete a “Datos” -> “Desde Web”
Establece la URL mencionada anteriormente y clica en “OK”
Si es la primera vez que estás haciendo esto, recibirás un mensaje como este. Clica en la pestaña de «Básico», pega el PAT que creaste en el paso anterior, en el campo «Contraseña» (deje el campo «Nombre de usuario» vacío) y clica en «Conectar»
Si la conexión fue exitosa, aparecerá una ventana como esta (Microsoft Power Query Editor). Clica en el elemento «Lista» para desglosar los resultados obtenidos de DevOps API
Convierte estos registros en una tabla haciendo clic en el botón «Transformar» -> «A tabla»
En la nueva ventana, deja el delimitador «Seleccionar o ingresar ” en “Ninguno” y clica en “Aceptar”
Divide los registros resultantes en columnas haciendo clic en el botón resaltado en la captura de pantalla
Verás una vista previa de los datos que se incluirán en la hoja de cálculo de Excel. Clica en el botón «Cerrar y cargar»
¡Y eso es todo! Bastante simple, ¿eh? 😉
3. Importar datos adicionales (por ejemplo, usuarios o tareas)
Ten en cuenta que la extensión TimeLog para Azure DevOps solo guarda información sobre el tiempo de seguimiento de cada usuario para cada tarea. Todo el resto de datos que puedas necesitar en tu hoja de cálculo (como nombres de usuarios, etiquetas en tareas, sprints, etc.) deben importarse desde DevOps. Esto se puede hacer exactamente con el mismo procedimiento del paso 2, pero alcanzando diferentes endpoints de la API.
Por ejemplo, podrás obtener datos adicionales de los siguientes endpoints:
- Datos de elementos de trabajo: https://analytics.dev.azure.com/techsbcn/main/_odata/v3.0/WorkItems?$select=WorkItemId,WorkItemType, Título, Estado, Área (Ámbito de análisis requerido en PAT)
- Datos de usuarios: https://vssps.dev.azure.com/TechsBCN/_apis/graph/users?api-version=6.0-preview.1 (Ámbito de gráfico requerido en PAT )
NOTA: recuerda que si el token de acceso personal que creaste se ajusta a un conjunto particular de permisos, es posible que debas ampliarlos si necesitas acceder a otros ámbitos de otros endpoints de la API, disponibles en Azure DevOps
Conclusión
Esperamos que esta guía sea de ayuda para importar TimeLog para la extensión Azure DevOps en tu hoja de cálculo de Excel. Si necesitas más ayuda o si hay información engañosa en esta guía, no dudes en ponerte en contacto con nosotros. Nos encantará recibir tus comentarios 😉