Kategorien-XML-Elementreferenz
Verwenden Sie das CATEGORIES-Element, um die Arbeitsaufgabentypen (WITs) zu gruppieren. Verwenden von Kategorien für Arbeitsaufgabentypen enthält eine Beschreibung der einzelnen Standardkategorien, die von Visual Studio Online und Team Foundation Server (TFS) verwendet werden.
<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
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. Geben Sie einen Namen mit nicht mehr als 70 Unicode-Zeichen an, in dem alphanumerische Zeichen, Unterstriche und Bindestriche vorkommen. Der Feldverweisname muss mindestens einen Punkt (.) enthalten, am Anfang oder Ende eines Namens darf jedoch kein Punkt stehen. Ein Verweisname darf auch nicht mit einer Zahl oder einem Unterstrich beginnen, und er darf keine aufeinander folgenden Bindestriche (--) enthalten. Geben Sie keinen Namen an, der mit dem reservierten System überlappt. XXX und Microsoft. XXX-Namespaces. Siehe 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.
Agile-Tools, Kategorienanforderungen und Einschränkungen
Beachten Sie beim Zuweisen von Arbeitsaufgabentypen zu Kategorien folgende Hinweise:
Um das Backlog und die Task Boards zu verwenden, müssen Sie mindestens einen WIT der Anforderungskategorie und einen WIT der Aufgabenkategorie zuordnen.
Derselbe WIT kann nicht gleichzeitig der Anforderungskategorie und der Aufgabenkategorie zugewiesen werden.
Wenn Sie mehrere WITs in die Anforderungs- oder Aufgabenkategorie einbeziehen, wird der dem DEFAULTWORKITEMTYPE-Element zugewiesene Typ auf den Backlog- und Boardseiten von Agile als Standardtyp angezeigt.
Arbeitsaufgabentypen, die zu einer Kategorie gehören, die einen Backlog in der ProcessConfiguration-Datei definiert, müssen einen Start-, End- und mindestens einen Zwischenworkflowstatus mit mindestens einem gültigen Metazustand aufweisen, wie in Prozesskonfigurations-XML-Elementreferenz beschrieben.
Arbeitsaufgabentypen, die Sie der Fehlerkategorie zuweisen, können so konfiguriert werden, das sie bei Rückständen und Boards für jedes Team angezeigt werden. Legen Sie das Standardverhalten fest, indem Sie die Eigenschaft für BugsBehavior in der Datei „ProcessConfiguration“ festlegen.
Beispiel
Im folgenden Beispiel ist die XML-Datei mit Standardkategorien für die Scrum-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="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>