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 | |||
$include
|
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 |
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 |
---|---|
Identity |
Descreve uma referência a uma identidade. |
Link |
O modo de consulta de link. |
Logical |
Operador lógico que separa a cláusula condition |
Query |
Os parâmetros de expansão para consultas. As opções possíveis são { None, Wiql, Clauses, All, Minimal } |
Query |
Representa um item na hierarquia de consulta do item de trabalho. Isso pode ser uma consulta ou uma pasta. |
Query |
|
Query |
A opção de recursão para uso em uma consulta de árvore. |
Query |
O tipo de consulta. |
Reference |
A classe para representar uma coleção de links de referência REST. |
Work |
Descreve uma operação de campo de item de trabalho. |
Work |
Referência a um campo em um item de trabalho |
Work |
Representa uma cláusula em uma consulta de item de trabalho. Isso mostra a estrutura de uma consulta de item de trabalho. |
Work |
Uma coluna de classificação. |
IdentityReference
Descreve uma referência a uma identidade.
Nome | Tipo | Description |
---|---|---|
_links |
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 |
Vincular referências a recursos REST relacionados. |
|
children |
Os itens de consulta filho dentro de uma pasta de consulta. |
|
clauses |
As cláusulas de uma consulta simples. |
|
columns |
As colunas da consulta. |
|
createdBy |
A identidade que criou o item de consulta. |
|
createdDate |
string |
Quando o item de consulta foi criado. |
filterOptions |
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 |
A identidade que executou a consulta pela última vez. |
|
lastExecutedDate |
string |
Quando a consulta foi executada pela última vez. |
lastModifiedBy |
A identidade que modificou o item de consulta pela última vez. |
|
lastModifiedDate |
string |
Quando o item de consulta foi modificado pela última vez. |
linkClauses |
A cláusula de consulta de link. |
|
name |
string |
O nome do item de consulta. |
path |
string |
O caminho do item de consulta. |
queryRecursionOption |
A opção de recursão para uso em uma consulta de árvore. |
|
queryType |
O tipo de consulta. |
|
sortColumns |
As colunas de classificação da consulta. |
|
sourceClauses |
As cláusulas de origem em uma consulta de link de árvore ou de um salto. |
|
targetClauses |
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 |
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 |
Cláusulas filho se a cláusula atual for um operador lógico |
|
field |
Campo associado à condição |
|
fieldValue |
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 |
Operador lógico que separa a cláusula condition |
|
operator |
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 |
Um campo de item de trabalho. |