Kategori Tanım Şema Başvurusu

Makale
03/26/2013

Çalışma öğesi türlerini gruplama için bir ya da daha fazla kategori tanımlamak amacıyla CATEGORIES öğesini kullanabilirsiniz.

Şema Hiyerarşisi

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>

Öznitelikler ve Öğeler

XML dosyası kategorileri için öznitelikler ve öğeler aşağıdaki bölümlerde açıklanmaktadır.

Alt Öğeler ve Öznitelikler

Öge	Öznitelik	Tanımlama
CATEGORIES		XML kategorileri dosyası içindeki gerekli öğe. Takım projesi için tanımlanan bir veya daha fazla CATEGORY öğelerini belirtmek için kapsayıcı öğe.
CATEGORY		Gerekli CATEGORIES alt öğesi. Bir varsayılan DEFAULTWORKITEMTYPE öğesi ve sıfır ya da daha fazla WORKITEMTYPE öğesini içeren bir adlandırılmış kategori grubu belirtir.
	name	Gerekli CATEGORY özniteliği. Öznitelik türü typelib:FriendlyName'dir. Kategori görüntü adını belirtir. 1 ile 254 karakter arasında olmalı ve takım projesi içinde benzersiz olmalıdır.
	refname	Gerekli CATEGORY özniteliği. Öznitelik türü typelib:ReferenceName'dir. Daha fazla bilgi için bkz. İş Öğesi İzleme Nesneleri için Adlandırma Kuralları.
DEFAULTWORKITEMTYPE		Gerekli CATEGORY öğesi. Adlandırılmış kategoriye ait olarak etiketlemek ve kategori için varsayılan tür olarak kullanmak amacıyla çalışma öğesi türünü belirtir.
	name	Gerekli DEFAULTWORKITEMTYPE özniteliği. Öznitelik türü WorkItemTypeRef'dir. Kategori için varsayılan tür olarak kullanılacak takım projesine ilişkin geçerli bir çalışma öğesi türü başvuru adını belirtir.
WORKITEMTYPE		İsteğe bağlı CATEGORY öğesi. Çalışma öğesi türünü, adlandırılmış kategoriye ait olarak etiketlemek için belirtir.
	name	Gerekli WORKITEMTYPE özniteliği. Öznitelik türü WorkItemTypeRef'dir. Adlandırılmış kategoriye ait olacak takım projesi için geçerli bir çalışma öğesi türü başvuru adını belirtir.

Notlar

CATEGORIES kategoriler şemasının kök öğesidir.

Kategori, takım projesi tarafından saklanan ve kullanılan CATEGORY öğeleri CATEGORIES kümesi içinde tanımlanır. Her CATEGORIES öğesinin tanımlanmış en az bir CATEGORY öğesi olması gerekir.

Kategori boş olamaz. Her CATEGORY öğesinin tanımlanmış en az bir DEFAULTWORKITEMTYPE veya WORKITEMTYPE öğesi olması gerekir.

Her kategorinin, takım projesi içinde benzersiz olması gereken bir kolay adı ve başvuru adı vardır. Her kategori kolay adı, aşağıdaki gereksinimleri karşılamalıdır:

Adlar, en fazla 254 Unicode karakterden oluşabilir.
Adlar boş olmamalıdır.
Adlar başında ve sonunda boşluğa sahip olamaz.
Adlar ters eğik çizgi (\) karakterlerini içeremez.
Adlar iki ardışık boşluk içeremez.

Çalışma öğesi türleri için adlar yerelleştirilir ve belirtece dönüştürülebilirken, kategori kolay adları yerelleştirilemez ve belirtece dönüştürülemez.

Başvuru adlandırma kuralları için, bkz. İş Öğesi İzleme Nesneleri için Adlandırma Kuralları.

Örnek

Aşağıdaki örnek, takım projesine içeri aktarılabilen XML dosyası kategorilerini belirtir. Dört kategori tanımlar ve her biri için sadece varsayılan çalışma öğesi türüne atar.

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

Öğe Bilgisi

Ad uzayı	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories
Şema Adı	Kategoriler
Dosya Doğrulama	Categories.xsd
Öğe türü	CATEGORIES, CATEGORY, DEFAULTWORKITEMTYPE, WORKITEMTYPE
Boş olabilir	Evet

Kategori Şema Tanımı

Aşağıdaki kod, kategoriler çalışma öğesi izleme nesnesi için şema tanımı listeler.

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

Ayrıca bkz.

Diğer Kaynaklar

Grup Çalışma Öğesi Türlerini Gruplamak için Kategoriler Tanımlama

Aracılığıyla paylaş