Queries - Search Queries

Service:

Work Item Tracking

API Version:

7.1-preview.2

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

With optional parameters:

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.

ReferenceLinks

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.