Información general sobre informes de ejemplo mediante consultas de OData

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

En este artículo, se proporcionan ejemplos para los informes más populares:


Azure Boards

Azure Test Plans



Canalización

Canalización y prueba




Todos los artículos de informe de ejemplo proporcionan las secciones e información siguientes:

  • Consultas de ejemplo: consulta de Power BI y consulta OData sin procesar que se usa para extraer datos en Power BI
  • Transformaciones de Power BI: pasos para transformar los datos en un formato notificable
  • Creación del informe : pasos para crear un informe simple a partir de los datos
  • Consultas adicionales : otras consultas de ejemplo para informes similares, pero diferentes.

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, los paneles deben estar habilitados . 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 colección de proyectos 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, los paneles deben estar habilitados . 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.

Una consulta de Power BI

Empiece a trabajar rápidamente con los pasos siguientes que insertan la consulta de OData en la consulta de Power BI. La consulta se puede pegar directamente en el editor de consultas avanzadas de Power BI de la siguiente manera:

  1. Seleccione Obtener datos y, después, Consulta en blanco.

    Power BI: consulta en blanco

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

    Power BI: selección de Editor avanzado

  3. Se abre la ventana Editor avanzado.

    Power BI: Editor avanzado

  4. Reemplace el contenido por una de las consultas de ejemplo proporcionadas en los artículos vinculados enumerados en la parte superior de este artículo.

    Power BI: Editor avanzado: consulta pegada

  5. Las consultas de ejemplo tienen cadenas que deben sustituirse por los valores, como {organization} y {project}.

    • {organization} - El nombre de la organización
    • {project} - El nombre del proyecto de equipo. Omita "/{project}" por completo para una consulta entre proyectos.

    En función de la consulta de ejemplo, puede haber una o más cadenas que reemplazar, como:

    • {areapath} - Ruta de acceso del área. Formato: Project\Level1\Level2
    • {iterationpath} - Ruta de acceso de iteración. Formato: Project\Level1\Level2
    • {startdate} - La fecha en la que se va a iniciar el informe de tendencias. Formato: AAAA-MM-DDZ. Ejemplo: 2019-04-01Z representa 2019-abril-01. No incluya comillas.

    Power BI: Editor avanzado: reemplazar cadenas en la consulta

  6. Para ejecutar la consulta, seleccione Listo.

    Si nunca se ha conectado a su cuenta, Power BI puede requerir que se autentique. Para más información, consulte Opciones de autenticación de cliente.

Consulta de OData sin procesar

La consulta de OData se proporciona en caso de que quiera modificar y probar la consulta de OData por separado, antes de usarla en Power BI. Este método proporciona más flexibilidad, pero implica otros pasos antes de usar la consulta de OData en Power BI, como se describe en Conexión mediante consultas de Power BI y OData.

Para obtener más información sobre cómo escribir consultas de OData en Analytics, consulte la referencia rápida de consultas de OData.