Consultas com âmbito de projeto e de organização

Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022

Usando o Analytics for Azure DevOps, você pode construir consultas com escopo para um projeto, uma organização ou coleção. Você pode executar essas consultas diretamente em seu navegador ou no Power BI.

As consultas de escopo do projeto ajudam a responder perguntas sobre um único projeto, enquanto as consultas de escopo de organização e coleção permitem que você responda a perguntas que cruzam os limites do projeto. As consultas com escopo de organização e coleta exigem permissões de usuário mais amplas ou restrições de escopo cuidadosas para garantir que sua consulta não seja bloqueada devido à falta de permissões.

Pré-requisitos

Consultas com alcance de projeto

Você constrói uma consulta inserindo a URL OData em um navegador da Web compatível.

A URL base para uma consulta OData no nível do projeto é conforme mostrado na sintaxe a seguir.

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}/

https://{servername}:{port}/tfs/{CollectionName}/{ProjectName}/_odata/{version}/

Devolver uma contagem de itens de trabalho

Por exemplo, a seguinte consulta com escopo de projeto retorna a contagem de itens de trabalho para um projeto específico.

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/v1.0/WorkItems/$count

Por exemplo, uma consulta do projeto Fabrikam Fiber retorna uma contagem de 7.126 itens de trabalho. Os itens de trabalho excluídos não são incluídos na contagem.

https://analytics.dev.azure.com/fabrikam/Fabrikam Fiber/_odata/v1.0/WorkItems/$count

7126

Retornar os caminhos da área do projeto

Da mesma forma, a seqüência de caracteres de consulta a seguir retorna as áreas para um projeto específico:

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/v1.0/Areas

É equivalente ao seguinte filtro em uma consulta com escopo da organização:

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/Areas?
  $filter=Project/ProjectName eq '{ProjectName}'

Por exemplo, uma consulta do projeto Fabrikam Fiber retorna todas as propriedades definidas para um caminho de área, pois nenhum $select operador é aplicado na consulta.

https://analytics.dev.azure.com/fabrikam/Fabrikam Fiber/_odata/v1.0/Areas

O exemplo a seguir mostra os dados retornados para um único Area Path.

ProjectSK	"56af920d-393b-4236-9a07-24439ccaa85c"
AreaSK	"26be05fd-e68a-4fcb-833f-497f6bee45f2"
AreaId	"26be05fd-e68a-4fcb-833f-497f6bee45f2"
AreaName	"Service Delivery"
Number	55373
AreaPath	"Fabrikam Fiber\\Service Delivery"
AreaLevel1	"Fabrikam Fiber"
AreaLevel2	"Service Delivery"
AreaLevel3	null
AreaLevel4	null
AreaLevel5	null
AreaLevel6	null
AreaLevel7	null
AreaLevel8	null
AreaLevel9	null
AreaLevel10	null
AreaLevel11	null
AreaLevel12	null
AreaLevel13	null
AreaLevel14	null
Depth	1

Utilização da opção $expand

Ao usar uma consulta com escopo de projeto com uma $expand opção, não é necessário fornecer outros filtros.

Por exemplo, o seguinte filtro com escopo de projeto:

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/v1.0/WorkItems?
  $expand=Parent

É filtrado automaticamente para reforçar a segurança:

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $filter=ProjectName eq '{ProjectName}'
  &$expand=Parent($filter=ProjectName eq '{ProjectName}')

Consultas no âmbito da organização

A URL base para consultas no nível da organização é a mostrada:

https://analytics.dev.azure.com/{OrganizationName}/_odata/v1.0

Ao utilizar uma consulta com abrangência da organização com a opção $expand, deve fornecer outro filtro.

Por exemplo, a seguinte consulta com escopo organizacional usa um $expand para recuperar os filhos de todos os itens de trabalho.

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $filter=Project/ProjectName eq '{ProjectName}'
  &$expand=Children

Requer outro filtro para verificar se as crianças estão limitadas ao projeto especificado:

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $filter=Project/ProjectName eq '{ProjectName}'
  &$expand=Children($filter=Project/ProjectName eq '{ProjectName}')

Devolver o pai de todos os itens de trabalho

A seguinte consulta utiliza uma opção de $expand para recuperar o item de trabalho pai de todos os itens.

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $filter=Project/ProjectName eq '{ProjectName}'
  &$expand=Parent

Ele requer outro filtro para verificar se o pai está limitado ao projeto especificado:

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $filter=Project/ProjectName eq '{ProjectName}'
  &$expand=Parent($filter=Project/ProjectName eq '{ProjectName}')

Sem o filtro adicional, a solicitação falhará se o pai de qualquer item de trabalho referenciar itens de trabalho em um projeto ao qual você não tem acesso de leitura .

Restrições de segurança ao nível do projeto

O Google Analytics tem mais algumas restrições na sintaxe de consulta relacionada à segurança no nível do projeto.

Os any ou all filtros aplicam-se à entidade base em uma $expand. Para filtros baseados em um projeto, ignoramos explicitamente o filtro ao usar um $expand:

Por exemplo, a seguinte consulta:

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $filter=ProjectName eq '{ProjectName}'
  &$expand=Children($filter=Project/ProjectName eq '{ProjectName}')

É interpretado como:

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $filter=ProjectName eq '{ProjectName}'
  &$expand=Children

E falha se você não tiver acesso a todos os projetos.

Para contornar a restrição, você precisa adicionar uma expressão extra no $filter:

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $filter=ProjectName eq '{ProjectName}' and Children/any(r: r/ProjectName eq '{ProjectName}')
  &$expand=Children

O uso $level só é suportado se você tiver acesso a todos os projetos da coleção ou ao usar uma consulta com escopo de projeto:

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $expand=Children($levels=2;$filter=ProjectName eq '{ProjectName}')

O Google Analytics não oferece suporte a nenhuma referência de nível cruzado para projetos que usam a $it cláusula. Como exemplo, a consulta a seguir faz referência ao ProjectName item de trabalho raiz usando o alias $it, que não é suportado:

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $expand=Links(
    $expand=TargetWorkItem;
    $filter=TargetWorkItem/Project/ProjectName eq $it/Project/ProjectName)

Próximo passo

Artigos relacionados

• Orientações de consulta