Creación de un informe de Power BI con una consulta de OData

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

Con Power BI Desktop, puede empezar a crear fácilmente informes para su proyecto en Azure DevOps.

Si no tiene Power BI Desktop, puede descargarlo e instalarlo de forma gratuita.

Requisitos previos

Categoría	Requisitos
Niveles de acceso	- Miembro del proyecto. - Al menos acceso Básico.
Permisos	El permiso View Analytics se ha establecido en Permitir. Para obtener más información, consulte Otorgar permisos para el acceso a Análisis.
Herramientas	- Azure Boards habilitadas - Power BI Desktop
Tareas	Supervise los elementos de trabajo durante un período especificado para generar un informe de tendencias.

Crear una consulta de Power BI

Cree una consulta de Power BI para extraer los datos en Power BI de la siguiente manera:

1. Elija Obtener datos y, a continuación, Consulta en blanco.

   

2. En el editor de consultas de Power BI, seleccione Editor avanzado.

   

3. Se abre la ventana Editor avanzado.

   

4. Reemplace el contenido con la siguiente consulta:

   let
      The query you provided has a syntax issue due to the placement of double quotes. Specifically, the `$apply` and `$orderby` parameters should be part of the URL string, but they are not correctly concatenated. Here is the corrected version:
   
   

let
   Source = OData.Feed (
      "https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/WorkItemSnapshot?"
      &"$apply=filter("
      &"WorkItemType eq 'Bug' "
      &"AND StateCategory ne 'Completed' "
      &"AND startswith(Area/AreaPath,'{areapath}') "
      &"AND DateValue ge {startdate} )/"
      &"groupby((DateValue,State,WorkItemType,Area/AreaPath), aggregate($count as Count))"
      &"&$orderby=DateValue",
      null, [Implementation="2.0", OmitValues = ODataOmitValues.Nulls, ODataVersion = 4]
   )
in
    Source

1. Sustituya sus valores dentro de la consulta de ejemplo.

   La consulta de ejemplo tiene cadenas que debe sustituir por sus valores:

   • {organization} - Nombre de su organización
   • {project} - El nombre de su proyecto de equipo. O bien omita /{project} por completo, para una consulta entre proyectos
   • {areapath} - Ruta de acceso del área. Formato: Project\Level1\Level2
   • {startdate} - La fecha de inicio del informe de tendencias. Formato: AAAA-MM-DDZ. Ejemplo: 2022-09-01Z representa el 01 de septiembre de 2022. No incluir entre comillas.

   

2. Seleccione Hecho para ejecutar la consulta.

   Es posible que Power BI le pida que se autentique. Para obtener más información, consulte Opciones de autenticación del cliente.

Expandir columnas Área, Iteración, AssignedTo

La consulta devuelve varias columnas que debe expandir antes de poder utilizarlas en Power BI. Cualquier entidad extraída mediante una instrucción $expand devuelve un registro con varios campos potenciales. Es necesario expandir el registro para aplanar la entidad en sus campos. Ejemplos de este tipo de entidades son: AssignedTo, Iteration y Area.

Después de cerrar el Editor avanzado y mientras permanece en el Editor Power Query, seleccione el botón expandir en las entidades que necesita aplanar.

1. Por ejemplo, elija el botón expandir para Área, seleccione las propiedades que desea expandir y elija OK. Aquí, elegimos AreaName y AreaPath para aplanar. La propiedad AreaName es similar al campo Nombre de nodo.

   

   Nota:

   Las propiedades disponibles para seleccionar dependen de las propiedades solicitadas para devolver en la consulta. Si no especifica ninguna propiedad, estarán disponibles todas las propiedades. Para obtener más información sobre estas propiedades, consulte las siguientes referencias de metadatos: Áreas, Iteraciones y Usuarios.

2. La tabla contiene ahora campos de entidad.

   

3. Repita los pasos 1 a 3 para todos los campos que representen entidades que necesiten expandirse. Estos campos aparecen con Registro en la columna de la tabla cuando no están expandidos.

Renombrar campos y consulta, luego Cerrar y aplicar

Cuando termine, puede optar por renombrar columnas.

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

   

2. También es posible que desee cambiar el nombre de la consulta del valor predeterminado Query1, a algo más significativo.

   

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

   

Creación del informe

Power BI le muestra los campos sobre los que puede informar.

Nota:

En el siguiente ejemplo se asume que no se ha renombrado ninguna columna.

Para un informe sencillo, realice los siguientes pasos:

1. Seleccione Visualización de Power BI Gráfico de líneas.
2. Añada el campo "DateValue" a Eje.
   • Haga clic con el botón derecho en "DateValue" y seleccione "DateValue", en lugar de Jerarquía de fechas
3. Añada el campo "Estado" a Leyenda
4. Añada el campo "Recuento" a Valores.
   • Haga clic con el botón derecho en el campo WorkItemId y asegúrese de que Suma está seleccionado

Informe de muestra:

Pasos siguientes

Creación de un informe de errores abiertos

Artículos relacionados

• Explore informes de ejemplo utilizando consultas OData
• Construir consultas OData para Analytics
• Conectarse a Power BI utilizando consultas OData
• Referirse a metadatos para Azure Boards Analytics
• Acceder a los informes de muestra y al índice de referencia rápida
• Agregar una segmentación de equipo a un informe existente