Compartir a través de

Classification Nodes - Create Or Update

  • Referencia
Servicio:
Work Item Tracking
Versión de la API:
7.1

Cree uno nuevo o actualice un nodo de clasificación existente.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
organization
 path True

string

Nombre de la organización de Azure DevOps.
project
 path True

string

Id. de proyecto o nombre del proyecto
structureGroup
 path True

TreeStructureGroup

Grupo de estructura del nodo de clasificación, área o iteración.
path
 path

string

Ruta de acceso del nodo de clasificación.
api-version
 query True

string

Versión de la API que se va a usar. Debe establecerse en "7.1" para usar esta versión de la API.

Cuerpo de la solicitud

Nombre Tipo Description
_links

ReferenceLinks

Vincular referencias a recursos REST relacionados.
attributes

object

Diccionario que tiene atributos de nodo, como la fecha de inicio y finalización de los nodos de iteración.
children

WorkItemClassificationNode[]

Lista de nodos secundarios capturados.
hasChildren

boolean

Marca que indica si el nodo de clasificación tiene nodos secundarios.
id

integer (int32)

Identificador entero del nodo de clasificación.
identifier

string (uuid)

Identificador GUID del nodo de clasificación.
name

string

Nombre del nodo de clasificación.
path

string

Ruta de acceso del nodo de clasificación.
structureType

TreeNodeStructureType

Tipo de estructura de nodo.
url

string

Respuestas

Nombre Tipo Description
200 OK

WorkItemClassificationNode

operación correcta

Seguridad

oauth2

Tipo: oauth2
Flujo: accessCode
Dirección URL de autorización: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Dirección URL del 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

Ámbitos

Nombre Description
vso.work_write Concede la capacidad de leer, crear y actualizar elementos de trabajo y consultas, actualizar metadatos del panel de actualización, áreas de lectura e iteraciones rutas de acceso a otros metadatos relacionados con el seguimiento de elementos de trabajo, ejecutar consultas y recibir notificaciones sobre eventos de elemento de trabajo a través de enlaces de servicio.

Ejemplos

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

Create an area

Solicitud de ejemplo

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

{
  "name": "Web"
}

Respuesta de muestra

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

Solicitud de ejemplo

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

Respuesta de muestra

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

Solicitud de ejemplo

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

{
  "id": 126391
}

Respuesta de muestra

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

Solicitud de ejemplo

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

{
  "id": 126392
}

Respuesta de muestra

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

Definiciones

Nombre Description
ReferenceLinks

Clase que representa una colección de vínculos de referencia rest.
TreeNodeStructureType

Tipo de estructura de nodo.
TreeStructureGroup

Grupo de estructura del nodo de clasificación, área o iteración.
WorkItemClassificationNode

Define un nodo de clasificación para el seguimiento de elementos de trabajo.
Object

Clase que representa una colección de vínculos de referencia rest.

Nombre Tipo Description
links

object

Vista de solo lectura de los vínculos. Dado que los vínculos de referencia son de solo lectura, solo queremos exponerlos como de solo lectura.

TreeNodeStructureType

Enumeración

Tipo de estructura de nodo.

Valor Description
area

Tipo de área.
iteration

Tipo de iteración.

TreeStructureGroup

Enumeración

Grupo de estructura del nodo de clasificación, área o iteración.

Valor Description
areas
iterations

WorkItemClassificationNode

Object

Define un nodo de clasificación para el seguimiento de elementos de trabajo.

Nombre Tipo Description
_links

ReferenceLinks

Vincular referencias a recursos REST relacionados.
attributes

object

Diccionario que tiene atributos de nodo, como la fecha de inicio y finalización de los nodos de iteración.
children

WorkItemClassificationNode[]

Lista de nodos secundarios capturados.
hasChildren

boolean

Marca que indica si el nodo de clasificación tiene nodos secundarios.
id

integer (int32)

Identificador entero del nodo de clasificación.
identifier

string (uuid)

Identificador GUID del nodo de clasificación.
name

string

Nombre del nodo de clasificación.
path

string

Ruta de acceso del nodo de clasificación.
structureType

TreeNodeStructureType

Tipo de estructura de nodo.
url

string