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

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

En esta sección, se proporcionan ejemplos de 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 siguientes secciones e información:

  • Consultas de ejemplo: la consulta Power BI y la consulta OData sin procesar que se usan para extraer datos en Power BI
  • Power BI transformaciones: pasos para transformar los datos en un formato que se puede notificar
  • Crear el informe: pasos para crear un informe simple a partir de los datos
  • Consultas adicionales: consultas de ejemplo adicionales 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, ahora se agrega. 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á deshabilitada, no se mostrarán las vistas de Analytics. Para volver a habilitar un servicio, consulte Activación o desactivación Azure DevOps servicio de mantenimiento
  • Para usar vistas de Analytics, habilite la característica vista previa Vistas de análisis para usuarios individuales o para la organización.
  • Además, debe tener el permiso *Ver análisis 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 ejecutar una consulta de OData para Analytics, debe tener el permiso de 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 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, ahora se agrega. 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 esta opción. Debe ser propietario de la cuenta o miembro del grupo administrador de Project recopilación 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á deshabilitada, no se mostrarán las vistas de Analytics. Para volver a habilitar un servicio, consulte Activación o desactivación Azure DevOps servicio de mantenimiento
  • Para usar vistas de Analytics, habilite la característica vista previa Vistas de análisis para usuarios individuales o para la organización.
  • Además, debe tener el permiso *Ver análisis 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 ejecutar una consulta de OData para Analytics, debe tener el permiso de 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 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.

Una Power BI consulta

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

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

    Power BI: consulta en blanco

  2. En el editor Power BI query, seleccione Editor avanzado.

    Power BI: seleccione Editor avanzado

  3. Se abre Editor avanzado ventana de configuración.

    Power BI: Editor avanzado

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

    Power BI - Editor avanzado - Consulta pegada

  5. Las consultas de ejemplo tienen cadenas que se deben sustituir por sus valores, como {organization} y {project}.

    • {organization}: nombre de la organización
    • {project}: nombre del proyecto de equipo. O bien, omita por completo "/{project}" para una consulta entre proyectos.

    En función de la consulta de ejemplo, puede haber una o varias cadenas adicionales que sustituir, 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: YYYY-MM-D JPEG. Ejemplo: 2019-04-01Z representa 2019-April-01. No incluya entre 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 desee modificar y probar la consulta de OData por separado, antes de usarlo en Power BI. Este método proporciona más flexibilidad, pero implica pasos adicionales antes de usar la consulta de OData en Power BI como se describe en Conectar mediante consultas 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.