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:
- Si no está familiarizado con Analytics, lea "qué es Analytics" antes de continuar.
- Instale la actualización Power BI DesktopOctober 2018 o una versión más reciente. Puede descargarlo desde la página oficial de descarga de Power BI Desktop.
- 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.
- Los paneles deben estar habilitados. Si está deshabilitado, no se mostrarán las vistas de Analytics . Para volver a habilitar paneles, consulte Activación o desactivación de un servicio de Azure DevOps.
- Asegúrese de que tiene permisos necesarios para acceder a Analytics. Si es miembro del grupo Colaboradores del proyecto, tiene permiso.
- Cree una vista de Analytics que quiera crear un informe de Power BI.
- Revise los artículos knowledge base de Power BI.
- Si no está familiarizado con Analytics, lea qué es Analytics antes de continuar.
- Instale la actualización Power BI DesktopOctober 2018 o una versión más reciente. Puede descargarlo desde la página oficial de descarga de Power BI Desktop.
- Debe ser miembro de un proyecto con acceso Básico o superior. Si aún no tiene un proyecto, cree uno.
- 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.
- Comprobar que Analytics] está instalado y, si no es así, habilitelo. Debe ser propietario de la cuenta o miembro del grupo Administradores de colección de proyectos para agregar extensiones o habilitar el servicio.
- Los paneles deben estar habilitados. Si está deshabilitado, no se mostrarán las vistas de Analytics . Para volver a habilitar paneles, consulte Activación o desactivación de un servicio de Azure DevOps.
- Asegúrese de que tiene permisos necesarios para acceder a Analytics. Si es miembro del grupo Colaboradores del proyecto, tiene permiso.
- Cree una vista de Analytics que quiera crear un informe de Power BI.
- Revise los artículos knowledge base de Power BI.
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
Abra Power BI Desktop.
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.
Elija Conectar tras la comprobación de sus credenciales.
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.
Especifique los parámetros básicos para conectarse a los datos.
- 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, mientrasDevice
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.
- 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 "
Selección de la vista Análisis
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.
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.
Seleccione la vista.
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.
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.
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.
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.
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.
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.
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.
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.