범주 XML 요소 참조

아티클
11/18/2015

CATEGORIES 요소를 사용하여 WIT(작업 항목 형식)를 그룹화합니다. 범주를 사용하여 작업 항목 형식 그룹화에서는 Visual Studio Online 및 TFS(Team Foundation Server)에서 사용하는 각 기본 범주에 대한 설명을 제공합니다.

<CATEGORIES>
   <CATEGORY name="category display name" refname="category reference name">
      <DEFAULTWORKITEMTYPE name="work item type reference name" />
      <WORKITEMTYPE name="work item type reference name" />
   </CATEGORY>
</CATEGORIES>

특성 및 요소

요소	특성	설명
CATEGORIES		XML 범주 파일 내의 필수 요소입니다. 팀 프로젝트에 대해 정의된 CATEGORY 요소를 하나 이상 지정하는 컨테이너 요소입니다.
CATEGORY		필수 CATEGORIES 자식 요소입니다. 하나의 기본 DEFAULTWORKITEMTYPE 요소와 0개 이상의 WORKITEMTYPE 요소를 포함하는 명명된 범주 그룹을 지정합니다.
	name	필수 CATEGORY 특성입니다. 특성 형식은 typelib:FriendlyName입니다. 범주의 표시 이름을 지정합니다. 1-254자 사이여야 하고 팀 프로젝트 내에서 고유해야 합니다.
	refname	필수 CATEGORY 특성입니다. 특성 형식은 typelib:ReferenceName입니다. 영숫자, 밑줄 및 하이픈 문자를 사용하는 70자 이하의 유니코드 문자로 이름을 지정합니다. 참조 이름에 마침표(.)가 적어도 한 개 이상 포함되어야 하지만 마침표가 이름의 맨 앞이나 끝에는 올 수 없습니다. 또한 참조 이름은 숫자나 밑줄로 시작할 수 없으며 (--)처럼 여러 개의 하이픈을 연속해서 사용할 수 없습니다. 예약된 시스템과 겹치는 이름을 지정하지 마세요. XXX 및 Microsoft XXX 네임스페이스 작업 항목 추적 개체의 명명 규칙을 참조하세요.
DEFAULTWORKITEMTYPE		필수 CATEGORY 요소입니다. 명명된 범주에 속하는 것으로 태그를 지정하고 범주의 기본 형식으로 사용할 작업 항목 형식을 지정합니다.
	name	필수 DEFAULTWORKITEMTYPE 특성입니다. 특성 형식은 WorkItemTypeRef입니다. 범주의 기본 형식으로 사용할 팀 프로젝트에 유효한 작업 항목 형식의 참조 이름을 지정합니다.
WORKITEMTYPE		선택적 CATEGORY 요소입니다. 명명된 범주에 속하는 것으로 태그를 지정할 작업 항목 형식을 지정합니다.
	name	필수 WORKITEMTYPE 특성입니다. 특성 형식은 WorkItemTypeRef입니다. 명명된 범주에 속하는 팀 프로젝트에 유효한 작업 항목 형식의 참조 이름을 지정합니다.

설명

CATEGORIES는 범주 스키마의 루트 요소입니다.

범주는 팀 프로젝트에서 저장 및 사용되는 CATEGORIES 요소의 CATEGORY 집합 내에 정의됩니다. 각 CATEGORIES 요소에는 CATEGORY 요소가 한 개 이상 정의되어 있어야 합니다.

범주는 비워둘 수 없습니다. 각 CATEGORY 요소에는 DEFAULTWORKITEMTYPE 또는 WORKITEMTYPE 요소가 하나 이상 정의되어 있어야 합니다.

범주마다 팀 프로젝트 내에서 고유해야 하는 이름과 참조 이름이 있습니다. 각 범주 이름은 다음 요구 사항을 충족해야 합니다.

전역 목록 이름은 최대 254자의 유니코드 문자로 지정할 수 있습니다.
전역 목록 이름은 비어 있지 않아야 합니다.
이름에 선행 또는 후행 공백을 사용할 수 없습니다.
이름에 백슬래시(\) 문자를 사용할 수 없습니다.
이름에는 두 개 이상의 연속된 공백을 사용할 수 없습니다.

범주 이름은 지역화되지 않으며 토큰으로 만들 수 없는 반면, 작업 항목 형식 이름은 지역화할 수 있고 토큰으로 만들 수 있습니다.

Agile 도구, 범주 요구 사항 및 제한

범주에 WIT를 할당할 때 다음과 같은 작업 메모를 고려합니다.

백로그 및 작업 보드를 사용하려면 최소한 요구 사항 범주에 WIT 하나, 작업 범주에 WIT 하나를 할당해야 합니다.
동일한 WIT를 요구 사항 범주 및 작업 범주 양쪽에 할당할 수 없습니다.
요구 사항 범주 또는 작업 범주에 여러 개의 WIT를 포함하는 경우 DEFAULTWORKITEMTYPE요소에 할당된 형식이 Agile 백로그 및 보드 페이지에 기본 형식으로 나타납니다.
ProcessConfiguration 파일에서 백로그를 정의하는 범주에 속하는 WIT에는 프로세스 구성 XML 요소 참조에 설명된 대로 유효한 metastate에 매핑된 시작, 종료 및 하나 이상의 중간 워크플로 상태가 있어야 합니다.
버그 범주에 할당하는 WIT는 각 팀의 백로그 및 보드에 표시되도록 구성할 수 있습니다. ProcessConfiguration 파일에서 BugsBehavior에 대한 속성을 정의하여 기본 동작을 설정합니다.

예제

다음 예제에서는 스크럼 프로세스 템플릿의 기본 범주 XML 파일을 나열합니다.

<?xml version="1.0" encoding="utf-8"?>
<cat:CATEGORIES xmlns:cat="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories">
  <!-- Usage: for resilience in Test system. Even if WITs have different name, they can be referred to by the category -->
  <CATEGORY name="Bug Category" refname="Microsoft.BugCategory">
    <DEFAULTWORKITEMTYPE name="Bug" />
  </CATEGORY>
  <CATEGORY name="Epic Category" refname="Microsoft.EpicCategory">
    <DEFAULTWORKITEMTYPE name="Epic" />
  </CATEGORY>
  <CATEGORY name="Feature Category" refname="Microsoft.FeatureCategory">
    <DEFAULTWORKITEMTYPE name="Feature" />
  </CATEGORY>
  <CATEGORY name="Requirement Category" refname="Microsoft.RequirementCategory">
    <DEFAULTWORKITEMTYPE name="Product Backlog Item" />
    <WORKITEMTYPE name="Bug" />
  </CATEGORY>
  <CATEGORY name="Test Case Category" refname="Microsoft.TestCaseCategory">
    <DEFAULTWORKITEMTYPE name="Test Case" />
  </CATEGORY>
  <CATEGORY name="Shared Step Category" refname="Microsoft.SharedStepCategory">
    <DEFAULTWORKITEMTYPE name="Shared Steps" />
  </CATEGORY>
   <CATEGORY name="Shared Parameter Category" refname="Microsoft.SharedParameterCategory">
    <DEFAULTWORKITEMTYPE name="Shared Parameter" />
  </CATEGORY>
  <CATEGORY name="Code Review Request Category" refname="Microsoft.CodeReviewRequestCategory">
    <DEFAULTWORKITEMTYPE name="Code Review Request" />
  </CATEGORY>
  <CATEGORY name="Code Review Response Category" refname="Microsoft.CodeReviewResponseCategory">
    <DEFAULTWORKITEMTYPE name="Code Review Response" />
  </CATEGORY>
  <CATEGORY name="Feedback Request Category" refname="Microsoft.FeedbackRequestCategory">
    <DEFAULTWORKITEMTYPE name="Feedback Request" />
  </CATEGORY>
  <CATEGORY name="Feedback Response Category" refname="Microsoft.FeedbackResponseCategory">
    <DEFAULTWORKITEMTYPE name="Feedback Response" />
  </CATEGORY>
  <CATEGORY name="Test Plan Category" refname="Microsoft.TestPlanCategory">
    <DEFAULTWORKITEMTYPE name="Test Plan" />
  </CATEGORY>
  <CATEGORY name="Test Suite Category" refname="Microsoft.TestSuiteCategory">
    <DEFAULTWORKITEMTYPE name="Test Suite" />
  </CATEGORY>
  <CATEGORY name="Task Category" refname="Microsoft.TaskCategory">
    <DEFAULTWORKITEMTYPE name="Task" />
  </CATEGORY>
  <CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory">
    <DEFAULTWORKITEMTYPE name="Code Review Request" />
    <WORKITEMTYPE name="Code Review Response" />
    <WORKITEMTYPE name="Feedback Request" />
    <WORKITEMTYPE name="Feedback Response" />
    <WORKITEMTYPE name="Shared Steps" />
    <WORKITEMTYPE name="Shared Parameter" />
    <WORKITEMTYPE name="Test Plan" />
    <WORKITEMTYPE name="Test Suite" />
  </CATEGORY>
</cat:CATEGORIES>

참고 항목

기타 리소스

범주를 사용하여 작업 항목 형식 그룹화

다음을 통해 공유

범주 XML 요소 참조

특성 및 요소

설명

Agile 도구, 범주 요구 사항 및 제한

예제

참고 항목

기타 리소스

추가 리소스