مرجع مخطط تعريف الفئات

يمكنك استخدام عنصرCATEGORIES لتعريف فئة واحدة أو أكثر لتجميع أنواع عناصر العمل.

هيكل المخطط

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>

السمات والعناصر

تصف المقاطع التالية السمات والعناصر فى ملف الXML للفئات.

العناصر التابعة والسمات

العنصر	السمة	الوصف
CATEGORIES		عنصر مطلوب داخل ملف XML للفئات. عنصر حاوى لتحديد أحد عناصر CATEGORY أو أكثر المعرّفة فى مشروع الفريق.
CATEGORY		عنصر تابع CATEGORIES مطلوب. تحديد مجموعة فئاة مسماة تحتوي على عنصر DEFAULTWORKITEMTYPE واحد افتراضي وعلى أى عدد -أو صفر- من عناصر WORKITEMTYPE.
	name	سمة CATEGORY مطلوبة. نوع السمة هو typelib:FriendlyName. تعيين اسم العرض للفئة. يجب أن تكون بين 1 إلى 254 حرفاً وأن يكون فريداً داخل مشروع الفريق.
	refname	سمة CATEGORY مطلوبة. نوع السمة هو typelib:ReferenceName. لمزيد من المعلومات، راجع اصطلاحات التسمية لكائنات متابعة عناصر العمل.
DEFAULTWORKITEMTYPE		عنصر CATEGORYالمطلوب. تحديد نوع عنصر عمل للإشارة إلى أنه ينتمي إلى الفئة المسماة وليتم استخدامه كنوع افتراضي الفئة.
	name	سمة DEFAULTWORKITEMTYPE مطلوبة. نوع السمة هو WorkItemTypeRef. تعيّن اسم المرجع لنوع عنصر عمل صالح لمشروع الفريق ليتم استخدامه كنوع افتراضي لفئة.
WORKITEMTYPE		العنصر CATEGORYالإختيارى. تحديد نوع عنصر عمل للإشارة إلى أنه ينتمى إلى الفئة المسماة.
	name	سمة WORKITEMTYPE مطلوبة. نوع السمة هو WorkItemTypeRef. تعيّن اسم المرجع لنوع عنصر عمل صالح لمشروع الفريق الذي سينتمي إلى الفئة المسماة.

ملاحظات

CATEGORIES هو العنصر الجذرى فى مخطط الفئات.

يتم تعريف الفئة ضمن CATEGORIES مجموعة من عناصر CATEGORY التي يتم تخزينها واستخدامها من قبل مشروع الفريق. يجب أن يحتوى كل عنصر CATEGORIES على الأقل على تعريف عنصر CATEGORY واحد.

الفئة لا يمكن أن تكون فارغة. يجب أن يحتوى كل عنصر CATEGORY على الأقل على تعريف عنصر DEFAULTWORKITEMTYPE أو WORKITEMTYPE واحد.

تحتوي كل فئة على اسم مألوف و اسم المرجع الذى يجب أن يكون فريداً ضمن مشروع الفريق. كل اسم مألوف يجب أن يفي بالمتطلبات التالية:

• يمكن أن يكون عدد حروف الاسم 254 أحرف Unicode كحد أقصى.

• يجب أن لا تكون الأسماء فارغة.

• لا يمكن أن تحتوي أسماء على مسافات فى البداية أو النهاية.

• لا يمكن أن تحتوي الأسماء على أحرف خط مائل عكسي (\).

• لا يمكن أن تحتوي الأسماء على مسافات بيضاء متتالية.

لا يتم ترجمة الأسماء المألوفة للغة المحلية و يتعذر وضعها في رمز مميز، بينما يمكن ترجمة أسماء أنواع عناصر العمل للغة المحلية و يمكن وضعها فى رمز مميز.

لأصطلاحات تسمية المرجع، راجع اصطلاحات التسمية لكائنات متابعة عناصر العمل.

مثال

يوضح المثال التالي ملف XML للفئات، الذى يمكن أن يتم استيراده فى مشروع الفريق. يعرّف أربعة فئات ويقوم بتعيين عنصر عمل افتراضى وحيد لكل فئة.

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

معلومات العناصر

مساحة الاسم	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories
اسم المخطط	فئات
ملف الـتحقق من الصحة	Categories.xsd
نوع العنصر	CATEGORIES, CATEGORY, DEFAULTWORKITEMTYPE, WORKITEMTYPE
يمكن أن يكون فارغاً	نعم

تعريف مخطط الفئة

تسرد التعليمات البرمجية التالية تعريف المخطط لكائن تعقب عنصر عمل الفئات:

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

راجع أيضًا:

المهام

إنشاء فئة لأنواع عناصر العمل

موارد أخرى

تجميع أنواع عناصر عمل في فئات