Condividi tramite

Classification Nodes - Get

  • Riferimento
Servizio:
Work Item Tracking
Versione API:
7.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=7.1
Con parametri facoltativi: 
GET https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?$depth={$depth}&api-version=7.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. Deve essere impostato su '7.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

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL 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

Ambiti

Nome Descrizione
vso.work Concede la possibilità di leggere elementi di lavoro, query, lavagne, percorsi di aree e iterazioni e altri metadati correlati al rilevamento degli elementi di lavoro. Concede inoltre la possibilità di eseguire query, cercare elementi di lavoro e ricevere notifiche sugli eventi degli elementi di lavoro tramite hook del servizio.

Esempio

Get an area
Get an iteration

Get an area

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
200 
{
  "id": 126391,
  "identifier": "d5d98099-47ac-468a-9579-c059c90bf7c5",
  "name": "Web",
  "structureType": "area",
  "hasChildren": false,
  "path": "\\fabrikam\\fiber\\tfvc\\iteration",
  "_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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
200 
{
  "id": 126392,
  "identifier": "dd643523-4d15-4106-a6a4-e70d39a09446",
  "name": "Final Iteration",
  "structureType": "iteration",
  "hasChildren": false,
  "path": "\\fabrikam\\fiber\\tfvc\\iteration",
  "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 per 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.
Object

Classe per rappresentare una raccolta di collegamenti di riferimento REST.

Nome Tipo Descrizione
links

object

Visualizzazione di sola lettura dei collegamenti. Poiché i collegamenti di riferimento sono di sola lettura, è consigliabile esporli solo come di sola lettura.

TreeNodeStructureType

Enumerazione

Tipo di struttura del nodo.

Valore Descrizione
area

Tipo di area.
iteration

Tipo di iterazione.

TreeStructureGroup

Enumerazione

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

Valore Descrizione
areas
iterations

WorkItemClassificationNode

Object

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

Nome Tipo Descrizione
_links

ReferenceLinks

Collegamenti ai riferimenti 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 (int32)

ID intero del nodo di classificazione.
identifier

string (uuid)

ID GUID del nodo di classificazione.
name

string

Nome del nodo di classificazione.
path

string

Percorso del nodo di classificazione.
structureType

TreeNodeStructureType

Tipo di struttura del nodo.
url

string