Kategorien-XML-Elementreferenz

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

<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

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

Bei CATEGORIES handelt es sich um 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-Element oder WORKITEMTYPE-Element verfügen.

Jede Kategorie hat einen Anzeigenamen und einen Verweisnamen, der innerhalb des Teamprojekts jeweils eindeutig sein muss. Jeder Anzeigename einer Kategorie 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.

Im Gegensatz zu den Namen von Arbeitsaufgabentypen werden Anzeigenamen von Kategorien nicht lokalisiert und können nicht in ein Token umgewandelt werden.

Weitere Informationen zu Verweisbenennungskonventionen finden Sie unter Benennungskonventionen für Arbeitsaufgabenverfolgungs-Objekte.

Agile-Tools, Kategorienanforderungen und Einschränkungen

Sie können angeben, welche Arbeitsaufgabentypen als Backlogelemente oder Aufgabenelemente betrachtet werden. Beispielsweise werden in der Scrum-Prozessvorlage der Fehlertyp und Product Backlog Item-Typ der Anforderungskategorie zugewiesen, während von der Agile-Vorlage die User Story und von der CMMI-Vorlage die Anforderung zugewiesen wird. Von allen Standardprozessvorlagen wird der Aufgabentyp einer Arbeitsaufgabe der Aufgabenkategorie zugewiesen.

Beachten Sie beim Zuweisen von Arbeitsaufgabentypen zu Kategorien folgende Hinweise:

  • Um das Backlog und das Task Board zu verwenden, müssen Sie der Anforderungskategorie und der Aufgabenkategorie jeweils mindestens einen Arbeitsaufgabentyp zuweisen.

  • Derselbe Arbeitsaufgabentyp kann nicht gleichzeitig der Anforderungskategorie und der Aufgabenkategorie zugewiesen werden.

  • Wenn Sie mehrere Arbeitsaufgabentypen in die Anforderungs- oder Aufgabenkategorie einbeziehen, wird der dem DEFAULTWORKITEMTYPE-Element zugewiesene Typ auf den Backlog- und Boardseiten von Agile als Standardtyp angezeigt.

  • Für alle Arbeitsaufgabentypen, denen Sie eine Kategorie zuweisen, auf die in der Datei "ProcessConfiguration" verwiesen wird, müssen Sie die Workflowzustände einem gültigen Metazustand zuweisen, wie unter Verweis der Prozesskonfigurations-XML-Elemente beschrieben. Auf die in der Datei "ProcessConfiguration" definierten Zuweisungen von Kategorien und Metazuständen wird von mehreren Team Foundation-Clients verwiesen.

Beispiel

Im folgenden Beispiel wird die standardmäßige XML-Datei mit Kategorien für die Visual Studio Scrum 2013.3-Prozessvorlage aufgelistet.

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

Elementinformationen

Namespace

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

Schemaname

Kategorien

Validierungsdatei

Categories.xsd

Elementtyp

CATEGORIES, CATEGORY, DEFAULTWORKITEMTYPE, WORKITEMTYPE

Kann leer sein

Ja

Siehe auch

Weitere Ressourcen

Verwenden von Kategorien für Arbeitsaufgabentypen