Queries - Create

Referência

Serviço:: Work Item Tracking

Versão da API:: 5.0

Cria uma consulta ou move uma consulta.

Saiba mais sobre a sintaxe WIQL (Work Item Query Language) aqui.

POST https://dev.azure.com/{organization}/{project}/_apis/wit/queries/{query}?api-version=5.0

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
query	path	True	string	A ID pai ou o caminho sob o qual a consulta deve ser criada.
api-version	query	True	string	Versão da API a ser usada. Isso deve ser definido como '5.0' para usar esta versão da API.

Corpo da solicitação

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 esta 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 irá desexá-lo. Cancelar a exclusão de 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 área/iteração 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

Respostas

Nome	Tipo	Description
200 OK	QueryHierarchyItem	operação bem-sucedida

Segurança

oauth2

Tipo: oauth2
Flow: accessCode
URL de Autorização: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL do Token: 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

Escopos

Nome	Description
vso.work_write	Concede a capacidade de ler, criar e atualizar itens de trabalho e consultas, atualizar metadados do quadro, ler caminhos de área e iterações de outros itens de trabalho que acompanham metadados relacionados, executar consultas e receber notificações sobre eventos de item de trabalho por meio de ganchos de serviço.

Exemplos

Create a folder

Create a query

Move a query or folder

Create a folder

Solicitação de exemplo

HTTP

POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/queries/{query}?api-version=5.0

{
  "name": "Website team",
  "isFolder": true
}

Resposta de exemplo

Código de status:: 201

{
  "id": "8a8c8212-15ca-41ed-97aa-1d6fbfbcd581",
  "name": "Website team",
  "path": "Shared Queries/Website team",
  "createdBy": {
    "displayName": "Jamal Hartnett",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "_links": {
      "avatar": {
        "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
      }
    },
    "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "uniqueName": "fabrikamfiber4@hotmail.com",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
  },
  "createdDate": "2016-06-01T16:58:56.323Z",
  "lastModifiedBy": {
    "displayName": "Jamal Hartnett",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "_links": {
      "avatar": {
        "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
      }
    },
    "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "uniqueName": "fabrikamfiber4@hotmail.com",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
  },
  "lastModifiedDate": "2016-06-01T16:58:56.323Z",
  "isFolder": true,
  "hasChildren": false,
  "isPublic": true,
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
    },
    "html": {
      "href": "https://dev.azure.com/fabrikam/web/qr.aspx?pguid=6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c&qid=8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
    },
    "parent": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/eb5c1e25-9b3e-4416-a833-e500122882c7"
    }
  },
  "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
}

Create a query

Solicitação de exemplo

HTTP

POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/queries/{query}?api-version=5.0

{
  "name": "All Bugs",
  "wiql": "Select [System.Id], [System.Title], [System.State] From WorkItems Where [System.WorkItemType] = 'Bug' order by [Microsoft.VSTS.Common.Priority] asc, [System.CreatedDate] desc"
}

Resposta de exemplo

Código de status:: 201

{
  "id": "342f0f44-4069-46b1-a940-3d0468979ceb",
  "name": "All Bugs",
  "path": "Shared Queries/Website team/All Bugs",
  "createdBy": {
    "displayName": "Jamal Hartnett",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "_links": {
      "avatar": {
        "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
      }
    },
    "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "uniqueName": "fabrikamfiber4@hotmail.com",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
  },
  "createdDate": "2016-06-01T16:58:56.64Z",
  "lastModifiedBy": {
    "displayName": "Jamal Hartnett",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "_links": {
      "avatar": {
        "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
      }
    },
    "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "uniqueName": "fabrikamfiber4@hotmail.com",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
  },
  "lastModifiedDate": "2016-06-01T16:58:56.64Z",
  "queryType": "flat",
  "columns": [
    {
      "referenceName": "System.Id",
      "name": "ID",
      "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.Id"
    },
    {
      "referenceName": "System.Title",
      "name": "Title",
      "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.Title"
    },
    {
      "referenceName": "System.State",
      "name": "State",
      "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.State"
    }
  ],
  "sortColumns": [
    {
      "field": {
        "referenceName": "Microsoft.VSTS.Common.Priority",
        "name": "Priority",
        "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/Microsoft.VSTS.Common.Priority"
      },
      "descending": false
    },
    {
      "field": {
        "referenceName": "System.CreatedDate",
        "name": "Created Date",
        "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.CreatedDate"
      },
      "descending": true
    }
  ],
  "wiql": "select [System.Id], [System.Title], [System.State] from WorkItems where [System.WorkItemType] = 'Bug' order by [Microsoft.VSTS.Common.Priority] asc, [System.CreatedDate] desc",
  "isPublic": true,
  "clauses": {
    "field": {
      "referenceName": "System.WorkItemType",
      "name": "Work Item Type",
      "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.WorkItemType"
    },
    "operator": {
      "referenceName": "SupportedOperations.Equals",
      "name": "="
    },
    "value": "Bug"
  },
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/342f0f44-4069-46b1-a940-3d0468979ceb"
    },
    "html": {
      "href": "https://dev.azure.com/fabrikam/web/qr.aspx?pguid=6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c&qid=342f0f44-4069-46b1-a940-3d0468979ceb"
    },
    "parent": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
    },
    "wiql": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/wiql/342f0f44-4069-46b1-a940-3d0468979ceb"
    }
  },
  "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/342f0f44-4069-46b1-a940-3d0468979ceb"
}

Move a query or folder

Solicitação de exemplo

HTTP

POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/queries/{query}?api-version=5.0

{
  "id": "8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
}

Resposta de exemplo

Código de status:: 200

{
  "id": "8a8c8212-15ca-41ed-97aa-1d6fbfbcd581",
  "name": "Website",
  "path": "My Queries/Website",
  "createdBy": {
    "displayName": "Jamal Hartnett",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "_links": {
      "avatar": {
        "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
      }
    },
    "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "uniqueName": "fabrikamfiber4@hotmail.com",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
  },
  "createdDate": "2016-06-01T16:58:56.323Z",
  "lastModifiedBy": {
    "displayName": "Jamal Hartnett",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "_links": {
      "avatar": {
        "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
      }
    },
    "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "uniqueName": "fabrikamfiber4@hotmail.com",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
  },
  "lastModifiedDate": "2016-06-01T16:58:59.407Z",
  "isFolder": true,
  "hasChildren": true,
  "isPublic": false,
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
    },
    "html": {
      "href": "https://dev.azure.com/fabrikam/web/qr.aspx?pguid=6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c&qid=8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
    },
    "parent": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/3c65fbc1-d427-48ce-9091-633dde9e27e2"
    }
  },
  "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
}

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
QueryHierarchyItem	Representa um item na hierarquia de consulta de item de trabalho. Isso pode ser uma consulta ou uma pasta.
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

Object

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 do grafo entre contas e organizações.
directoryAlias	string
displayName	string	Este é 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
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
name	string	Propriedade de back-compat herdada. Esse foi o valor específico de WIT de Constants. Será ocultado (mas existe) no cliente, a menos que ele esteja direcionando a versão mais recente
profileUrl	string
uniqueName	string
url	string	Essa URL é a rota completa para o recurso de origem desta entidade de grafo.

LinkQueryMode

Enumeration

O modo de consulta de link.

Valor	Description
linksOneHopDoesNotContain	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	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	Retorna itens de trabalho em que os critérios de origem, destino e link são todos atendidos.
linksRecursiveDoesNotContain
linksRecursiveMayContain	Retorna itens de trabalho de uma hierarquia de itens de trabalho que, por padrão, atendem à origem
linksRecursiveMustContain
workItems

LogicalOperation

Enumeration

Operador lógico que separa a cláusula condition

Valor	Description
aND
nONE
oR

QueryHierarchyItem

Object

Representa um item na hierarquia de consulta de 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 esta 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 irá desexá-lo. Cancelar a exclusão de 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 área/iteração 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

QueryRecursionOption

Enumeration

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

Valor	Description
childFirst	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	Retorna itens de trabalho que atendem à origem, mesmo que nenhum item de trabalho vinculado atenda aos critérios de destino e link.

QueryType

Enumeration

O tipo de consulta.

Valor	Description
flat	Obtém uma lista simples de itens de trabalho.
oneHop	Obtém uma lista de itens de trabalho e seus links diretos.
tree	Obtém uma árvore de itens de trabalho mostrando sua hierarquia de vínculos.

ReferenceLinks

Object

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

Object

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

Nome	Tipo	Description
name	string	Nome da operação.
referenceName	string	Nome de referência da operação.

WorkItemFieldReference

Object

Referência a um campo em um item de trabalho

Nome	Tipo	Description
name	string	O nome do campo.
referenceName	string	O nome de referência do campo.
url	string	A URL REST do recurso.

WorkItemQueryClause

Object

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 um campo para a comparação de campos
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

Object

Uma coluna de classificação.

Nome	Tipo	Description
descending	boolean	A direção pela qual classificar.
field	WorkItemFieldReference	Um campo de item de trabalho.

Compartilhar via

Queries - Create

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

oauth2

Escopos

Exemplos

Create a folder

Solicitação de exemplo

Resposta de exemplo

Create a query

Solicitação de exemplo

Resposta de exemplo

Move a query or folder

Solicitação de exemplo

Resposta de exemplo

Definições

IdentityReference

LinkQueryMode

LogicalOperation

QueryHierarchyItem

QueryRecursionOption

QueryType

ReferenceLinks

WorkItemFieldOperation

WorkItemFieldReference

WorkItemQueryClause

WorkItemQuerySortColumn