自訂工作面板頁面

發行項
02/28/2013

您可以自訂 Team Web Access 的工作面板以指定不同型別的工作項目，並且增加頁面上顯示工作項目的數目。例如，除了工作之外，您可能會想要將 bug 的資訊加入工作面板中。藉著工作面板，您的小組可以更新工作項目和報告進度。顯示的工作項目包含指派給目前反覆項目與其父項目的所有工作，不論父代指派的反覆項目為何。若要進一步了解如何使用工作面板，請參閱執行反覆項目。

如果您的 Team 專案使用 Visual Studio Application Lifecycle Management (ALM) 提供的流程範本以外或您已經自訂工作項目的類型定義或修改了它們的工作流程，您可能需要自訂一個流程設定的定義檔。

本主題內容

顯示在工作面板頁面的工作項目
資料行標題與資料行順序
待處理項目的排序次序。
可以出現在工作面板頁面的項目數目。

需求

若要運行 witadmin 命令列工具，您必須是專案的 [Team Foundation Administrators] 群組成員或 [Project Administrators] 群組成員。如需詳細資訊，請參閱Team Foundation Server 使用權限。
若要檢視工作面板，則您必須將 Team Web Access 權限設為 [標準]。可能還會有其他授權需求。如需詳細資訊，請參閱存取 Team Web Access 中的功能。

顯示在工作面板頁面的工作項目

下列項目決定哪些工作項目會顯示在工作面板頁面。

待處理項目對應到指派給要求分類的工作項目。只有指派給目前的反覆項目或將工作指派給目前反覆項目中的待處理項目才會出現在工作面板上。它們可以在任何的工作流程狀態。
可以當成子系工作的工作項目加到待處理項目對應到指派給工作分類的工作項目類型。

只有被指派到目前反覆項目的工作才出現在工作面板上。

工作會出現在工作流程狀態下的資料行標題。當您從一個資料行拖放工作到另一個資料行，狀態欄位會自動更新。

注意事項
如果您將工作項目類別加入至工作分類，請務必將您用來追蹤工作的工作項目類型定義加入至欄位裡。

若要指定工作項目類型的外觀。

若要執行 witadmin 命令列工具，請在安裝 Visual Studio 或 Team Explorer 的系統中開啟命令提示字元視窗，並輸入：
```
cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE
```
在 Windows 64 位元版本中，將 %programfiles% 取代為 %programfiles(x86)%。
輸入替換成您的資料的下列命令是此處顯示的引數，其中 CollectionURL 指定 Team 專案集合的 URL， ProjectName 指定集合內定義的 Team 專案名稱，然後DirectoryPath 指定名稱和位置以檔案可以匯出。接著選取 [輸入]。
```
witadmin exportcategories /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\categories.xml"
```
開啟類別檔在記事本中，並設置 "Task Category"的 CATEGORY 項目。

若要加入新類別的工作項目類型，請加入指定另一個工作項目類型的易記名稱的 WORKITEMTYPE 項目。

例如，下列語法加入「Bug」的工作項目類型至使用 Agile 流程範本 Team 專案的工作分類。

<CATEGORY name="Task Category" refname="Microsoft.TaskCategory">
   <DEFAULTWORKITEMTYPE name="Task" />
   <WORKITEMTYPE name="Bug" />
</CATEGORY>

提示
您必須指定為 Team 專案所定義的工作項目類型。一個工作項目類型可以屬於多個分類。不過，您無法指定已經屬於「需求分類」的工作項目類型。

輸入下列命令以匯入定義檔:

witadmin importcategories /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\categories.xml"

若要指派 metastaes 至工作項目的工作類型的工作流程狀態

從 witadmin的命令提示字元視窗，請輸入下列命令，以您的資料由此處顯示的引數，其中 CollectionURL 指定 Team 專案集合的 URL， ProjectName 指定集合內定義的 Team 專案名稱，然後， DirectoryPath 指定名稱和位置以檔案可以匯出。接著選取 [輸入]。
```
witadmin exportcommonprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\CommonConfiguration.xml"
```

在記事本中開啟 CommonConfiguration 檔案，並設置 TaskWorkItems 項目。

例如，針對 Agile 流程範本，下列語法會出現:

<TaskWorkItems category="Microsoft.TaskCategory">
   <States>
      <State value="New" type="Proposed" />
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
   </States>
</TaskWorkItems>

工作面板會顯示 [新增]、 [作用中] 和 [已關閉] 的資料行行首。

(選擇性) 若要包含其他工作項目類型的工作流程狀態，例如 bug，您必須指派 [已解析] 的工作流程狀態。

例如，您可以更新 <TaskWorkItems> 以包含連結到待處理項目指派到 bug 和工作的 metastate。在下列語法中， Resolved 工作流程狀態被指派給 InProgress metastate。

<TaskWorkItems category="Microsoft.TaskCategory">
   <States>
      <State value="New" type="Proposed" />
      <State value="Active" type="InProgress" />
      <State value="Resolved" type="InProgress" />
      <State value="Closed" type="Complete" />
   </States>
</TaskWorkItems>

重要事項
您必須為對應到有效的工作流程狀態的 State 項目所指定的值。在此情況下，有效的工作流程狀態是一個已經被定義給一個包含在您 Team 專案之工作分類的工作項目類型的狀態。此外，您必須在 Agile 群組內指派一個 metastate type，也就是 Proposed，InProgress 和 Complete。如需對於每一個狀態的說明，請參閱工作流程狀態、metastates 和管理設定。

您必須為對應到有效的工作流程狀態的 State 項目所指定的值。在此情況下，有效的工作流程狀態是一個已經被定義給一個包含在您 Team 專案之工作分類的工作項目類型的狀態。此外，您必須在 Agile 群組內指派一個 metastate type，也就是 Proposed，InProgress 和 Complete。如需對於每一個狀態的說明，請參閱工作流程狀態、metastates 和管理設定。

輸入下列命令以匯入定義檔:

witadmin importcommonprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\CommonConfiguration.xml"

按 F5 重新整理 Team Web Access 頁面以反映變更。

回到頁首

資料行和資料行順序

顯示在工作面板頁面中的資料行標題與工作流程狀態指派到預設工作型別指派到的工作分類互相對應。資料行順序對應到工作流程轉換的自然進展順序，從左至右移動。在工作分類中為預設工作類別定義的工作流程狀態必須被指派到一個在 Agile 全組裡有效的 metastate。如同在工作流程狀態、metastates 和管理設定所述。

您不需要修改資料行的配置。

回到頁首

待處理項目的排序次序。

待處理項目會根據欄位指派給 CommonConfiguration 定義 type="Order" 的值依遞增順序列出。這個欄位會控制待處理項目中出現在反覆項目和工作面板頁面的項目順序。

若要指定不同的欄位使用以排序待處理項目

從 witadmin的命令提示字元視窗，請輸入下列命令，以您的資料由此處顯示的引數，其中 CollectionURL 指定 Team 專案集合的 URL， ProjectName 指定集合內定義的 Team 專案名稱，然後， DirectoryPath 指定名稱和位置以檔案可以匯出。接著選取 [輸入]。
```
witadmin exportcommonprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\CommonConfiguration.xml"
```
在記事本中開啟 CommonConfiguration 檔案，並透過 type="Order" 尋找 TypeField 項目。

例如，Agile 流程範本的預設指派為:
```
<TypeField refname="Microsoft.VSTS.Common.StackRank" type="Order" />
```
將指派給 refname 的值到您要根據排序次序的欄位。

例如，下列語法會指定依據自訂欄位排序的待處理項目， Fabrikam.Order。
```
<TypeField refname="Fabrikam.Order" type="Order" />
```
重要事項

您必須指定由 Team 專案的需求分類所定義的工作項目的預設類型之欄位的參考名稱。

重要事項
您必須指定由 Team 專案的需求分類所定義的工作項目的預設類型之欄位的參考名稱。

輸入下列命令以匯入定義檔:

witadmin importcommonprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\CommonConfiguration.xml"

按 F5 重新整理 Team Web Access 頁面以反映變更。

回到頁首

可以出現在工作面板頁面的項目數目。

基於效能考量，工作面板會預設限制最多 500 個工作項目。當您開啟工作面板時，所有的工作項目會載入至快取。限制工作項目的數目可以減少載入的時間。您可以變更這個限制透過指定 IterationBacklog 項目的 workItemCountLimit 屬性的值。

從 witadmin的命令提示字元視窗，請輸入下列命令，以您的資料由此處顯示的引數，其中 CollectionURL 指定 Team 專案集合的 URL， ProjectName 指定集合內定義的 Team 專案名稱，然後， DirectoryPath 指定名稱和位置以檔案可以匯出。接著選取 [輸入]。
```
witadmin exportagileprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\AgileConfiguration.xml"
```
在記事本中開啟 AgileConfigurations 檔案，然後找出 IterationBacklog 的部分。
提供 workItemCountLimit 屬性的值。

例如，下列語法會增加計數到 800。
```
<IterationBacklog workItemCountLimit="800">
. . .
  </IterationBacklog>
```

輸入下列命令以匯入定義檔:

witadmin importagileprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\AgileConfiguration.xml"

按 F5 重新整理 Team Web Access 頁面以反映變更。

回到頁首

請參閱

概念

執行反覆項目

處理序組態 XML 項目參考

使用處理序組態自訂待處理項目和面板頁面

共用方式為

自訂工作面板頁面

顯示在工作面板頁面的工作項目

若要指定工作項目類型的外觀。

若要指派 metastaes 至工作項目的工作類型的工作流程狀態

資料行和資料行順序

待處理項目的排序次序。

若要指定不同的欄位使用以排序待處理項目

可以出現在工作面板頁面的項目數目。

請參閱

概念

其他資源