Queries - Create

Odwołanie

Service:: Work Item Tracking

API Version:: 7.1-preview.2

Tworzy zapytanie lub przenosi zapytanie.

Dowiedz się więcej o składni języka zapytań elementów roboczych (WIQL) tutaj.

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

With optional parameters:

POST https://dev.azure.com/{organization}/{project}/_apis/wit/queries/{query}?validateWiqlOnly={validateWiqlOnly}&api-version=7.1-preview.2

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
organization	path	True	string	Nazwa organizacji usługi Azure DevOps.
project	path	True	string	Identyfikator projektu lub nazwa projektu
query	path	True	string	Identyfikator lub ścieżka nadrzędna, w której ma zostać utworzone zapytanie.
api-version	query	True	string	Wersja interfejsu API do użycia. Ta wartość powinna mieć wartość "7.1-preview.2", aby używać tej wersji interfejsu API.
validateWiqlOnly	query		boolean	Jeśli chcesz tylko zweryfikować zapytanie WIQL bez faktycznego utworzenia, ustaw je na true. Wartość domyślna to false.

Treść żądania

Nazwa	Typ	Opis
_links	ReferenceLinks	Linki do powiązanych zasobów REST.
children	QueryHierarchyItem[]	Elementy zapytania podrzędnego wewnątrz folderu zapytania.
clauses	WorkItemQueryClause	Klauzule dla płaskiego zapytania.
columns	WorkItemFieldReference[]	Kolumny zapytania.
createdBy	IdentityReference	Tożsamość, która utworzyła element zapytania.
createdDate	string	Po utworzeniu elementu zapytania.
filterOptions	LinkQueryMode	Tryb zapytania łącza.
hasChildren	boolean	Jeśli jest to folder zapytania, wskazuje, czy zawiera jakiekolwiek elementy podrzędne.
id	string	Identyfikator elementu zapytania.
isDeleted	boolean	Wskazuje, czy ten element zapytania jest usuwany. Ustawienie wartości false dla usuniętego elementu zapytania spowoduje jego cofnięcie. Usunięcie zapytania lub folderu nie spowoduje przywrócenia zmian uprawnień, które zostały wcześniej zastosowane.
isFolder	boolean	Wskazuje, czy jest to folder zapytania lub zapytanie.
isInvalidSyntax	boolean	Wskazuje, czy WIQL tego zapytania jest nieprawidłowy. Może to być spowodowane nieprawidłową składnią lub nieprawidłową ścieżką obszaru/iteracji.
isPublic	boolean	Wskazuje, czy ten element zapytania jest publiczny lub prywatny.
lastExecutedBy	IdentityReference	Tożsamość, która ostatnio uruchomiła zapytanie.
lastExecutedDate	string	Kiedy zapytanie zostało ostatnio uruchomione.
lastModifiedBy	IdentityReference	Tożsamość, która ostatnio zmodyfikowała element zapytania.
lastModifiedDate	string	Kiedy element zapytania został ostatnio zmodyfikowany.
linkClauses	WorkItemQueryClause	Klauzula kwerendy linku.
name	string	Nazwa elementu zapytania.
path	string	Ścieżka elementu zapytania.
queryRecursionOption	QueryRecursionOption	Opcja rekursji do użycia w zapytaniu drzewa.
queryType	QueryType	Typ zapytania.
sortColumns	WorkItemQuerySortColumn[]	Sortowanie kolumn zapytania.
sourceClauses	WorkItemQueryClause	Klauzule źródłowe w zapytaniu linku drzewa lub jednego przeskoku.
targetClauses	WorkItemQueryClause	Klauzule docelowe w zapytaniu linku drzewa lub jednego przeskoku.
url	string
wiql	string	Tekst WIQL zapytania

Odpowiedzi

Nazwa	Typ	Opis
200 OK	QueryHierarchyItem	operacja zakończona powodzeniem

Zabezpieczenia

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

Nazwa	Opis
vso.work_write	Umożliwia odczytywanie, tworzenie i aktualizowanie elementów roboczych i zapytań, aktualizowanie metadanych tablicy, ścieżki obszaru odczytu i iteracji innych metadanych powiązanych z elementami roboczymi, wykonywanie zapytań i odbieranie powiadomień o zdarzeniach elementów roboczych za pośrednictwem punktów zaczepienia usługi.

Przykłady

Create a folder

Create a query

Move a query or folder

Create a folder

Sample Request

HTTP

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

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

Sample Response

Status code:: 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

Sample Request

HTTP

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

{
  "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"
}

Sample Response

Status code:: 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

Sample Request

HTTP

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

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

Sample Response

Status code:: 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"
}

Definicje

Nazwa	Opis
IdentityReference	Opisuje odwołanie do tożsamości.
LinkQueryMode	Tryb zapytania łącza.
LogicalOperation	Operator logiczny oddzielający klauzulę warunku
QueryHierarchyItem	Reprezentuje element w hierarchii zapytań elementu roboczego. Może to być zapytanie lub folder.
QueryRecursionOption	Opcja rekursji do użycia w zapytaniu drzewa.
QueryType	Typ zapytania.
ReferenceLinks	Klasa reprezentująca kolekcję linków referencyjnych REST.
WorkItemFieldOperation	Opisuje operację pola elementu roboczego.
WorkItemFieldReference	Odwołanie do pola w elemencie roboczym
WorkItemQueryClause	Reprezentuje klauzulę w zapytaniu elementu roboczego. Spowoduje to wyświetlenie struktury zapytania elementu roboczego.
WorkItemQuerySortColumn	Kolumna sortowania.

IdentityReference

Opisuje odwołanie do tożsamości.

Nazwa	Typ	Opis
_links	ReferenceLinks	To pole zawiera zero lub więcej interesujących linków dotyczących tematu grafu. Te linki mogą być wywoływane w celu uzyskania dodatkowych relacji lub bardziej szczegółowych informacji na temat tego tematu grafu.
descriptor	string	Deskryptor jest podstawowym sposobem odwołowania się do tematu grafu podczas działania systemu. To pole będzie jednoznacznie identyfikować ten sam temat grafu zarówno w ramach kont, jak i organizacji.
directoryAlias	string	Przestarzałe — można pobrać, wysyłając zapytanie do użytkownika programu Graph przywoływanego w wpisie "self" słownika IdentityRef "_links"
displayName	string	Jest to unikatowa nazwa wyświetlana tematu grafu. Aby zmienić to pole, musisz zmienić jego wartość u dostawcy źródłowego.
id	string
imageUrl	string	Przestarzałe — dostępne w wpisie "avatar" słownika IdentityRef "_links"
inactive	boolean	Przestarzałe — można pobrać, wysyłając zapytanie do stanu członkostwa programu Graph, do których odwołuje się wpis "membershipState" słownika GraphUser "_links"
isAadIdentity	boolean	Przestarzałe — można wywnioskować z typu podmiotu deskryptora (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Przestarzałe — można wywnioskować z typu podmiotu deskryptora (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
name	string	Starsza właściwość back-compat. Była to wartość specyficzna dla funkcji WIT z stałych. Będzie ukryty (ale istnieje) na kliencie, chyba że są one przeznaczone dla najnowszej wersji
profileUrl	string	Przestarzałe — nie jest używane w większości istniejących implementacji toIdentityRef
uniqueName	string	Przestarzałe — zamiast tego użyj nazwy Domain+PrincipalName
url	string	Ten adres URL jest pełną trasą do zasobu źródłowego tego tematu grafu.

LinkQueryMode

Tryb zapytania łącza.

Nazwa	Typ	Opis
linksOneHopDoesNotContain	string	Zwraca elementy robocze spełniające źródło, tylko wtedy, gdy żaden połączony element roboczy nie spełnia kryteriów linku i celu.
linksOneHopMayContain	string	Zwraca elementy robocze spełniające kryteria źródła i łącza, nawet jeśli żaden połączony element roboczy nie spełnia kryteriów docelowych.
linksOneHopMustContain	string	Zwraca elementy robocze, w których wszystkie kryteria źródła, elementu docelowego i łącza są spełnione.
linksRecursiveDoesNotContain	string
linksRecursiveMayContain	string	Zwraca elementy robocze hierarchię elementów roboczych, które domyślnie spełniają wymagania źródła
linksRecursiveMustContain	string
workItems	string	Zwraca płaską listę elementów roboczych.

LogicalOperation

Operator logiczny oddzielający klauzulę warunku

Nazwa	Typ	Opis
and	string
none	string
or	string

QueryHierarchyItem

Reprezentuje element w hierarchii zapytań elementu roboczego. Może to być zapytanie lub folder.

Nazwa	Typ	Opis
_links	ReferenceLinks	Połącz odwołania do powiązanych zasobów REST.
children	QueryHierarchyItem[]	Elementy zapytania podrzędnego wewnątrz folderu zapytania.
clauses	WorkItemQueryClause	Klauzule dla płaskiego zapytania.
columns	WorkItemFieldReference[]	Kolumny zapytania.
createdBy	IdentityReference	Tożsamość, która utworzyła element zapytania.
createdDate	string	Po utworzeniu elementu zapytania.
filterOptions	LinkQueryMode	Tryb zapytania łącza.
hasChildren	boolean	Jeśli jest to folder zapytania, wskazuje, czy zawiera jakiekolwiek elementy podrzędne.
id	string	Identyfikator elementu zapytania.
isDeleted	boolean	Wskazuje, czy ten element zapytania jest usuwany. Ustawienie wartości false dla usuniętego elementu zapytania spowoduje jego cofnięcie. Usunięcie zapytania lub folderu nie spowoduje przywrócenia zmian uprawnień, które zostały wcześniej zastosowane.
isFolder	boolean	Wskazuje, czy jest to folder zapytania lub zapytanie.
isInvalidSyntax	boolean	Wskazuje, czy WIQL tego zapytania jest nieprawidłowy. Może to być spowodowane nieprawidłową składnią lub nieprawidłową ścieżką obszaru/iteracji.
isPublic	boolean	Wskazuje, czy ten element zapytania jest publiczny lub prywatny.
lastExecutedBy	IdentityReference	Tożsamość, która ostatnio uruchomiła zapytanie.
lastExecutedDate	string	Kiedy zapytanie zostało ostatnio uruchomione.
lastModifiedBy	IdentityReference	Tożsamość, która ostatnio zmodyfikowała element zapytania.
lastModifiedDate	string	Kiedy element zapytania został ostatnio zmodyfikowany.
linkClauses	WorkItemQueryClause	Klauzula zapytania linku.
name	string	Nazwa elementu zapytania.
path	string	Ścieżka elementu zapytania.
queryRecursionOption	QueryRecursionOption	Opcja rekursji do użycia w zapytaniu drzewa.
queryType	QueryType	Typ zapytania.
sortColumns	WorkItemQuerySortColumn[]	Sortowanie kolumn zapytania.
sourceClauses	WorkItemQueryClause	Klauzule źródłowe w zapytaniu linku drzewa lub jednego przeskoku.
targetClauses	WorkItemQueryClause	Klauzule docelowe w zapytaniu linku drzewa lub jednego przeskoku.
url	string
wiql	string	Tekst WIQL zapytania

QueryRecursionOption

Opcja rekursji do użycia w zapytaniu drzewa.

Nazwa	Typ	Opis
childFirst	string	Zwraca elementy robocze spełniające kryteria docelowe, nawet jeśli żaden element roboczy nie spełnia kryteriów źródła i linku.
parentFirst	string	Zwraca elementy robocze spełniające źródło, nawet jeśli żaden połączony element roboczy nie spełnia kryteriów docelowych i linków.

QueryType

Typ zapytania.

Nazwa	Typ	Opis
flat	string	Pobiera płaską listę elementów roboczych.
oneHop	string	Pobiera listę elementów roboczych i ich linków bezpośrednich.
tree	string	Pobiera drzewo elementów roboczych z ich hierarchią linków.

ReferenceLinks

Klasa reprezentująca kolekcję linków referencyjnych REST.

Nazwa	Typ	Opis
links	object	Czytelny widok linków. Ponieważ linki referencyjne są czytelne, chcemy uwidocznić je tylko jako tylko do odczytu.

WorkItemFieldOperation

Opisuje operację pola elementu roboczego.

Nazwa	Typ	Opis
name	string	Przyjazna nazwa operacji.
referenceName	string	Nazwa odwołania operacji.

WorkItemFieldReference

Odwołanie do pola w elemencie roboczym

Nazwa	Typ	Opis
name	string	Przyjazna nazwa pola.
referenceName	string	Nazwa odwołania pola.
url	string	Adres URL REST zasobu.

WorkItemQueryClause

Reprezentuje klauzulę w zapytaniu elementu roboczego. Spowoduje to wyświetlenie struktury zapytania elementu roboczego.

Nazwa	Typ	Opis
clauses	WorkItemQueryClause[]	Klauzule podrzędne, jeśli bieżąca klauzula jest operatorem logicznym
field	WorkItemFieldReference	Pole skojarzone z warunkiem
fieldValue	WorkItemFieldReference	Prawa strona warunku, gdy pole do porównania pól
isFieldValue	boolean	Określa, czy jest to pole do porównania pól
logicalOperator	LogicalOperation	Operator logiczny oddzielający klauzulę warunku
operator	WorkItemFieldOperation	Operator pola
value	string	Prawa strona warunku, gdy pole do porównania wartości

WorkItemQuerySortColumn

Kolumna sortowania.

Nazwa	Typ	Opis
descending	boolean	Kierunek sortowania według.
field	WorkItemFieldReference	Pole elementu roboczego.

Udostępnij za pośrednictwem

Queries - Create

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Zabezpieczenia

oauth2

Scopes

Przykłady

Create a folder

Sample Request

Sample Response

Create a query

Sample Request

Sample Response

Move a query or folder

Sample Request

Sample Response

Definicje

IdentityReference

LinkQueryMode

LogicalOperation

QueryHierarchyItem

QueryRecursionOption

QueryType

ReferenceLinks

WorkItemFieldOperation

WorkItemFieldReference

WorkItemQueryClause

WorkItemQuerySortColumn

Dodatkowe zasoby