Conexión mediante Power Query y funciones de Azure DevOps

  • Artículo

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

El conector de datos para Azure DevOps incluye Power Query funciones M que los autores de consultas pueden usar. Estas funciones pueden controlar los requisitos específicos de Azure DevOps, como la autenticación. En este artículo se describen los argumentos de las funciones y cómo usarlos para conectarse a Analytics.

The VSTS. La función AccountContents es un reemplazo de Power Query función M Web.Contents. Diseñado para escenarios más avanzados, VSTS. AccountContents devuelve el contenido descargado de la dirección URL de Analytics como un valor binario. Puede usarlo para llamar a las API REST de AzureDevOps.

Importante

  • Uso de VSTS. AccountContents solo para acceder a los datos que no están disponibles en Analytics. Extrae datos directamente de Azure DevOps y, para proteger a otros usuarios de Azure DevOps, es susceptible a la limitación. Consulte subdominios admitidos para VSTS. Sección AccountContents más adelante en este artículo. Para obtener información sobre otros enfoques, consulte la introducción a la integración de Power BI.
  • VSTS. AccountContents solo admite datos Azure Boards (elementos de trabajo). El conector de datos no admite otros tipos de datos, como las canalizaciones. Actualmente, no tenemos planes para actualizar el conector para admitir otros tipos de datos.

VSTS. AccountContents

Función avanzada que devuelve el contenido descargado de la dirección URL de Analytics como un valor binario.

La VSTS.AccountContents función tiene los mismos argumentos, opciones y formato de valor devuelto que Web.Contents. Para obtener más información, vea referencia de fórmulas de Power Query (M): Web.Contents.

Si ya usa Web.Contents para acceder a los datos de seguimiento del trabajo desde Analytics (API REST o OData), puede reemplazarlos por VSTS.AccountContents para usar la autenticación del conector de datos. Informa a Power BI de que estas solicitudes hacen referencia al mismo origen de datos. Puede combinar los datos sin infringir las restricciones de origen de datos únicas en el servicio Power BI. Sin embargo, VSTS.AccountContent solo admite datos de Azure Boards y no se puede usar para admitir consultas para canalizaciones u otros servicios.

'VSTS. AccountContents proporciona un subconjunto de los argumentos y las opciones disponibles a través de "OData.Contents". Las limitaciones específicas se describen en la tabla siguiente:

Argumentos para VSTS. Contenido

Argumento Descripción
url Dirección URL a uno de los puntos de conexión de servicio de Azure DevOps.
options Registro de opciones para controlar el comportamiento de esta función.

Campos de opciones para VSTS. Contenido

Campo Descripción
IsRetry Especifique este valor lógico como true omitirá cualquier respuesta existente en la memoria caché al capturar datos.
ManualStatusHandling Especifique este valor como una lista impedirá cualquier control integrado para las solicitudes HTTP cuya respuesta tenga uno de estos códigos de estado.
MaxSize Controla el tamaño máximo de la tabla en la que está interesado el cliente. Si la solicitud supera este límite, el servidor puede producir un error en la solicitud inmediatamente. El valor predeterminado es cero, que indica al servidor de servidores que use su valor predeterminado.
Query Agregue parámetros de consulta mediante programación a la dirección URL.
RelativePath Especifique este valor como texto lo anexa a la dirección URL base antes de realizar la solicitud.
Timeout Especifique este valor como duración para cambiar el tiempo de espera de una solicitud HTTP. El valor predeterminado es 600 segundos.
Version Versión del modelo de datos. Esta opción es principal para los diagnósticos.

Subdominios admitidos para VSTS. AccountContents

Actualmente, el VSTS.AccountContents() método solo funciona para los subdominios que se enumeran a continuación. Otros servicios, como el servicio release, aún no se admiten:

  • https://dev.azure.com/
  • https://analytics.dev.azure.com/
  • https://vsrm.dev.azure.com/