Kategorie definicji schematu odwołania

Artykuł
03/26/2013

Możesz użyć CATEGORIES z elementu jednej lub wielu kategorii do grupowania typów elementów pracy.

Hierarchii schematów

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>

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty i elementy do pliku XML kategorie.

Elementy podrzędne i atrybuty

Element	Atrybut	Opis
CATEGORIES		Wymagany element w pliku XML kategorie. Elementu-kontenera dla określający jedną lub więcej CATEGORY elementów, które są zdefiniowane dla zespołu projektu.
CATEGORY		Wymagany CATEGORIES element podrzędny. Określa grupę o nazwie kategorii, która zawiera jeden domyślny DEFAULTWORKITEMTYPE element i zero lub więcej WORKITEMTYPE elementy.
	name	Wymagany CATEGORY atrybut. Typ atrybutu jest typelib:FriendlyName. Określa nazwę wyświetlaną tej kategorii.Musi być unikatowa w obrębie zespołu projektu i od 1 do 254 znaków.
	refname	Wymagany CATEGORY atrybut. Typ atrybutu jest typelib:ReferenceName. Aby uzyskać więcej informacji, zobacz Konwencje nazewnictwa dla elementu pracy śledzenia obiektów.
DEFAULTWORKITEMTYPE		Wymagany CATEGORY element. Określa typ pozycji roboczej zaznaczone jako należące do kategorii nazwanych i być używane jako domyślny typ kategorii.
	name	Wymagany DEFAULTWORKITEMTYPE atrybut. Typ atrybutu jest WorkItemTypeRef. Określa nazwę odniesienia typu elementu pracy ważne dla zespołu projektu, który będzie używany jako domyślny typ dla kategorii.
WORKITEMTYPE		Opcjonalny CATEGORY element. Określa typ pozycji roboczej do zaznaczone jako należące do kategorii nazwane.
	name	Wymagany WORKITEMTYPE atrybut. Typ atrybutu jest WorkItemTypeRef. Określa nazwę odwołanie typu elementu pracy prawidłowy dla projektu zespołu, który będzie należał do kategorii nazwanego.

Uwagi

CATEGORIESjest elementem schematu kategorii.

Kategoria jest zdefiniowana w CATEGORIES zestaw CATEGORY elementy, które są przechowywane i wykorzystywane przez zespołu projektu.Każdy CATEGORIES element musi mieć co najmniej jeden CATEGORY zdefiniowano elementu.

Kategoria nie może być pusta.Każdy CATEGORY element musi mieć co najmniej jeden DEFAULTWORKITEMTYPE lub WORKITEMTYPE zdefiniowano elementu.

Każda kategoria ma przyjazną nazwę i nazwę odniesienia, które muszą być unikatowe w obrębie zespołu projektu.Przyjazna nazwa każdej kategorii muszą spełniać następujące wymagania:

Nazw może zawierać do 254 znaków Unicode.
Nazwy nie może być pusta.
Nazwy nie mogą mieć spacji wiodących i końcowych.
Nazwy nie mogą zawierać odwróconej kreski ułamkowej (\).
Nazwy nie mogą zawierać dwóch następujących po sobie spacji.

Przyjazne nazwy kategorii nie są lokalizowane i nie mogą pozostawać w tokenie, natomiast nazwy dla typów elementów pracy są lokalizowane i mogą być wykonane w tokenie.

Aby konwencji nazewnictwa, zobacz Konwencje nazewnictwa dla elementu pracy śledzenia obiektów.

Przykład

W następującym przykładzie określono kategorie pliku XML, który można zaimportować do zespołu projektu.To definiuje cztery kategorie i przypisuje tylko domyślny element typu prac dla każdego.

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

Informacje o elementach

Przestrzeń nazw	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories
Nazwa schematu	Categories
Sprawdzanie poprawności pliku	Categories.xsd
Typ elementu	KATEGORIE, KATEGORII, DEFAULTWORKITEMTYPE, WORKITEMTYPE
Może być pusta.	Tak

Definicja schematu kategorii

Poniższy kod zawiera listę definicji schematu dla obiektu śledzenia elementu pracy kategorie:

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

Zobacz też

Inne zasoby

Definiowanie kategorii — Grupowanie typów elementów pracy

Udostępnij za pośrednictwem