영어로 읽기

다음을 통해 공유


작업 항목 추적

작업 항목 추적 리소스

팀에 대한 버그, 작업 및 다른 작업 항목을 가져오고, 만들고, 업데이트합니다. 쿼리를 통해 작업 항목 쿼리 언어를 완전히 활용하여 작업 항목을 검색 및 필터링할 수 있습니다. 작업 항목 쿼리 언어를 사용하여 쿼리를 충족하는 각 작업 항목에 접근할 수 있습니다. 작업 항목에는 전체 기록이 보존되고 작업 항목의 각 전체 수정 또는 각 수정에서 업데이트된 내용만 가져올 수 있습니다. 작업 항목에 태그를 지정할 수도 있습니다.


일반 작업

쿼리를 사용하여 작업 항목 가져오기

  1. 사용하려는 쿼리 를 조회합니다.
  2. 해당 쿼리에 대한 결과를 가져옵니다.
  3. 각 작업 항목을 ID별로 가져옵니다.

일괄 처리로 WorkItems 업데이트

Batch WorkItem Update API를 사용하여 작업 사이트를 일괄 처리로 업데이트합니다.

작업 항목의 필드 업데이트

  1. 업데이트하려는 작업 항목 의 ID를 가져옵니다.
  2. 작업 항목의 필드를 업데이트합니다.
  1. 연결하려는 작업 항목 의 ID를 가져옵니다.
  2. 작업 항목 간에 링크를 추가합니다.

작업 항목 만들기를 사용하고 일괄 처리 호출에 링크 API를 추가합니다.

작업 항목에 파일 첨부

  1. 업데이트하려는 작업 항목 의 ID를 가져옵니다.
  2. 첨부 파일을 첨부 파일 저장소에 업로드합니다.
  3. 작업 항목에 첨부 파일을 추가 합니다.

작업 항목 만들기

작업 항목을 만듭니다. 제목을 하나 이상 제공해야 합니다. 일부 작업 항목 유형에는 다른 필드에 대한 값이 필요합니다.

작업 항목의 전체 기록 가져오기

  1. 작업 항목의 ID를 가져옵니다.
  2. 작업 항목 에 대한 업데이트 목록을 가져옵니다.
  3. 수정 버전에 표시된 대로 전체 작업 항목을 가져옵니다.

작업 항목 삭제

  1. 작업 항목의 ID를 가져옵니다.
  2. 작업 항목을 삭제합니다.

팀 프로젝트에 사용되는 필드 가져오기

  1. 팀 프로젝트에 사용되는 작업 항목 유형을 가져옵니다.
  2. 작업 항목 유형을 가져와서 사용하는 필드를 확인합니다. (xmlform을 지나 fieldinstances로 건너뜁니다.)

작업 항목 범주 가져오기

작업 항목의 범주를 사용하여 다양한 함수에 대해 팀 프로젝트에서 사용되는 작업 항목 유형을 가져옵니다. 예를 들어 백로그에 표시되는 작업 항목을 보려면 요구 사항 범주를 가져옵니다.

영역 및 반복 가져오기

팀 프로젝트에 대한 영역 계층 구조 또는 반복 계층 구조를 가져옵니다.

작업 항목 관계 유형 가져오기

프로젝트 컬렉션에서 사용할 수 있는 사용 가능한 유형의 작업 항목 링크를 가져옵니다.


작업 항목 메타데이터 리소스

작업 항목은 메타데이터에 의해 관리됩니다. 일부 메타데이터는 특정 팀 프로젝트로 범위가 지정되고 다른 메타데이터는 프로젝트 컬렉션(예: Azure DevOps Services 계정의 기본 컬렉션)으로 범위가 지정됩니다.

프로젝트 범위 메타데이터

팀 프로젝트에는 작업 항목 유형 집합이 있습니다. 각 작업 항목 유형은 프로젝트에서 해당 역할을 정의하는 "요구 사항" 또는 "버그"와 같은 범주 에 속할 수 있습니다. 분류 노드는 팀 프로젝트의 작업 항목에 대한 영역 및 반복 필드에 사용할 수 있는 값 집합을 정의합니다.

컬렉션 범위 메타데이터

작업 항목 유형은 필드관계 유형(링크 및 첨부 파일)을 다른 유형의 작업 항목과 공유합니다.


작업 항목 일괄 업데이트 API

여러 작업 항목 업데이트 요청을 수행합니다. 응답에는 일괄 처리의 각 요청에 대한 개별 응답이 포함됩니다. 실패한 요청은 일괄 처리의 후속 요청에 영향을 미치지 않습니다.

REST API 의미 체계

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
조직 경로 True 문자열 Azure DevOps 조직의 이름입니다.
api-version Query 문자열 사용할 API의 버전입니다.
bypassRules Query boolean 이 업데이트에 작업 항목 유형 규칙을 적용하지 마세요.
suppressNotifications Query boolean 이 변경에 대한 알림을 실행하지 마세요.

요청 본문

요청 본문은 작업 항목 업데이트 요청 목록으로 구성됩니다. 이 목록의 각 항목은 REST 메서드, 경로, 헤더 및 본문을 포함하여 단일 업데이트 요청에 대한 모든 정보를 연결합니다.

단일 요청에 대한 자세한 내용은 작업 항목 업데이트 설명서를 검사 수 있습니다.

Batch 업데이트 예제

요청

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

요청 본문

[
  {
    // 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"
        }
    ]
  },
]

응답

응답은 일괄 처리된 각 업데이트 요청에 대한 개별 응답으로 구성됩니다.

  • count : 반환된 일괄 처리된 업데이트 응답 수
  • value : 응답 코드, 헤더 및 본문이 있는 응답 개체 목록
{
  "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}"
    }
  ]
}