다음을 통해 공유


범주 정의 스키마 참조

CATEGORIES 요소를 사용하여 그룹화 작업 항목 형식에 대해 하나 이상의 범주를 정의할 수 있습니다.

스키마 계층 구조

CATEGORIES Element (CATEGORIES Definition Schema)

**    CATEGORY Element (CATEGORIES Definition Schema)**

**        DEFAULTWORKITEMTYPE Element (CATEGORIES Definition Schema)**

**        WORKITEMTYPE Element (CATEGORIES Definition Schema)**

<xs:element name="CATEGORIES">
<xs:element name="CATEGORY" minOccurs="0" maxOccurs="unbounded">
<xs:element name="DEFAULTWORKITEMTYPE" type="WorkItemTypeRef" />
<xs:element name="WORKITEMTYPE" type="WorkItemTypeRef" minOccurs="0" maxOccurs="unbounded"/>

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

특성 및 요소

다음 단원에서는 범주 XML 파일의 특성 및 요소에 대해 설명합니다.

자식 요소 및 특성

요소

특성

설명

CATEGORIES

 

XML 범주 파일 내에서 필요한 요소입니다.

팀 프로젝트에 대해 정의된 하나 이상의 CATEGORY 요소를 지정하는 컨테이너 요소입니다.

CATEGORY

 

필요한 CATEGORIES 자식 요소입니다.

하나의 기본 DEFAULTWORKITEMTYPE 요소와 0개 이상의 WORKITEMTYPE 요소를 포함하는 명명된 범주 그룹을 지정합니다.

 

name

필수 CATEGORY 특성입니다.

특성 형식은 typelib:FriendlyName입니다.

범주의 표시 이름을 지정합니다. 1 ~ 254 문자 사이가 되고 팀 프로젝트 내에서 고유해야 합니다.

 

refname

필수 CATEGORY 특성입니다.

특성 형식은 typelib:ReferenceName입니다.

자세한 내용은 작업 항목 추적 개체의 명명 규칙을 참조하십시오.

DEFAULTWORKITEMTYPE

 

필수적 CATEGORY 요소입니다.

명명된 범주에 속하는 것으로 태그되고 범주에 대해 기본 형식으로 사용할 작업 항목 형식을 지정합니다.

 

name

필수 DEFAULTWORKITEMTYPE 특성입니다.

특성 형식은 WorkItemTypeRef입니다.

범주의 기본 형식으로 사용할 팀 프로젝트의 유효한 작업 항목 형식의 참조 이름을 지정합니다.

WORKITEMTYPE

 

선택적 CATEGORY 요소입니다.

명명된 범주에 속하는 것으로 태그를 지정할 작업 항목 형식을 지정합니다.

 

name

필수 WORKITEMTYPE 특성입니다.

특성 형식은 WorkItemTypeRef입니다.

명명된 범주에 속하는 팀 프로젝트의 유효한 작업 항목 형식의 참조 이름을 지정합니다.

설명

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

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

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

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

  • 전역 목록 이름은 최대 254자의 유니코드 문자로 지정할 수 있습니다.

  • 전역 목록 이름은 비어 있지 않아야 합니다.

  • 이름에는 선행 또는 후행 공백을 사용할 수 없습니다.

  • 이름에는 백슬래시(\) 문자를 사용할 수 없습니다.

  • 이름에는 두 개 이상의 연속된 공백을 사용할 수 없습니다.

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

참조 명명 규칙의 경우 작업 항목 추적 개체의 명명 규칙를 참조하십시오.

예제

다음 예제에서는 팀 프로젝트로 가져올 수 있는 범주 XML 파일을 지정합니다. 네 가지 범주를 정의하고 각 경우에만 기본 작업 항목 형식을 할당합니다.

<?xml version="1.0" encoding="utf-8"?>
<cat:CATEGORIES xmlns:cat="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories">
   <CATEGORY refname="Microsoft.BugCategory" name="Bug Category">
      <DEFAULTWORKITEMTYPE name="Bug" />
   </CATEGORY>
   <CATEGORY refname="Microsoft.RequirementCategory" name="Requirement Category">
      <DEFAULTWORKITEMTYPE name="User Story" />
   </CATEGORY>
   <CATEGORY refname="Microsoft.SharedStepCategory" name="Shared Step Category">
      <DEFAULTWORKITEMTYPE name="Shared Steps" />
   </CATEGORY>
   <CATEGORY refname="Microsoft.TestCaseCategory" name="Test Case Category">
      <DEFAULTWORKITEMTYPE name="Test Case" />
   </CATEGORY>
</cat:CATEGORIES>

요소 정보

Namespace

https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories

스키마 이름

범주

유효성 검사 파일

Categories.xsd

요소 형식

CATEGORIES, CATEGORY, DEFAULTWORKITEMTYPE, WORKITEMTYPE

비워 둘 수 있음

범주 스키마 정의

다음 코드는 범주 작업 항목 추적 개체에 대한 스키마 정의를 나열합니다.

<?xml version="1.0" encoding="utf-8" ?> 
<xs:schema targetNamespace="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories"
  elementFormDefault="unqualified"
  attributeFormDefault="unqualified"
  xmlns="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories"
  xmlns:xs="http://www.w3.org/2001/XMLSchema"
  xmlns:typelib="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typelib">  
  <xs:import namespace="https://schemas.microsoft.com/VisualStudio/2009/workitemtracking/typelib"/> 
  <xs:element name="CATEGORIES">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="CATEGORY" minOccurs="0" maxOccurs="unbounded">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="DEFAULTWORKITEMTYPE" type="WorkItemTypeRef" />
              <xs:element name="WORKITEMTYPE" type="WorkItemTypeRef" minOccurs="0" maxOccurs="unbounded"/>
            </xs:sequence>
            <xs:attribute name="refname" type="typelib:ReferenceName" use="required"/>
            <xs:attribute name="name" type="typelib:FriendlyName" use="required"/>
          </xs:complexType>
          <xs:unique name="WorkItemTypeName">
            <xs:selector xpath="*"/>
            <xs:field xpath="@name"/>
          </xs:unique>
        </xs:element>
      </xs:sequence>
    </xs:complexType>
    <xs:unique name="CategoryRefName">
      <xs:selector xpath="CATEGORY"/>
      <xs:field xpath="@refname"/>
    </xs:unique>
    <xs:unique name="CategoryName">
      <xs:selector xpath="CATEGORY"/>
      <xs:field xpath="@name"/>
    </xs:unique>
  </xs:element>
  <xs:complexType name="WorkItemTypeRef">
    <xs:attribute name="name" type="typelib:NonEmptyPlainConstant" use="required"/>
  </xs:complexType>
</xs:schema>

참고 항목

작업

작업 항목 형식의 범주 만들기

기타 리소스

작업 항목 형식을 범주로 그룹화