عناصر تحكم نموذج عنصر عمل

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

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

• إضافة حقول عنصر عمل إلى نموذج عنصر عمل

  • إضافة السلسلة و حقول العدد: FieldControl

  • إضافة حقول التاريخ والوقت: DateTimeControl

  • إضافة حقول المحفوظات: WorkItemLogControl

  • إضافة حقول HTML: HtmlFieldControl

  • إضافة حقول TreePath: WorkItemClassificationControl

• إضافة نص مستقل و تسميات حقل الارتباط التشعبي إلى نموذج عنصر عمل

• إضافة عناصر تحكم خاصة إلى نموذج عنصر عمل

  • دعم إمكانية اضافة مرفقات لعناصر العمل: AttachmentsControl

  • دعم إمكانية إنشاء ارتباطات بين عناصر العمل: LinksControl

  • عرض محتوى الويب ضمن نموذج عنصر عمل: WebpageControl

• إضافة عناصر تحكم مخصصة إلى نموذج عنصر عمل

إضافة حقول عنصر عمل إلى نموذج عنصر عمل

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

يتم ربط كل حقل عنصر عمل مع نوع من انواع البيانات. وكذلك, العديد من حقول عنصر العمل يتم تعقبها بواسطة النظام و يجب ألا يتم تغييرها . على سبيل المثال، التاريخ المنشأ و المنشأ بواسطة الحقول التي يتم تعقبها من قبل النظام. يمكنك ان تشكل استعلامات باستخدام هذه الحقول; ومع ذلك، لا يمكنك تغيير قيمة هذه الحقول عبر نموذج عنصر عمل. للحصول على وصف لكل حقل نظام ، راجع باستخدام حقول النظام و الحقول المعرفة من قبل قوالب المعالجة MSF.

يمكنك استخدام المعلومات في الجدول التالي لتحديد أي نوع حقل يتم تدعيمه بواسطة Type أي سمة من Control العنصر. استخدام Label السمة لتحديد النص الذي يظهر بجانب عنصر التحكم. استخدام السمة ذات الصلة LabelPosition لتحديد مكان ظهور التسمية نسبة إلى عنصر التحكم.

ملاحظة

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

نوع الحقل	سمة نوع عنصر التحكم	الاستخدام
التاريخ والوقت	FieldControl DateTimeControl	استخدام FieldControl ليوفر حقل نصي لإدخال أو لعرض حقل نوع بيانات التاريخ و الوقت استخدام DateTimeControl ليوفر منتقي التقويم لتحديد تاريخ لـحقل ما.
مزدوج	FieldControl	استخدام FieldControl ليوفر حقل نصي لإدخال أو لعرض حقول مزدوجة.
المحفوظات	WorkItemLogControl	استخدام WorkItemLogControl ليوفر حقل عنصر تحكم لحقول المحفوظات التي تتعقب مؤشرات ترابط المناقشات ومعلومات محفوظة أخرى .
HTML	HTMLControl	استخدام HTMLControl ليوفر حقل عنصر تحكم لحقول HTML لالتقاط تنسيق النص المنسق.
Integer (عدد صحيح)	FieldControl	استخدام FieldControl ليوفر حقل عنصر تحكم لحقل عدد صحيح.
النص العادي	FieldControl HTMLControl	استخدام FieldControl أو HTMLControl ليوفر حقل عنصر تحكم لحقل نص عادي مثل مربع النص الذي يحتوي على أوصاف قد تكون أكثر من 255 حرفاً.
سلسة نصية	FieldControl	استخدام FieldControl ليوفر حقل عنصر تحكم لحقل سلسلة. تقتصر حقول السلسلة على 255 حرفاً.
TreePath	WorkItemClassificationControl	استخدام WorkItemClassificationControl ليوفر حقل عنصر تحكم لحقل TreePath.

سمات حقل عنصر التحكم اختيارية لكافة أنواع عناصر التحكم

يمكن تحديد السمات الاختيارية التالية فقط لأنواع عناصر التحكم المسرودة:

Attribute	الوصف
Field	تحديد عنصر التحكم المقترن بـحقل عنصر العمل.
Label	تحديد النص المرئي على النموذج الذي يعرّف عنصر التحكم. تحديد سلسلة من عدد لا يتجاوز 80 حرف.
LabelPosition	تحديد موضع التسمية نسبة إلى بيانات عنصر التحكم . حدد سلسلة من إحدى القيم التالية: Top و Bottom وLeft و Right.
Dock	تحديد محاذاة التسمية بـالجانب المحدد من الحاوية, أو تمدد الحقل لتعبئة الحاوية. حدد سلسلة من إحدى القيم التالية: Fill, Top, Bottom, Left و Right.
Padding	تحديد مقدار المسافة بالبكسل حول الحد الداخلي لعنصر التحكم. يتم توفير أربعة قيم مناظرة للأعلى و الأسفل و اليسار و اليمين. فعلى سبيل المثال: (2,0,2,0).
Margin	تحديد مقدار المسافة بالبكسل حول الحد الخارجي لعنصر التحكم. يتم توفير أربعة قيم مناظرة للأعلى و الأسفل و اليسار و اليمين. فعلى سبيل المثال: (2,0,2,0).
ReadOnly	يحدد أن الحقل للقراءة فقط. تحديد True أو False.
MinimumSize	تحدد أدنى حجم بـالبكسل يجب أن يشغله عنصر التحكم في النموذج. يتم تعيين قيمتين مناظرتين للارتفاع والعرض. فعلى سبيل المثال: (100,100)
Name	يعرّف عنصر التحكم بشكل فريد . Name السمة يتم طلبها إذا كان أكثر من عنصر تحكم في النموذج يتم ربطه مع نفس حقل عنصر العمل . ملاحظة استخدام السمة Name لعرض نفس الحقل في أكثر من منطقة واحدة على النموذج.تقوم بتحديد قيمة فريدة للسمة Name لكلٍ من مدخلات عنصري تحكم بحيث يعرّف النظام كل عنصر تحكم بشكل فريد.من المفيد إظهار نفس عنصر التحكم في مواقع مختلفة استناداً إلى سياق علامات التبويب.

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

يمكن تحديد السمات الاختيارية التالية فقط لأنواع عناصر التحكم المسرودة:

Attribute	معرّف نوع عنصر تحكم	الوصف
NumberFormat	FieldControl	تعين الأحرف التي يمكنك إدخالها في عنصر تحكم الحقل . يتم سرد القيم الصالحة كما يلي: WholeNumbers و SignedWholeNumbers وDecimalNumbers و SignedDecimalNumbers.
MaxLength	FieldControl	تعيّن الحد الأقصى لطول الأحرف التي يمكنك استخدامها لعنصر تحكم حقل.
Format	DateTimeControl	تحديد تنسيق حقل التاريخ - الوقت الذي يتوافق مع إحدى القيم التعداد DateTimePickerFormat. يتم سرد القيم الصالحة كما يلي: Custom, Long, Short, Time.
CustomFormat	DateTimeControl	تحديد التنسيق المخصص المستخدم لحقل التاريخ - الوقت الذي يتوافق مع تعريف بناء جملة للخاصية DateTimePicker.CustomFormat.

إضافة السلسلة و حقول العدد: FieldControl

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

مثال: تسمية حقل عادي

<Control Type="FieldControl" FieldName="System.Title" Label="Title" LabelPosition="Left" />

مثال: تسمية حقل الارتباط التشعبي

<Control Type="FieldControl" FieldName="System.State" Label="&amp;State:" LabelPosition="Left">
   <Link OpenInNewWindow="true" URL="http://{0}/sites/{1}/render.aspx?wit=bug&amp;state={2}">
      <Param value="@Server"/>
      <Param value="System.Project"/>
      <Param value="System.State" type ="original"/>
   </Link>
</Control>

مثال: تسمية الحقل بالارتباط التشعبي لجزء من النص

<Control Type="FieldControl" FieldName="System.IterationPath">
   <Label LabelPosition="Left">
      <Text>
         <Link URL="http://{0}/sites/{1}/render.aspx?wit=bug&amp;topic=Iteration">
            <Param value="@Server"/>
            <Param value="System.Project"/>
         </Link>
            Iteration Path
      </Text>
      <Text> (must be 3 levels deep)</Text>
   </Label>
</Control>

إضافة حقول التاريخ والوقت: عنصر تحكم التاريخ والوقت

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

<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStart"
Label="Preferred Start Date:" LabelPosition="Left" Dock="Fill" />
<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStartTime"
Label="Preferred Start Time:" LabelPosition="Left" Dock="Fill" Format="Time" />

إضافة حقول المحفوظات: WorkItemLogControl

يمكنك استخدام WorkItemLogControl لإضافة الحقول التي نوع بياناتها History. عنصر التحكم هذا يوفر الدعم لعرض حقل محفوظات عنصر العمل. باستخدام عنصر التحكم هذا , يمكن توسيع و طي تفاصيل حول مراجعات محفوظات عنصر عمل.

<Control Type="WorkItemLogControl" FieldName="System.History" Label="Detailed Description
and History" LabelPosition="Top" Dock="Fill" />

إضافة حقول HTML: HtmlFieldControl

يمكنك استخدام HTMLFieldControl لإضافة الحقول التي نوع بياناتها HTML. يوفر عنصر التحكم هذا الدعم لعرض نص منسق عبر خطوط متعددة.

<Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.ReproSteps" Label="Repro Steps"
LabelPosition="Top" Dock="Left" MinimumSize="100,500" />

إضافة حقول TreePath: WorkItemClassificationControl

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

<Control Type=" WorkItemClassificationControl " FieldName="System.AreaPath" Label="Area"
LabelPosition="Left" />

إضافة نص مستقل وتسميات حقل الارتباط التشعبي

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

مثال: تسمية نص عادي

المثال التالي يضيف النص العادي "التعبئة في تفاصيل الخطأ هنا. الحقول الغير مطلوبة موصي بها ليتم ملؤها "لحقل عنصر العمل.

<Control Type="LabelControl" Label="Fill in the details of the bug here. Fields that are not required are recommended to be filled in." />

مثال: تسمية حقل الارتباط التشعبي

يوضح المثال التالي كيفية اضافة الارتباط التشعبي إلى تسمية حقل:

<Control Type="FieldControl" FieldName="System.Title" LabelPosition="Left" Label="Title 1"
   <LabelText>
      <Text>
         <Link UrlRoot="http://www.live.com/" />
            Title 2
      </Text>
   </LabelText>
</Control>

ملاحظة

للحصول على العملاء Team Foundation الذين لم يقوموا بالترقية إلى أحدث إصدار Label يظهر نص السمة. للحصول على عملاء Visual Studio Application Lifecycle Management 2010 تعرض علامة النص كارتباط تشعبي مع URL المعرّفة من قِبل Link العلامة.

مثال: تسمية نص الارتباط التشعبي

يوضح المثال التالي كيفية إضافة ارتباط تشعبي إلى نص معروض في نموذج عنصر عمل:

تسمية نص الارتباط التشعبي

<Group>
   <Column PercentWidth="100">
      <!-- Standalone label control 2 -->
      <Control Type="LabelControl" Label="How do I use this work item?">
         <Link UrlRoot="http://www.live.com"></Link>
      </Control>
   </Column>
</Group>

مثال: ضم نص و ارتباطات تشعبية في تسمية مفردة

يوضح المثال التالي كيفية إضافة ارتباطين تشعبيين صواب أجزاء من تسمية على عمل نموذج العنصر:

ضم نص و ارتباطات تشعبية في تسمية مفردة

<Group>
   <Column PercentWidth="100">
   <!-- Standalone label control 3 -->
      <Control Type="LabelControl" Name="Microsoft.VSTS.Common.GuidanceLabel3">
         <LabelText>
            <Text>Click here for </Text>
            <Text>
               <Link UrlRoot="https://www.msn.com"></Link>
               work item guidance</Text>
            <Text> or here for </Text>
            <Text>
               <Link UrlRoot="http://www.msdn.com"></Link>
               process guidance
            </Text>
         </LabelText>
      </Control>
   </Column>
</Group>

إضافة عناصر تحكم خاصة إلى نموذج عنصر عمل

يصف الجدول التالي Control العنصر type السمات التي توفر لك دعمًا لإدارة مرفقات الملفات و إنشاء ارتباطات و عرض محتوى يستند إلى ويب و عرض بيانات أخرى غير مرتبطة بـحقل عنصر عمل.

سمة نوع عنصر التحكم	الاستخدام
AttachmentsControl	يستخدم لإرفاق ملفات لنموذج عنصر عمل. عنصر التحكم هذا يكون عادةً موجود ضمن مجموعة علامات التبويب الخاصة به.
LabelControl	يستخدم لعرض نص عادي أو نص الارتباط التشعبي الغير مرتبط بـحقل.
LinksControl	يستخدم لإنشاء و إدارة الارتباطات بين عناصر العمل. عنصر التحكم هذا يكون عادةً موجود ضمن مجموعة علامات التبويب الخاصة به.
WebpageControl	يستخدم لعرض محتوى الويب في نموذج عنصر عمل. عنصر التحكم هذا يكون عادةً موجود ضمن مجموعة علامات التبويب الخاصة به.

العناصر التابعة لعنصر التحكم الاختياري

يسرد الجدول التالي العناصر التابعة الاختيارية التي يمكنك استخدامها مع أنواع عناصر التحكم المناظرة:

العنصر	نوع عنصر تحكم	الوصف
LabelText	FieldControl LabelControl	عنصر الحاوية لتحديد النص و الارتباط التشعبي والموضع لحقل أو تسمية نصهـا مقترن جزئياً بـارتباط تشعبي. لمزيد من المعلومات، راجع LABELTEXT وعناصر نص.
Link	FieldControl LabelControl	تعرّف الارتباط التشعبي لحقل أو نص. لمزيد من المعلومات، راجع Link and Param Elements.
LinksControlOptions	LinksControl	تعرّف عوامل تصفية الارتباط وتخطيط حقول الأعمدة المستخدمة لعرض قائمة من الارتباطات. لمزيد من المعلومات، راجع عناصر LinksControlOptions.
WebpageControlOptions	WebpageControl	تحديد عناصر التحكم المطلوبة لتحميل هدف صفحة الويب في نموذج عنصر العمل. لمزيد من المعلومات، راجع عناصر WebpageControlOptions.

دعم إمكانية اضافة مرفقات لعناصر العمل: AttachmentsControl

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

عنصر تحكم المرفقات

<Tab Label="Attachments">
   <Control Type="AttachmentsControl" LabelPosition="Top" />
</Tab>

دعم إمكانية إنشاء ارتباطات بين عناصر العمل: LinksControl

يمكنك استخدام LinksControl لتمكين المستخدمين من إضافة وعرض و إدارة علاقات الارتباط في نموذج عنصر عمل. باستخدام عنصر التحكم هذا يمكنك فتح او تحرير او إضافة أو ازالة الارتباطات. الخيارات المتوفرة مع عنصر التحكم هذا تتضمن تحديد (1) عوامل التصفية لتقييد أنواع الارتباطات التي يمكن إضافتها إلى نوع عنصر العمل و (2) تعريف حقول العمود التي تريد عرضها للحصول على قائمة الارتباطات في نموذج عنصر العمل.

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

عنصر تحكم الارتباطات

<Tab Label="Implementation">
   <Control Type="LinksControl" Name="Hierarchy" Label="Parents and &amp;Child Tasks:"
LabelPosition="Top">
      <LinksControlOptions>
         <WorkItemLinkFilters FilterType="include">
            <Filter LinkType="System.LinkTypes.Hierarchy" />
         </WorkItemLinkFilters>
         <ExternalLinkFilters FilterType="excludeAll"/>
         <LinkColumns>
            <LinkColumn RefName="System.ID" />
            <LinkColumn RefName="System.WorkItemType" />
            <LinkColumn RefName="System.Title" />
            <LinkColumn RefName="System.AssignedTo" />
            <LinkColumn RefName="System.State" />
            <LinkColumn LinkAttribute="System.Links.Comment" />
         </LinkColumns>
      </LinksControlOptions>
   </Control>
</Tab>

للحصول على معلومات أكثر حول أنواع الارتباطات الافتراضية , راجع التعامل مع أنواع الارتباطات .

عرض محتوى الويب ضمن نموذج عنصر عمل: WebpageControl

يمكنك استخدام WebpageControl لعرض محتوى الويب في نموذج عنصر العمل كعنصر تحكم بدلاً من الارتباط بـصفحة ويب منفصلة. يمكن أن يكون هذا العرض مفيداً من أجل توفير القياسات التي تمكّن المستخدمين من مراجعة محتويات تقرير أو لوحة معلومات أو محتويات أخرى مستندة إلى HTML. يمكنك توفير ارتباط للمحتوى أو تضمين محتوى HTML الأولية في علامة تبويب CDATA.

مثال: عرض محتوى متوفر بواسطة URI

<Tab Label="Web">
   <Group>
      <Column PercentWidth="100">
         <Control Type="WebpageControl" Name="WssPortalPage" Label="WssPortalPage" LabelPosition="Top" Dock="Fill">
            <WebpageControlOptions AllowScript="false">
               <Link UrlRoot="http://www.msdn.com" />
            </WebpageControlOptions>
         </Control>
      </Column>
   </Group>
</Tab>

مثال: عرض محتوى متوفر في علامة تبويب CDATA

<Control Type="WebpageControl">
   <Content>
      <![CDATA[Click here for detailed <b><a href="https://www.microsoft.com">Process Guidance</a></b>]]>
   </Content>
</Control>

إضافة عناصر تحكم مخصصة إلى نموذج عنصر عمل

بالإضافة إلى عناصر التحكم المضمنة, يمكنك إضافة عنصر التحكم الخاص بك إلى نموذج عنصر عمل.

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

لتطبيق عنصر تحكم مخصص، يجب تحديد اسم عنصر التحكم للسمة Type . لمزيد من المعلومات، راجع موقع الويب Microsoft: تتبع عنصر العمل لعناصر تحكم مخصصة.

راجع أيضًا:

المهام

إضافة وتخصيص نوع عنصر عمل

تغيير تخطيط نموذج عنصر العمل

تغيير تسمية حقل

إضافة محتوى ويب إلى نموذج عنصر العمل

المرجع

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

المبادئ

عينة لنموذج عنصر العمل

تصميم و تخصيص نموذج عنصر العمل