Classification Nodes - Get

Service:

Work Item Tracking

API Version:

4.1

Ottiene il nodo di classificazione per un determinato percorso del nodo.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
organization	path	True	string	Nome dell'organizzazione di Azure DevOps.
project	path	True	string	ID progetto o nome progetto
structureGroup	path	True	TreeStructureGroup	Gruppo di strutture del nodo di classificazione, dell'area o dell'iterazione.
path	path		string	Percorso del nodo di classificazione.
api-version	query	True	string	Versione dell'API da usare. Questa opzione deve essere impostata su '4.1' per usare questa versione dell'API.
$depth	query		integer int32	Profondità dei bambini da recuperare.

Risposte

Nome	Tipo	Descrizione
200 OK	WorkItemClassificationNode	operazione riuscita

Sicurezza

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	Descrizione
vso.work	Concede la possibilità di leggere elementi di lavoro, query, schede, aree e percorsi iterazioni e altri metadati correlati al rilevamento degli elementi di lavoro. Concede inoltre la possibilità di eseguire query e di ricevere notifiche sugli eventi dell'elemento di lavoro tramite hook del servizio.

Esempio

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

Definizioni

Nome	Descrizione
ReferenceLinks	Classe da rappresentare una raccolta di collegamenti di riferimento REST.
TreeNodeStructureType	Tipo di struttura del nodo.
TreeStructureGroup	Gruppo di strutture del nodo di classificazione, dell'area o dell'iterazione.
WorkItemClassificationNode	Definisce un nodo di classificazione per il rilevamento degli elementi di lavoro.

ReferenceLinks

Classe da rappresentare una raccolta di collegamenti di riferimento REST.

Nome	Tipo	Descrizione
links	object	Visualizzazione di lettura dei collegamenti. Poiché i collegamenti di riferimento sono in sola lettura, si vuole esporre solo i collegamenti di riferimento come sola lettura.

TreeNodeStructureType

Tipo di struttura del nodo.

Nome	Tipo	Descrizione
area	string	Tipo di area.
iteration	string	Tipo di iterazione.

TreeStructureGroup

Gruppo di strutture del nodo di classificazione, dell'area o dell'iterazione.

Nome	Tipo	Descrizione
areas	string
iterations	string

WorkItemClassificationNode

Definisce un nodo di classificazione per il rilevamento degli elementi di lavoro.

Nome	Tipo	Descrizione
_links	ReferenceLinks	Riferimenti ai collegamenti alle risorse REST correlate.
attributes	object	Dizionario con attributi di nodo come data di inizio/fine per i nodi di iterazione.
children	WorkItemClassificationNode[]	Elenco dei nodi figlio recuperati.
hasChildren	boolean	Flag che indica se il nodo di classificazione ha nodi figlio.
id	integer	ID intero del nodo di classificazione.
identifier	string	ID GUID del nodo di classificazione.
name	string	Nome del nodo di classificazione.
structureType	TreeNodeStructureType	Tipo di struttura del nodo.
url	string