Agregar una segmentación de equipo a un informe de Power BI

Artículo
04/18/2022
Tiempo de lectura: 7 minutos

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019

A menudo, los informes Power BI incluyen datos de varios equipos para la agregación y comparación. En este artículo se muestra cómo agregar una segmentación de equipos a un informe de Power BI existente. La segmentación equipo permite filtrar los datos del informe por Teams, en lugar de ruta de acceso del área.

Importante

El filtro Equipo requiere que el campo "AreaSK" se incluya en la consulta usada por el informe que desea filtrar. Todas las consultas proporcionadas en los informes de ejemplo ya incluyen "AreaSK". Si ha creado su propia consulta, asegúrese de que devuelve "AreaSK" en las cláusulas $select o groupby().

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 un conocimiento básico 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 agregará ahora. Cualquier persona con acceso al proyecto, excepto las partes interesadas, puede ver las vistas de Analytics.
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 Activación o desactivación de un servicio de Azure DevOps
Para usar 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 establecido el permiso *View Analytics 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 compartidas de Analytics, debe tener el permiso *Editar vistas compartidas de Analytics establecido en Permitir. Para más información, consulte Concesión de permisos para acceder al servicio Analytics.

Debe ser miembro de un proyecto con acceso Básico o superior. Si no se ha agregado como miembro del proyecto, se agregará ahora. Cualquier persona con acceso al proyecto, excepto las partes interesadas, puede ver las vistas de Analytics.
Compruebe que Analytics está instalado y, si no es así, habilite. Debe ser propietario de la cuenta o miembro del grupo administradores de recopilación de Project para agregar extensiones o habilitar el servicio.
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 Activación o desactivación de un servicio de Azure DevOps
Para usar 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 establecido el permiso *View Analytics 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 vistas compartidas de Analytics, debe tener establecido el permiso Editar vistas de Analytics compartidas en Permitir. Para más información, consulte Concesión de permisos para acceder al servicio Analytics.

Consultas de ejemplo

Deberá agregar otra consulta al informe de Power BI. La consulta siguiente devuelve la asignación entre Teams y rutas de acceso de área.

consulta de Power BI
Consulta de OData

Puede pegar la consulta 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/v1.0/Areas?"
        &"$filter=startswith(AreaPath,'{areapath}') "
            &"&$select=AreaSK,AreaPath "
            &"&$expand=Teams($select=TeamName) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Puede usar el siguiente código de consulta de OData para modificar o probar la consulta antes de usarla en Power BI. Para obtener más información, consulte Conectar mediante consultas de Power BI y OData.

https://analytics.dev.azure.com/{organization}/{project}/_odata/v1.0/Areas?
        $filter=startswith(AreaPath,'{areapath}')
            &$select=AreaSK,AreaPath
            &$expand=Teams($select=TeamName)

Cadenas de sustitución

Cada consulta contiene las siguientes cadenas que debe sustituir por los valores. No incluya corchetes {} con la sustitución. Por ejemplo, si el nombre de la organización es "Fabrikam", reemplace {organization} por Fabrikam, no por {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.

Desglose de consultas

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

Elemento de consulta

Descripción

$filter=startswith(AreaPath, '{areapath}')

Devuelve todos los equipos asignados a una ruta de acceso de área en o bajo el especificado {areapath}. Para incluir todos los equipos de un proyecto, omita esta instrucción.

&$select=AreaSK, AreaPath

Devolver campos de ruta de área, para usarlos para la asignación

&$expand=Teams($select=TeamName)

Devolver el equipo asociado a la ruta de acceso del área

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 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 a un EntityType.

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

<EntitySet Name="WorkItemSnapshot" EntityType="Microsoft.VisualStudio.Services.Analytics.Model.WorkItemSnapshot">
  <NavigationPropertyBinding Path="Date" Target="Dates"/>
  <NavigationPropertyBinding Path="RevisedOn" Target="Dates"/>
  <NavigationPropertyBinding Path="Teams" Target="Teams"/>
  <NavigationPropertyBinding Path="Processes" Target="Processes"/>
  <NavigationPropertyBinding Path="Project" Target="Projects"/>
  <NavigationPropertyBinding Path="Area" Target="Areas"/>
  <NavigationPropertyBinding Path="Iteration" Target="Iterations"/>
  <NavigationPropertyBinding Path="AssignedTo" Target="Users"/>
  <NavigationPropertyBinding Path="ChangedBy" Target="Users"/>
  <NavigationPropertyBinding Path="CreatedBy" Target="Users"/>
  <NavigationPropertyBinding Path="ActivatedBy" Target="Users"/>
  <NavigationPropertyBinding Path="ClosedBy" Target="Users"/>
  <NavigationPropertyBinding Path="ResolvedBy" Target="Users"/>
  <NavigationPropertyBinding Path="Tags" Target="Tags"/>
  <NavigationPropertyBinding Path="ChangedOn" Target="Dates"/>
  <NavigationPropertyBinding Path="ClosedOn" Target="Dates"/>
  <NavigationPropertyBinding Path="CreatedOn" Target="Dates"/>
  <NavigationPropertyBinding Path="ResolvedOn" Target="Dates"/>
  <NavigationPropertyBinding Path="StateChangeOn" Target="Dates"/>
  <NavigationPropertyBinding Path="InProgressOn" Target="Dates"/>
  <NavigationPropertyBinding Path="CompletedOn" Target="Dates"/>
</EntitySet>

transformaciones de Power BI

Expanda la columna Teams

Elija el botón expandir.
Seleccione los campos que se van a acoplar.
La tabla ahora contendrá campos de entidad.

Cambiar el nombre de los campos y la consulta y, a continuación, Cerrar & aplicar

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

Haga clic con el botón derecho en un encabezado de columna y seleccione Cambiar nombre...
También puede cambiar el nombre de la consulta de la consulta predeterminada Query1 a algo más significativo.
Una vez hecho esto, elija Cerrar & aplicar para guardar la consulta y volver a Power BI.

Crear una relación mediante "AreaSK"

Después de seleccionar Cerrar & aplicar y volver a Power BI, siga estos pasos:

Seleccione el menú Modelado.
Seleccione Administrar relaciones
Cree una relación entre la consulta informe y la consulta Teams. Es probable que Power BI detecte automáticamente y cree la relación automáticamente. Este es un ejemplo de una relación entre la consulta en el informe Open Bugs y la consulta Teams:

Agregar el filtro de equipo a un informe existente

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.

The example assumes that no one renamed any columns.

Para agregar un filtro de equipo al informe de Power BI, siga estos pasos:

Seleccionar segmentación de visualización
Agregue el campo "Team.TeamName" al campo

En el ejemplo siguiente se muestra el informe Open Bugs con un filtro Team agregado. Al seleccionar un equipo en la segmentación de datos se filtran los resultados del informe Abrir errores. Funcionará para cualquier informe, siempre y cuando su consulta devuelva AreaSK.

Team Slicer report

Consultas adicionales

Puede usar las siguientes consultas adicionales para crear informes diferentes pero similares. Puede usar estas consultas con los pasos definidos anteriormente.

Filtrar por Teams, en lugar de ruta de acceso del área

Esta consulta es la misma que la usada anteriormente, salvo que filtra por Nombre del equipo en lugar de por Ruta de acceso del área.

consulta de Power BI
Consulta de OData

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v1.0/Areas?"
        &"$filter=(Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname}) "
            &"&$select=AreaSK,AreaPath "
            &"&$expand=Teams($select=TeamName) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v1.0/Areas?
        $filter=(Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname})
            &$select=AreaSK,AreaPath
            &$expand=Teams($select=TeamName)