Kategorien-Definitionsschemareferenz

Artikel
03/26/2013

Sie definieren mindestens eine Kategorie zum Gruppieren von Arbeitsaufgabentypen mithilfe des CATEGORIES-Elements.

Schemahierarchie

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>

Attribute und Elemente

In den folgenden Abschnitten werden die Attribute und Elemente für die Kategorien-XML-Datei beschrieben.

Untergeordnete Elemente und Attribute

Element	Attribut	Beschreibung
CATEGORIES		Erforderliches Element innerhalb der XML-Kategorien-Datei. Containerelement zum Angeben von einem oder mehreren CATEGORY-Elementen, die für ein Teamprojekt definiert werden.
CATEGORY		Erforderliches CATEGORIES-Element. Gibt eine benannte Kategoriegruppe an, die ein standardmäßiges DEFAULTWORKITEMTYPE-Element und null oder mehr WORKITEMTYPE-Elemente enthält.
	name	Erforderliches CATEGORY-Attribut. Der Attributtyp ist typelib:FriendlyName. Gibt den Anzeigenamen der Kategorie an.Muss zwischen 1 und 254 Zeichen lang sein und innerhalb des Teamprojekts eindeutig sein.
	refname	Erforderliches CATEGORY-Attribut. Der Attributtyp ist typelib:ReferenceName. Weitere Informationen finden Sie unter Benennungskonventionen für Arbeitsaufgabenverfolgungs-Objekte.
DEFAULTWORKITEMTYPE		Erforderliches CATEGORY-Element. Gibt einen Arbeitsaufgabentyp an, der als zur benannten Kategorie gehörend markiert und als Standardtyp für die Kategorie verwendet werden soll.
	name	Erforderliches DEFAULTWORKITEMTYPE-Attribut. Der Attributtyp ist WorkItemTypeRef. Gibt den Verweisnamen eines gültigen Arbeitsaufgabentyps für das Teamprojekt an, der als Standardtyp für die Kategorie verwendet wird.
WORKITEMTYPE		Optionales CATEGORY-Element. Gibt einen Arbeitsaufgabentyp an, der als zur benannten Kategorie gehörend markiert werden soll.
	name	Erforderliches WORKITEMTYPE-Attribut. Der Attributtyp ist WorkItemTypeRef. Gibt den Verweisnamen eines gültigen Arbeitsaufgabentyps für das Teamprojekt an, der zur benannten Kategorie gehört.

Hinweise

CATEGORIES ist das Stammelement des Kategorienschemas.

Eine Kategorie wird innerhalb des CATEGORIES-Satzes von CATEGORY-Elementen definiert, der gespeichert und von einem Teamprojekt verwendet wird.Jedes CATEGORIES-Element muss über mindestens ein definiertes CATEGORY-Element verfügen.

Eine Kategorie kann nicht leer sein.Jedes CATEGORY-Element muss über mindestens ein definiertes DEFAULTWORKITEMTYPE- oder WORKITEMTYPE-Element verfügen.

Jede Kategorie hat einen Anzeigenamen und einen Verweisnamen, der innerhalb des Teamprojekts jeweils eindeutig sein muss.Jeder Kategorieanzeigename muss die folgenden Anforderungen erfüllen:

Namen dürfen maximal 254 Unicode-Zeichen umfassen.
Namen dürfen nicht leer sein.
Namen dürfen keine vorangestellten oder nachgestellten Leerzeichen enthalten.
Namen dürfen keine umgekehrten Schrägstriche (\) enthalten.
Namen dürfen nicht zwei aufeinanderfolgende Leerstellen enthalten.

Kategorieanzeigenamen werden nicht lokalisiert und können nicht in ein Token umgewandelt werden, wohingegen die Namen für Arbeitsaufgabentypen lokalisiert und in ein Token umgewandelt werden.

Verweisnamenkonventionen entnehmen Sie Benennungskonventionen für Arbeitsaufgabenverfolgungs-Objekte.

Beispiel

Im folgenden Beispiel wird eine Kategorien-XML-Datei angegeben, die in ein Teamprojekt importiert werden kann.Es definiert vier Kategorien und weist nur einen Standardarbeitsaufgabentyp für jede zu.

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

Elementinformationen

Namespace	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories
Schemaname	Kategorien
Validierungsdatei	Categories.xsd
Elementtyp	CATEGORIES, CATEGORY, DEFAULTWORKITEMTYPE, WORKITEMTYPE
Kann leer sein	Ja

Kategorieschemadefinition

Im folgenden Code wird die Schemadefinition für das Arbeitsaufgabenverfolgungs-Objekt der Kategorien aufgeführt.

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

Siehe auch

Weitere Ressourcen

Definieren von Kategorien für Arbeitsaufgabentypen

Freigeben über