Seguimiento de elementos de trabajo

  • Artículo

Recursos de seguimiento de elementos de trabajo

Obtenga, cree y actualice errores, tareas y otros elementos de trabajo para su equipo. Las consultas le permiten usar toda la eficacia del lenguaje de la consulta de elementos de trabajo para buscar y filtrar elementos de trabajo. Puede usar el lenguaje de la consulta de elementos de trabajo para llegar a cada elemento de trabajo que cumple con la consulta. Los elementos de trabajo conservan un historial completo, y usted puede obtener una revisión total del elemento de trabajo o solo las actualizaciones que se realizaron en cada revisión. Los elementos de trabajo también pueden etiquetarse.

Tareas comunes

Obtener elementos de trabajo mediante una consulta

  1. Busque la consulta que desea usar.
  2. Obtenga los resultados de esa consulta.
  3. Obtenga cada uno de los elementos de trabajo por identificador.

Actualización de WorkItems en lotes

Use batch WorkItem Update API para actualizar los elementos de trabajo en el lote.

Actualizar los campos de un elemento de trabajo

  1. Obtenga el identificador del elemento de trabajo que desea actualizar.
  2. Actualice los campos del elemento de trabajo.
  1. Obtenga el identificador de los elementos de trabajo que desea vincular.
  2. Agregue un vínculo entre los elementos de trabajo.

Use la creación de un elemento de trabajo y agregue una API de vínculo en una llamada por lotes.

Adjuntar un archivo a un elemento de trabajo

  1. Obtenga el identificador del elemento de trabajo que desea actualizar.
  2. Cargue los datos adjuntos en el almacén de datos adjuntos.
  3. Agregue los datos adjuntos al elemento de trabajo.

Crear un elemento de trabajo

Cree un elemento de trabajo. Asegúrese de proporcionar al menos un título. Algunos tipos de elementos de trabajo requerirán valores para otros campos.

Obtener el historial completo de un elemento de trabajo

  1. Obtenga el identificador del elemento de trabajo.
  2. Obtenga una lista de las actualizaciones realizadas en un elemento de trabajo.
  3. Obtenga todo el elemento de trabajo tal como apareció en cualquier revisión.

Eliminar un elemento de trabajo

  1. Obtenga el identificador del elemento de trabajo.
  2. Elimine el elemento de trabajo.

Obtener los campos usados en un proyecto de equipo

  1. Obtiene los tipos de elementos de trabajo usados en un proyecto de equipo.
  2. Obtenga cada tipo de elemento de trabajo para ver los campos que usa. (Omita el xmlform a fieldinstances).

Obtener categorías de elementos de trabajo

Use categorías de elementos de trabajo para obtener los tipos de elementos de trabajo usados en un proyecto de equipo para distintas funciones. Por ejemplo, para ver los elementos de trabajo que aparecen en el trabajo pendiente, obtenga la categoría de requisitos.

Obtención de áreas e iteraciones

Obtenga la jerarquía de área o la jerarquía de iteración del proyecto de equipo.

Obtener tipos de relaciones de elementos de trabajo

Obtenga los tipos disponibles de vínculos de elementos de trabajo que están disponibles en la colección de proyectos.

Recursos de metadatos del elemento de trabajo

Los elementos de trabajo se rigen por metadatos. Algunos de los metadatos se limitan a un proyecto de equipo específico y otros metadatos se limitan a una colección de proyectos (como la colección predeterminada de la cuenta de Azure DevOps Services).

Metadatos con ámbito de proyecto

El proyecto de equipo tiene un conjunto de tipos de elementos de trabajo. Cada tipo de elemento de trabajo puede pertenecer a una categoría como "requisito" o "error" para definir su rol en el proyecto. Los nodos de clasificación definen el conjunto de valores que se pueden usar en el área y los campos de iteración para los elementos de trabajo del proyecto de equipo.

Metadatos con ámbito de recopilación

Los tipos de elementos de trabajo comparten campos y tipos de relación (vínculos y datos adjuntos) con otros tipos de elementos de trabajo.

API de actualización por lotes de elementos de trabajo

Realiza varias solicitudes de actualización de elementos de trabajo. La respuesta contiene respuestas individuales para cada una de las solicitudes del lote. Las solicitudes con error no afectan a las solicitudes posteriores del lote.

SEMÁNTICA DE LA API REST

PATCH https://dev.azure.com/{organization}/_apis/wit/$batch?api-version=6.1

Parámetros de identificador URI

Nombre En Obligatorio Tipo Descripción
organization Ruta de acceso True string El nombre de la organización de Azure DevOps.
api-version Query string Versión de la API que se va a usar.
bypassRules Query boolean No aplique las reglas de tipo de elemento de trabajo en esta actualización.
suppressNotifications Query boolean No active ninguna notificación para este cambio.

Cuerpo de la solicitud

El cuerpo de la solicitud se compone como una lista de solicitudes de actualización de elementos de trabajo. Cada elemento de esta lista conatinará toda la información sobre una única solicitud de actualización, incluido el método REST, la ruta de acceso, los encabezados y el cuerpo.

Puede consultar la documentación de actualización de elementos de trabajo para obtener información detallada sobre una sola solicitud.

Ejemplo de actualización por lotes

Solicitud

PATCH https://dev.azure.com/fabrikam/_apis/wit/$batch?api-version=6.1

Cuerpo de la solicitud

[
  {
    // Add priority and test rev on work item with id 1
    "method": "PATCH",
    "uri": "/_apis/wit/workitems/1?api-version=6.1",
    "headers": {
      "Content-Type": "application/json-patch+json"
    },
    "body": [
      {
        "op": "test",
        "path": "/rev",
        "value": 3
      },
      {
        "op": "add",
        "path": "/fields/Microsoft.VSTS.Common.Priority",
        "value": "1"
      }
    ]
  },
  {
    // Replace tags on work item with id 299x   
    "method": "PATCH",
    "uri": "/_apis/wit/workitems/299?api-version=6.1",
    "headers": {
      "Content-Type": "application/json-patch+json"
    },
    "body": [
      {
        "op": "replace",
        "path": "/fields/System.Tags",
        "value": "Tag1; Tag2"
      }
    ]
  },
  {
    // You can also use Work Item Create format
    "method": "PATCH",
    "uri": "/mytestprojectname/_apis/wit/workitems/$Bug?api-version=4.1",
    "headers": {
        "Content-Type": "application/json-patch+json"
    },
    "body": [
        {
            "op": "add",
            "path": "/id",
            "value": "-1"
        },
        {
            "op": "add",
            "path": "/fields/System.Title",
            "from": null,
            "value": "Sample 1"
        }
    ]
  },
]

Respuesta

La respuesta consta de respuestas individuales para cada solicitud de actualización por lotes.

  • count : número de respuestas de actualización por lotes devueltas
  • value : lista de objetos de respuesta con su código de respuesta, encabezados y cuerpo
{
  "count": 2,
  "value": [
    {
      "code": 200,
      "headers": {
        "Content-Type": "application/json; charset=utf-8"
      },
      "body": "{work item object}"
    },
    {
      "code": 200,
      "headers": {
        "Content-Type": "application/json; charset=utf-8"
      },
      "body": "{work item object}"
    }
  ]
}