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

يمكنك استخدام حقول عنصر العمل لتعقب بيانات نوع عنصر العمل ولتعريف معيار عامل تصفية للاستعلامات وأيضاً لإنشاء التقارير. أي عنصر بيانات، فيما عدا حقول بيانات النظام الأساسية، التي ترغب في تعقبها، أو استخدامها لتعريف سير العمل، أو لتظهر على نموذج لنوع عنصر عمل يجب أن يتم تعريفها كحقل عنصر عمل وتعريفها في ملف تعريف نوع عنصر العمل. يتم تعريف حقول النظام الأساسية تلقائياً لكل تعريف نوع عنصر عمل لمشروع فريق. للحصول على قائمة لتلك الحقول، راجع باستخدام حقول النظام و الحقول المعرفة من قبل قوالب المعالجة MSF.

تتم المحافظة على حقول عنصر عمل لمجموعة مشروع فريق. تتم إضافة كافة الحقول، عدا حقول النظام الأساسية، إلى مشروع الفريق عند وقوع أحد الأحداث التالية:

• قيامك بإنشاء مشروع فريق . يتم إنشاء كافة الحقول المعرفة داخل تعريفات نوع عنصر العمل المعرّفة لقالب العملية المحدد.

• استيراد تعريف نوع عنصر عمل جديد. كل الحقول الجديدة التي يتم تعريفها داخل تعريف نوع عنصر العمل يتم إضافتها إلى مجموعة فريق المشروع.

تشكل كافة الحقول المعرفة في كل أنواع عناصر العمل لكل مشاريع الفريق مجموعة كاملة من الحقول المعرفة لمجموعة المشروع. يمكنك تغيير سمات الحقول الموجودة، وإعادة تسميتها وحذفها.

لكل عنصر حقل يوجد أسم مألوف اختياري وإسم مرجعى مطلوب. يجب أن يكون الاسم المرجعى فريد داخل مجموعة المشروع. لمزيد من المعلومات، راجع اصطلاحات التسمية لكائنات متابعة عناصر العمل.

هام

يمكنك تغيير الاسم المألوف لحقل باستخدام أداة سطر الأوامرwitadmin changefield على الرغم من ذلك، إذا قمت بإعادة تسمية حقل، سوف يؤثر هذا على كافة عناصر العمل المعرفة في كافة مشاريع الفريق داخل مجموعة المشروع.

لإضافة، أو إزالة، أو تخصيص حقل لنوع عنصر عمل، يمكنك تعديل محتوى XML لتعريف نوع عنصر العمل. يتم تعريف كل حقل بواسطة عنصر FIELD داخل مقطع FIELDSفى تعريف نوع عنصر العمل. لمزيد من المعلومات حول بنية وموقع ملفات تعريف نوع عنصر العمل، راجعالتعامل مع أنواع عنصر العمل.

محتويات الموضوع

• بنية بناء الجملة

• أنواع بيانات الحقول

• استخدام الحقول فى عمل التقارير

• الحقول المفهرسة

• العناصر التابعة لحقل عنصر العمل

• حقول النظام و الحقول المعرفة مسبقاً

• مخطط تعريف حقل عنصر العمل

بنية بناء الجملة

يتم تعريف الحقل بواسطة بناء جملة XML التالي في ملف XML الخاص بتعريف نوع عنصر العمل.

<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="avg" >
   <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>

أنواع بيانات الحقول

يحدد نوع الحقل نوع وحجم البيانات التي يمكن تخزينها في الحقل. هناك نوع واحد فقط للحقل لكل Team Foundation Server. يشجع هذا التقييد المؤسسات على استخدام حقول مشتركة بين المشاريع و أنواع عناصر العمل.

تعرض القائمة التالية أنواع الحقول المدعمة:

نوع البيانات	الوصف
DateTime	تحديد التاريخ وفقاً للتوقيت العالمي المتنفق عليه(UTC) الحالى. يمكنك إضافة حقل DateTime لنموذج عنصر عمل إما باستخدام سمات FieldControlأو DateTimeControl type.
Double	تحديد قيمة فاصلة عائمة. الحقول المزدوجة تستخدم بشكل متكرر في عوامل تصفية الاستعلام و وقوائم النتائج. يمكنك إضافة ‎حقل Doubleإلى نموذج عنصر عمل باستخدام سماتFieldControl أو type.
GUID	تحديد الحقل الذي يحتوي على معرف فريد. لا يمكنك إضافة حقل GUID إلى نموذج عنصر العمل.
History	يدعم عرض المناقشات المرتبطة وتعقب معلومات المحفوظات الأخرى. ملاحظة System.History الحقل هو الحقل الوحيد الذي يستخدم نوع البيانات.لا يمكن تعريف حقل مخصص باستخدام نوع البيانات. يمكنك إضافة حقل System.History إلى نموذج عنصر عمل باستخدام سمة WorkItemLogControl typeالتى تدعم عناصر تحكم تنسيق نص منسق.
HTML	تدعم إمكانية التقاط بيانات النص المنسق و استخدم أوصاف نصية أطول مثل وصف عنصر عمل. يختلف حقل HTML عن حقل النص العادى في أنه يتم ربط حقل HTML بشدة ب HTML للحصول على عرض أغنى للمعلومات. يمكنك إضافة حقل HTML إلى نموذج عنصر عمل باستخدام سمة HTMLControl typeالتى تدعم عناصر تحكم تنسيق نص منسق.
Integer	تعيّن قيمة 32-بت لعدد صحيح ذو إشارة. تستخدم حقول الأعداد الصحيحة بشكل متكرر في عوامل تصفية الاستعلام و وقوائم النتائج. يمكنك إضافة ‎حقل Integerإلى نموذج عنصر عمل باستخدام سماتFieldControl أو type.
PlainText	يعتمد إدخال سلسلة النص التي يمكن أن تحتوي على أكثر من 255 حرف Unicode. يمكنك إضافة حقل PlainText لعنصر عمل باستخدام إما سمة نوعFieldControl والمحدودة بالنص العادى أو سمة HTMLControl type التى تدعم عناصر تحكم تنسيق النص المنسق.
String	يدعم إدخال سلسلة النص التي يمكن أن تحتوي على أكثر من 255 حرف Unicode. استخدم سلسة الحقل للتسمية أو سلسلة النص القصير حتى سطر واحد طويل. حقول السلسلة تستخدم بشكل متكرر في عوامل تصفية الاستعلام و وقوائم النتائج. يمكنك إضافة ‎حقل Stringإلى نموذج عنصر عمل باستخدام سماتFieldControl أو type.
TreePath	تعيين الحقل الذى يعرض الإدخالات في تنظيم هرمي أو بنية شجرة مثل متطلبات عرض مسارات المنطقة و التكرار للمنتج. ملاحظة System.AreaPath و System.IterationPath الحقول هى الحقول فقط التي تستخدم نوع البيانات.لا يمكن تعريف حقل مخصص باستخدام نوع البيانات. يمكنك إضافة حقول System.AreaPath و System.IterationPath إلى نموذج عنصر عمل باستخدام سمات WorkItemClassificationControأو type.

استخدام الحقول فى عمل التقارير

بعض قيم الحقول تكون مفيدة بشكل خاص لإصدار التقارير. باستخدام لغة تعريف نوع عنصر العمل يمكنك تحديد سمة اختيارية، reportable ، للحقول التي يجب استخدامها للتقارير. عند إضافة حقل موجود إلى عنصر عمل اكتب ، تستخدم القيمة الحالية لـسمة reportable. عند إضافة حقل إلى نوع عنصر عمل، يتم تعطيل التقرير إذا لم تقوم بتحديده بشكل واضح باستخدام سمة reportable.

سيتم تصدير بيانات الحقول التى تحتوى على سمة reportable إلى مستودع البيانات و يمكن تضمينها في التقارير. بعد تعريف حقل، يمكنك استخدام أداة سطر الأوامرwitadmin reportfield لتغيير قيمة سمة reportable.

لمزيد من المعلومات، راجع إنشاء، وتخصيص، و إدارة تقارير لبرنامج ‏‫Visual Studio ALM.

قيم السمات المستخدمة فى التقارير

تتطلب سمة reportable أحد ثلاث قيم: البعد، والتفاصيل، والمقياس ، كما هو موضح في الجدول التالي:

ملاحظة

يمكنك جعل استخدام حقل فى التقرير بعد استخدامه لعنصر العمل. بعد تعيين قيمة التقرير، ستحتوي المراجعات الجديدة لعنصر العمل التي يتم نسخها إلى مستودع على قيمة الحقل. ومع ذلك، لن يتم إعادة ملء المراجعات الموجودة في المستودع بالقيم الحالية.

قيمة السمة	الوصف
Dimension	استخدم نوعDimension فقط مع حقول الأعداد الصحيحة ، والمزدوجة ، والسلسلة أو التاريخ والوقت. يتم أدخال البيانات في هذا الحقل فى قاعدة بيانات المستودع العلائقية والمكعب مثل سمة من أبعاد عنصر العمل بحيث يمكن استخدام البيانات لتصفية التقارير. استخدم هذا النوع للحقول التي تحتوي على قوائم القيم الصالحة. بعض الأمثلة الجيدة للأبعاد هى نوع عنصر العمل و حالته.
Detail	استخدم نوعDetail فقط مع حقول الأعداد الصحيحة ، والمزدوجة ، والسلسلة أو التاريخ والوقت. يتم نقل البيانات الموجودة في هذا الحقل إلى قاعدة بيانات المستودع العلائقية في محفوظات عنصر العمل و جداول عنصر العمل ، لكن ليس في المكعب. يمكن استخدام هذا النوع بالنسبة للحقول النصية الغير مقيدة والتي يمكنك استخدامها في التقارير، ولكنه يتجنب جعل المكعب أكبر بشكل ملحوظ.
Measure	استخدم نوع Measure فقط لحقول الأعداد الصحيحة والمزدوجة. القياسات هى القيم الرقمية في التقارير الخاصه بك. يظهر كل قياس في كل من مجموعة قياس عنصر العمل الحالى ومجموعة قياس محفوظات عنصر العمل. على سبيل المثال، يكون "العمل المقدر" قياس. عند تحديد Measure ، يجب عليك تحديد sum لسمة formula التى تقوم بإرجاع مجموع كل مقياس مشار إليه في الاستعلام.

أمثلة تظهر كيفية تحديد التقرير

مثال البعد

<FIELD refname="MyCorp.Category" name="Category" type="String" reportable="dimension">

مثال التفاصيل

<FIELD refname="MyCorp.Summary" name="Summary" type="String" reportable="detail">

مثال قياس

<FIELD refname="MyCorp.Cost" name="Cost" type="Integer" reportable="measure" formula="sum">

الحقول المفهرسة

يمكنك تمكين أو تعطيل الفهرسة لحقل عنصر عمل. عند تمكينك الفهرسة لحقل، قد تقوم بزيادة أداء البحث عن عناصر العمل التى تحدد استعلاماتهم هذا الحقل. إذا قمت بإضافة حقل مخصص تستخدمه في العديد من استعلامات عناصر العمل الخاصة بك، قد تحتاج لتمكين الفهرسة لهذا الحقل.

العناصر التابعة لحقل عنصر العمل

هناك عدد من العناصر التابعة الاختيارية التى يمكنك تحديدها لأحد حقول عنصر العمل، على سبيل المثال:

• نص المساعدة: تعريف أداة تلميح أو معلومات المساعدة التي تعرض لحقل على نموذج عنصر العمل من ( HELPTEXT).

• حقول التقييدات. تحديد حقل إما كمطلوب، أو للقراءة فقط، أو فارغ، أو مجمد أو مطابقة نقش معين ( REQUIRED ، READONLY ، EMPTY ، FROZEN ، MATCH).

• الملء التلقائى لقيم الحقول. تعيّن قيمة لـحقل ( DEFAULT ، COPY ، SERVERDEFAULT).

• قواعد قيم قائمة الحقول. تحديد القيم المسموح بها أو المقترحة أو الممنوعة. (ALLOWEDVALUES, SUGGESTEDVALUES, PROHIBITEDVALUES)

• شروط قواعد الحقل. تطبيق قاعدة أو أكثر على حقل عند تغيير حقل آخر أو عدم تغييره، أو عند احتواء أو عدم احتواء حقل آخر على قيمة محددة، أو شرط أخر( WHEN ، WHENNOT ، WHENCHANGED ، WHENNOTCHANGED ، CANNOTLOSEVALUE ، NOTSAMEAS).

لمزيد من المعلومات، راجع عنصر الحقل (عنصر نوع عنصر العمل).

حقول النظام و الحقول المعرفة مسبقاً

كافة حقول النظام المعرفة تحتوي على اسماء مرجعية تبدأ بSystem، على سبيل المثال، System.AreaPath ، System.AssignedTo ، واستمر على هذا النمط.

الحقول المعرفة مسبقاً المعرفة بواسطة قالب عملية Microsoft Solutions Framework (MSF) تبدأ ب Microsoft.VSTS و تختلف بعد ذلك حسب الاستخدام الخاص بهم. أمثلة الحقول المعرفة مسبقاً التي يتم استخدامها بشكل عام، من أجل أغراض الجدولة والتكامل مع Office Project ، للتكامل مع بنية Team Foundation ، والتكامل مع Team Foundation هي كالتالي:

• Microsoft.VSTS.الأولوية الشائعة

• Microsoft.VSTS.Scheduling.DueDate

• Microsoft.VSTS.Build.FoundIn

• Microsoft.VSTS.TCM.Steps

للحصول على نظرة عامة حول النظام وكافة الحقول المعرفة مسبقاً التي تم تعريفها لـقالب عملية التطوير السريع للبرامج (MSF)، راجع باستخدام حقول النظام و الحقول المعرفة من قبل قوالب المعالجة MSF. للحصول على معلومات حول تعيين أسماء الحقول، راجع اصطلاحات التسمية لكائنات متابعة عناصر العمل.

مخطط تعريف حقل عنصر العمل

للحصول على تعريفات المخططات، راجع النوع المركب FieldDefinition (عنصر WORKITEMTYPE).

راجع أيضًا:

المهام

إضافة أو إزالة حقل من نوع عنصر عمل

المرجع

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

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

المبادئ

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

موارد أخرى

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