Informe de ejemplo de tiempo de plazo y tiempo de ciclo

  • Artículo

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Puede crear gráficos de plazos y ciclos mediante las consultas proporcionadas en este artículo. El tiempo de espera y el tiempo de ciclo indican cuánto tiempo tarda el trabajo en fluir a través de la canalización de desarrollo de un equipo. El tiempo de ejecución mide el tiempo total transcurrido desde la creación de elementos de trabajo hasta su finalización. El tiempo de ciclo mide el tiempo que tarda un equipo en completar los elementos de trabajo una vez que comienzan a trabajar activamente en ellos.

En la imagen siguiente se muestra un ejemplo para el tiempo medio de clientes potencial desglosados por las asignaciones de prioridad realizadas en los casos de usuario.

Captura de pantalla del informe de tendencias de tiempo de ciclo de clientes potencial de Power BI.

Para más información sobre el plazo y el tiempo de ciclo, consulte Widgets de tiempo de plazo y tiempo de ciclo y flujo acumulativo, tiempo de ejecución y guía de tiempo de ciclo.

Nota

En este artículo se da por supuesto que ha leído Información general de los informes de ejemplo mediante consultas de OData y tiene conocimientos básicos de Power BI.

Requisitos previos

  • Para ver los datos de Analytics y consultar el servicio, debe ser miembro de un proyecto con acceso básico o superior. De forma predeterminada, a todos los miembros del proyecto se les conceden permisos para consultar Analytics y definir vistas de Analytics.
  • Para obtener información sobre otros requisitos previos relacionados con la habilitación de servicios y características y las actividades generales de seguimiento de datos, consulte Permisos y requisitos previos para acceder a Analytics.

Consultas de ejemplo

Las consultas de esta sección admiten la devolución de datos de tiempo de cliente potencial y ciclo para los casos de usuario completados. Puede consultar por ruta de acceso de área o nombres de equipo. Todas estas consultas especifican el WorkItems conjunto de entidades a medida que devuelven los datos calculados para cada elemento de trabajo por el servicio Analytics.

Nota

Para determinar las propiedades disponibles con fines de filtro o informe, consulte Referencia de metadatos para Azure Boards. Puede filtrar las consultas o devolver propiedades mediante cualquiera de los Property valores de o EntityTypeNavigationPropertyBinding Path disponibles con .EntitySet Cada EntitySet corresponde a .EntityType Para más información sobre el tipo de datos de cada valor, revise los metadatos proporcionados para el correspondiente EntityType.

Devolver tiempo de espera y tiempo de ciclo para casos de usuario y ruta de acceso de área

Puede pegar la consulta de Power BI que se muestra a continuación directamente en la ventana Obtener consulta en blanco de datos>. Para obtener más información, consulte Introducción a los informes de ejemplo mediante consultas de OData.

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
        &"$filter=WorkItemType eq 'User Story' "
            &"and StateCategory eq 'Completed' "
            &"and CompletedDate ge {startdate} "
            &"and startswith(Area/AreaPath,'{areapath}') "
        &"&$select=WorkItemId,Title,WorkItemType,State,Priority,AreaSK "
            &",CycleTimeDays,LeadTimeDays,CompletedDateSK "
        &"&$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Cadenas de sustitución y desglose de consultas

Sustituya las cadenas siguientes por sus valores. No incluya corchetes {} con la sustitución. Por ejemplo, si el nombre de la organización es "Fabrikam", reemplace por {organization}Fabrikam, no {Fabrikam}.

  • {organization} - El nombre de la organización
  • {project} - El nombre del proyecto de equipo, o bien se omite "/{project}" por completo, para una consulta entre proyectos.
  • {areapath} - Su ruta de acceso del área. Formato de ejemplo: Project\Level1\Level2
  • {startdate} - Inicie el informe para los elementos completados en o después de una fecha determinada con el formato : YYYY-MM-DDZ. Por ejemplo: 2022-04-01Z representa 2022-april-01. No incluya comillas.

Desglose de consultas

En la tabla siguiente se describe cada parte de la consulta.

Elemento de consulta

Descripción

$filter=WorkItemType eq 'User Story'

Devuelve datos para casos de usuario.

and StateCategory eq 'Completed'

Devuelve solo los elementos completados. El sistema calcula los valores de Los días de plazo y los días de tiempo de ciclo solo para los elementos de trabajo que se han completado.

Nota

Si examina los datos sin procesar de los registros, es posible que vea las entradas en las que CycleTimeDays=0. Esto ocurre cuando el artículo de usuario o el elemento de trabajo entran en un estado de categoría de flujo de trabajo En curso y Completado el mismo día. Para obtener más información sobre las categorías de estado de flujo de trabajo, consulte Cómo se usan los estados de flujo de trabajo y las categorías de estado en Trabajos pendientes y paneles.

and CompletedDate ge {startdate}

Devuelve elementos que se completan después de la fecha especificada. Ejemplo: 2022-04-01Z representa 2022-april-01

and startswith(Area/AreaPath,'{areapath}')

Devuelve elementos de trabajo en una ruta de acceso de área específica que especifique.'{areapath}' Para filtrar por nombre de equipo, use la instrucción Teams/any(x:x/TeamName eq '{teamname})'filter .

&$select=WorkItemId, Title, WorkItemType, State, Priority

Seleccione las propiedades que se van a devolver.

, CycleTimeDays, LeadTimeDays, CompletedDateSK

Devuelve las propiedades que admiten los días de tiempo de clientes potencial, los días de tiempo de ciclo y CompletedDateSK. CompletedDateSK devuelve un valor de fecha como un entero.

&$expand=AssignedTo($select=UserName), Iteration($select=IterationPath), Area($select=AreaPath)

Expanda las propiedades de AssignedTolas entidades , Iterationy Area y seleccione los campos de entidad para ellas.

Devolver el tiempo de espera y el tiempo de ciclo de los casos de usuario y los equipos

Esta consulta es la misma que la proporcionada en la sección anterior, salvo que filtra por varios nombres de equipo en lugar de rutas de acceso de área.

Puede pegar la consulta de Power BI que se muestra a continuación directamente en la ventana Obtener consulta en blanco de datos>. Para obtener más información, consulte Introducción a los informes de ejemplo mediante consultas de OData.

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
        &"$filter=WorkItemType eq 'User Story' "
            &"and StateCategory eq 'Completed' "
            &"and CompletedDate ge {startdate} "
            &"and (Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname}) "
        &"&$select=WorkItemId,Title,WorkItemType,State,Priority,AreaSK "
            &",CycleTimeDays,LeadTimeDays,CompletedDateSK "
        &"&$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

(Opcional) Cambiar el nombre de la consulta

Puede cambiar el nombre de la etiqueta de consulta predeterminada, Query1, a algo más significativo. Simplemente escriba un nuevo nombre en el panel Configuración de consulta .

Captura de pantalla de las opciones del menú de consulta de Power BI, cambiar el nombre de la consulta.

Transformación de datos en Editor de Power Query

En el Editor de Power Query, elija la consulta con los datos que desea transformar. Para un gráfico de tiempo de clientes potencial/ciclo, querrá realizar las siguientes transformaciones:

  • Expanda columnas como Area, Iterationy AssignedTo.
  • Transforme el tipo de datos de las LeadTimeDays columnas y CycleTimeDays en un número entero.
  • Transforme el tipo de datos de la CompletedDateSK columna de un entero a un valor de fecha.

Para obtener información sobre cómo hacerlo, consulte las secciones siguientes en Transformar datos de Analytics para generar informes de Power BI:

Cierre la consulta y aplique los cambios

Una vez completadas todas las transformaciones de datos, elija Cerrar & aplicar en el menú Inicio para guardar la consulta y volver a la pestaña Informe de Power BI.

Captura de pantalla de Editor de Power Query opción Cerrar y aplicar.

Creación del gráfico de tendencias

En el ejemplo siguiente, se cambió el nombre de la consulta a LeadCycleTime, pero no se cambió el nombre de las columnas.

  1. En Power BI, elija el informe Gráfico de líneas en Visualizaciones.

    Captura de pantalla del informe de gráfico de tendencias visualizaciones y campos de Power BI para clientes potencial.

  2. Agregue CompletedDateSK al eje X.

  3. Agregue LeadTimeDays al eje Y, haga clic con el botón derecho y seleccione Promedio.

  4. Agregue Priority a Leyenda.

Se muestra el informe de ejemplo. Tenga en cuenta que, al mantener el puntero sobre cualquier área del informe, se muestran más datos.

Captura de pantalla del informe de tendencias de tiempo de ciclo de clientes potencial de Power BI de ejemplo.