مشاركة عبر

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

  • مقالة

يمكنك إدارة حقول نوع عنصر العمل التي تم تعريفها لمجموعة مشروع الفريق باستخدام الأوامر التالية witadmin:

  • deletefield: يقوم بحذف الحقل المعيّن.

  • listfields: يقوم بسرد السمات لكافة الحقول أو الحقل المحدد.

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

  • changefield: يقوم بتغيير سمة واحدة أو أكثر من الحقل مثل اسم الحقل المألوف أو السمات لتقارير مستودع البيانات أو القدرة على مزامنة الحقل الذي يحتوي على أسماء الشخص. عند تمكين المزامنة، يتم تحديث الحقل كما يتم إجراء تحديثات على الدليل النشط أو مجموعة العمل النشطة. لمزيد من المعلومات حول كيفية استخدام الحقول للإبلاغ, راجع استخدام الحقول عنصر العمل.

    هام

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

يمكنك العثور على أداة سطر الأمر witadmin في < محرك الأقراص \Program Files\Microsoft Visual Studio 10.0\Common7\IDE على كمبيوتر العميل الذي يقوم بتشغيل مستكشف الفريق.

لمزيد من المعلومات حول الحقول، راجع Customizing and Using Work Item Fields.

الأذونات المطلوبة.

للحصول علي مجموعة مشروع الفريق التي تم تعريف حقول نوع عنصر العمل فيها، يجب أن يكون لديك الأذونات التالية معيّنة:

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

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

للمزيد من المعلومات، راجع أذونات خادم أساس الفريق والمجموعات و الأذونات و الأدوار الافتراضية لخادم Team Foundation.

ملاحظة

حتى لو قمت بتسجيل الدخول بأذونات إدارية، يجب أن تقوم بفتح نافذة موجه أوامر غير مقيد لتنفيذ هذه الوظيفة على خادم يقوم بتشغيل Windows Server 2008. لفتح نافذة موجه أوامر غير مقيدة، انقر فوق ابدأ، ثم انقر بزر الماوس الأيمن فوق موجه الأوامر ثم انقر فوق تشغيل كمسؤول. لمزيد من المعلومات، راجع موقع الويب Microsoft: التحكم في وصول المستخدم.

witadmin deletefield /collection:CollectionURL /n:RefName [/noprompt]

witadmin listfields /collection:CollectionURL /n:RefName [/unused]

witadmin indexfield /collection:CollectionURL /n:Name /index:on|off 

witadmin changefield /collection:CollectionURL /n:RefName [/name:NewName] [/syncnamechanges:true | false] [/reportingname:ReportingName] [/reportingrefname:ReportingRefName] [/reportingtype:Type] [/reportingformula:Formula] [/noprompt]

المعلمات

المعلمة

الوصف

/collection:CollectionURL

تعيين URI الخاص بمجموعة مشروع الفريق. تنسيق URI هو كالتالي: http: / / ServerName:Port/VirtualDirectoryName/CollectionName

في حالة عدم استخدام دليل ظاهري، تنسيق URI هو كالتالي:

http: / / ServerName:Port / CollectionName.

/n:RefName

/n:Name

اسم المرجع لحقل نوع عنصر العمل.

/index

تعين تمكين أو تعطيل فهرسة الحقل المحدد. حدد on لتمكين فهرسة و تعطيل فهرسة off.

/name:NewName

يعيّن الاسم الجديد للحقل.

/syncnamechanges

تحدد استخدام حقل عنصر عمل لتخزين الأسماء و للتحديث أثناء إجراء التغييرات في الدليل النشط أو مجموعة العمل. يكون هذا الخيار صالحاً فقط عند تحديد حقل بنوع بيانات سلسلة محدد لـ typename.

حدد true لتمكين المزامنة لحقل البيانات ، حدد false لتعطيل المزامنة لحقل البيانات.

/reportingname:ReportingName

تحدد اسم الحقل في مستودع البيانات لاستخدامه في التقارير.

/reportingrefname:ReportingRefName

تحدد اسم المرجع الخاص بالحقل فى مستودع البيانات لاستخدامه في التقارير.

/reportingtype:Type

تحدد كيفية استخدام الحقل في المستودع لإصدار التقارير. القيم التالية صالحة:

  • dimension: يستخدم لحقول العدد الصحيح(Integer) أو السلسة(String) أو التاريخ و الوقت(DateTime).

  • detail:يستخدم لحقول العدد الصحيح(Integer) أو المزدوج(Double) أو السلسة(String) أو التاريخ و الوقت(DateTime).

  • measure: يستخدم في حقول العدد الصحيح و المزدوج. نوع التجميع الافتراضي هو المجموع (sum). يمكنك تحديد نوع تجميع آخر باستخدام المعلمة formula.

  • disable: يستخدم في تعطيل إمكانية التقرير على الحقل.

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

/reportingformula:Formula

تحدد صيغة التجميع ليتم استخدامها عندما يتم الإعلام عن الحقل كـ measure. الصيغة المعتمدة الوحيدة هي sum.

/unused

يسرد كافة الحقول التي لا تستخدم من قبل أي مشروع فريق معرّف في مجموعة مشروع الفريق.

/noprompt

تعطل المطالبة بالتأكيد.

/? or help

عرض تعليمات حول الأمر في إطار موجّه الأمر.

ملاحظات

عندما تقوم بتعيين السمة syncnamechanges لحقل السلسلة، يقبل الحقل دائماً أسماء مستخدم صالحة. ومع ذلك، لا يسمح الحقل بأسماء المجموعات التي يتم تخزينها في Team Foundation Server أو في الدليل النشط إذا كان أحد الشروط التالية هو true:

  • يتم تحديد قاعدة VALIDUSER عبر كافة أنواع عنصر العمل

  • يتم تحديد قاعدة VALIDUSER لنوع عنصر العمل

  • يتم تحديد قاعدة ALLOWEDVALUES لنوع عنصر العمل، و لهذه القاعدة معايير تصفية تقوم باستثناء مجموعات

لمزيد من المعلومات، راجع تطبيق قواعد حقل والشروط الحقل.

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

أمثلة

ما لم يتم تعيين شيء أخر القيم التالية تنطبق في كل مثال:

  • URI الخاص بمجموعة مشروع الفريق: http://AdventureWorksServer:8080/AWTeam/Collection1

  • اسم حقل عنصر العمل: AdventureWorks.Field

  • الترميز الافتراضي: UTF-8

قائمة الحقول

يعرض الأمر التالي معلومات حول كل حقل معرّف لـ Collection1 على الخادم AdventureWorksServer:

witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1

يعرض الأمر التالي معلومات الحقل للحقل المحدد AdventureWorks.Field المستخدم من قبل Collection1:

witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field

يعرض الأمر التالي كافة الحقول التي لا تستخدمها Collection1:

witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /unused

إعادة تسمية الحقل

يقوم الأمر التالي بتغيير الاسم المألوف للحقل المشار إليه AdventureWorks.Field إلي NewFieldName لـ Collection1:

witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field /name:NewFieldName

تغيير التقرير كقيمة للحقل

يقوم الأمر التالي بتعيين إمكانية تقرير نوع حقل التاريخ و الوقت DateTime AdventureWorks.CreatedOn إلي البُعد. إدخال بيانات هذا الحقل في المخزون وقواعد بيانات "الخدمات التحليل" بحيث يمكن استخدام إلى تصفية التقارير.

witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.CreatedOn /reportingtype:dimension

يقوم الأمر التالي بتعيين إمكانية تقرير نوع الحقل المزدوج AdventureWorks.Field إلى القياس. يتم تجميع كافة القياسات حسب المجموع.

witadmin reportfield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field /reportingtype:measure

تمكين المزامنة لحقل الاسم المخصص

يقوم الأمر التالي بتمكين المزامنة لحقل عنصر العمل AW.CustomerName المعرّف لـ Collection1 على AdventureWorksServer.

witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AW.CustomerName /syncnamechanges:true

حذف حقل

يحذف الأمر التالي حقل AdventureWorks.Field من Collection1:

witadmin deletefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field

راجع أيضًا:

المبادئ

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

موارد أخرى

Customizing and Using Work Item Fields

witAdmin: إدارة كائنات تعقب عنصر العمل