Classification Nodes - Create Or Update

Reference

Service:: Work Item Tracking

API Version:: 5.0

Vytvořte nový nebo aktualizujte existující uzel klasifikace.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
organization	path	True	string	Název organizace Azure DevOps.
project	path	True	string	ID projektu nebo název projektu
structureGroup	path	True	TreeStructureGroup	Skupina struktury klasifikačního uzlu, oblasti nebo iterace.
path	path		string	Cesta uzlu klasifikace.
api-version	query	True	string	Verze rozhraní API, která se má použít. Aby se tato verze rozhraní API používala, měla by být nastavená na hodnotu 5.0.

Text požadavku

Name	Typ	Description
_links	ReferenceLinks	Odkazy na související prostředky REST.
attributes	object	Slovník, který má atributy uzlu, jako je datum zahájení a dokončení pro uzly iterace.
children	WorkItemClassificationNode[]	Seznam načtených podřízených uzlů
hasChildren	boolean	Příznak, který označuje, jestli má uzel klasifikace nějaké podřízené uzly.
id	integer	Celočíselné ID uzlu klasifikace.
identifier	string	IDENTIFIKÁTOR GUID uzlu klasifikace.
name	string	Název uzlu klasifikace.
structureType	TreeNodeStructureType	Typ struktury uzlu.
url	string

Odpovědi

Name	Typ	Description
200 OK	WorkItemClassificationNode	úspěšná operace

Zabezpečení

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

Name	Description
vso.work_write	Uděluje možnost číst, vytvářet a aktualizovat pracovní položky a dotazy, metadata aktualizačního panelu, oblast čtení a iterace cest k jiným metadatům souvisejícím se sledováním pracovních položek, spouštět dotazy a přijímat oznámení o událostech pracovních položek prostřednictvím zachytávání služeb.

Příklady

Create an area

Create an iteration

Move an area node

Move an iteration node

Create an area

Sample Request

HTTP

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

{
  "name": "Web"
}

Sample Response

Status code:: 201

{
  "id": 126391,
  "identifier": "a5c68379-3258-4d62-971c-71c1c459336e",
  "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"
}

Create an iteration

Sample Request

HTTP

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

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

Sample Response

Status code:: 201

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

Move an area node

Sample Request

HTTP

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

{
  "id": 126391
}

Sample Response

Status code:: 200

{
  "id": 126391,
  "identifier": "d01a1947-781a-4328-95be-960b90d04fe3",
  "name": "Website team",
  "structureType": "area",
  "hasChildren": false,
  "_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

Sample Request

HTTP

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

{
  "id": 126392
}

Sample Response

Status code:: 200

{
  "id": 126392,
  "identifier": "81f373b4-93cb-4c2b-99e6-1308ea5d1adc",
  "name": "Ultimate iteration",
  "structureType": "iteration",
  "hasChildren": false,
  "_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"
}

Definice

Name	Description
ReferenceLinks	Třída představující kolekci odkazů REST.
TreeNodeStructureType	Typ struktury uzlu.
TreeStructureGroup	Skupina struktury klasifikačního uzlu, oblasti nebo iterace.
WorkItemClassificationNode	Definuje uzel klasifikace pro sledování pracovních položek.

ReferenceLinks

Třída představující kolekci odkazů REST.

Name	Typ	Description
links	object	Zobrazení odkazů jen pro čtení. Vzhledem k tomu, že odkazy jsou jen pro čtení, chceme je zveřejnit jenom jako odkazy jen pro čtení.

TreeNodeStructureType

Typ struktury uzlu.

Name	Typ	Description
area	string	Typ oblasti.
iteration	string	Typ iterace.

TreeStructureGroup

Skupina struktury klasifikačního uzlu, oblasti nebo iterace.

Name	Typ	Description
areas	string
iterations	string

WorkItemClassificationNode

Definuje uzel klasifikace pro sledování pracovních položek.

Name	Typ	Description
_links	ReferenceLinks	Odkazy na související prostředky REST.
attributes	object	Slovník, který má atributy uzlu, jako je datum zahájení a dokončení pro uzly iterace.
children	WorkItemClassificationNode[]	Seznam načtených podřízených uzlů
hasChildren	boolean	Příznak, který označuje, jestli má uzel klasifikace nějaké podřízené uzly.
id	integer	Celočíselné ID uzlu klasifikace.
identifier	string	IDENTIFIKÁTOR GUID uzlu klasifikace.
name	string	Název uzlu klasifikace.
structureType	TreeNodeStructureType	Typ struktury uzlu.
url	string

Sdílet prostřednictvím

Classification Nodes - Create Or Update

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

oauth2

Scopes

Příklady

Create an area

Sample Request

Sample Response

Create an iteration

Sample Request

Sample Response

Move an area node

Sample Request

Sample Response

Move an iteration node

Sample Request

Sample Response

Definice

ReferenceLinks

TreeNodeStructureType

TreeStructureGroup

WorkItemClassificationNode

Další materiály