處理序組態 XML 項目參考

程序設定檔決定下列功能的配置和性質： 產品待辦項目和小組處理速度、 迭代項目中的待辦項目、小組容量和待執行工作圖表、 工作版面、 專案關係人意見和 我的工作。您可以從小組專案匯出像是[Agile設定]和[一般設定]的設定檔，或是從 Visual Studio Team Foundation Server 2012下載的流程範本存取它們。您可以藉由修改在[Agile設定]中指定的定義來自訂待辦項目頁面的配置，而您還可以藉由修改[一般設定]中指定的定義來自訂對一些功能都通用的區域。

如需瀏覽一些您可以自訂的功能，請參閱 使用處理序組態自訂待處理項目和面板頁面。

注意事項
如需有關小組使用待辦項目和工作版面頁面資訊，請參閱 敏捷式計劃和反覆項目。

本主題內容

• Agile設定：語法結構和項目

• 一般設定：語法結構和項目

Agile設定：語法結構和項目

您可以藉由修改在 AgileProjectConfiguration 項目中包含的項目來自訂待辦項目的頁面。若要自訂產品待辦項目頁面，請修改 ProductBacklog 項目內的項目，而若要自訂迭代待辦項目頁面，請修改 IterationBacklog 項目中包含的項目。

下列 XML 範例顯示在 AgileConfiguration.xml 檔案內定義Agile程序設定的程式碼結構。這個範例會對應至敏捷式軟體開發 (Agile Software Development)6.0版的MSF所定義的預設語法。

<?xml version="1.0" encoding="utf-8"?>
<AgileProjectConfiguration>
  <ProductBacklog>
    <Columns>
      <Column refname="System.Title" width="400" />
      <Column refname="System.State" width="100" />
      <Column refname="Microsoft.VSTS.Scheduling.StoryPoints" width="50" />
      <Column refname="System.IterationPath" width="200" />
    </Columns>
    <AddPanel>
      <Fields>
        <Field refname="System.Title" />
      </Fields>
    </AddPanel>
  </ProductBacklog>
  <IterationBacklog>
    <Columns>
      <Column refname="Microsoft.VSTS.Scheduling.StoryPoints" width="50" />
      <Column refname="System.Title" width="400" />
      <Column refname="System.State" width="100" />
      <Column refname="System.AssignedTo" width="100" />
      <Column refname="Microsoft.VSTS.Scheduling.RemainingWork" width="50" />
    </Columns>
  </IterationBacklog>
</AgileProjectConfiguration>

回到頁首

待辦項目頁面的 XML 項目

下表說明 AgileProjectConfiguration 根項目下的子項目。您可以使用這些項目來指定應該會出現於待辦項目頁面的資料行和欄位。

元素	描述和語法	備註
AddPanel	用來指定「快速加入」經驗的容器項目，欄位會在定義新待辦項目的面板區域中出現。 <AddPanel>     <Fields>        <Field . . . />        . . .    </Fields> </AddPanel>	必要項。只有一個執行個體。 您必須至少指定一個 Fields 項目。 「快速加入」經驗只出現在 Team Web Access的產品待辦項目頁面。
Column	指定欄位顯示為待辦項目頁面的資料行。 <Column refname="FieldReferenceName" width="FieldWidth" />	必要項。 對於每一個想要顯示在待辦項目清單頁面的資料行，您必須為定義工作項目類型(和代辦項目有關)的欄位指定參考名稱。您必須為欄位寬度指定一個正整數
Columns	指定 Column 項目的集合。 <Columns>    <Column . . . />    . . . </Columns>	必要項。一個執行個體僅屬於每個 IterationBacklog 和 ProductBacklog 父項目。 您必須指定想要顯示在產品待辦和迭代待辦項目頁面的資料行。
Field	指定出現在產品待辦項目頁面的面板中的欄位 <Field refname=”FieldReferenceName” />	必要項。在 Fields 父項目內的一個或多個項目。 當您定義工作項目類型加入至待辦項目時，您可以指定在安裝程序的 AddPanel 部分中欄位的值。 如下列程式碼範例所示，預設設定指定 [標題] 欄位做為單一的欄位顯示： <AddPanel>    <Fields>       <Field refname="System.Title" />    </Fields> </AddPanel>
Fields	指定 Field 項目的集合。 <Fields> <Field . . . />    . . . </Fields>	必要項。一個執行個體只為 AddPanel 父項目定義。 當您將項目加入至產品待辦項目中，指定你想要可以快速指定的欄位
IterationBacklog	用於自訂頁面配置的容器項目，該頁面會顯示指派給特定迭代項目的工作項目。 <IterationBacklog workItemCountLimit="MaximumLimit" >    <Columns> . . . </Columns>    . . .  </IterationBacklog >	必要項。只有一個執行個體。 您指定資料行數、行寬和填入這些頁面(顯示指派給迭代項目的待辦項目清單)每一行的欄位。 根據預設，工作面板限制在總和 500 個工作項目。您可以指定 workItemCountLimit 屬性的值來變更這項限制。
ProductBacklog	用於自訂頁面配置的容器項目，該頁面會顯示產品待辦項目並包含用來加入工作至待辦項目的面板。 <ProductBacklog>    <Columns> . . . </Columns>    <AddPanel> . . . </ AddPanel> </ProductBacklog >	必要項。只有一個執行個體。 您指定資料行數、行寬和填入這些頁面(顯示指派給產品待辦項目的待辦項目清單)每一行的欄位。產品待辦項目會顯示於待辦項目中所有的執行項目，包括那些指派給迭代項目的。

回到頁首

一般設定：語法結構和項目

您可以使用支援數個子項目的CommonProjectConfiguration 項目自訂工作版面頁面。TypeFields 指定用於工作項目型別的欄位以取得特定資訊。大部分的子項目，例如， RequirementWorkItems、 TaskWorkItems和 BugWorkItems 指定分類群組以連結被特定程序設定功能區域參考用的連結。

下列 XML 範例展示定義CommonConfiguration.xml檔案中的一般程序設定的程式碼結構。這個範例會對應至敏捷式軟體開發 (Agile Software Development)6.0版的MSF所定義的預設語法。

<?xml version="1.0" encoding="utf-8"?>
<CommonProjectConfiguration>
  <TypeFields>
    <TypeField refname="System.AreaPath" type="Team" />
    <TypeField refname="Microsoft.VSTS.Scheduling.RemainingWork" type="RemainingWork" format="format h" />
    <TypeField refname="Microsoft.VSTS.Common.StackRank" type="Order" />
    <TypeField refname="Microsoft.VSTS.Scheduling.StoryPoints" type="Effort" />
    <TypeField refname="Microsoft.VSTS.Common.Activity" type="Activity" />
    <TypeField refname="Microsoft.VSTS.Feedback.ApplicationStartInformation" type="ApplicationStartInformation" />
    <TypeField refname="Microsoft.VSTS.Feedback.ApplicationLaunchInstructions" type="ApplicationLaunchInstructions" />
    <TypeField refname="Microsoft.VSTS.Feedback.ApplicationType" type="ApplicationType">
        <TypeFieldValues>
            <TypeFieldValue value="Web application" type="WebApp" />
            <TypeFieldValue value="Remote machine" type="RemoteMachine" />
            <TypeFieldValue value="Client application" type="ClientApp" />
        </TypeFieldValues>
    </TypeField>
  </TypeFields>
  <RequirementWorkItems category="Microsoft.RequirementCategory" plural="Stories">
    <States>
      <State value="New" type="Proposed" />
      <State value="Active" type="InProgress" />
      <State value="Resolved" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </RequirementWorkItems>
  <TaskWorkItems category="Microsoft.TaskCategory">
    <States>
      <State value="New" type="Proposed" />
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </TaskWorkItems>
  <BugWorkItems category="Microsoft.BugCategory">
   <States>
        <State value="Active" type="InProgress" />
        <State value="Resolved" type="Resolved" />
        <State value="Closed" type="Complete" />
      </States> 
  </BugWorkItems>
  <FeedbackRequestWorkItems category="Microsoft.FeedbackRequestCategory" plural="Feedback Requests">
    <States>
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </FeedbackRequestWorkItems>
  <FeedbackResponseWorkItems category="Microsoft.FeedbackResponseCategory" plural="Feedback Responses">
    <States>
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </FeedbackResponseWorkItems>
  <Weekends>
    <DayOfWeek>Saturday</DayOfWeek>
    <DayOfWeek>Sunday</DayOfWeek>
  </Weekends>
</CommonProjectConfiguration>

回到頁首

共同區域的 XML 項目。

下表說明 CommonProjectConfiguration 項目的子項目。這些項目設定區域，該區域支援頁面顯示Team Web Access、 Team Explorer 和回應要求表單。

重要事項
指派給類別名稱的值必須對應於針對小組專案定義的分類群組。您可以在類別的定義檔指定分類群組。Visual Studio ALM 的最新版本定義了五個新的類別。如需詳細資訊，請參閱 類別，程序設定和停用工作項目的特定型別的建立。

元素	描述和語法	備註
BugWorkItems	指定對應至錯誤 (bug) 工作項目的類別和連結轉移狀態的待辦項目的工作流程狀態。 <BugWorkItems category=”CategoryName”>     <States>        <State . . . />        . . .    </States> </BugWorkItems	必要項。類別名稱 必須對應於針對小組專案定義的分類。
DayOfWeek	指定一周的某一天對應至一個非工作日。 <DayOfWeek>NameOfADay</DayOfWeek>	Weekends 項目的必要子系。 對應至英文，一週的有效名稱是：Sunday、Monday、Tuesday、Wednesday、Thursday、Friday和 Saturday。 注意事項 不論安裝的語言 Team Foundation Server，你必須以英文指定一週的日期。
FeedbackResponseWorkItems	指定對應工作項目用來擷取意見回應型別的類別，並連結轉移狀態項目的工作流程狀態。。	必要項。不要自訂。 類別名稱 必須對應於針對小組專案定義的分類群組。
FeedbackRequestWorkItems	指定對應於用來擷取回應要求的工作項目型別的類別，連結轉移狀態項目的工作流程狀態。	必要項。不要自訂。 類別名稱 必須對應於針對小組專案定義的分類群組。指定使用 Categories.xml 檔案的分類群組。
RequirementWorkItems	指定對應於待辦項目的類別，待辦項目例如使用者劇本、需求和產品待辦項目，並連結轉移狀態的待辦項目的工作流程狀態。 <RequirementWorkItems category="CategoryName" plural="NameOfBacklogItems" >    <States>       <State . . . />       . . .    </States> </RequirementWorkItems>	必要項。 類別名稱 必須對應於針對小組專案定義的分類群組。指定使用 Categories.xml 檔案的分類群組。
State	指定一個工作流程狀態到轉移狀態。轉移狀態表示為工作流程狀態的群組，工作流程狀態支援在工作面板上或其他程序設定元件的工作流程狀態管理。 <State type="TypeName" value="ValueName"/>	必要項。 型別名稱 的有效值會分別對應至指定給工作流程內STATE 屬性的值，類別群組中的工作項目類型定義該工作流程。 數值名稱 的有效值分別對應至下列列舉的值之一：分類群組中出現的工作項目的類型。 Agile Proposed：表示新的、未認可或還沒被執行工作的工作項目。 InProgress：表示已認可或可以有效執行的工作項目。 Complete：表示已實作的工作項目。 錯誤(Bug)：除了 Agile的轉移狀態之外，也包括指出錯誤的Resolved轉移狀態。 回應：Requested、 Received、 Reviewed和 Declined。 如需詳細資訊，請參閱 工作流程狀態、轉移狀態和管理設定。。
States	指定 State 項目集合，該項目集合和有轉移狀態之工作項目類型的工作流程有關。 <States>    <State . . . />    . . . </States>	BugWorkItems、 FeedbackResponseWorkItems、 FeedbackRequestWorkItems、 RequirementWorkItems 和 TaskWorkItems 的必要項目。 State 項目是用來將分配工作流程狀態給轉移狀態。
TaskWorkItems	指定與工作項目有關的類別，並連結工作流程狀態和轉移狀態。 <TaskWorkItems category="CategoryName">    <States>       <State . . . />       . . .    </States> </TaskWorkItems>	必要項。 類別名稱 必須對應於針對小組專案定義的分類群組。您可以使用 Categories.xml檔案以分類群組。 待辦項目和版面頁面會列出對應至 States 項目中指定狀態值的工作項目。
TypeField	指定欄位的參考名稱，被該欄位支援之功能區域的活動類型會參考該欄位的值。您可以在 TypeFields 容器項目內指定這個項目。 <TypeField refname=”FieldReferenceName” type=”NameOfType” [format="{0} TimeUnitString"] / > 指定格式只有在 type="RemainingWork"才有效。您可以指定給單位時間字串任何字串，任何您想要顯示在迭代待辦頁面和工作版面的容量列上。	必要項。您必須指定欄位對應至您在工作項目類型上使用的欄位， 以用來擷取特定資訊。 針對待辦項目和工作版面頁面： Activity：用於支援以活動定義容量的功能。指定一個由工作項目類型定義的欄位，您使用該工作項目來指定要執行的活動類型。 Effort：指定用來計算小組執行速度的欄位。指定一個工作項目待辦類別的欄位，你可以用此工作項目來擷取實作待辦項目工作量的投入程度和相對分級。 Order： 指定用於定義待辦項目排序次序的欄位，該待辦項目是在迭代待辦項目和工作版面頁面上。指定用於擷取指派給待辦項目的相對優先權的欄位。工作項目在頁面中，以欄位為其類型定義的遞增順序列出來。 RemainingWork：指定用來計算剩餘工作和待辦工作圖表的欄位。指定您用於擷取完成一個工作還剩餘的時數或天數的欄位。 您為 format 指定的值是使用在任何剩餘工作呈報的待辦項目和工作版面頁面。例如，當報告活動產能或每個成員的產能，或在資料行標題旁邊的在工作面板的工作狀態 對於單位時間字串，指定任何您要用來反映時間值的字串，例如時數或天數。 例如，下列值都是有效的: format="{0} h" format="{0} hours" format="hours {0}" format="time {0}" Team：指定用於連結待辦項目和工作版面頁面到一個小組的欄位。這個欄位應該維持設定為預設的System.AreaPath。 對於回應需求的表單： 注意事項 您不需要變更下列 TypeField 項目的預設分配。這些分配對應於的欄位是用來擷取工作項目之回應需求類型的對應資訊。 ApplicationStartInformation：指定用於擷取執行應用程式之路徑的欄位。 ApplicationLaunchInstructions：指定用於擷取啟動指令的欄位。 ApplicationType：指定用於擷取應用程式類型的欄位。列出來的類型會對應到回應需求之類型定義的許可值。
TypeFields	指定 TypeField 項目的集合。 <TypeFields>    <TypeField . . . />    . . . </TypeFields>	必要項。 您必須指定您要參考以支援功能的欄位類型，該功能會出現在待辦項目、工作版面和回應要求表單。
TypeFieldValue	指定應用程式類型的名稱，該名稱會出現在回應要求表單。 <TypeFieldValue value="ApplicationTypeName" type="TypeApp"/>	必要項。不要自訂。 預設的分配對應於在類別定義中為回應需求表單指定的允許值。 <TypeFieldValues>    <TypeFieldValue value="Web application" type="WebApp" />    <TypeFieldValue value="Remote machine" type="RemoteMachine" />    <TypeFieldValue value="Client application" type="ClientApp" /> </TypeFieldValues>
TypeFieldValues	指定 TypeFieldValue 項目的集合。 <TypeFieldValues>    <TypeFieldValue . . . />    . . . </TypeFieldValues>	當 type="ApplicationType"，需要TypeFieldValue項目。 您必須指定您想要顯示在回應需求表單的欄位型別的值。
Weekends	用來指定非工作的容器。 <Weekends>    <DayOfWeek> . . . </DayOfWeek >    . . . </ Weekends >	選擇項。 當你確認非工作日的天數和待辦工作圖表時，指定非工作日。

回到頁首

請參閱

參考

管理程序組態 [witadmin]

概念

更新已升級的 Team 專案以使用新功能

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