Classification Nodes - Create Or Update

  • Başvuru
Service:
Work Item Tracking
API Version:
7.1-preview.2

Yeni bir sınıflandırma düğümü oluşturun veya var olan bir sınıflandırma düğümünü güncelleştirin.

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

URI Parametreleri

Name İçinde Gerekli Tür Description
organization
 path True

string

Azure DevOps kuruluşunun adı.
project
 path True

string

Proje Kimliği veya proje adı
structureGroup
 path True

TreeStructureGroup

Sınıflandırma düğümünün, alanın veya yinelemenin yapı grubu.
path
 path

string

Sınıflandırma düğümünün yolu.
api-version
 query True

string

Kullanılacak API sürümü. Api'nin bu sürümünü kullanmak için bu değer '7.1-preview.2' olarak ayarlanmalıdır.

İstek Gövdesi

Name Tür Description
_links

ReferenceLinks

İlgili REST kaynaklarına bağlantı başvuruları.
attributes

object

Yineleme düğümleri için başlangıç/bitiş tarihi gibi düğüm özniteliklerine sahip sözlük.
children

WorkItemClassificationNode[]

Getirilen alt düğümlerin listesi.
hasChildren

boolean

Sınıflandırma düğümünde alt düğüm olup olmadığını gösteren bayrak.
id

integer

Sınıflandırma düğümünün tamsayı kimliği.
identifier

string

Sınıflandırma düğümünün GUID kimliği.
name

string

Sınıflandırma düğümünün adı.
path

string

Sınıflandırma düğümünün yolu.
structureType

TreeNodeStructureType

Düğüm yapısı türü.
url

string

Yanıtlar

Name Tür Description
200 OK

WorkItemClassificationNode

başarılı işlem

Güvenlik

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 İş öğelerini ve sorgularını okuma, oluşturma ve güncelleştirme, pano meta verilerini güncelleştirme, alan ve yineleme yollarını diğer iş öğesi izlemeyle ilgili meta verileri izleme, sorguları yürütme ve hizmet kancaları aracılığıyla iş öğesi olayları hakkında bildirim alma olanağı verir.

Örnekler

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

Create an area

Sample Request

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

{
  "name": "Web"
}

Sample Response

Status code:
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

Sample Request

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

{
  "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,
  "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

Sample Request

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

{
  "id": 126391
}

Sample Response

Status code:
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

Sample Request

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

{
  "id": 126392
}

Sample Response

Status code:
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"
}

Tanımlar

Name Description
ReferenceLinks

REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.
TreeNodeStructureType

Düğüm yapısı türü.
TreeStructureGroup

Sınıflandırma düğümünün, alanın veya yinelemenin yapı grubu.
WorkItemClassificationNode

İş öğesi izleme için bir sınıflandırma düğümü tanımlar.

REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.

Name Tür Description
links

object

Bağlantıların salt okunur görünümü. Başvuru bağlantıları salt okunur olduğundan, bunları yalnızca salt okunur olarak göstermek istiyoruz.

TreeNodeStructureType

Düğüm yapısı türü.

Name Tür Description
area

string

Alan türü.
iteration

string

Yineleme türü.

TreeStructureGroup

Sınıflandırma düğümünün, alanın veya yinelemenin yapı grubu.

Name Tür Description
areas

string

iterations

string

WorkItemClassificationNode

İş öğesi izleme için bir sınıflandırma düğümü tanımlar.

Name Tür Description
_links

ReferenceLinks

İlgili REST kaynaklarına bağlantı başvuruları.
attributes

object

Yineleme düğümleri için başlangıç/bitiş tarihi gibi düğüm özniteliklerine sahip sözlük.
children

WorkItemClassificationNode[]

Getirilen alt düğümlerin listesi.
hasChildren

boolean

Sınıflandırma düğümünde alt düğüm olup olmadığını gösteren bayrak.
id

integer

Sınıflandırma düğümünün tamsayı kimliği.
identifier

string

Sınıflandırma düğümünün GUID kimliği.
name

string

Sınıflandırma düğümünün adı.
path

string

Sınıflandırma düğümünün yolu.
structureType

TreeNodeStructureType

Düğüm yapısı türü.
url

string