Condividi tramite

Classification Nodes - Create Or Update

  • Riferimento
Servizio:
Work Item Tracking
Versione API:
7.1

Creare un nodo di classificazione nuovo o aggiornare un nodo di classificazione esistente.

POST https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?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.

Corpo della richiesta

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

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_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 percorsi di altri metadati correlati di rilevamento degli elementi di lavoro, eseguire query e ricevere notifiche sugli eventi degli elementi di lavoro tramite hook del servizio.

Esempio

Create an area
Create an iteration
Move an area node
Move an iteration node

Create an area

Esempio di richiesta

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

{
  "name": "Web"
}

Risposta di esempio

Codice di stato:
201 
{
  "id": 126391,
  "identifier": "a5c68379-3258-4d62-971c-71c1c459336e",
  "name": "Web",
  "structureType": "area",
  "hasChildren": false,
  "path": "\\fabrikam\\fiber\\tfvc\\area",
  "_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"
}

Create an iteration

Esempio di richiesta

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

{
  "name": "Final Iteration",
  "attributes": {
    "startDate": "2014-10-27T00:00:00Z",
    "finishDate": "2014-10-31T00:00:00Z"
  }
}

Risposta di esempio

Codice di stato:
201 
{
  "id": 126392,
  "identifier": "8dbed14a-c1b6-46e8-8540-8118c4ea29ae",
  "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"
}

Move an area node

Esempio di richiesta

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

{
  "id": 126391
}

Risposta di esempio

Codice di stato:
200 
{
  "id": 126391,
  "identifier": "d01a1947-781a-4328-95be-960b90d04fe3",
  "name": "Website team",
  "structureType": "area",
  "hasChildren": false,
  "path": "\\fabrikam\\fiber\\tfvc\\area",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Parent%20Area/Website%20team"
    },
    "parent": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Parent%20Area"
    }
  },
  "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Parent%20Area/Website%20team"
}

Move an iteration node

Esempio di richiesta

POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/{structureGroup}?api-version=7.1

{
  "id": 126392
}

Risposta di esempio

Codice di stato:
200 
{
  "id": 126392,
  "identifier": "81f373b4-93cb-4c2b-99e6-1308ea5d1adc",
  "name": "Ultimate iteration",
  "structureType": "iteration",
  "hasChildren": false,
  "path": "\\fabrikam\\fiber\\tfvc\\iteration",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Parent%20Iteration/Ultimate%20iteration"
    },
    "parent": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Parent%20Iteration"
    }
  },
  "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Parent%20Iteration/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.
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