Conexión a Analytics con El conector de datos de Power BI

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

El conector de datos de Power BI usa vistas de análisis.

Importante

Las vistas de Analytics solo admiten datos Azure Boards (elementos de trabajo). Las vistas de Análisis no admiten otros tipos de datos, como canalizaciones. Las vistas proporcionan una lista plana de elementos de trabajo y no admiten jerarquías de elementos de trabajo. En este momento, no tenemos planes de actualizar el conector para admitir otros tipos de datos. Para obtener información sobre otros enfoques, consulte Introducción a la integración de Power BI.

Requisitos previos

Siga los pasos que se indican a continuación para empezar a usar el conector de datos de Power BI de Azure DevOps:

Importante

Azure DevOps ya no admite la autenticación de credenciales alternativas desde el 2 de marzo de 2020. Si sigue usando credenciales alternativas, le recomendamos encarecidamente que cambie a un método de autenticación más seguro (por ejemplo, tokens de acceso personal). Más información.

Conexión a una vista de Analytics

  1. Abra Power BI Desktop.

  2. Inicie sesión en el servicio. Tras el acceso por primera vez, se le pedirá que inicie sesión y que sus credenciales se autentiquen. Power BI Desktop guarda las credenciales para que solo tenga que hacerlo una vez.

    Elija entre estas dos opciones de autenticación:

    • Seleccione Windows si desea iniciar sesión con Windows.

    • Seleccione Token de acceso personal si desea usar un token de acceso personal.

      Cuadro de diálogo de inicio de sesión

  3. Elija Conectar tras la comprobación de sus credenciales.

    Cuadro de diálogo Conectar

  4. Elija (1) Obtener datos, (2) Online Services y (3) Azure DevOps (solo paneles) para servicios en la nube o Azure DevOps Server (solo paneles) para el entorno local. A continuación, elija Conectar. Las vistas de Analytics solo admiten consultas en elementos de trabajo y casos de prueba.

    Conexión a datos

  5. Especifique los parámetros básicos para conectarse a los datos.

    Especifique el nombre de la organización y del proyecto.

    Especifique el nombre de la organización y del proyecto, versión local.

    • En Dirección URL de colección, escriba la dirección URL donde se hospeda la instancia de Azure DevOps Server. Por ejemplo, una dirección URL de ejemplo es "http://fabrikam-server/AzureDevOpsServer/fabrikam-collection".
    • En Proyecto de equipo, escriba solo el nombre del proyecto (por ejemplo, use Fabrikam-Fiber si la dirección URL de la instancia de Azure DevOps Server es "http://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber").

    Importante

    No confunda el nombre del equipo con el nombre del proyecto, un error común. Si la dirección URL que usa diariamente es "http://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber-Git/Device", Fabrikam-Fiber-Git es el nombre del proyecto, mientras Device que es el nombre del equipo.

    Tras iniciar sesión correctamente, Power BI comprueba si las credenciales de usuario tienen los permisos adecuados para acceder al proyecto especificado. Si surgen errores, consulte la sección Q & A , ya que trata los problemas más comunes.

Selección de la vista Análisis

  1. Expanda la carpeta Vistas compartidas , elija una vista De análisis y, a continuación, elija Cargar. El conector de datos presenta una lista de vistas de Análisis disponibles. Cada vista representa un conjunto de datos que puede extraer en Power BI. También puede crear vistas de Análisis personalizadas.

    En la imagen siguiente se muestran las vistas de Analytics predeterminadas. La lista de vistas puede diferir en función del modelo de proceso usado para crear el proyecto. Todas las vistas enumeradas, excepto las anexadas con "Today", proporcionarán datos históricos de tendencias.

    Aquí elegimos Historias - Últimos 30 días. Esta vista filtra los elementos de trabajo pendiente del producto.

    Cuadro de diálogo Navegador, Elegir una vista de Análisis

    Nota

    Dado que ha comprobado la vista en la sección anterior, la vista debe cargarse. Sin embargo, si la vista no se carga, lo más probable es que el conjunto de datos sea demasiado grande. Vuelva a la vista en la vista Analytics del portal web y ajuste los filtros para reducir el tamaño del conjunto de datos.

  2. Seleccione la vista.

    Cuadro de diálogo Navegador, vistas predeterminadas

    Nota

    La vista previa que se muestra para las vistas seleccionadas en el navegador se puede truncar según el número de campos seleccionados y el tamaño del conjunto de datos. Los datos solo se truncan para la versión preliminar y no afectarán a la actualización de datos completa.

    Elija Elementos de trabajo: tabla Hoy y espere a que se cargue la vista previa. Representa el estado actual de todos los elementos de trabajo del proyecto.

    Active la casilla situada junto a la tabla Elementos de trabajo - Hoy y elija Cargar.

    Nota

    Las vistas de Análisis no aplican filtros que se han definido mediante Power BI en el servidor. Los filtros aplicados en Power BI limitarán los datos mostrados a los usuarios finales, pero no reducirán la cantidad de datos recuperados de Analytics. Si el filtro está pensado para reducir el tamaño del conjunto de datos, se debe aplicar mediante la personalización de la vista.

  3. Espere a que se carguen los datos. Puede observar su progreso examinando los mensajes de estado, que aparecen directamente bajo el nombre de la tabla. Si ve algún error, consulte la sección Q & A , ya que trata los problemas más comunes.

    Cuadro de diálogo Aplicar cambios de consulta de carga

  4. Revise el modelo de datos. Mientras se carga el modelo, revise el diseño del conjunto de datos para El conector de datos de Power BI.

Creación del informe

Cree informes basados en los datos cargados. Una vez finalizada la operación de carga, puede explorar los datos mediante la creación de informes personalizados. Para obtener ejemplos de informes comunes, consulte Informes de ejemplo: uso del conector de datos.

Vista de informe de Power BI Desktop

Preguntas y respuestas

P: ¿Cómo debo leer los mensajes de error procedentes del conector?

Un: Es posible que se sienta difícil leer mensajes de error procedentes del conector porque normalmente contienen información contextual adicional. Si se produce un error en la operación de carga, el mensaje comienza con Error al guardar las modificaciones en el servidor.... Cuando lo vea, busque [DataSource.Error] Azure DevOps...:. El texto siguiente es el mensaje de error real devuelto desde el conector.

En el ejemplo siguiente, la parte más importante del mensaje de error es:

El resultado de la consulta supera el tamaño máximo. Reduzca el número de registros aplicando filtros adicionales.

Captura de pantalla que muestra la excepción QueryExceedsPreferredMaxSize.

P: Cómo resolver el resultado de la consulta supera el tamaño máximo. ¿Reduzca el número de registros aplicando errores de filtros adicionales?

Un: Obtendrá el siguiente error si el número de registros recuperados de Analytics supera los 250 000.

No se pudieron guardar las modificaciones en el servidor. Error devuelto: 'OLE DB o ODBC error: [DataSource.Error] VSTS: Error de solicitud: El servidor remoto devolvió un error: (400) Solicitud incorrecta. (El resultado de la consulta supera el tamaño máximo. Reduzca el número de registros aplicando filtros adicionales).

Este error suele producirse cuando el proyecto tiene un gran número de elementos de trabajo. El tamaño del conjunto de datos debe reducirse personalizando la vista. Hágalo antes de usarlo en Power BI.

El resultado de la consulta supera el tamaño máximo. Reduzca el número de registros aplicando filtros adicionales.

P: Cómo resolver el error ¿El usuario no estaba autorizado?

El usuario no estaba autorizado.

Un: Puede encontrar este error si intenta acceder a un proyecto al que no tiene permisos. También lo verá si Power BI no reconoce sus credenciales. Para comprobar los permisos, consulte Establecimiento de permisos para acceder a las vistas de Analytics y Analytics. Si se trata de un problema de credenciales, debe trabajar con el administrador para ver si pueden ayudar a resolver el problema. Para más información, consulte Seguridad de Power BI, Autenticación de usuarios y Solución de problemas de inicio de sesión para Power BI.

El usuario no estaba autorizado.

Nota

Power BI usa Azure Active Directory (AAD) para autenticar a los usuarios que inician sesión en el servicio Power BI y, a su vez, usa las credenciales de inicio de sesión de Power BI siempre que un usuario intenta acceder a recursos que requieren autenticación. Los usuarios inician sesión en el servicio Power BI con la dirección de correo electrónico usada para establecer la cuenta de Power BI; Power BI usa ese correo electrónico de inicio de sesión como nombre de usuario en vigor y lo pasa a los recursos cuando un usuario intenta conectarse a los datos. El nombre de usuario efectivo se asigna después a un Nombre principal de usuario (UPN) y se resuelve en la cuenta de dominio de Windows asociada, en la que se aplica la autenticación.

P: ¿Cómo resolver el error Acceso al recurso está prohibido?

El acceso al recurso está prohibido.

Un: Puede encontrar este error si tiene acceso a un proyecto determinado, pero no tiene los permisos ver análisis . Trabaje con el administrador del proyecto para obtener estos permisos. Para más información sobre el modelo de seguridad, consulte Seguridad de Analytics.

El acceso al recurso está prohibido.

P: Cómo resolver el proyecto "X" no existe o no tiene permisos para acceder a él?

Hemos encontrado un error al intentar conectarse.
Detalles: parámetro "Project" no válido. El proyecto "X" no existe o no tiene permisos para acceder a él.

Un: Este error indica que el valor especificado para Nombre del proyecto no corresponde a ningún proyecto. Un error común que pueden cometer los usuarios es confundir el nombre del proyecto con un nombre de equipo.

Si la dirección URL que usa cada día es "https://dev.azure.com/fabrikam-fiber-inc/Fabrikam-Fiber-Git/Device", Fabrikam-Fiber-Git es el nombre del proyecto y se debe usar en el parámetro . Device es el nombre del equipo.

ProjectNotFoundError