Sdílet prostřednictvím


Categories XML element reference

Můžete použít CATEGORIES elementu, který chcete skupina pracovních položek typů (WITs). Pomocí kategorií, které mají typy položek pracovní skupina obsahuje popis jednotlivých výchozích kategorií, které používají Visual Studio Online a Team Foundation Server (TFS).

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

Atributy a prvky

Element

Atribut

Popis

CATEGORIES

Požadovaný element v rámci kategorií souboru XML.

Element kontejneru pro zadání jednoho nebo více CATEGORY elementy, které jsou definovány pro týmový projekt.

CATEGORY

Požadované CATEGORIES podřízený element.

Určuje skupinu pojmenovanou kategorii, která obsahuje jeden výchozí DEFAULTWORKITEMTYPE element a nula nebo více WORKITEMTYPE elementy.

name

Požadované CATEGORY atributu.

Typ atributu je typelib:FriendlyName.

Určuje zobrazovaný název kategorie. Musí být mezi 1 až 254 znaky a jedinečné v rámci týmového projektu.

refname

Požadované CATEGORY atributu.

Typ atributu je typelib:ReferenceName.

Zadejte název již než 70 znaky znakové sady Unicode, které používá alfanumerické znaky, podtržítka a znaky pomlčka. Název odkazu musí obsahovat alespoň jeden tečky (.), ale na začátku nebo na konci názvu nesmí objevit žádné období. Také název odkazu nelze spustit s číslem nebo podtržítkem a nemůže mít více po sobě jdoucích pomlčky, jako je například (-).

Nezadávejte název, který se překrývá s vyhrazené systémem. XXX a společnosti Microsoft. XXX obory názvů. Podívejte se na téma Vytváření názvů pro objekty sledování pracovní položky.

DEFAULTWORKITEMTYPE

Požadované CATEGORY elementu.

Určuje typ pracovní položky, chcete-li být označeným jako patřící do pojmenované kategorie a který se má použít jako výchozí typ pro kategorii.

name

Požadované DEFAULTWORKITEMTYPE atributu.

Typ atributu je WorkItemTypeRef.

Určuje název odkazu typu platný pracovní položky pro týmový projekt, který bude použit jako výchozí typ pro kategorii.

WORKITEMTYPE

Volitelný CATEGORY elementu.

Určuje typ pracovní položky, které chcete-li být označeným jako patřící do pojmenované kategorie.

name

Požadované WORKITEMTYPE atributu.

Typ atributu je WorkItemTypeRef.

Určuje název odkazu typu platný pracovní položky pro týmový projekt, který bude patřit do pojmenovanou kategorii.

Poznámky

CATEGORIES není kořenovým elementem schématu kategorií.

Kategorie je definována v rámci CATEGORIES Sada CATEGORY prvky, které jsou uloženy a používány podle týmový projekt. Každý CATEGORIES element musí obsahovat alespoň jeden CATEGORY element definovaný.

Kategorie nesmí být prázdný. Každý CATEGORY element musí obsahovat alespoň jeden DEFAULTWORKITEMTYPE nebo WORKITEMTYPE element definovaný.

Každá kategorie obsahuje popisný název a název odkazu, který musí být jedinečné v rámci týmového projektu. Popisný název každé kategorie musí splňovat následující požadavky:

  • Názvy mohou mít maximálně 254 znaky znakové sady Unicode.

  • Názvy nesmí být prázdný.

  • Názvy nemohou mít počáteční nebo koncové mezery.

  • Názvy nesmí obsahovat znaky lomítkem (\\).

  • Názvy nesmí obsahovat dvě po sobě jdoucí prázdné znaky.

Kategorie popisné názvy nejsou lokalizována a nelze ho do tokenu, že byly lokalizovány názvy pro typy pracovních položek a mohou být provedeny do tokenu.

Agilní nástroje, kategorie požadavky a omezení

Při přiřazování WITs do kategorií, zvažte následující provozní poznámky:

Příklad

Následující příklad uvádí výchozí soubor XML kategorií pro šablonu procesu Scrum.

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

Viz také

Další zdroje

Use categories to group work item types