عنصر الحقل (عنصر نوع عنصر العمل)

يعرّف حقل عنصر العمل و يحدد القواعد و الشروط لتطبيقها عليه.

هيكل المخطط

عنصر WITD (مخطط تعريف نوع عنصر العمل)

    عنصر WORKITEMTYPE (مخطط تعريف نوع عنصر العمل)

        عنصر حقول (عنصر WORKITEMTYPE)

            عنصر الحقل (عنصر نوع عنصر العمل)

<xs:element name="FIELD" type="FieldDefinition" maxOccurs="unbounded"/>

<FIELD name="field display name" refname="field reference name" type="String |
Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID" 
syncnamechanges ="true | false" reportable="Dimension | Detail | Measure" formula="sum" >
   <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
   <ALLOWEXISTINGVALUE />
   <CANNOTLOSEVALUE />
   <COPY />
   <DEFAULT />
   <EMPTY />
   <FROZEN />
   <HELPTEXT> . . . </HELPTEXT>
   <MATCH />
   <NOTSAMEAS />
   <PROHIBITEDVALUES /> . . . </PROHIBITEDVALUES>
   <READONLY />
   <REQUIRED />
   <SERVERDEFAULT />
   <SUGGESTEDVALUES /> . . . </SUGGESTEDVALUES>
   <VALIDUSER />
   <WHEN>> . . . </WHEN>
   <WHENNOT> . . . </WHENNOT>
   <WHENCHANGED> . . . </WHENCHANGED>
   <WHENNOTCHANGED> . . . </WHENNOTCHANGED>
</FIELD>

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

تصف المقاطع التالية سمات، عناصر تابعة وعناصر الأصل.

السمات

السمة	الوصف
name	سمة FieldDefinition مطلوبة. اسم الحقل المعروض حيث يتم تطبيق قواعد والشروط. نوع السمة هو typelib:FieldName. الحد الأدنى للطول: 1; أقصى طول: 128. نموذج القيمة: ^[^\. \[\]]+$ مثال نموذج القيمة: معين إلى
refname	سمة FieldDefinition مطلوبة. اسم الحقل المعروض حيث يتم تطبيق القواعد والشروط. اسم المرجع يجب أن يتطابق مع اسم المرجع المعرف في عنصر تعريف الحقل FIELD. اسم الحقل المعروض حيث يتم تطبيق القواعد و الشروط. اسم المرجع يجب أن يطابق اسم المرجع المعرفة في تعريف الحقل العنصر. نوع السمة هو typelib:ReferenceFieldName. الحد الأدنى للطول: 1; أقصى طول: 70. نموذج القيمة: ^ [a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+) + $ مثال نموذج القيمة: Company.Division.IssueType
type	سمة FieldDefinition مطلوبة. تحديد نوع البيانات التى يقبلها الحقل. يتم سرد القيم الصالحة كما يلي: Value الاستخدام DateTime تحديد التاريخ وفقاً للتوقيت العالمي المتنفق عليه(UTC) الحالى. Double تحديد قيمة فاصلة عائمة. GUID تحديد الحقل الذي يحتوي على معرف فريد. History يعتمد مؤشرات ترابط المناقشات و يحتفظ بمعلومات عن المعلومات الأخرى التاريخية. ملاحظة System.History الحقل هو الحقل الوحيد الذي يستخدم نوع البيانات.لا يمكن تعريف حقل مخصص باستخدام نوع البيانات. HTML يعتمد التقاط النص المنسق مع الإستخدام من أجل أوصاف نصية أطول مثل وصف عنصر عمل. Integer تعيّن قيمة 32-بت لعدد صحيح ذو إشارة. PlainText يعتمد إدخال سلسلة النص التي يمكن أن تحتوي على أكثر من 255 حرف Unicode. String يدعم إدخال سلسلة النص التي يمكن أن تحتوي على أكثر من 255 حرف Unicode.استخدم سلسة الحقل للتسمية أو سلسلة النص القصير حتى سطر واحد طويل. TreePath تعيين الحقل الذى يعرض الإدخالات في تنظيم هرمي أو بنية شجرة مثل ما هو مطلوب لعرض المسارات ناحية و التكرار للمنتج. ملاحظة System.AreaPath و System.IterationPath الحقول هى الحقول فقط التي تستخدم نوع البيانات.لا يمكن تعريف حقل مخصص باستخدام نوع البيانات.
syncnamechanges	سمة FieldDefinition اختيارية. تحديد ما إذا كان يتم استخدام حقل عنصر العمل لتخزين الأسماء التي ترغب في تحديث كما يتم إجراء تغييرات فيActive Directory أوWorkgroup. هذا الخيار صالحاً فقط عند type="String". نوع السمة هو xs:boolean. حدد true لتمكين المزامنة لحقل البيانات ، حدد false لتعطيل المزامنة لحقل البيانات.
reportable	سمة FieldDefinition اختيارية. تحديد ما إذا كان سيتم تصدير البيانات من حقل البيانات المخزونة و يمكن تضمينها في التقارير. يتم سرد القيم الصالحة كما يلي: Value الاستخدام Dimension يمكن تحديد الحقول من نوع DateTime Double, Integer,او String. يتم أدخال البيانات في هذا الحقل فى قاعدة بيانات المستودع العلائقية والمكعب مثل سمة من أبعاد عنصر العمل بحيث يمكن استخدام البيانات لتصفية التقارير.استخدم هذا النوع للحقول التي تحتوي على قوائم القيم الصالحة.بعض الأمثلة الجيدة للأبعاد هى نوع عنصر العمل و حالته. Detail يمكن تحديد الحقول من نوع DateTime Double, Integer,او String. يتم نقل البيانات الموجودة في هذا الحقل إلى قاعدة بيانات المستودع العلائقية في محفوظات عنصر العمل و جداول عنصر العمل ، لكن ليس في المكعب.هذا النوع خيار جيد على حقول نص غير مقيد لأنه يتيح لك باستخدامها في تقارير ولكن كان تجنب المكعب بشكل ملحوظ تكبير. Measure استخدام نوع المقياس فقط لحقول Integer او Double .القياسات هى القيم الرقمية في التقارير الخاصه بك.يظهر كل قياس في كل من مجموعة قياس عنصر العمل الحالى ومجموعة قياس محفوظات عنصر العمل.يكون العمل المقدر مثال جيد مقياس.عند تحديد قياس يجب عليك تحديد formula السمة.
formula	سمة FieldDefinition اختيارية. التجميع نوع لـ measure النوع المقرر. القيمة الصالحة الوحيدة هي sum ، والذي إرجاع مجموع القيم عبر المجموعة.

العناصر التابعة

العنصر	الوصف
عنصر ALLOWEDVALUES (مخطط تعريف نوع عنصر العمل)	عنصر اختياري. يعرّف قائمة القيم المسموح بها للحقل. القيم المسموح بها هى القيم المتوفرة للتحديد في قائمة الحقول على نماذج عنصر العمل في منشئ الاستعلام. يجب تحديد إحدى هذه القيم.
عنصر السماح بقيمة موجودة (مخطط تعريف نوع عنصر عمل)	عنصر اختياري. يعرّف الحقل للسماح بالقيم الموجودة. يسمح هذا العنصر لقيم الحقول الموجودة بالفعل ان يمكن استخدامها ، حتى إذا لم تكن صالحة. يجب أن تكون كافة القيم الجديدة للحقل صحيحة.
عنصر CANNOTLOSEVALUE (مخطط تعريف نوع عنصر العمل)	عنصر اختياري. يعرّف الحقل كما لا تفقد قيمتة. يحتفظ هذا العنصر قيمة الحقل الجارية وهو لا يمكن مسح أو إجراء فارغة.
عنصر COPY (مخطط تعريف نوع عنصر العمل)	عنصر اختياري. تحديد حقل آخر يحتوي على قيمة المراد نسخها إلى الحقل الجارى.
العنصر الافتراضى (مخطط تعريف نوع عنصر العمل)	عنصر اختياري. تعريف قيمة إفتراضية للحقل.
عنصر EMPTY (مخطط تعريف لنوع عنصر العمل)	عنصر اختياري. يعرّف حقل كحقل فارغ.
عنصرتجميد (مخطط تعريف نوع عنصر العمل)	عنصر اختياري. تعرّف الحقل كمجمد. لا يمكن تغيير حقل مجمد إلى أي قيمة غير فارغة بعد تنفيذ التغييرات. ومع ذلك، يمكنك إلغاء الحقل يدوياً و حفظ عنصر العمل ثم حدد قيمة مختلفة.
عنصر نص التعليمات (مخطط تعريف نوع عنصر عمل)	عنصر اختياري. يحدد النص الذي سيتم عرضه في تلميح الأدوات للحقل.
عنصر MATCH (مخطط تعريف نوع عنصر العمل)	عنصر اختياري. تحدد نموذج للحقل الذي يجب أن تتطابق قيمة الحقل معه.
عنصر NOTSAMEAS (مخطط تعريف نوع عنصر العمل)	عنصر اختياري. تحديد حقل آخر لا يمكن أن تكون القيمة التي تطابق قيمة الحقل الجارى .
عنصر PROHIBITEDVALUES (تعريف مخطط نوع عنصر العمل)	عنصر اختياري. يعرّف قائمة بالقيم الممنوعة للحقل.
عنصر READONLY (مخطط تعريف لنوع صنف عمل)	عنصر اختياري. عرّف الحقل للقراءة فقط.
عنصر REQUIRED (مخطط تعريف نوع عنصر عمل)	عنصر اختياري. عرّف الحقل كما هو مطلوب.
عنصر SERVERDEFAULT (مخطط تعريف نوع عنصر العمل)	عنصر اختياري. تعيّن مكون الخادم الذى يوفر يوفر القيم للحقل.
عنصر SUGGESTEDVALUES (مخطط تعريف نوع عنصر العمل)	عنصر اختياري. يعرّف قائمة القيم المقترحة للحقل. القيم المسموح بها هى القيم المتوفرة للتحديد في قائمة الحقول على نماذج عنصر العمل و في منشئ الاستعلام. يمكنك إدخال قيم أخرى بالإضافة إلى تلك التى في القائمة.
عنصر VALIDUSER (مخطط تعريف نوع عنصر العمل)	عنصر اختياري. تعيّن أنه يجب أن تتكون قائمة القيم المسموح بها فقط من المستخدمين الصالحين للنظام.
عنصر "عند" (مخطط تعريف نوع صنف عمل)	عنصر اختياري. تحدد قاعدة أو أكثر لتطبيقها على الحقل الحالى عندما يكون لحقل آخر قيمة محددة.
عنصر CANNOTLOSEVALUE (مخطط تعريف نوع عنصر العمل)	عنصر اختياري. يطبق قاعدة أو أكثر إلى الحقل الحالى عند تغيير قيمة حقل معين.
عنصر WHENNOT (مخطط تعريف نوع صنف عمل)	عنصر اختياري. يطبق قاعدة أو أكثر إلى الحقل الحالي عندما لا يحتوي حقل آخر علي قيمة محددة.
عنصر CANNOTLOSEVALUE (مخطط تعريف نوع عنصر العمل)	عنصر اختياري. يطبق قاعدة أو أكثر إلى الحقل الحالى عند عدم تغيير قيمة حقل معينة.

العناصر الأصلية

العنصر	الوصف
عنصر حقول (عنصر WORKITEMTYPE)	العنصر المطلوب. يحتوي على تعريف حقل نوع عنصر العمل .

ملاحظات

FIELD هو عنصر مطلوب تابع لـ FIELDS.

"minOccurs = "1(الحد الأدنى للحدوث)

"maxOccurs = "unbounded(الحد الأقصى للحدوث)= غير محدد

متطلبات إضافية و قيود على الأسماء المألوفة وأسماء مرجع راجع اصطلاحات التسمية لـ كائنات تعقب عنصر عمل.

لا يمكن تعريف حقل مخصص الذي يبدأ ب System. بادئة. يمكنك تعريف الحقل باستخدام Microsoft. بادئة ، على الرغم من ذلك، هذا التمرين يوصي بشدة لأنه قد يتضمن Team Foundation Server وظيفة.

للحصول على نظرة عامة حول عنصر العمل فى الحقل تعقب الكائن، راجع استخدام الحقول عنصر العمل.

للحصول على نظرة عامة حول النظام وكافة الحقول المعرفة مسبقاً التي تم تعريفها لـ Framework حلول Microsoft (MSF) لقالب عملية تطوير البرامج Agile v5.0 ' ، راجع باستخدام نظام الحقول و الحقول المعرفة من قبل قوالب معالجة MSF.

لا يمكن إعادة تسمية أسماء الحقول المرجعية. يمكن سرد الحقول و إعادة تسميها باسم مألوف و تغيير سمات الحقل باستخدام witadmin أداة سطر الأوامر. لمزيد من المعلومات، راجع إدارة العمل العنصر حقول [witadmin].

مثال

<FIELD name="Activity" refname="Microsoft.VSTS.Common.Activity" type="String" reportable="dimension">
   <HELPTEXT>Type of work involved</HELPTEXT>
   <SUGGESTEDVALUES>
      <LISTITEM value="Development"/>
      <LISTITEM value="Testing"/>
      <LISTITEM value="Requirements"/>
      <LISTITEM value="Design"/>
      <LISTITEM value="Deployment"/>
      <LISTITEM value="Documentation"/>
   </SUGGESTEDVALUES>
</FIELD>

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

مساحة الاسم	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef
اسم المخطط	تعريف نوع عنصر العمل
ملف الـتحقق من الصحة	WorkItemTypeDefinition.xsd
نوع العنصر	النوع المركب FieldDefinition (عنصر WORKITEMTYPE)
يمكن أن يكون فارغاً	نعم

راجع أيضًا:

المرجع

إدارة العمل العنصر حقول [witadmin]

المبادئ

اصطلاحات التسمية لـ كائنات تعقب عنصر عمل

باستخدام نظام الحقول و الحقول المعرفة من قبل قوالب معالجة MSF

تخصيص Project تعقب البيانات نماذج سير العمل وكائنات أخرى

استخدام الحقول عنصر العمل

موارد أخرى

العناصر (مخطط تعريف نوع عنصر العمل)