Work Item Search Results - Fetch Work Item Search Results

Serviço:: Search

Versão da API:: 7.1

Fornece um conjunto de resultados para o texto de pesquisa.

POST https://almsearch.dev.azure.com/{organization}/{project}/_apis/search/workitemsearchresults?api-version=7.1

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
organization	path	True	string	O nome da organização do Azure DevOps.
project	path		string	ID do projeto ou nome do projeto
api-version	query	True	string	Versão da API a ser usada. Isso deve ser definido como '7.1' para usar essa versão da api.

Corpo da solicitação

Nome	Tipo	Description
$orderBy	SortOption[]	Opções para classificar os resultados da pesquisa. Se definido como nulo, os resultados serão retornados classificados por relevância. Se mais de uma opção de classificação for fornecida, os resultados serão classificados na ordem especificada no OrderBy.
$skip	integer (int32)	Número de resultados a serem ignorados.
$top	integer (int32)	Número de resultados a serem retornados.
filters	object	Filtros a serem aplicados. Defina-o como nulo se não houver filtros a serem aplicados.
includeFacets	boolean	Sinalizar para optar pela faceta no resultado. O comportamento padrão é falso.
searchText	string	O texto da pesquisa.

Respostas

Nome	Tipo	Description
200 OK	WorkItemSearchResponse	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	Concede a capacidade de ler itens de trabalho, consultas, placas, 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.

Exemplos

Solicitação de exemplo

HTTP

POST https://almsearch.dev.azure.com/fabrikam/_apis/search/workitemsearchresults?api-version=7.1

{
  "searchText": "Rest Api Story",
  "$skip": 0,
  "$top": 1,
  "filters": {
    "System.TeamProject": [
      "MyFirstProject"
    ],
    "System.AreaPath": [
      "MyFirstProject"
    ],
    "System.WorkItemType": [
      "Bug",
      "User Story",
      "Feature",
      "Task"
    ],
    "System.State": [
      "New",
      "Active",
      "Closed"
    ],
    "System.AssignedTo": [
      "John Doe <[email protected]>"
    ]
  },
  "$orderBy": [
    {
      "field": "system.id",
      "sortOrder": "ASC"
    }
  ],
  "includeFacets": true
}

Resposta de exemplo

Código de status:: 200

{
  "count": 2,
  "results": [
    {
      "project": {
        "name": "MyFirstProject",
        "id": "5a0690b2-823c-4389-a3ab-5ea2a9cbde75"
      },
      "fields": {
        "system.id": "2",
        "system.workitemtype": "User Story",
        "system.title": "Rest Api User Story",
        "system.assignedto": "John Doe <[email protected]>",
        "system.state": "Closed",
        "system.tags": "api; rest",
        "system.rev": "5",
        "system.createddate": "2018-01-05T17:14:40.033Z",
        "system.changeddate": "2018-01-05T17:55:36.953Z"
      },
      "hits": [
        {
          "fieldReferenceName": "system.tags",
          "highlights": [
            "<highlighthit>api</highlighthit>; <highlighthit>rest</highlighthit>"
          ]
        },
        {
          "fieldReferenceName": "system.title",
          "highlights": [
            "<highlighthit>Rest</highlighthit> <highlighthit>Api</highlighthit> User <highlighthit>Story</highlighthit>"
          ]
        }
      ],
      "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/2"
    }
  ],
  "infoCode": 0,
  "facets": {
    "System.TeamProject": [
      {
        "name": "MyFirstProject",
        "id": "MyFirstProject",
        "resultCount": 2
      }
    ],
    "System.WorkItemType": [
      {
        "name": "Task",
        "id": "Task",
        "resultCount": 1
      },
      {
        "name": "User Story",
        "id": "User Story",
        "resultCount": 1
      },
      {
        "name": "Bug",
        "id": "Bug",
        "resultCount": 0
      },
      {
        "name": "Feature",
        "id": "Feature",
        "resultCount": 0
      }
    ],
    "System.State": [
      {
        "name": "Closed",
        "id": "Closed",
        "resultCount": 1
      },
      {
        "name": "New",
        "id": "New",
        "resultCount": 1
      },
      {
        "name": "Active",
        "id": "Active",
        "resultCount": 0
      }
    ],
    "System.AssignedTo": [
      {
        "name": "John Doe <[email protected]>",
        "id": "John Doe <[email protected]>",
        "resultCount": 2
      }
    ]
  }
}

Definições

Nome	Description
Project	Define os detalhes do projeto.
SortOption	Define como classificar o resultado.
WorkItemHit	Define os termos correspondentes no campo do resultado do item de trabalho.
WorkItemResult	Define o resultado do item de trabalho que correspondeu a uma solicitação de pesquisa de item de trabalho.
WorkItemSearchRequest	Define uma solicitação de pesquisa de item de trabalho.
WorkItemSearchResponse	Define um item de resposta retornado para uma solicitação de pesquisa de item de trabalho.

Project

Objeto

Define os detalhes do projeto.

Nome	Tipo	Description
id	string (uuid)	ID do projeto.
name	string	Nome do projeto.

SortOption

Objeto

Define como classificar o resultado.

Nome	Tipo	Description
field	string	Nome do campo no qual a classificação deve ser feita.
sortOrder	string	Ordem (ASC/DESC) na qual os resultados devem ser classificados.

WorkItemHit

Objeto

Define os termos correspondentes no campo do resultado do item de trabalho.

Nome	Tipo	Description
fieldReferenceName	string	Nome de referência do campo realçado.
highlights	string[]	Snippets correspondentes/realçados do campo.

WorkItemResult

Objeto

Define o resultado do item de trabalho que correspondeu a uma solicitação de pesquisa de item de trabalho.

Nome	Tipo	Description
fields	object	Um conjunto padrão de campos de item de trabalho e seus valores.
hits	WorkItemHit[]	Trechos de código realçados de campos que correspondem à solicitação de pesquisa. A lista é classificada por relevância dos snippets.
project	Project	Detalhes do projeto do item de trabalho.
url	string	Referência ao item de trabalho.

WorkItemSearchRequest

Objeto

Define uma solicitação de pesquisa de item de trabalho.

Nome	Tipo	Description
$orderBy	SortOption[]	Opções para classificar os resultados da pesquisa. Se definido como nulo, os resultados serão retornados classificados por relevância. Se mais de uma opção de classificação for fornecida, os resultados serão classificados na ordem especificada no OrderBy.
$skip	integer (int32)	Número de resultados a serem ignorados.
$top	integer (int32)	Número de resultados a serem retornados.
filters	object	Filtros a serem aplicados. Defina-o como nulo se não houver filtros a serem aplicados.
includeFacets	boolean	Sinalizar para optar pela faceta no resultado. O comportamento padrão é falso.
searchText	string	O texto da pesquisa.

WorkItemSearchResponse

Objeto

Define um item de resposta retornado para uma solicitação de pesquisa de item de trabalho.

Nome	Tipo	Description
count	integer (int32)	Número total de itens de trabalho correspondentes.
facets	object	Um dicionário armazenando uma matriz de `Filter` objeto em cada faceta.
infoCode	integer (int32)	Código numérico que indica qualquer informação adicional: 0 – Ok, 1 – A conta está sendo reindexada, 2 – A indexação de conta não foi iniciada, 3 – Solicitação Inválida, 4 – Não há suporte para consulta curinga de prefixo, 5 – MultiWords com faceta de código sem suporte, 6 – a conta está sendo integrada, 7 – a conta está sendo integrada ou reindexada, 8 – Valor superior cortado para maxresult permitido 9 – Branches estão sendo indexados, 10 – Faceta não habilitada, 11 – Itens de trabalho não acessíveis, 19 – Consultas de frase com filtros de tipo de código sem suporte, 20 – Consultas curinga com filtros de tipo de código sem suporte. Qualquer outro código de informações é usado para fins internos.
results	WorkItemResult[]	Lista dos principais itens de trabalho correspondentes.

Comentários

Esta página foi útil?