Classification Nodes - Update

Service:

Work Item Tracking

API Version:

4.1

Aktualizace existujícího uzlu klasifikace

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

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 4.1.

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

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

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