Aracılığıyla paylaş

Classification Nodes - Create Or Update

  • Başvuru
Hizmet:
Work Item Tracking
API Sürümü:
7.1

Yeni bir sınıflandırma düğümü oluşturun veya mevcut 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

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'nin sürümü. Bu, API'nin bu sürümünü kullanmak için '7.1' olarak ayarlanmalıdır.

İstek Gövdesi

Name Tür Description
_links

ReferenceLinks

Başvuruları ilgili REST kaynaklarına bağlayın.
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 (int32)

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

string (uuid)

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

Tür: oauth2
Akış: accessCode
Yetkilendirme URL’si: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Belirteç URL'si: 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

Kapsamlar

Name Description
vso.work_write İş öğelerini ve sorgularını okuma, oluşturma ve güncelleştirme, pano meta verilerini güncelleştirme, okuma alanı ve yineleme yolları ile ilgili diğer iş öğesi izleme meta verilerini okuma, 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

Örnek isteği

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

{
  "name": "Web"
}

Örnek yanıt

Durum kodu:
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

Örnek isteği

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

Örnek yanıt

Durum kodu:
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

Örnek isteği

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

{
  "id": 126391
}

Örnek yanıt

Durum kodu:
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

Örnek isteği

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

{
  "id": 126392
}

Örnek yanıt

Durum kodu:
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.
Object

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 kullanıma açmak istiyoruz.

TreeNodeStructureType

Listeleme

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

Değer Description
area

Alan türü.
iteration

Yineleme türü.

TreeStructureGroup

Listeleme

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

Değer Description
areas
iterations

WorkItemClassificationNode

Object

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

Name Tür Description
_links

ReferenceLinks

Başvuruları ilgili REST kaynaklarına bağlayın.
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 (int32)

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

string (uuid)

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