定義連結控制項以限制連結關聯性

發行項
03/12/2013

更新：2012 年 9 月

您可以自訂工作表單，藉此控制哪些工作項目彼此連結。具體來說，您可以控制使用者可在連結控制中檢視及加入的連結和工作項目類型。例如，您可能想要將索引標籤加入至表單，以協助管理相依功能。在該索引標籤上，您可以加入連結控制，並限制小組成員可從該控制項檢視及設定的連結關聯性，使其只包含其他功能的連結。

使用 Control 項目 LinksControlType 屬性就可以讓使用者在工作項目和 Team Foundation 資料庫中的其他物件之間建立連結關聯性。然後您可以使用 LinksControlOptions 子項目來定義選項，以控制小組成員可加入至工作項目的連結，以及他們可連結至何種工作項目類型或物件。您也可以定義想要在該控制項之連結清單中顯示的預設資料行。

如需為 Microsoft Solutions Framework (MSF) for Agile Software Development v5.0 流程範本定義之連結限制的摘要，請參閱連結的工作項目、連結控制項和限制。如需連結類型的詳細資訊，請參閱連結類型項目參考。

本主題內容

指定 Links 控制項
控制連結關聯性
限制工作項目的連結關聯性
限制變更集、超連結和其他非工作項目的連結關聯性
限制工作項目類型的連結關聯性
指定要顯示的預設資料行

指定 Links 控制項

使用 LinksControl 選項可以讓使用者能夠在工作項目表單中加入、檢視及管理連結關聯性。您可以使用這個控制項來開啟、編輯、加入及移除連結。

您可以自訂表單，讓一個索引標籤僅顯示父連結和子連結，而另一個索引標籤顯示所有其他連結類型。在下列範例中，會建立標示為 "All Links" 的索引標籤，小組成員可使用這個索引標籤加入所有連結類型。此外，連結會顯示的預設資料行是 [ID]、[工作項目類型]、[標題]、[指派給]、[狀態] 和 [連結註解] 欄位。

Links 控制項

加入至工作項目表單的連結控制項範例

<Tab Label="All Links">
   <Control Type="LinksControl" Name="All" >
      <LinksControlOptions>
         <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>

回到頁首

控制連結關聯性

當您將連結控制項加入至工作項目表單時，您可以指定篩選條件，以限制小組成員在使用該控制項時可加入的連結和工作項目類型。下表描述控制連結關聯性的選擇性子項目。

元素	描述
WorkItemLinkFilters	限制可用來連結至工作項目的連結類型。
ExternalLinkFilters	限制可以用來連結至非工作項目類型之物件 (例如變更集、超連結或版本控制項目) 的連結類型。
WorkItemTypeFilters	限制使用者可連結的工作項目類型，以及定義這些工作項目的 Team 專案。
Filter	指定要包含或排除的連結類型或工作項目類型。

回到頁首

限制工作項目的連結關聯性

使用 WorkItemLinkFilters 和 Filter 子項目可以定義連結控制應該包含或排除的連結類型。您使用這個項目來限制連結控制可選取的連結類型，以建立定義在相同專案中之工作項目的關聯性。這些項目的語法如下。

<WorkItemLinkFilters FilterType="include | exclude | includeAll | excludeAll">
   <Filter LinkType="linkTypeRefName" FilterOn="reversename | forwardname" />
</WorkItemLinkFilters>

屬性	描述
FilterType	必要的 WorkItemLinkFilters 屬性。定義用來篩選 Filter 項目集中所提供之連結類型集的方法。您可使用下列有效值： exclude：用於防止從 Filter 項目所列的連結類型建立連結。 excludeAll：用於禁止所有連結類型。 include：用於只允許 Filter 項目所列的連結類型。 includeAll：用於允許從所有連結類型建立連結。
LinkType	必要的 Filter 屬性。指定連結類型的參考名稱。如需詳細資訊，請參閱連結類型項目參考。
FilterOn	選擇性 Filter 屬性。指定要套用到連結類型的篩選條件類型。您可使用下列有效值： forwardname：用來篩選為連結類型定義的正向名稱。 reversename：用來篩選為連結類型定義的反向名稱。如果未指定，會使用正向及反向名稱來篩選連結類型。如果連結類型拓撲是網路，則正向及反向名稱是相同的。如需詳細資訊，請參閱連結類型項目參考。

FilterType

必要的 WorkItemLinkFilters 屬性。

定義用來篩選 Filter 項目集中所提供之連結類型集的方法。您可使用下列有效值：

exclude：用於防止從 Filter 項目所列的連結類型建立連結。
excludeAll：用於禁止所有連結類型。
include：用於只允許 Filter 項目所列的連結類型。
includeAll：用於允許從所有連結類型建立連結。

LinkType

必要的 Filter 屬性。

指定連結類型的參考名稱。如需詳細資訊，請參閱連結類型項目參考。

FilterOn

選擇性 Filter 屬性。

指定要套用到連結類型的篩選條件類型。您可使用下列有效值：

forwardname：用來篩選為連結類型定義的正向名稱。
reversename：用來篩選為連結類型定義的反向名稱。

如果未指定，會使用正向及反向名稱來篩選連結類型。如果連結類型拓撲是網路，則正向及反向名稱是相同的。如需詳細資訊，請參閱連結類型項目參考。

範例：排除兩個工作項目連結類型

您可以使用下列程式碼範例定義，此連結控制除了一個自訂需求連結類型和系統階層連結類型以外，允許所有連結類型的連結關聯性。

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="exclude">
         <Filter LinkType="MyLinks.LinkTypes.Requirement" /> 
         <Filter LinkType="System.LinkTypes.Hierarchy" /> 
      </WorkItemLinkFilters>
      <ExternalLinkFilters FilterType="excludeAll" /> 
   </LinksControlOptions>
. . .
</Control>

回到頁首

限制變更集、超連結和其他非工作項目的連結關聯性

使用 ExternalLinkFilters 和 Filter 子項目，可以定義哪些 Team 專案外部項目的連結類型，連結控制應該加以包含或排除。這些項目的語法如下。

<ExternalLinkFilters FilterType="include | exclude | includeAll | excludeAll">
   <Filter LinkType="externalLinkName" />
</ExternalLinkFilters>

屬性	描述
FilterType	選擇性 ExternalLinkFilters 屬性。定義用來篩選 Filter 項目集中所提供之連結類型集的方法。您可使用下列有效值： exclude：用於禁止從 Filter 項目所列的連結類型建立連結。 excludeAll：用於禁止所有連結類型。 include：用於只允許 Filter 項目所列的連結類型。 includeAll：用於允許從所有連結類型建立連結。如果未指定，會排除外部工作項目的所有連結。
LinkType	必要的 Filter 屬性。指定要排除或包含之連結類型的參考名稱。您可以指定下列連結類型：固定於變更集結果附件原始程式碼檔測試結果工作項目超連結

FilterType

選擇性 ExternalLinkFilters 屬性。

定義用來篩選 Filter 項目集中所提供之連結類型集的方法。您可使用下列有效值：

exclude：用於禁止從 Filter 項目所列的連結類型建立連結。
excludeAll：用於禁止所有連結類型。
include：用於只允許 Filter 項目所列的連結類型。
includeAll：用於允許從所有連結類型建立連結。

如果未指定，會排除外部工作項目的所有連結。

LinkType

必要的 Filter 屬性。

指定要排除或包含之連結類型的參考名稱。您可以指定下列連結類型：

固定於變更集
結果附件
原始程式碼檔
測試結果
工作項目超連結

範例：排除所有非工作項目連結

下列範例定義連結控制，以包含工作項目 (例如相關和父子式) 的所有連結類型，但排除非工作項目 (例如變更集、超連結和測試結果) 的連結類型。

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="includeAll" /> 
      <ExternalLinkFilters FilterType="excludeAll" /> 
   </LinksControlOptions>
</Control>

下列範例定義連結控制項，以允許使用者只指定變更集連結類型以及只連結至變更集。

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="excludeAll"/>
      <ExternalLinkFilters FilterType="include" /> 
         <Filter LinkType="Fixed in Changeset" />
      </ExternalLinkFilters> 
 </LinksControlOptions>
. . .
</Control>

回到頁首

限制工作項目類型的連結關聯性

使用 WorkItemTypeFilters 和 Filter 子項目可以限制連結控制可連結的工作項目類型。您可以限制 Team 專案或工作項目類型的連結關聯性。這些項目的語法如下。

<WorkItemTypeFilters Scope=" project | all" FilterType=" include | exclude | includeAll" >
   <Filter WorkItemType="workItemTypeReferenceName" />
</WorkItemTypeFilters>

屬性	描述
Scope	選擇性 WorkItemTypeFilters 屬性。定義要套用至 Filter 項目集中所提供之工作項目類型集的篩選範圍。您可使用下列有效值： all：用來允許對 Filter 項目指定的所有工作項目類型建立連結。 project：用來允許只對為了目前專案所定義的工作項目類型建立連結。如果未指定，則允許所有工作項目類型的連結。
FilterType	必要的 WorkItemTypeFilters 屬性。定義用來篩選 Filter 項目集中所提供之連結類型集的方法。您可使用下列有效值： exclude：用於禁止 Filter 項目所列的工作項目類型。 excludeAll：用於禁止所有工作項目類型。 include：用於允許 Filter 項目所列的工作項目類型。 includeAll：用於允許所有工作項目類型。
WorkItemType	必要的 Filter 屬性。指定工作項目類型的參考名稱。

Scope

選擇性 WorkItemTypeFilters 屬性。

定義要套用至 Filter 項目集中所提供之工作項目類型集的篩選範圍。您可使用下列有效值：

all：用來允許對 Filter 項目指定的所有工作項目類型建立連結。
project：用來允許只對為了目前專案所定義的工作項目類型建立連結。

如果未指定，則允許所有工作項目類型的連結。

FilterType

必要的 WorkItemTypeFilters 屬性。

定義用來篩選 Filter 項目集中所提供之連結類型集的方法。您可使用下列有效值：

exclude：用於禁止 Filter 項目所列的工作項目類型。
excludeAll：用於禁止所有工作項目類型。
include：用於允許 Filter 項目所列的工作項目類型。
includeAll：用於允許所有工作項目類型。

WorkItemType

必要的 Filter 屬性。

指定工作項目類型的參考名稱。

範例：限制「工作」工作項目的連結關聯性

下列範例定義連結控制，只允許建立定義於 Team 專案之工作的階層式關聯性。

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="include">
         <Filter LinkType="System.LinkTypes.Hierarchy" />
      </WorkItemLinkFilters>
      <ExternalLinkFilters FilterType="excludeAll"/>
      <WorkItemTypeFilters Scope ="project" FilterType="include" />
         <Filter WorkItemType="Task" />
      </WorkItemTypeFilters> 
   </LinksControlOptions>
. . .
</Control>

回到頁首

指定要顯示的預設資料行

使用 LinkColumns 和 LinkColumn 子項目可以指定要在連結控制中顯示的預設資料行。您可以指定工作項目欄位的參考名稱或連結屬性。這些項目的語法如下。

<LinkColumns>
   <LinkColumn RefName="reference name" | LinkAttribute=" link attribute name" />
</LinkColumns>

項目列示的順序定義工作項目表單內顯示資料行欄位的順序。如需參考名稱和連結屬性的清單，請參閱Visual Studio ALM 的工作項目欄位參考。下列語法定義四個資料行的顯示：[ID]、[狀態]、[標題] 和 [連結屬性註解]。

<Control Type="LinksControl">
. . .
   <LinksControlOptions>
      <LinkColumns>
         <LinkColumn RefName="System.ID" />
         <LinkColumn RefName="System.State" />
         <LinkColumn RefName="System.Title" />
         <LinkColumn LinkAttribute="System.Links.Comment" />
      </LinkColumns>
   </LinksControlOptions>
</Control>

回到頁首

請參閱

參考

LinksControlOptions 項目

概念

連結的工作項目、連結控制項和限制

連結類型項目參考

指定工作項目表單控制項

變更記錄

日期	記錄	原因
2012 年 9 月	已更正語法案例結構。所有的列舉值會區分大小寫。	內容 Bug 修正。

2012 年 9 月

已更正語法案例結構。所有的列舉值會區分大小寫。

內容 Bug 修正。

共用方式為

定義連結控制項以限制連結關聯性

指定 Links 控制項

控制連結關聯性

限制工作項目的連結關聯性

限制變更集、超連結和其他非工作項目的連結關聯性

限制工作項目類型的連結關聯性

指定要顯示的預設資料行

請參閱

參考

概念

變更記錄

其他資源