處理序組態 XML 元素參考
流程組態會定義您的小組可以使用 Agile 規劃工具存取的預設組態和功能。
這些工具 (您可以透過 Team Web Access (TWA) 檢視) 會根據對流程組態 XML 定義檔的 PortfolioBacklog、RequirementBacklog 和 TaskBacklog 區段所做的組態來顯示篩選過的工作項目集。 此外,流程組態還會針對所有需要對應的工作項目類型 (WIT) 定義工作流程的狀態至轉移狀態的對應。
若要進一步了解,請參閱設定及自訂 Team 專案的 Agile 計劃工具。
您可以自訂的區域:
設定待處理項目 (Backlog) 頁面
對應工作項目類型分類的轉移狀態
自訂預設資料行和資料行序列
自訂快速加入面板
變更工作面板上可出現的工作項目數
對應工具專屬工作項目類型的轉移狀態
指派用於敏捷式軟體開發規劃工具和圖表的欄位
指定週末日
變更工作項目類型的色彩
若要更新流程組態,請將 XML 定義檔案匯出,加以編輯,然後再匯入檔案。 您可以使用 witadmin 命令列工具匯入和匯出檔案。
注意事項 |
---|
本主題中的語法範例與 Visual Studio Scrum 2013 流程範本中所定義的預設指派相對應。若要存取最新版本的流程範本,請安裝最新版 TFS 並使用流程範本管理員下載範本。 |
設定待處理項目 (Backlog) 頁面
待處理項目 (Backlog) 頁面有三個類型:產品待處理項目、反覆項目或衝刺 (Sprint) 待處理項目和 Portfolio 待處理項目。 您可以使用下列方式自訂每個待處理項目 (Backlog) 頁面:
轉移狀態對應:將工作流程狀態對應至轉移狀態。 這些對應支援顯示所有敏捷式軟體開發規劃頁面,包括看板和工作面板。
快速加入面板:指定為了迅速將項目加入至待處理項目 (Backlog) 而顯示的 WIT 和工作項目欄位。
若要變更視為待處理項目 (Backlog) 或工作的工作項目類型,請將其加入至對應的分類。 如需範例,請參閱將 Bug 加入至工作面板或待處理項目。
資料行欄位:定義預設欄位和資料行順序。
您可以設定在下列範例中出現於 XML 區段內的待處理項目 (Backlog) 頁面:
<PortfolioBacklogs>
<PortfolioBacklog category="Microsoft.FeatureCategory" pluralName="Features" singularName="Feature">
. . .
</PortfolioBacklog>
</PortfolioBacklogs>
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName=" Backlog items" singularName=" Backlog item">
. . .
</RequirementBacklog>
<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" singularName="Task">
. . .
</TaskBacklog>
項目 |
描述 |
---|---|
PortfolioBacklogs |
選擇項。 Portfolio 待處理項目 (Backlog) 頁面的容器項目。 |
PortfolioBacklog |
選擇項。 最多五個執行個體。 針對 Portfolio 待處理項目 (Backlog) 頁面定義轉移狀態對應、預設資料行和快速加入面板的容器項目。
為屬性指定值,如下所述:
|
RequirementBacklog |
必要項。 只有一個執行個體。 針對產品待處理項目 (Backlog) 頁面定義轉移狀態對應、預設資料行和快速加入面板的容器項目。 產品待處理項目 (Backlog) 會顯示小組待處理項目中的所有現用項目。
|
TaskBacklog |
必要項。 只有一個執行個體。 用於自訂頁面配置的容器項目,這些頁面會顯示指派給特定反覆項目的工作項目。
根據預設,工作面板限制為總計 500 個工作項目。 您可以指定 workItemCountLimit 屬性的值來變更這項限制。 |
實作注意事項
指派給 CategoryName 的值必須與針對 Team 專案定義的分類群組相對應。 您可以在分類的定義檔指定分類群組。 如需詳細資訊,請參閱Categories XML 項目參考。
您可使用 Portfolio 待處理項目 (Backlog),檢視較低層級的待處理項目彙總,以及檢視跨數個小組的進度。 新增和升級的 Team 專案包含一個層級標記的功能。 您最多可以加入四個額外的層級。
注意事項 若要使用 Portfolio 頁面,您必須具備「進階」存取權。如需詳細資訊,請參閱 變更存取層級。
如需使用 Portfolio 待處理項目頁面的詳細資訊,請參閱使用 Portfolio 待處理項目.
產品待處理項目 (Backlog) 代表您開發的產品的需求清單。 待處理項目 (Backlog) 會根據用於建立 Team 專案的流程範本,對應至特定類型的工作項目,例如產品待處理項目 (Backlog)、使用者劇本或需求。 如果您使用不同類型的工作項目,或使用兩個以上類型的工作項目擷取您的需求,則可以自訂產品待處理項目 (Backlog) 頁面以支援您的使用方式。
如需使用產品待處理項目頁面的詳細資訊,請參閱建立待處理項目.
衝刺 (Sprint) 或反覆項目的待處理項目 (Backlog) 頁面,會顯示您和小組在特定反覆項目週期中認可的一組需求以及已連結至這些需求的工作。 工作必須使用子連結類型連結至需求。 由於出現在這些頁面中的工作項目類型會對應至顯示在產品待處理項目 (Backlog) 頁面上的相同類型,您為產品待處理項目頁面進行的許多自訂工作將會定義工作待處理項目頁面的功能。
如需使用衝刺待處理項目頁面的詳細資訊,請參閱衝刺工作.
將工作流程狀態對應至轉移狀態
大部分 WIT 都需要其工作流程狀態對應至轉移狀態。 工作流程狀態定義工作項目如何從啟用或建立開始進展至關閉或完成。 例如,Scrum 產品待處理項目 (Backlog) 定義的狀態定義了一個有四個狀態的進展,從 [新增]、[認可] 和 [已認可] 到 [完成],同時也加入第五個狀態 [已移除],以說明未經實作即已從待處理項目移除的狀態。
另一方面,轉移狀態會判斷敏捷式軟體開發規劃工具如何處理每一個工作流程狀態。 待處理項目 (Backlog) 和工作面板所使用的主要轉移狀態是Proposed、InProgress和Complete。
透過建立每個工作流程狀態與轉移狀態的關聯,為顯示待處理項目 (Backlog) 和工作面板而執行的背景作業,就會知道如何正確轉譯每個工作項目的狀態。 例如,為 Scrum 產品待處理項目 (Backlog) 頁面定義下列對應。
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Backlog items" singularName="Backlog item">
<States>
<State value="New" type="Proposed" />
<State value="Approved" type="Proposed" />
<State value="Committed" type="InProgress" />
<State value="Done" type="Complete" />
</States>
. . .
</RequirementBacklog >
轉移狀態有三個分類:Agile、Bug 和意見。 下表說明對應屬性和值。
項目 |
描述 |
||
---|---|---|---|
State |
必要項。 指派工作流程狀態給轉移狀態。
TypeName 的有效值會對應至指派給那些指派至分類群組之 WIT 的 WORKFLOW 區段中 STATE 的值。 ValueName 的有效值對應至下列其中一個列舉值:
|
||
States |
指定將 WIT 工作流程狀態與轉移狀態建立關聯之 State 項目的集合。 下列父項目的必要項目:
|
自訂預設資料行和資料行序列
您可以加入或移除資料行、變更資料行序列,或變更顯示待處理項目 (Backlog) 頁面的頁面欄寬。 您透過 [資料行選項] 對話方塊對頁面的進行變更會保存,直到您再次變更它們。 下列程式碼區段簡單定義預設資料行集和序列。
<Columns>
<Column refname="Microsoft.VSTS.Common.Priority" width="400" />
<Column refname="System.Title" width="400" />
<Column refname="System.State" width="100" />
<Column refname="Microsoft.VSTS.Scheduling.Effort" width="50" />
<Column refname="System.IterationPath" width="200" />
</Columns>
項目 |
描述 |
---|---|
Columns |
指定 Column 項目的集合。 待處理項目頁面項目的必要項目:PortfolioBacklog、RequirementBacklog 和 TaskBacklog。 |
Column |
指定欄位,顯示為待處理項目 (Backlog) 頁面的資料行。
|
工作面板資料行標題
顯示在工作面板頁面中的資料行標題,會與指派給預設 WIT (指派給工作分類) 的工作流程狀態相對應。 資料行序列會與工作流程轉換的自然進展相對應,由左向右移動。 若要修改資料行配置,請修改指派給工作分類之 WIT 的工作流程。 針對工作分類中的預設工作類型定義的工作流程狀態,必須指派給有效的轉移狀態,如對應工作項目類型分類的轉移狀態中所述。
自訂快速加入面板
您可以對快速加入面板加入任何欄位。 例如,下列範例是將 [商務價值] 加入至產品待處理項目 (Backlog) 面板。
對於,面板只會顯示包含在所選取 WIT 之 WIT 定義 FIELDS 區段中的欄位。 例如,如果您選取 Bug WIT,只會標題顯示,因為商務價值不是針對 Bug 定義的。 若要將其他 WIT 加入至面板,請將其加入至 [需求分類],如此處所述。
下列程式碼會對應至 Visual Studio Scrum 和 MSF for Agile 流程範本中定義的預設指派。
<AddPanel>
<Fields>
<Field refname="System.Title" />
</Fields>
</AddPanel>
項目 |
描述 |
---|---|
AddPanel |
用來指定「快速加入」經驗的容器項目,要在所定義新待處理項目 (Backlog) 之面板區域中出現的欄位。 |
Fields |
指定 Field 項目的集合。 |
Field |
指定出現在產品待處理項目 (Backlog) 頁面的面板中的工作項目欄位。
同一個欄位應該出現在每個包含於待處理項目 (Backlog) 分類之 WIT 的工作項目表單上。 |
變更工作面板上可出現的工作項目數
基於效能考量,工作面板會限制為最多顯示 500 個工作項目。 當您開啟工作面板時,所有的工作項目會載入至快取。 限制工作項目的數目可以加快載入的時間。 您可以透過指定 TaskBacklog 項目的 workItemCountLimit 屬性值,變更這個限制。
例如,您可以加入 workItemCountLimit="800" 來提高限制:
<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" singularName="Task" workItemCountLimit="800" >
. . .
</TaskBacklog>
對應工具專屬工作項目類型的轉移狀態
轉移狀態對應是針對其他 WIT 分類來定義。 若是 Scrum 流程範本,這會包括意見要求和回應分類的對應。 若是 MSF Agile 和 CMMI 流程範本,還會包括 Bug 分類的對應 (Scrum 包括需求分類中的 Bug,因此會在 RequirementBacklog 區段中定義轉移狀態對應)。
<FeedbackRequestWorkItems category="Microsoft.FeedbackRequestCategory" pluralName="Feedback Requests" singularName="Feedback Request">
<States>
<State value="Active" type="InProgress" />
<State value="Closed" type="Complete" />
</States>
</FeedbackRequestWorkItems>
<FeedbackResponseWorkItems category="Microsoft.FeedbackResponseCategory" pluralName="Feedback Responses" singularName="Feedback Response">
<States>
<State value="Active" type="InProgress" />
<State value="Closed" type="Complete" />
</States>
</FeedbackResponseWorkItems>
下表說明其他用來定義工具特定工作項目類型的轉移狀態對應。 如需指派實際狀態值和類型的詳細資訊,請參閱對應工作項目類型分類的轉移狀態。 CategoryName 必須對應至針對 Team 專案定義的分類。
項目 |
描述 |
---|---|
BugWorkItems |
選擇項。 針對指派給 Bug 分類的工作項目類型,定義轉移狀態對應的容器項目。 除了控制如何使用這些對應來顯示 TWA 敏捷式軟體開發規劃頁面之外,還會控制 Team Explorer 中的 [我的工作] 功能,如何在開發人員使用 [我的工作] 移動 Bug 時更新 Bug 狀態。 若要進一步了解,請參閱使用者本文撰寫新程式碼。
|
FeedbackRequestWorkItems |
必要項。 不要自訂。 針對指派給意見要求分類的工作項目類型,定義轉移狀態對應的容器項目。
|
FeedbackResponseWorkItems |
必要項。 不要自訂。 針對指派給意見回應分類的工作項目類型,定義轉移狀態對應的容器項目。
|
TestPlanWorkItems |
只有在發生下列狀況時才需要:當您自訂測試計劃的工作流程狀態,且可透過與 Visual Studio 2013.2 或更早的版本一起安裝的 Test Manager 版本連線到 Team 專案時。 為指派給測試計劃分類的工作項目類型,定義轉移狀態對應的容器項目。 例如:
|
TestSuiteWorkItems |
只有在發生下列狀況時才需要:當您自訂測試套件的工作流程狀態,且可透過與 Visual Studio 2013.2 或更早的版本一起安裝的 Test Manager 版本連線到 Team 專案時。 為指派給測試套件分類的工作項目類型,定義轉移狀態對應的容器項目。 例如:
|
若要對應 TestPlanWorkItems 或 TestSuiteWorkItems 的轉移狀態,您必須將應用程式層伺服器升級至 TFS 2013.3。 之後,即可自訂測試計劃與測試套件的工作流程狀態。
若要進一步了解,請參閱匯入與匯出處理序組態。
指派用於敏捷式軟體開發規劃工具和圖表的欄位
您可以變更用來計算產能、燃盡圖、預測和速度的工作項目欄位。 您對於其中一個預設指派進行的任何變更應該與用來定義和擷取該值資訊的 WIT 變更相對應。
例如,如果您變更指派給 type="Activity" 的 refname,則在指派給擷取活動資訊的工作分類的 WIT 定義中應包含相同欄位。
<TypeFields>
<TypeField refname="System.AreaPath" type="Team" />
<TypeField refname="Microsoft.VSTS.Scheduling.RemainingWork" type="RemainingWork" format="format h" />
<TypeField refname=" Microsoft.VSTS.Common.BacklogPriority" type="Order" />
<TypeField refname="Microsoft.VSTS.Scheduling.Effort" 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>
項目 |
描述 |
||||
---|---|---|---|---|---|
TypeFields |
必要項。 指定 TypeField 項目的集合。 |
||||
TypeField |
必要項。 指定欄位的參考名稱,其值支援功能區域的活動類型。 您指定的欄位應與您在用於擷取功能資訊之 WIT 中使用的欄位相對應。
只在 type="RemainingWork" 時才指定格式。 您可以對 TimeUnitString 指定任何文字字串,這些文字字串將顯示在目前反覆項目待處理項目 (Backlog) 頁面和工作面板上的產能列。 敏捷式軟體開發規劃頁面:
對於意見要求表單:
|
||||
TypeFieldValues |
當 type="ApplicationType" 時,為 TypeFieldValue 的必要項。 指定用於意見要求表單的 TypeFieldValue 項目集合。 |
||||
TypeFieldValue |
必要項。 不要自訂。 指定要出現在意見要求表單上的應用程式類型名稱。
預設指派會與意見要求表單的類型定義中所指定的允許值相對應。
|
實作注意事項
如果您變更 TypeFields 區段內的欄位,您應該在 WIT 定義中進行相對應的變更。 例如,如果您變更指派要擷取工作 Effort 的欄位,那麼您應該在產品待處理項目 (Backlog) 和 Bug (Scrum) 的 WIT 定義中進行相同變更。
您可以使用這個索引查詢欄位的參考名稱。
指派非工作日
產能計劃和燃盡圖會參考非工作日。 在每個 TFS 流程範本中會定義下列非工作日。
<Weekends>
<DayOfWeek>Saturday</DayOfWeek>
<DayOfWeek>Sunday</DayOfWeek>
</Weekends>
項目 |
描述 |
||
---|---|---|---|
DayOfWeek |
Weekends 項目的必要子系。 指定一週的某一天對應至一個非工作日。
對應至英文,一週的有效日次名稱是:Sunday、Monday、Tuesday、Wednesday、Thursday、Friday和Saturday。
|
||
Weekends |
選擇項。 用來指定非工作日的容器項目。 若要在計算產能和燃盡圖時將非工作日計入,請指定非工作日。 某個有關何以發生此情況的附註會出現在燃盡圖中,而且無法移除。 |
變更工作項目類型的色彩
檢視查詢結果或待處理項目 (Backlog) 時,根據指派給 WIT 的色彩,您一看就可以區分 WIT。
下列色彩指派是在 Scrum 流程範本中定義的。
<WorkItemColors>
<WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="ProductBacklogItem" />
<WorkItemColor primary="FF773B93" secondary="FFEEE2F2" name="Feature" />
<WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Task" />
<WorkItemColor primary="FFCC293D" secondary="FFFAEAE5" name="Bug" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Code Review Request" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Code Review Response" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Feedback Request" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Feedback Response" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Impediment" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Shared Step" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Test Case" />
</WorkItemColors>
項目 |
描述 |
---|---|
WorkItemColors |
選擇項。 指定工作項目類型色彩的容器項目。 |
WorkItemColor |
指定在 TWA 中用來顯示 WIT 的色彩。 主要色彩用於顯示清單,而次要色彩用於顯示面板,例如工作面板或看板。
|
問與答
問:如何自訂在 TWA 中出現於敏捷式軟體開發規劃工具上的其他功能?
**答:**有些自訂可以透過使用者介面進行。 其他自訂則需要編輯流程組態或其他 Team 專案物件。 如需概觀說明,請參閱設定及自訂 Team 專案的 Agile 計劃工具.
問:您是否要使用兩個以上的 Portfolio 待處理項目 (Backlog)?
**答:**預設經驗支援一個層級的 Portfolio 待處理項目 (Backlog)。 最多可以加入五個層級,如下所述:將待處理項目加入至 Agile Portfolio 管理.
問:是否要加入或變更出現在工作面板或產品待處理項目 (Backlog) 中的 WIT?
**答:**如果加入了自訂 WIT,您可以將其加入至待處理項目 (Backlog) 或工作面板。 您無法讓其顯示在兩個位置。 閱讀下列資訊以了解做法:將 Bug 加入待處理項目或工作面板.
問:是否要參考匯入和匯出流程組態的工作範例?
**答:**以下提供範例:匯入和匯出流程組態 [witadmin].