작업 항목 추적
팀에 대한 버그, 작업 및 다른 작업 항목을 가져오고, 만들고, 업데이트합니다. 쿼리를 통해 작업 항목 쿼리 언어를 완전히 활용하여 작업 항목을 검색 및 필터링할 수 있습니다. 작업 항목 쿼리 언어를 사용하여 쿼리를 충족하는 각 작업 항목에 접근할 수 있습니다. 작업 항목에는 전체 기록이 보존되고 작업 항목의 각 전체 수정 또는 각 수정에서 업데이트된 내용만 가져올 수 있습니다. 작업 항목에 태그를 지정할 수도 있습니다.
- 사용하려는 쿼리 를 조회합니다.
- 해당 쿼리에 대한 결과를 가져옵니다.
- 각 작업 항목을 ID별로 가져옵니다.
Batch WorkItem Update API를 사용하여 작업 사이트를 일괄 처리로 업데이트합니다.
- 업데이트하려는 작업 항목 의 ID를 가져옵니다.
- 작업 항목의 필드를 업데이트합니다.
작업 항목 만들기를 사용하고 일괄 처리 호출에 링크 API를 추가합니다.
- 업데이트하려는 작업 항목 의 ID를 가져옵니다.
- 첨부 파일을 첨부 파일 저장소에 업로드합니다.
- 작업 항목에 첨부 파일을 추가 합니다.
작업 항목을 만듭니다. 제목을 하나 이상 제공해야 합니다. 일부 작업 항목 유형에는 다른 필드에 대한 값이 필요합니다.
- 작업 항목의 ID를 가져옵니다.
- 작업 항목을 삭제합니다.
작업 항목의 범주를 사용하여 다양한 함수에 대해 팀 프로젝트에서 사용되는 작업 항목 유형을 가져옵니다. 예를 들어 백로그에 표시되는 작업 항목을 보려면 요구 사항 범주를 가져옵니다.
팀 프로젝트에 대한 영역 계층 구조 또는 반복 계층 구조를 가져옵니다.
프로젝트 컬렉션에서 사용할 수 있는 사용 가능한 유형의 작업 항목 링크를 가져옵니다.
작업 항목은 메타데이터에 의해 관리됩니다. 일부 메타데이터는 특정 팀 프로젝트로 범위가 지정되고 다른 메타데이터는 프로젝트 컬렉션(예: Azure DevOps Services 계정의 기본 컬렉션)으로 범위가 지정됩니다.
팀 프로젝트에는 작업 항목 유형 집합이 있습니다. 각 작업 항목 유형은 프로젝트에서 해당 역할을 정의하는 "요구 사항" 또는 "버그"와 같은 범주 에 속할 수 있습니다. 분류 노드는 팀 프로젝트의 작업 항목에 대한 영역 및 반복 필드에 사용할 수 있는 값 집합을 정의합니다.
작업 항목 유형은 필드 및 관계 유형(링크 및 첨부 파일)을 다른 유형의 작업 항목과 공유합니다.
여러 작업 항목 업데이트 요청을 수행합니다. 응답에는 일괄 처리의 각 요청에 대한 개별 응답이 포함됩니다. 실패한 요청은 일괄 처리의 후속 요청에 영향을 미치지 않습니다.
PATCH https://dev.azure.com/{organization}/_apis/wit/$batch?api-version=6.1
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
조직 | 경로 | True | 문자열 | Azure DevOps 조직의 이름입니다. |
api-version | Query | 문자열 | 사용할 API의 버전입니다. | |
bypassRules | Query | boolean | 이 업데이트에 작업 항목 유형 규칙을 적용하지 마세요. | |
suppressNotifications | Query | boolean | 이 변경에 대한 알림을 실행하지 마세요. |
요청 본문은 작업 항목 업데이트 요청 목록으로 구성됩니다. 이 목록의 각 항목은 REST 메서드, 경로, 헤더 및 본문을 포함하여 단일 업데이트 요청에 대한 모든 정보를 연결합니다.
단일 요청에 대한 자세한 내용은 작업 항목 업데이트 설명서를 검사 수 있습니다.
요청
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}"
}
]
}