Informe de ejemplo de tendencia de duración de prueba

Azure DevOps Services

En este artículo se muestra cómo crear un informe que muestre la tendencia diaria del tiempo medio necesario para ejecutar una prueba para un intervalo de tiempo seleccionado.

Importante

Power BI integración y acceso a la fuente OData del servicio Analytics se encuentran en versión preliminar. Las consultas de ejemplo proporcionadas en este artículo solo son válidas en Azure DevOps Services y dependen de la versión v3.0-preview o posterior. Le recomendamos que use estas consultas y nos proporcione comentarios.

Un ejemplo se muestra en la imagen siguiente.

Sample - Test Summary - Report

Nota:

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

Requisitos previos

  • Debe ser miembro de un proyecto con acceso básico o superior. Si no se ha agregado como miembro del proyecto, se agrega ahora. Cualquier persona con acceso al proyecto, excepto las partes interesadas, puede ver las vistas de Análisis.
  • Para que los datos de Analytics estén disponibles, se debe habilitar el servicio correspondiente. Por ejemplo, para consultar los datos de seguimiento del trabajo, Boards debe estar habilitado. Si está deshabilitado, no se mostrarán las vistas de Analytics . Para volver a habilitar un servicio, consulte Activar o desactivar un servicio de Azure DevOps.
  • Para usar las vistas de Analytics, habilite la característica vista previa de vistas de Análisis para usuarios individuales o para la organización.
  • Además, debe tener el permiso *Ver analytics establecido en Permitir. Para más información, consulte Concesión de permisos para acceder al servicio Analytics.
  • Para usar Power BI para Azure DevOps o para ejercer una consulta de OData para Analytics, debe tener el permiso View Analytics establecido en Permitir. De forma predeterminada, se concede acceso a todos los colaboradores con acceso básico. Para editar las vistas de Análisis compartidas, debe tener establecido el permiso Editar vistas de Análisis compartido en Permitir. Para más información, consulte Concesión de permisos para acceder al servicio Analytics.

Consultas de ejemplo

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/v4.0-preview/TestResultsDaily?
$apply=filter("
                &"Pipeline/PipelineName eq '{pipelineName}' "
                &"And Date/Date ge {startdate} "
        &"And Workflow eq 'Build' "
        &") "
            &"/groupby( "
                &"(TestSK, Test/TestName, Date/Date), "
                &"aggregate( "
            &"ResultCount with sum as TotalCount, "
                &"ResultDurationSeconds with sum as TotalDuration "
            &")) "
        &"/compute( "
    &"TotalDuration div TotalCount as AvgDuration "
    &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Cadenas de sustitución

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

  • {organization} - Nombre de la organización
  • {project} - Nombre del proyecto de equipo
  • {pipelinename} : el nombre de la canalización. Ejemplo: Fabrikam hourly build pipeline.
  • {startdate} - La fecha de inicio del informe. Formato: AAAA-MM-DDZ. Ejemplo: 2021-09-01Z representa el 1 de septiembre de 2021. No incluya comillas o corchetes y use dos dígitos para ambos, mes y fecha.

Desglose de consultas

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

Elemento de consulta

Descripción

$apply=filter(

Iniciar filtro()

Pipeline/PipelineName eq '{pipelineName}'

Devolver ejecuciones de prueba para la canalización especificada

And Date/Date ge {startdate}

Devolver ejecuciones de pruebas en o después de la fecha especificada

and Workflow eq 'Build'

Devolución de ejecuciones de pruebas para el flujo de trabajo "Build"

)

Cerrar filter()

/groupby(

Iniciar groupby()

(TestSK, Test/TestName, Date/Date),

Agrupar por el nombre de la prueba y la fecha de ejecución de la prueba

aggregate(

Inicie el agregado. Para todas las ejecuciones de prueba que coinciden con los criterios de filtro anteriores:

ResultCount with sum as TotalCount,

Recuento del número total de ejecuciones de prueba como TotalCount

ResultDurationSeconds with sum as TotalDuration

Suma la duración total de todas las ejecuciones como TotalDuration.

))

Cierre aggregate() y groupby()

/compute(

Iniciar proceso()

TotalDuration div TotalCount as AvgDuration

Para todas las pruebas, ya tenemos el número total de ejecuciones y la duración total. Calcule la duración media por duración total de buceo por número total de ejecuciones.

)

Cerrar compute()

Filtros de consulta

Para determinar los filtros de consulta disponibles, consulte los metadatos como se describe en Exploración de los metadatos de OData de Analytics. Puede filtrar las consultas mediante cualquiera de los valores de NavigationPropertyBinding Path enumerados en entitySet. Para obtener más información sobre el tipo de datos de cada valor, revise los metadatos proporcionados para el EntityType correspondiente. Cada EntitySet corresponde al valor singular de un EntityType.

Por ejemplo, EntitySet Name="TestPoints" corresponde a EntityType Name="TestPoint". Los metadatos de OData para EntitySet Name="TestPoints" se muestran a continuación para v4.0-preview. Puede agregar filtros basados en cualquiera de los valores de NavigationPropertyBinding Path enumerados.

<EntitySet Name="TestPoints" EntityType="Microsoft.VisualStudio.Services.Analytics.Model.TestPoint">
  <NavigationPropertyBinding Path="ChangedOn" Target="Dates"/>
  <NavigationPropertyBinding Path="Project" Target="Projects"/>
  <NavigationPropertyBinding Path="TestSuite" Target="TestSuites"/>
  <NavigationPropertyBinding Path="TestConfiguration" Target="TestConfigurations"/>
  <NavigationPropertyBinding Path="TestCase" Target="WorkItems"/>
  <NavigationPropertyBinding Path="Tester" Target="Users"/>
  <NavigationPropertyBinding Path="AssignedTo" Target="Users"/>
  <Annotation Term="Org.OData.Display.V1.DisplayName" String="Test Points"/>
</EntitySet>

Transformaciones de Power BI

La consulta devuelve algunas columnas que necesita expandir y acoplar en sus campos para poder usarlas en Power BI. En este ejemplo, estas entidades son Test y Date.

Después de cerrar el Editor avanzado y mientras permanece en el Editor de Power Query, seleccione el botón expandir en Prueba y fecha.

Expanda la columna Test and Date (Prueba y fecha)

  1. Elija el botón expandir.

    Power BI + OData - Choose expand button

  2. Active la casilla "(Seleccionar todas las columnas)" para expandir

    Power BI + OData - Select all columns

  3. La tabla contiene ahora la entidad expandida Test.TestName.

    Power BI + OData - Expanded entity

Cambiar el tipo de columna

La consulta no devuelve todas las columnas en el formato en el que puede consumirlas directamente en Power BI informes. Puede cambiar el tipo de columna como se muestra.

  1. Cambie el tipo de columna TotalCount a Número entero.

    Power BI + OData - change Total Count column type.

  2. Cambie el tipo de columna TotalDuration y AvgDuration a Número decimal.

    Power BI + OData - change Total Duration column type.

Cambie el nombre de los campos y la consulta y, a continuación, Cierre & aplicar

Cuando haya terminado, puede optar por cambiar el nombre de las columnas.

  1. Haga clic con el botón derecho en un encabezado de columna y seleccione Cambiar nombre...

    Power BI Rename Columns

  2. También puede cambiar el nombre de la consulta de la consulta predeterminada Query1 a algo más significativo.

    Power BI Rename Query

  3. Una vez hecho, elija Cerrar & aplicar para guardar la consulta y volver a Power BI.

    Power BI Close & Apply

Creación del informe

Power BI muestra los campos en los que puede informar.

Nota:

En el ejemplo siguiente se supone que nadie ha cambiado el nombre de ninguna columna.

Sample - Test Summary - Fields

Para un informe sencillo, siga estos pasos:

  1. Seleccione Power BI Gráfico de líneas de visualización.
  2. Agregue el campo "Date.Date" al eje.
    • Haga clic con el botón derecho en "Date.Date" y seleccione "Date.Date", en lugar de Date Hierarchy (Jerarquía de fechas).
  3. Agregue el campo "AvgDuration" a Valores.
  4. Agregar segmentación de visualización de energía.
  5. Agregue el campo "Test.TestName" al campo de segmentación de datos.

El informe debe tener este aspecto.

Sample - Test Summary - Report

Lista completa de informes de ejemplo de Pipelines

Canalización

Canalización y prueba