Classification Nodes - Get

Service:

Work Item Tracking

API Version:

4.1

Pobiera węzeł klasyfikacji dla danej ścieżki węzła.

GET https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?api-version=4.1

With optional parameters:

GET https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?$depth={$depth}&api-version=4.1

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
structureGroup	path	True	TreeStructureGroup	Grupa struktury węzła klasyfikacji, obszaru lub iteracji.
path	path		string	Ścieżka węzła klasyfikacji.
api-version	query	True	string	Wersja interfejsu API do użycia. Należy ustawić wartość "4.1", aby używać tej wersji interfejsu API.
$depth	query		integer int32	Głębokość dzieci do pobrania.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	WorkItemClassificationNode	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	Umożliwia odczytywanie elementów roboczych, zapytań, tablic, ścieżek obszaru i iteracji oraz innych metadanych powiązanych ze śledzeniem elementów roboczych. Umożliwia również wykonywanie zapytań i odbieranie powiadomień o zdarzeniach elementu roboczego za pośrednictwem punktów zaczepienia usługi.

Przykłady

Get an area

Get an iteration

Get an area

Sample Request

HTTP

GET https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/Areas?api-version=4.1

Sample Response

Status code:

200

{
  "id": 126391,
  "identifier": "d5d98099-47ac-468a-9579-c059c90bf7c5",
  "name": "Web",
  "structureType": "area",
  "hasChildren": false,
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Web"
    },
    "parent": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas"
    }
  },
  "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Web"
}

Get an iteration

Sample Request

HTTP

GET https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/Iterations?api-version=4.1

Sample Response

Status code:

200

{
  "id": 126392,
  "identifier": "dd643523-4d15-4106-a6a4-e70d39a09446",
  "name": "Final Iteration",
  "structureType": "iteration",
  "hasChildren": false,
  "attributes": {
    "startDate": "2014-10-27T00:00:00Z",
    "finishDate": "2014-10-31T00:00:00Z"
  },
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Final%20Iteration"
    },
    "parent": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations"
    }
  },
  "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Final%20Iteration"
}

Definicje

Nazwa	Opis
ReferenceLinks	Klasa reprezentująca kolekcję linków referencyjnych REST.
TreeNodeStructureType	Typ struktury węzła.
TreeStructureGroup	Grupa struktury węzła klasyfikacji, obszaru lub iteracji.
WorkItemClassificationNode	Definiuje węzeł klasyfikacji na potrzeby śledzenia elementów roboczych.

ReferenceLinks

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

Nazwa	Typ	Opis
links	object	Widok linków w trybie tylko do odczytu. Ponieważ linki odwołania są tylko do odczytu, chcemy uwidocznić je tylko jako tylko do odczytu.

TreeNodeStructureType

Typ struktury węzła.

Nazwa	Typ	Opis
area	string	Typ obszaru.
iteration	string	Typ iteracji.

TreeStructureGroup

Grupa struktury węzła klasyfikacji, obszaru lub iteracji.

Nazwa	Typ	Opis
areas	string
iterations	string

WorkItemClassificationNode

Definiuje węzeł klasyfikacji na potrzeby śledzenia elementów roboczych.

Nazwa	Typ	Opis
_links	ReferenceLinks	Linki do powiązanych zasobów REST.
attributes	object	Słownik zawierający atrybuty węzła, takie jak data rozpoczęcia/zakończenia dla węzłów iteracji.
children	WorkItemClassificationNode[]	Lista pobranych węzłów podrzędnych.
hasChildren	boolean	Flaga wskazująca, czy węzeł klasyfikacji ma jakiekolwiek węzły podrzędne.
id	integer	Identyfikator liczby całkowitej węzła klasyfikacji.
identifier	string	Identyfikator GUID węzła klasyfikacji.
name	string	Nazwa węzła klasyfikacji.
structureType	TreeNodeStructureType	Typ struktury węzła.
url	string