Link and Param Elements

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

• إضافة ارتباط تشعبي إلى حقل التسميه

• إضافة ارتباط تشعبي لتسمية مستقلة أو أجزاء من النص إخبارية

• تحديد URL للمحتوى لضمن نموذج عنصرالعمل

إضافة Linkعنصر واحد أو أكثر Controlالعناصر التابعة كـ توابع WebpageControlTarget او WebpageControlOptionsالعنصر. لمزيد من المعلومات حول هذه الإعتبارات ، راجع عنصر تحكم (مخطط تعريف نوع عنصر عمل) و عناصر WebpageControlOptions.

هيكل المخطط

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

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

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

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

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

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

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

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

<xs:element name="Link" type="HyperLinkType" minOccurs="0" maxOccurs="1" />
<xs:element name="Param" type="HyperLinkParamType" minOccurs="0" maxOccurs="unbounded"/>

<Link URLRoot="URL root" URLPath ="URL path with parameters">
   <Param index="index value " value="Param Value " type ="Original | Current"/>
</Link>

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

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

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

العنصر	السمة	الوصف
Link		عنصر اختياريControl عند type="FieldControl". العنصر Textالإختيارى. العنصر WebpageControlالإختيارى. العنصر WebpageControlOptionsالإختيارى. حاوية عنصر لتعريف ارتباط تشعبي أو URL. نوع العنصر هو النوع المعقد : HyperLinkType.
	URLRoot	سمة Link مطلوبة. تعيّن البروتوكول واسم الخادم URL الذي ارتباطات التسمية. البروتوكولات المعتمدة هي HTTP و HTTPS و MAILTO. يمكنك أما hardcode اسم الخادم المحدد، أو يمكنك استخدام إحدى وحدات الماكرو التالية و اختيارياً بإلحاق معلومات العنوان الإضافية إلى ماكرو: ملاحظة كل الارتباطات الماكرو إلى محدد موقع المعلومات الذي هو المعرفة وتمكين لفريق مشروع من نموذج عنصر عمل الذي Linkعنصر هو المعرفة.إذا كان أي من موارد لم يتم توفير أو ممكنة للفريق مشروع، فسيظهر خطأ "غير موجود صفحه". @PortalPage: "URL" لموقع SharePoint لفريق مشروع الحالي (ل مثال، http:// إسمالخادم /المواقع/ collectionName/TeamProjectName ). @ProcessGuidanceUrl: "URL" موقع SharePoint لإرشادات عملية فريق مشروع. @ReportManagerUrl: "محدد موقع المعلومات" الخاص الخادم التي تستضيف إدارة التقارير للحالي مشروع الفريق. وهذا ما يوفر ارتباط إلى عرض المجلد للتقارير (على سبيل المثال، http://إسمالخادم/Reports/الصفحات/مجلد.aspx?ItemPath=/ collectionName/teamProjectName ). @ReportServiceSiteUrl: URL الخاص بالخادم الذي يستضيفSQL Server"الخدمات التقارير" الحالي فريق مشروع بالإضافة إلى مسار الأساسي فريق مشروع (على سبيل المثال، http:// إسمالخادم /Reports/الصفحات/reportservice.asmx?ItemPath=/ collectionName/فريقProjectName ). إلى تحديد القيمة ضمنية لوحدات الماكرو أول والثاني، يمكنك فتح إعدادات مشروع المدخل لمشروع فريق. لمزيد من المعلومات، راجع كيفية: الوصول إلى فريق المشروع ومواقع إرشادات معالجة. نوع السمة هو نوع بسيط . NonBlankString.
	URLPath	سمة Link اختيارية. ‏‫تحديد مسار ULR للارتباط التشعبي. ‬ استخدم هذة السمة لتحديد معلمات متغير يتم تحديدها وقت التشغيل. نوع السمة هو نوع بسيط . NonBlankString.
Param		العنصر Linkالإختيارى. مطلوبة عند تحديد URLPath. تحدد قيمة لاستخدامها لتحديد URL للارتباط التشعبي عند تحديد URLPath. نوع العنصر هو النوع المعقد : HyperLinkParamType.
	index	سمة Param مطلوبة. تحديد الفهرس للمعلمات حيث يجب أن يتم تنسيق القيمة إلى سلسلة URL. غير مطلوب لترتيب قيم الفهرس بالتسلسل; ولكن, ويجب أن تتطابق مع رقم الفهرس في URLPath سلسلة. نوع السمة هو PositiveInteger. يجب أن يكون رقم الفهرس الأول 1.
	value	سمة Param مطلوبة. تعيّن رقم المقترن بقيمة مسار URL للارتباط التشعبي. تحديد قيمة يجب تهيئتها إلى URLPath سلسلة. يجب أن تكون القيم مرجع أسماء صالح للأسماء المستخدمة في نوع تعريف عنصر العمل. @Me معتمد متغير. يتم استبدال مع الاسم لعضو الفريق الحالى الذي يقوم بعرض نموذج عنصر العمل. إدخالات القيمة ليست حساسة لحالة الأحرف نوع السمة هو xs:string.
	type	سمة Param اختيارية. تحديد أن القيمة الأصلية الحقل يجب استخدام المعلمات. نوع السمة هو نوع بسيط HyperLinkParamValueKind . يتم سرد القيم الصالحة كما يلي: Original: تعيين استخدام معلم القيمة الأصلي مسار URL . Current: تعيين استخدام معلم القيمة الحالى لتعيين مسار URL . إذا لم يتم تعيين هذه السمة ، يتم استخدام القيمة الحالية للحقل كمعلمة

العناصر الأصل

العنصر	الوصف
عنصر تحكم (مخطط تعريف نوع عنصر عمل)	العنصر المطلوب. يعرّف حقل النص أو الارتباط التشعبي أو عنصر تحكم آخر لتظهر على نموذج عنصر العمل.
LabelText	العنصر Controlالإختيارى. عنصر حاوية لتسمية للظهور على نموذج عنصر العمل. لمزيد من المعلومات، راجع LABELTEXT وعناصر نص.
Text	العنصر LabelTextالإختيارى. حاوية العنصر للحصول على المعلومات أو التسمية لتظهر على نموذج عنصر العمل. لمزيد من المعلومات، راجع LABELTEXT وعناصر نص.
WebpageControlOptions	العنصر Controlالإختيارى. عنصر الحاوية التي تحدد خيارات عنصر تحكم صفحة الويب. لمزيد من المعلومات، راجع عرض محتويات ويب داخل نموذج عنصر عمل: عناصر WebpageControlOptions.

ملاحظات

السلوك الافتراضي Link العنصر لفتح الارتباط التشعبي في نموذج عنصر العمل أو صفحة ويب. في حالة كتابة الارتباط التشعبي لقتح في إطار جديد (الهدف = ” _blank ”) ، ثم يتم فتح مستعرض خارجية.

يمكنك ضم نص عادي و ارتباط تشعبي عن طريق إضافة عدة Text عناصر في LabelTextالعنصر.

العنصرLabelText يمكن فقط التعرف عليه من قبل العملاء التي تقوم بتشغيل أحدث إصدار من مستكشف الفريق. لذلك يجب تحديد Labelالسمة في Control العنصر عند تحديد تابع Link العنصر. العملاء التي تستخدم أحدث إصدار من مستكشف الفريق ، النص المتوفرة من قبل LabelText العنصر يظهر في نموذج عنصر العمل . عملاء التي تقوم بتشغيل إصدارات سابقة من مستكشف الفريق ، يظهر النص المحدد بواسطة Control العنصر Label تظهر السمة في نموذج عنصر العمل .

مثال: تحديد ارتباط تشعبي عن طريق المعلمات

الوصف

يظهر المثال التالي كيف يمكنك تعريف ارتباط تشعبي يرتبط إرشادات عملية للحصول تكرار الموضوع :

http:// إسمالخادم /المواقع/ collectionName //render.aspx?wit=خطأ اسم المشروع & &؛ الموضوع = تكرار

اسم المشروع مشتق من القيمة التي تم تعيينها إلى الحقل System.Project.

الرمز

<Link UrlRoot="https://serverName" UrlPath="sites/{0}/render.aspx?wit=bug&amp;topic=Iteration">
   <Param index="1 " value="System.Project"/>
</Link>

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

الوصف

يظهر المثال التالي كيفية تعيين ارتباط تشعبى للنص "إرشادات عنصر عمل" في نموذج عنصر عمل.

الرمز

<Control type="LabelControl">
   <LabelText> 
      <Text>
         <Link UrlRoot="https://www.msn.com" />
      work item guidance
      </Text>
   </LabelText> 
</Control>

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

الوصف

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

الرمز

<Control Type="FieldControl" FieldName="System.Title" LabelPosition="Left" Label="This text comes from the Label attribute:">
   <LabelText>
      <Text>
         <Link UrlRoot="http://www.live.com/" />
         This text comes from the inner Label Text
      </Text>
   </LabelText>
</Control>

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

• HyperLinkType.

• NonBlankString

• HyperLinkParamType.

• HyperLinkParamValueKind

نوع معقد HyperLinkType.

<xs:complexType name="HyperLinkType" >
   <xs:sequence>
      <xs:element name="Param" type="HyperLinkParamType" minOccurs="0" maxOccurs="unbounded"/>
   </xs:sequence>
   <xs:attribute name="UrlRoot"  type="NonBlankString" use="required" />
   <xs:attribute name="UrlPath"  type="NonBlankString" use="optional" />
</xs:complexType>

HyperLinkParamType.

<xs:complexType name="HyperLinkParamType" >
   <xs:attribute name="Index"     type="PositiveInteger" use="required" />
   <xs:attribute name="Value"     type="xs:string" use="required" />
   <xs:attribute name="Type" type="HyperLinkParamValueKind" use="optional" />
</xs:complexType>

NonBlankString

<xs:simpleType name="NonBlankString">
   <xs:restriction  base="xs:string">
   <xs:pattern value=".*\S+.*"/>
   </xs:restriction>
</xs:simpleType>

HyperLinkParamValueKind

<xs:simpleType name="HyperLinkParamValueKind">
   <xs:restriction base="xs:string">
   <xs:enumeration value="Original"/>
   <xs:enumeration value="Current"/>
   </xs:restriction>
</xs:simpleType>   

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

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

راجع أيضًا:

المبادئ

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

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

موارد أخرى

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