Queries - Search Queries

Pesquisa todas as consultas às quais o usuário tem acesso no projeto atual

GET https://dev.azure.com/{organization}/{project}/_apis/wit/queries?$filter={$filter}&api-version=7.1-preview.2
GET https://dev.azure.com/{organization}/{project}/_apis/wit/queries?$filter={$filter}&$top={$top}&$expand={$expand}&$includeDeleted={$includeDeleted}&api-version=7.1-preview.2

Parâmetros de URI

Nome Em Obrigatório Tipo Description
organization
path True

string

O nome da organização do Azure DevOps.

project
path True

string

ID do projeto ou nome do projeto

$filter
query True

string

O texto com o qual filtrar as consultas.

api-version
query True

string

Versão da API a ser usada. Isso deve ser definido como '7.1-preview.2' para usar essa versão da api.

$expand
query

QueryExpand

$includeDeleted
query

boolean

Incluir consultas e pastas excluídas

$top
query

integer

int32

O número de consultas a serem retornadas (o padrão é 50 e o máximo é 200).

Respostas

Nome Tipo Description
200 OK

QueryHierarchyItemsResult

operação bem-sucedida

Segurança

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

Nome Description
vso.work Concede a capacidade de ler itens de trabalho, consultas, quadros, caminhos de área e iterações e outros metadados relacionados ao acompanhamento de itens de trabalho. Também concede a capacidade de executar consultas, pesquisar itens de trabalho e receber notificações sobre eventos de item de trabalho por meio de ganchos de serviço.

Definições

Nome Description
IdentityReference

Descreve uma referência a uma identidade.

LinkQueryMode

O modo de consulta de link.

LogicalOperation

Operador lógico que separa a cláusula condition

QueryExpand

Os parâmetros de expansão para consultas. As opções possíveis são { None, Wiql, Clauses, All, Minimal }

QueryHierarchyItem

Representa um item na hierarquia de consulta do item de trabalho. Isso pode ser uma consulta ou uma pasta.

QueryHierarchyItemsResult
QueryRecursionOption

A opção de recursão para uso em uma consulta de árvore.

QueryType

O tipo de consulta.

ReferenceLinks

A classe para representar uma coleção de links de referência REST.

WorkItemFieldOperation

Descreve uma operação de campo de item de trabalho.

WorkItemFieldReference

Referência a um campo em um item de trabalho

WorkItemQueryClause

Representa uma cláusula em uma consulta de item de trabalho. Isso mostra a estrutura de uma consulta de item de trabalho.

WorkItemQuerySortColumn

Uma coluna de classificação.

IdentityReference

Descreve uma referência a uma identidade.

Nome Tipo Description
_links

ReferenceLinks

Esse campo contém zero ou mais links interessantes sobre o assunto do grafo. Esses links podem ser invocados para obter relações adicionais ou informações mais detalhadas sobre esse assunto do grafo.

descriptor

string

O descritor é a principal maneira de referenciar o assunto do grafo enquanto o sistema está em execução. Esse campo identificará exclusivamente o mesmo assunto de grafo entre contas e organizações.

directoryAlias

string

Preterido – pode ser recuperado consultando o usuário do Graph referenciado na entrada "self" do dicionário IdentityRef "_links"

displayName

string

Esse é o nome de exibição não exclusivo do assunto do grafo. Para alterar esse campo, você deve alterar seu valor no provedor de origem.

id

string

imageUrl

string

Preterido – Disponível na entrada "avatar" do dicionário IdentityRef "_links"

inactive

boolean

Preterido – pode ser recuperado consultando o estado de associação do Graph referenciado na entrada "membershipState" do dicionário "_links" do GraphUser

isAadIdentity

boolean

Preterido – pode ser inferido do tipo de assunto do descritor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)

isContainer

boolean

Preterido – pode ser inferido do tipo de assunto do descritor (Descriptor.IsGroupType)

isDeletedInOrigin

boolean

name

string

Propriedade back-compat herdada. Esse foi o valor específico de WIT de Constantes. Será ocultado (mas existe) no cliente, a menos que ele esteja direcionando a versão mais recente

profileUrl

string

Preterido – não em uso na maioria das implementações preexistir de ToIdentityRef

uniqueName

string

Preterido – use Domain+PrincipalName em vez disso

url

string

Essa URL é a rota completa para o recurso de origem desta entidade de grafo.

LinkQueryMode

O modo de consulta de link.

Nome Tipo Description
linksOneHopDoesNotContain

string

Retorna itens de trabalho que satisfazem a origem, somente se nenhum item de trabalho vinculado atender aos critérios de link e de destino.

linksOneHopMayContain

string

Retorna itens de trabalho que atendem aos critérios de origem e link, mesmo que nenhum item de trabalho vinculado atenda aos critérios de destino.

linksOneHopMustContain

string

Retorna itens de trabalho em que os critérios de origem, destino e link são todos atendidos.

linksRecursiveDoesNotContain

string

linksRecursiveMayContain

string

Retorna itens de trabalho uma hierarquia de itens de trabalho que, por padrão, satisfazem a origem

linksRecursiveMustContain

string

workItems

string

Retorna uma lista simples de itens de trabalho.

LogicalOperation

Operador lógico que separa a cláusula condition

Nome Tipo Description
and

string

none

string

or

string

QueryExpand

Os parâmetros de expansão para consultas. As opções possíveis são { None, Wiql, Clauses, All, Minimal }

Nome Tipo Description
all

string

Expande todas as propriedades

clauses

string

Expande colunas, links, changeInfo, texto WIQL e cláusulas

minimal

string

Exibe propriedades mínimas e o texto WIQL

none

string

Expande Colunas, Links e ChangeInfo

wiql

string

Expande colunas, links, texto ChangeInfo e WIQL

QueryHierarchyItem

Representa um item na hierarquia de consulta do item de trabalho. Isso pode ser uma consulta ou uma pasta.

Nome Tipo Description
_links

ReferenceLinks

Vincular referências a recursos REST relacionados.

children

QueryHierarchyItem[]

Os itens de consulta filho dentro de uma pasta de consulta.

clauses

WorkItemQueryClause

As cláusulas de uma consulta simples.

columns

WorkItemFieldReference[]

As colunas da consulta.

createdBy

IdentityReference

A identidade que criou o item de consulta.

createdDate

string

Quando o item de consulta foi criado.

filterOptions

LinkQueryMode

O modo de consulta de link.

hasChildren

boolean

Se essa for uma pasta de consulta, indica se ela contém filhos.

id

string

A ID do item de consulta.

isDeleted

boolean

Indica se esse item de consulta foi excluído. Definir isso como false em um item de consulta excluído o desmarcará. Desmarcando uma consulta ou pasta não trará de volta as alterações de permissão que foram aplicadas anteriormente a ela.

isFolder

boolean

Indica se esta é uma pasta de consulta ou uma consulta.

isInvalidSyntax

boolean

Indica se o WIQL dessa consulta é inválido. Isso pode ser devido à sintaxe inválida ou a um caminho de iteração/área não mais válido.

isPublic

boolean

Indica se esse item de consulta é público ou privado.

lastExecutedBy

IdentityReference

A identidade que executou a consulta pela última vez.

lastExecutedDate

string

Quando a consulta foi executada pela última vez.

lastModifiedBy

IdentityReference

A identidade que modificou o item de consulta pela última vez.

lastModifiedDate

string

Quando o item de consulta foi modificado pela última vez.

linkClauses

WorkItemQueryClause

A cláusula de consulta de link.

name

string

O nome do item de consulta.

path

string

O caminho do item de consulta.

queryRecursionOption

QueryRecursionOption

A opção de recursão para uso em uma consulta de árvore.

queryType

QueryType

O tipo de consulta.

sortColumns

WorkItemQuerySortColumn[]

As colunas de classificação da consulta.

sourceClauses

WorkItemQueryClause

As cláusulas de origem em uma consulta de link de árvore ou de um salto.

targetClauses

WorkItemQueryClause

As cláusulas de destino em uma consulta de link de árvore ou de um salto.

url

string

wiql

string

O texto WIQL da consulta

QueryHierarchyItemsResult

Nome Tipo Description
count

integer

A contagem de itens.

hasMore

boolean

Indica se o limite máximo de retorno foi atingido, mas ainda há mais itens

value

QueryHierarchyItem[]

A lista de itens

QueryRecursionOption

A opção de recursão para uso em uma consulta de árvore.

Nome Tipo Description
childFirst

string

Retorna itens de trabalho que atendem aos critérios de destino, mesmo que nenhum item de trabalho atenda aos critérios de origem e link.

parentFirst

string

Retorna itens de trabalho que satisfazem a origem, mesmo que nenhum item de trabalho vinculado atenda aos critérios de destino e link.

QueryType

O tipo de consulta.

Nome Tipo Description
flat

string

Obtém uma lista simples de itens de trabalho.

oneHop

string

Obtém uma lista de itens de trabalho e seus links diretos.

tree

string

Obtém uma árvore de itens de trabalho mostrando sua hierarquia de vínculo.

A classe para representar uma coleção de links de referência REST.

Nome Tipo Description
links

object

A exibição somente leitura dos links. Como os links de referência são somente leitura, só queremos expô-los como somente leitura.

WorkItemFieldOperation

Descreve uma operação de campo de item de trabalho.

Nome Tipo Description
name

string

Nome amigável da operação.

referenceName

string

Nome de referência da operação.

WorkItemFieldReference

Referência a um campo em um item de trabalho

Nome Tipo Description
name

string

O nome amigável do campo.

referenceName

string

O nome de referência do campo.

url

string

A URL REST do recurso.

WorkItemQueryClause

Representa uma cláusula em uma consulta de item de trabalho. Isso mostra a estrutura de uma consulta de item de trabalho.

Nome Tipo Description
clauses

WorkItemQueryClause[]

Cláusulas filho se a cláusula atual for um operador lógico

field

WorkItemFieldReference

Campo associado à condição

fieldValue

WorkItemFieldReference

Lado direito da condição quando uma comparação campo a campo

isFieldValue

boolean

Determina se essa é uma comparação de campo a campo

logicalOperator

LogicalOperation

Operador lógico que separa a cláusula condition

operator

WorkItemFieldOperation

O operador de campo

value

string

Lado direito da condição quando um campo para comparação de valor

WorkItemQuerySortColumn

Uma coluna de classificação.

Nome Tipo Description
descending

boolean

A direção a ser classificada por.

field

WorkItemFieldReference

Um campo de item de trabalho.