Classification Nodes - Update

Service:

Work Item Tracking

API Version:

4.1

Aggiornare un nodo di classificazione esistente.

PATCH https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?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 del 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 '4.1' per usare questa versione dell'API.

Corpo della richiesta

Nome	Tipo	Descrizione
_links	ReferenceLinks	Collegare i riferimenti alle risorse REST correlate.
attributes	object	Dizionario con attributi di nodo come la 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

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_write	Concede la possibilità di leggere, creare e aggiornare elementi di lavoro e query, aggiornare i metadati della scheda, l'area di lettura e le iterazioni dei percorsi di altri metadati correlati al rilevamento degli elementi di lavoro, eseguire query e ricevere notifiche sugli eventi degli elementi di lavoro tramite hook del servizio.

Esempio

Change an iteration's dates

Rename an area

Rename an iteration

Change an iteration's dates

Sample Request

HTTP

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

{
  "attributes": {
    "startDate": "2015-01-26T00:00:00Z",
    "finishDate": "2015-01-30T00:00:00Z"
  }
}

Sample Response

Status code:

200

{
  "id": 126392,
  "identifier": "a5c68379-3258-4d62-971c-71c1c459336e",
  "name": "Ultimate iteration",
  "structureType": "iteration",
  "hasChildren": false,
  "attributes": {
    "startDate": "2015-01-26T00:00:00Z",
    "finishDate": "2015-01-30T00:00:00Z"
  },
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Ultimate%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/Ultimate%20iteration"
}

Rename an area

Sample Request

HTTP

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

{
  "name": "Website team"
}

Sample Response

Status code:

200

{
  "id": 126391,
  "identifier": "25450731-5178-4044-84f0-0a0ebdef0c33",
  "name": "Website team",
  "structureType": "area",
  "hasChildren": false,
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Website%20team"
    },
    "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/Website%20team"
}

Rename an iteration

Sample Request

HTTP

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

{
  "name": "Ultimate iteration"
}

Sample Response

Status code:

200

{
  "id": 126392,
  "identifier": "8677aa7d-2f4a-4f53-8f0f-b84a23997f70",
  "name": "Ultimate iteration",
  "structureType": "iteration",
  "hasChildren": false,
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Ultimate%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/Ultimate%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.

ReferenceLinks

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

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	Collegare i riferimenti alle risorse REST correlate.
attributes	object	Dizionario con attributi di nodo come la 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