عناصر LinksControlOptions

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

• WorkItemLinkFilters: يستخدام لتقييد أنواع الارتباطات التي يمكن استخدامها لربط تعريف نوع عنصر العمل للمشروع الحالي

• ExternalLinkFilters: يستخدام لتقييد أنواع الارتباطات التي يمكن استخدامها لربط تعريف نوع عنصر العمل للمشروع الحالي

• WorkItemTypeFilters: يستخدام لتقييد أنواع عناصر العمل حيث يمكن للمستخدم الارتباط.

في كل من هذه العناصر يمكنك تعيين عناصر Filter لتعيين أنواع الارتباطات أو أنواع عنصر العملالتي تريد تضمينها أو استبعادها.

العنصر LinksControlOptions هو عنصر فرعي من العنصر Control.

هيكل المخطط

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

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

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

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

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

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

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

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

<xs:element name="LinksControlOptions" type="LinksControlOptionsType" minOccurs="0"/>
<xs:element name="WorkItemLinkFilters" type="WorkItemLinkFiltersType" minOccurs="0" maxOccurs="1"/>
<xs:element name="Filter" type="WorkItemLinkFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ExternalLinkFilters" type="ExternalLinkFiltersType" minOccurs="0" maxOccurs="1" />
<xs:element name="Filter" type="ExternalLinkFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="WorkItemTypeFilters"   type="LinksControlWorkItemTypeFiltersElementType" minOccurs="0" maxOccurs="1" />
<xs:element name="Filter" type="LinksControlWorkItemTypeFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="LinkColumns" type="LinkColumnsType" minOccurs="0" maxOccurs="1" />
<xs:element name="LinkColumn" type="LinkColumnType" minOccurs="1" maxOccurs="unbounded"/>

<LinksControlOptions>
   <WorkItemLinkFilters FilterType="include | exclude | includeAll | excludeAll">
       <Filter LinkType="linkTypeRefName" FilterOn="reverseName | forwardName" />
   </WorkItemLinkFilters>
   <ExternalLinkFilters FilterType ="include | exclude | includeAll | excludeAll">
       <Filter LinkType="externalLinkName"/>
   </ExternalLinkFilters>
   <WorkItemTypeFilters Scope=" project | all" FilterType=" include | exclude | includeAll" />
       <Filter WorkItemType="workItemTypeName"/>
   </WorkItemTypeFilters>
   <LinkColumns>
      <LinkColumn RefName="reference name" | LinkAttribute="link attribute name"/>
   </LinkColumns>
</LinksControlOptions>

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

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

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

العنصر	السمة	الوصف
LinksControlOptions		عنصر اختياريControl عند type="LinksControl". قم بتوفير حاوية للعناصر التى تعرف خيارات التحكم فى الارتباطات التى ستقوم بإضافتها لعنصر العمل والأعمدة الافتراضية التي تريد إظهارها فى قائمة الارتباطات في عنصر العمل. نوع العنصر هو النوع المعقد : LinksControlOptionsType.
WorkItemLinkFilters		العنصر LinksControlOptionsالإختيارى. يوفر حاوية أو أكثر من عناصر Filter التى تحدد معايير تصفية الارتباط لاستخدامها لأنواع الارتباطات التي تم تعريفها لمجموعة فريق المشروع. نوع العنصر هو النوع المعقد : WorkItemLinkFiltersType.
	FilterType	سمة WorkItemLinkFilters مطلوبة. تعريف الأسلوب المستخدم لتصفية مجموعة أنواع الارتباطات المتوفرة في المجموعة Filter عناصر. نوع العنصر هو النوع المعقد : LinksControlFilterKind. القيم الصالحة التي يمكنك استخدامها هى . exclude: استخدام صواب لعدم السماح بإنشاء للارتباطات من أنواع الارتباطات تلك المسرودة فيFilter عناصر. excludeAll:لعدم السماح بإنشاء للارتباطات من جميع الأنواع include: تستخدم للسماح فقط لتلك الأنواع من الارتباطات في تصفية العلامات. includeAll: تستخدم للسماح لإنشاء للارتباطات من كافة أنواع الارتباط .
Filter		مطلوب WorkItemLinkFilters العنصر عند FilterType يتم exclude أو include. عند FilterType يتم excludeAll أو includeAll ، لا Filter يجب أن يتم تعيين عناصر. تعين أنواع الارتباطات لتضمينها أو استثناؤها من مجموعة الارتباطات التي يمكن إنشاؤها لعنصر العمل. نوع العنصر هو النوع المعقد : WorkItemLinkFilterElementType.
	LinkType	سمة Filter مطلوبة. يحدد اسم المرجع لنوع من الارتباط. نوع السمة هو typelib:ReferenceFieldName. لمزيد من المعلومات، راجع العمل مع أنواع ارتباط.
	FilterOn	سمة Filter اختيارية. تعيّن نوع عامل التصفية لتطبيقة صواب لنوع الارتباط. نوع العنصر هو النوع المعقد : LinksControlFilterKind. القيم الصالحة هي : forwardName: استخدامها لتصفية على الاسم إامعاد توجيهة المعرف لنوع من الارتباط. revserseName: استخدامها لتصفية على العكس الاسم المعرف لنوع من الارتباط. في حال عدم تعيينها، كلا الأسماء الامامية و العكسية تستخدم صواب لتصفية نوع الارتباط. ملاحظة إذا كان طبولوجيا نوع الارتباط هو الشبكة ،الأسماء الاماميةوالعكسية هي نفسها.لمزيد من المعلومات، راجع العمل مع أنواع ارتباط.
ExternalLinkFilters		العنصر LinksControlOptionsالإختيارى. يوفر حاوية أو أكثر من عناصر Filter التى تحدد معايير التصفية لاستخدامها لأنواع الارتباطات التي تم تعريفها فى مشاريع الفرسق الأخرى. نوع العنصر هو النوع المعقد : ExternalLinkFiltersType.
	FilterType	سمة ExternalLinkFilters اختيارية. تعريف الأسلوب المستخدم لتصفية مجموعة أنواع الارتباطات المتوفرة في المجموعة Filter عناصر. نوع العنصر هو النوع المعقد : LinksControlFilterKind. القيم الصالحة التي يمكنك استخدامها هى . exclude: استخدام صواب لعدم السماح بإنشاء للارتباطات من أنواع الارتباطات تلك المسرودة فيFilter عناصر. excludeAll:لعدم السماح بإنشاء للارتباطات من جميع الأنواع include: يستخدم للسماح فقط لتلك أنواع الارتباطات المدرجة فىFilter عناصر. includeAll: تستخدم للسماح لإنشاء للارتباطات من كافة أنواع الارتباط . في حال عدم تعيينها، لذلك كافة الارتباطات لعناصر العمل الخارجي تستبعد .
Filter		مطلوب ExternalLinkFilters العنصر عند FilterType يتم exclude أو include. عند FilterType يتم excludeAll أو includeAll ، لا Filter يجب أن يتم تعيين عناصر. نوع العنصر هو النوع المعقد : ExternalLinkFilterElementType. تعين أنواع الارتباطات لتضمينها أو استثناؤها من مجموعة الارتباطات التي يمكن إنشاؤها لعنصر العمل.
	LinkType	سمة Filter مطلوبة. تعيين اسم المرجع لنوع من الارتباط لاستبعاد أو تضمينها. نوع السمة هو نوع بسيط . ExternalLinkTypeName. لمزيد من المعلومات، راجع العمل مع أنواع ارتباط.
WorkItemTypeFilters		العنصر LinksControlOptionsالإختيارى. يوفر حاوية أو أكثر من عناصر Filter التى تحدد معايير التصفية لتطبيقها على أنواع عنصر العمل. نوع العنصر هو النوع المعقد : LinksControlWorkItemTypeFiltersElementType.
	Scope	سمة WorkItemTypeFilters اختيارية. يعرّف نطاق عامل التصفية المطبق على مجموعة أنواع عناصر العمل المتوفرة في المجموعة Filter العلامات. نوع العنصر هو النوع المعقد : LinksControlWorkItemTypeFilterScopeKind. القيم الصالحة التي يمكنك استخدامها هى . all: يستخدم للسماح لإنشاء الارتباطات لكافة أنواع عناصر العمل المحددة فيFilter العلامات. project: تستخدم للسماح لإنشاء ارتباطات فقط لتلك الأنواع من عناصر العمل المعرّفة من أجل المشروع الحالي. في حال عدم تعيينها، لذلك الارتباطات لكافة أنواع عناصر العمل يسمح بها.
	FilterType	سمة WorkItemTypeFilters مطلوبة. تعريف الأسلوب المستخدم لتصفية مجموعة أنواع الارتباطات المتوفرة في المجموعة Filter عناصر. نوع العنصر هو النوع المعقد : LinksControlWorkItemTypeFilterKind. القيم الصالحة التي يمكنك استخدامها هى . exclude: يستخدم لعدم السماح بإنشاء ارتباطات لأنواع عانصر العمل المحددة فيFilter العلامات. include: يستخدم لعدم السماح بإنشاء ارتباطات لأنواع عانصر العمل المحددة فيFilter العلامات. includeAll: تستخدم للسماح لإنشاء للارتباطات من كافة أنواع الارتباط . في حال عدم تعيينها، لذلك الارتباطات لكافة أنواع عناصر العمل يسمح بها.
Filter		اختياري WorkItemTypeFilters عنصر عند FilterType يتم exclude أو include. عند FilterType يتم includeAll ، لا Filter يجب أن يتم تعيين tags. تحدد أنواع عناصر العمل التي يتم تضمينها أو استثناؤها من مجموعة أنواع عناصر العمل التي يمكن ربطها ل. نوع العنصر هو النوع المعقد : LinksControlWorkItemTypeFiltersElementType.
	WorkItemType	سمة Filter مطلوبة. تعيّن الاسم لنوع عنصر العمل لتتم تصفيته. نوع السمة هو . typelib:NonEmptyPlainConstant. الحد الأدنى للطول: 1; أقصى طول: 255. نموذج القيمة: ^[^\\]*$ مثال نموذج القيمة: المهمة
LinkColumns		العنصر LinksControlOptionsالإختيارى. يوفر حاوية لواحد أو أكثر من علامات LinkColumn . نوع العنصر هو النوع المعقد : LinkColumnsType.
LinkColumn		عنصر LinkColumnsالمطلوب. تعيّن حقل عنصر العمل سمات نوع الارتباط المعروضة لقائمة الارتباطات المعرّفة من أجل عنصر عمل . نوع العنصر هو النوع المعقد : LinkColumnType. هذا قائمة العمود هو العرض الافتراضي. يمكن للمستخدم إضافة الأعمدة وإزالتها من قائمة الارتباط. الترتيب LinkColumn العناصر المسرودة تحدد الترتيب الذي يتم عرض حقول الأعمدة في نموذج العمل عنصر .
	RefName	سمة LinkColumn اختيارية. تحديد RefName أو LinkAttribute ، وليس كلاهما. تعيين اسم المرجع المتوافق مع عنصر الحقل لمجموعة فريق العمل. نوع السمة هو typelib:ReferenceFieldName.
	LinkAttribute	سمة LinkColumn اختيارية. تحديد RefName أو LinkAttribute ، وليس كلاهما. تعيين اسم المرجع المطابق لأي سمة لنوع ارتباط صالح لمجموعة فريق المشروع. نوع السمة هو typelib:ReferenceFieldName.

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

العنصر	الوصف
عنصر تحكم (مخطط تعريف نوع عنصر عمل)	العنصر المطلوب. يعرّف حقل النص أو الارتباط التشعبي أو عنصر تحكم آخر لتظهر على نموذج عنصر العمل.

ملاحظات

LinksControlOptions هو عنصر اختياري تابع لـ Control, ControlType="LinksControl" و . يمكنك استخدام عنصر LinksControlOptionsليعتمد الإجراءات التالية:

• تحديد القيود التي تريدها حتى يمكن إنشاء الارتباطات استناداً إلى نوع الارتباط واختيارياً الأسماء الامامية و العكسية لانواع الارتباط.

• تحديد القيود التي تريد إنشاء الارتباطات التي تستند إلى أنواع الارتباط الخارجي المعرفة في فريق المشاريع ال الأخرى.

• حدد القيود المرغوب وضعها على أنواع عناصر العمل التي يمكن ربطها.

• تحديد حقول العمود الافتراضي الذي تريد عرضه لمعلومات قائمة الارتباط.

مثال

يحدد المثال التالي كيفية تمكين إنشاء ارتباطات نوعها هو Microsoft.VSTS.Common.TestedBy وإظهار Forward Name لهذا النوع من الارتباط. خيارات التصفية لعدم السماح بإنشاء ارتباطات لكافة أنواع الارتباط الخارجي. بالإضافة إلى ذلك ,عرض حقول الأعمدة الافتراضية ، على الارتباطات التى تتوافق مع الأسماء المألوفة التالية: المعرف,و نوع عنصر العمل, العنوان, معين الى ، حالة, و حقل تعليق المعيف للارتباط.

<Control Type="LinksControl" Name="TestedBy" Label="&amp;Work items testing this bug:" LabelPosition="Top">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="include">
         <Filter LinkType="Microsoft.VSTS.Common.TestedBy" FilterOn="forwardname" />
      </WorkItemLinkFilters>
      <WorkItemTypeFilters FilterType="include">
          <Filter WorkItemType="Test Case" />
      </WorkItemTypeFilters>
          <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>

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

• LinksControlOptionsType.

• WorkItemLinkFiltersType.

• WorkItemLinkFilterElementType.

• ExternalLinkFiltersType.

• ExternalLinkFilterElementType.

• LinksControlFilterKind.

• LinksControlFilterKind.

• ExternalLinkTypeName.

• LinksControlWorkItemTypeFiltersElementType.

• LinksControlWorkItemTypeFiltersElementType.

• LinksControlWorkItemTypeFilterScopeKind.

• LinksControlWorkItemTypeFilterKind.

• LinkColumnsType.

• LinkColumnType.

LinksControlOptionsType.

<xs:complexType name="LinksControlOptionsType">
   <xs:all>
      <xs:element name="LinkColumns" type="LinkColumnsType" minOccurs="0" maxOccurs="1" />
      <xs:element name="WorkItemLinkFilters" type="WorkItemLinkFiltersType" minOccurs="0" maxOccurs="1"/>
      <xs:element name="ExternalLinkFilters" type="ExternalLinkFiltersType" minOccurs="0" maxOccurs="1" />
      <xs:element name="WorkItemTypeFilters" type="LinksControlWorkItemTypeFiltersElementType" minOccurs="0" maxOccurs="1" />
   </xs:all>
</xs:complexType>

WorkItemLinkFiltersType.

<xs:complexType name="WorkItemLinkFiltersType" >
   <xs:sequence>
      <xs:element name="Filter" type="WorkItemLinkFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
   </xs:sequence>
      <xs:attribute name="FilterType" type="LinksControlFilterKind" use="required" />
</xs:complexType>

WorkItemLinkFilterElementType.

<xs:complexType name="WorkItemLinkFilterElementType" >
   <xs:attribute name="LinkType" type="typelib:ReferenceFieldName" use="required" />
   <xs:attribute name="FilterOn" type="LinksControlFilterOnKind" use="optional" />
</xs:complexType>

ExternalLinkFiltersType.

<xs:complexType name="ExternalLinkFiltersType" >
   <xs:sequence>
      <xs:element name="Filter" type="ExternalLinkFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
   </xs:sequence>
      <xs:attribute name="FilterType" type="LinksControlFilterKind" use="required" />
</xs:complexType>

ExternalLinkFilterElementType.

<xs:complexType name="ExternalLinkFilterElementType" >
   <xs:attribute name="LinkType" type="ExternalLinkTypeName" use="required" />
</xs:complexType>

LinksControlFilterKind.

<xs:simpleType name="LinksControlFilterKind">
   <xs:restriction base="xs:string">
      <xs:enumeration value="include" />
      <xs:enumeration value="exclude" />
      <xs:enumeration value="includeAll" />
      <xs:enumeration value="excludeAll" />
   </xs:restriction>
</xs:simpleType>

LinksControlFilterKind.

<xs:simpleType name="LinksControlFilterOnKind">
   <xs:restriction base="xs:string">
      <xs:enumeration value="forwardname" />
      <xs:enumeration value="reversename" />
   </xs:restriction>
</xs:simpleType>

ExternalLinkTypeName.

<xs:simpleType name="ExternalLinkTypeName">
   <xs:restriction base="xs:string">
      <xs:minLength value="1"/>
      <xs:maxLength value="128"/>
   </xs:restriction>
</xs:simpleType>

LinksControlWorkItemTypeFiltersElementType.

<xs:complexType name="LinksControlWorkItemTypeFiltersElementType" >
   <xs:sequence>
      <xs:element name="Filter" type="LinksControlWorkItemTypeFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
   </xs:sequence>
      <xs:attribute name="Scope" type="LinksControlWorkItemTypeFilterScopeKind" use="optional" />
      <xs:attribute name="FilterType" type="LinksControlWorkItemTypeFilterKind" use="required" />
</xs:complexType>

LinksControlWorkItemTypeFiltersElementType.

<xs:complexType name="LinksControlWorkItemTypeFilterElementType" >
   <xs:attribute name="WorkItemType" type="typelib:NonEmptyPlainConstant" use="required" />
</xs:complexType>

LinksControlWorkItemTypeFilterScopeKind.

<xs:simpleType name="LinksControlWorkItemTypeFilterScopeKind">
   <xs:restriction base="xs:string">
   <xs:enumeration value="project" />
   <xs:enumeration value="all" />
</xs:restriction>
</xs:simpleType>

LinksControlWorkItemTypeFilterKind.

<xs:simpleType name="LinksControlWorkItemTypeFilterKind">
   <xs:restriction base="xs:string">
      <xs:enumeration value="include" />
      <xs:enumeration value="exclude" />
      <xs:enumeration value="includeAll" />
   </xs:restriction>
</xs:simpleType>

LinkColumnsType.

<xs:complexType name="LinkColumnsType" >
   <xs:sequence>
      <xs:element name="LinkColumn" type="LinkColumnType" minOccurs="1" maxOccurs="unbounded"/>
   </xs:sequence>
</xs:complexType>

LinkColumnType.

<xs:complexType name="LinkColumnType" >
   <!-- Must be one or the other, but not both -->
      <xs:attribute name="LinkAttribute" type="typelib:ReferenceFieldName" use="optional" />
      <xs:attribute name="RefName" type="typelib:ReferenceFieldName" use="optional" />
</xs:complexType>

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

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

راجع أيضًا:

المبادئ

العمل مع أنواع ارتباط

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

موارد أخرى

يتم تخصيص "كيفية عمل العناصر" ذات الصلة خلال "أنواع ارتباط"

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