處理序組態 XML 元素參考

Azure DevOps Server 2022 |Azure DevOps Server 2020 |Azure DevOps Server 2019 |TFS 2018

程式組態會定義您的小組可以使用入口網站 Agile 工具存取的預設組態和功能功能。 這些工具組括產品待辦專案、短期衝刺待辦專案、工作流程看板和工作面板,而且可供您新增至專案的每個小組自訂。

組態項目會指定工作項目類型 (WIT)、預設資料行、工具所使用的欄位,以及其他項目。 主要組態會藉由定義程式組態 XML 定義檔的PortfolioBacklogRequirementBacklog 和 TaskBacklog區段,來決定要針對組合、產品和短期衝刺待辦專案顯示哪些專案。 此外,進程組態會針對需要對應的所有 WIT 定義狀態與狀態類別的工作流程對應。

流程組態 XML 項目

如需您可以透過使用者介面設定之專案的摘要,請參閱 自訂工作追蹤、新增小組及設定其 Scrum 和 Kanban 工具

您可以透過 ProcessConfiguration 自訂的區域:

注意

  1. 以星號表示的專案會設定專案的預設值。 您可以透過 小組設定,針對每個小組變更這些專案。
  2. 支援裝載的 XML,以及 TFS 2015.2 或更新版本的內部部署 XML。
  3. 支援裝載的 XML,以及 TFS 2017.2 或更新版本的內部部署 XML。

重要

如果您想要自訂專案以新增自訂工作專案類型,以出現在待辦專案或面板上,或新增自訂群組合待辦專案,請參閱 將工作專案類型新增至待 辦專案和麵板,以及 新增組合待辦專案

更新進程組態

注意

若要存取最新版的進程範本,請安裝最新版的 TFS,並使用 進程範本管理員下載範本。

若要更新專案的處理常式組態,您可以匯出 XML 定義檔、編輯它,然後匯入檔案。 您可以 匯出進程匯出進程組態定義檔來匯出這些檔案

匯出 ProcessConfig 定義檔編輯 XML 定義檔 匯WIT 定義檔重新整理並確認變更

提示

使用 witadmin,您可以 匯入和匯出定義檔案。 您可以使用的其他工具組括 [程式編輯器] (要求您已安裝 Visual Studio) 版本。 從 Visual Studio Marketplace 安裝程式範本編輯器

或者,您可以使用 TFS Team Project Manager,這是可從 GitHub 取得的開放原始碼用戶端。

提示

使用 witadmin,您可以 匯入和匯出定義檔案。 您可以使用的其他工具組括 [程式編輯器] (要求您已安裝 Visual Studio) 版本。 從 Visual Studio Marketplace 安裝 TFS 進程範本編輯器。 您可以使用這個版本的進程編輯器來修改舊樣式的工作專案表單。 您無法使用它來編輯與 新 Web 表單相關聯的表單

或者,您可以使用 TFS Team Project Manager,這是可從 GitHub 取得的開放原始碼用戶端。

設定待處理項目

您可以為產品待處理項目、衝刺待處理項目和 Portfolio 待處理項目自訂下列項目:

  • 狀態類別對應:將工作流程狀態對應至先前稱為中繼) 的狀態類別 (。 這些對應支援顯示所有 Agile 規劃工具,包括看板和工作面板。

  • 快速新增面板:指定出現的 WIT 和工作專案欄位,以便快速將專案新增至待辦專案。

    若要變更視為待處理項目 (Backlog) 或工作的工作項目類型,請將其加入至對應的分類。 如需範例,請參閱 將 Bug 新增至工作面板或待辦專案

  • 資料列欄位:定義預設欄位和資料行順序。

您可以設定在下列範例中出現於 XML 區段內的待處理項目:

<PortfolioBacklogs>
      <PortfolioBacklog category="Microsoft.EpicCategory" pluralName="Epics" singularName="Epic" workItemCountLimit="1000">
. . . 
      </PortfolioBacklog>
      <PortfolioBacklog category="Microsoft.FeatureCategory" pluralName="Features" singularName="Feature" parent="Microsoft.EpicCategory" workItemCountLimit="1000">
. . . 
      </PortfolioBacklog>
</PortfolioBacklogs>
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Stories" singularName="User Story" workItemCountLimit="1000">
. . . 
</RequirementBacklog>
<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" singularName="Task" workItemCountLimit="1000">
. . . 
</TaskBacklog>

注意

根據與 ProcessConfiguration 檔案—Agile、ScrumCMMI相關聯的程式,for pluralNameRequirementCategory 會對應至 Stories (Agile) 、 Backlog Items (Scrum) ,或 Requirements (CMMI) 。 這三者都類似:它們描述要傳遞的客戶價值,以及要執行的工作。

PortfolioBacklogs 元素的語法

Element

說明

PortfolioBacklogs

選擇性。 Portfolio 待處理項目的容器項目。

PortfolioBacklog

選擇性。 最多五個執行個體。

定義組合待辦專案狀態類別目錄對應、預設資料行和快速新增面板的容器元素。

<PortfolioBacklog category="PortfolioCategory" parent="ParentCategory"  
pluralName="PluralName" singularName="SingleName" workItemCountLimit="MaximumLimit>  
<States> . . . </States>  
<Columns> . . . </Columns>  
<AddPanel> . . . </ AddPanel>  
</PortfolioBacklog >  

為屬性指定值,如下所述:

  • category:針對包含要與此待辦專案類型相關聯之 WIT 的專案,指定您在類別定義檔中定義的類別名稱。

  • parent:指定類別的名稱,代表階層內的父組合待辦專案。

  • pluralName:指定參照與此待辦專案類型相關聯之 WIT 時要使用的複數標籤。 例如,Stories、Goals、Initiatives 或 Epics。

  • singularName:指定參考與此待辦專案類型相關聯之 WIT 時要使用的單一標籤。 例如,Story、Goal、Initiative 或 Epic。

  • workItemCountLimit:指定整數。 預設值為 1000。 待處理項目和面板會根據這項限制來限制顯示的項目計數。

RequirementBacklog

必要。 只有一個執行個體。

定義產品待處理專案狀態類別目錄對應、預設資料行和快速新增面板的容器專案。 產品待辦專案會顯示小組待處理專案中的所有使用中專案。

<RequirementBacklog category="RequirementCategory"  
pluralName="PluralName" singularName="SingleName"   
workItemCountLimit="MaximumLimit" >  
<States> . . . </States>
<Columns> . . . </Columns>
<AddPanel> . . . </ AddPanel>
</RequirementBacklog >

TaskBacklog

必要。 只有一個執行個體。

用於自訂的短期衝刺待辦項目配置容器項目。

<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" 
singularName="Task workItemCountLimit="MaximumLimit">
. . . 
</TaskBacklog > 

實作附註

  • 根據預設,每個待處理項目 (backlog) 是限制為總計 1000 個工作項目。 您可以藉由指定 屬性的值來 workItemCountLimit 變更此限制。
  • 指派給 CategoryName 的值必須對應至為專案定義的類別群組。 您可以在 [類別] 的定義檔中指定類別群組
  • 您可以使用 組合待 辦專案來組織待辦專案、檢視較低層級的待辦專案匯總,以及檢視數個小組的進度。 新增和升級的專案包含兩個組合待辦專案層級:功能和 Epic。 您最多可以加入三個額外的層級。 只有最上層組合待辦專案不會指定父類別。
  • 您的 產品待 辦專案會對應至您的專案計劃,這是小組計畫交付專案的藍圖。 它會列出其 WIT 屬於需求分類的工作項目。 若要管理與預設專案所提供的不同 WIT,您可以將 WIT 新增至需求類別,並將工作流程狀態對應至狀態類別。
  • 您的 短期衝刺或反復專案待辦專案 會顯示您和小組在特定的短期衝刺週期中認可的一組需求,以及您已連結至這些需求的工作。 您可以使用父子式連結類型,將工作連結至需求。 由於出現在這些待處理項目上的 WIT,會對應至產品待處理項目上顯示的相同類型,因此您為產品待處理項目進行的許多自訂工作將會定義衝刺待處理項目的功能。

將 WIT 類別工作流程狀態對應至狀態類別

數個 WIT 需要其工作流程狀態對應至狀態類別目錄。 工作流程狀態定義工作項目如何從啟用或建立開始進展至關閉或完成。 例如,針對 Scrum 產品待辦專案定義的狀態會定義四個狀態的進度,從 NewApprovedCommittedTo Done,也包含第五個狀態 Removed,以考慮從待辦專案移除的狀態,而不需實作。 工作流程狀態與 屬性相關聯 value

另一方面,狀態類別會決定敏捷式規劃工具如何處理每個工作流程狀態。 待辦專案和工作面板所使用的主要狀態類別是 [建議]、[ InProgress] 和 [ 完成]。 狀態類別與 type 屬性相關聯。 若要深入瞭解,請參閱工作流程狀態和狀態類別。

藉由將每個工作流程狀態與狀態類別目錄產生關聯,執行的背景作業會顯示待辦專案和工作面板,知道如何正確解譯每個工作專案的狀態。 例如,為 Scrum 產品待辦項目定義下列對應。

<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>

狀態類別有三組:敏捷式、Bug 和意見反應。 下表說明對應屬性和值。

WIT 類別 (狀態專案的語法)

Element

說明

State

必要。 將工作流程狀態指派給狀態類別目錄。

<State value="ValueName" type="TypeName" />

ValueName的有效值會對應到指派給指派給類別群組之WIT 之 WORKFLOW區段中STATE的值。

TypeName的有效值會對應至下列其中一個列舉值:

  • Agile:用於所有工作項目類型。
  • 建議:指出新、尚未認可或尚未處理的工作專案。
  • InProgress:指出已認可或正在處理的工作專案。
  • 完成:指出已實作的工作專案。 若要讓 工作流程看板 有效,只有一個工作流程狀態必須對應到 [完成 ] 狀態類別。 如果需要表示其他工作流程狀態,則可以對應至 [已解決 ] 狀態類別目錄。
    一旦工作流程狀態轉換為與 完整 中繼狀態相關聯的狀態,相關聯的工作專案就會中斷產品待處理專案。 不過,它將繼續列在工作流程看板的最後一個資料行中。

    工作流程狀態中未對應至其中一個狀態類別的工作專案不會出現在待辦專案或面板上。
  • Bug:只用於 Bug 分類群組中的工作項目類型。 除了敏捷式狀態類別之外,還包含 解決狀態類別目錄,指出已解決的錯誤。

注意

您只能將 已解決 的狀態類別指派給 BugWorkItems 元素下指定的工作流程狀態。

  • 意見:只用於意見要求或意見回應分類群組內的工作項目類型。 要求接收檢閱拒絕

狀態

指定將 WIT 工作流程狀態與狀態分類產生關聯之 State 元素的集合。

下列父項目的必要項目:

  • BugWorkItems
  • PortfolioBacklog
  • RequirementBacklog
  • TaskBacklog
  • TestPlanWorkItems
  • TestSuiteWorkItems
  • FeedbackRequestWorkItems
  • FeedbackResponseWorkItems

設定預設資料行

指定您要顯示在 [ 資料 行] 區段內每個待辦專案上的欄位。 您透過 [ 資料行選項] 對話方塊所做的變更會持續存在,直到您再次變更它們為止。

待處理項目頁面的預設欄和順序

以下是由產品待辦專案之 Scrum 程式範本所定義的預設組態。

<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 元素的語法

Element

說明

資料行

指定 Column 專案的集合。 待辦專案的必要元素: PortfolioBacklogRequirementBacklogTaskBacklog

資料行

指定欄位,顯示為待處理項目上的資料行。

<Column refname="FieldReferenceName"  width="FieldWidth" />

工作面板資料行標題

顯示在工作面板中的資料行標題,會與指派給預設 WIT (指派給工作分類) 的工作流程狀態相對應。 資料行序列會與工作流程轉換的自然進展相對應,由左向右移動。 若要修改資料行配置,請修改指派給工作分類之 WIT 的工作流程。 在 [工作類別目錄] 中為預設工作類型定義的工作流程狀態必須指派給有效的狀態類別,如 對應工作專案類型類別目錄中所述。

自訂快速加入面板

您可以對快速加入面板加入任何欄位。 例如,下列範例會將 商務價值 新增至產品待辦專案面板。

已加入 [商務價值] 欄位的 [待處理項目] 面板

面板只會顯示包含在所選取 WIT 定義之 WIT 定義之 FIELDS 區段中的 欄位 。 例如,如果您選取 Bug WIT,則只會顯示 [標題],因為未針對 Bug 定義商業價值。 若要將另一個 WIT 新增至面板,您可以將它新增至需求類別,如 將工作專案類型新增至待辦專案和麵板中所述。

下列程式碼會對應至 Visual Studio Scrum 和 MSF for Agile 流程範本中定義的預設指派。

<AddPanel>
      <Fields>
      <Field refname="System.Title" />
      </Fields>
</AddPanel>

AddPanel 元素的語法

Element

說明

AddPanel

用來指定「快速新增」體驗的容器元素,要顯示在定義新待辦專案之面板區域內的欄位。

欄位

指定 Field 專案的集合。

欄位

指定出現在產品待處理項目的面板中的工作項目欄位。

<Field refname="FieldReferenceName"/>

同一個欄位應該出現在每個包含於待處理項目 (Backlog) 分類之 WIT 的工作項目表單上。

設定工作面板的工作專案數目

基於效能考量,工作面板會限制為最多顯示 1000 個工作項目。 當您開啟工作面板時,所有的工作項目會載入至快取。 限制工作項目的數目可以加快載入的時間。 您可以指定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必須對應至為專案定義的類別。

工具特定狀態類別對應專案的語法

Element

說明

BugWorkItems

選擇性。 容器專案,定義指派給 Bug 類別目錄的工作專案類型狀態類別對應。 除了這些對應如何在敏捷式工具的顯示中使用,它們也會控制 Team Explorer 中的 [我的工作 ] 功能如何在開發人員使用 My Work移動 Bug 時更新 Bug 狀態。 若要深入瞭解,請參閱 (TFVC) 檢閱您的程式碼

<BugWorkItems category="CategoryName"  
pluralName="PluralName" singularName="SingleName">
<States>
. . .
</States>
</BugWorkItems>

FeedbackRequestWorkItems

必要。 不要自訂。 容器專案,定義指派給意見反應要求類別的工作專案類型狀態類別目錄對應。

<FeedbackResponseWorkItems category="CategoryName"  
pluralName="PluralName" singularName="SingleName">
<States>
. . .
</States>
</FeedbackRequestWorkItems>

FeedbackResponseWorkItems

必要。 不要自訂。 容器專案,定義指派給意見反應回應類別目錄的工作專案類型狀態類別對應。

<FeedbackResponseWorkItems category="CategoryName"  
pluralName="PluralName" singularName="SingleName">
<States>
. . .
</States>
</FeedbackResponseWorkItems>```

TestPlanWorkItems

只有在您自訂測試計劃的工作流程狀態,並支援從與 Visual Studio 2013.2 或舊版一起安裝之 Test Manager 版本的專案連線時,才需要此專案。

容器專案,定義指派給測試計劃類別目錄的工作專案類型狀態類別對應。 例如:

<TestPlanWorkItems category="Microsoft.TestPlanCategory"  
pluralName="Test Plans" singularName="Test Plan">
<States>
<State type="InProgress" value="Design" />
<State type="InProgress" value="Testing" />
<State type="Complete" value="Signed Off" />
</States>
</TestPlanWorkItems>

TestSuiteWorkItems

只有在您自訂 Test Suite 的工作流程狀態,並支援從與 Visual Studio 2013.2 或舊版一起安裝之 Test Manager 版本的專案連線時,才需要此專案。

容器專案,定義指派給 Test Suite 類別的工作專案類型狀態類別對應。 例如:

<TestSuiteWorkItems  
category="Microsoft.TestSuiteCategory"  
pluralName="Test Suites" singularName="Test Suite">
<States>
<State type="Proposed" value="Authoring" />
<State type="InProgress" value="Testing" />
<State type="Complete" value="Completed" />
</States>
</TestSuiteWorkItems>

注意

功能可用性:若要對應 或 TestSuiteWorkItems 的狀態類別 TestPlanWorkItems ,您必須將應用層伺服器升級至 TFS 2013.3 或更新版本。 之後,即可自訂測試計劃與測試套件的工作流程狀態。 若要深入瞭解,請參閱 測試計劃和測試套件功能

指派敏捷式工具欄位

您可以變更用來計算產能、燃盡圖、預測和速度的工作項目欄位。 您對於其中一個預設指派進行的任何變更應該與用來定義和擷取該值資訊的 WIT 變更相對應。

例如,如果您將指派的 變更 refnametype="Activity" ,則應該在指派給工作類別目錄的 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 專案的語法

Element

說明

TypeFields

必要。 指定 TypeField 專案的集合。

TypeField

必要。 指定欄位的參考名稱,其值支援功能區域的活動類型。 您指定的欄位應與您在用於擷取功能資訊之 WIT 中使用的欄位相對應。

<TypeField refname="FieldReferenceName"  
type="NameOfType" [format="{0} TimeUnitString"] / >

只有在 時 type="RemainingWork" ,才指定格式。 您可以指定您想要出現在目前短期衝刺待辦專案和工作面板容量列上 TimeUnitString 的任何文字字串。

Agile 工具:

  • 活動:用來支援依活動容量的功能。 指定與指派至工作分類之 WIT 中所使用的相同欄位。

注意

Capacity 工具所顯示的值會反映針對專案集合實例內所有專案中欄位所定義之所有值的聯集。 因此,若要限制針對短期衝刺容量顯示的值,您必須在指派給 type="Activity" 之欄位的所有專案中比對值。

  • 工作:用來計算小組速度。 指定與指派至需求分類之 WIT 中所使用的相同欄位,您會使用此欄位來擷取待辦項目實作所需的預計投入時間量、劇本點數 (Story point) 或工作量大小。

  • 順序:用來定義待辦專案和麵板上的專案排序次序。 系統會按照此類型欄位所定義的工作項目遞增順序,來列出這些工作項目。

注意

您可以在待處理項目或面板的清單中,以上下拖曳的方式移動項目。 當您移動專案時,背景程式會更新指派給 的 type="Order" 欄位。

  • RemainingWork:用來計算剩餘工時和待用圖表。 指定與指派至工作分類之 WIT 中所使用的相同欄位,您會使用此欄位來擷取工作完成前剩餘的小時、天數或其他度量單位。
    您為 格式 指定的值會用於短期衝刺待辦專案和工作面板上,無論報告剩餘工時。 例如,當報告活動產能或每個小組成員的產能時,或用在工作面板上工作狀態的資料行標題旁邊。
    針對 TimeUnitString,指定您想要用來反映時間值的任何文字字串,例如小時或天數。
    例如,下列全部是有效的值:
    format="{0} h"
    format="{0} hours"
    format="hours {0}"
    format="time {0}"
  • 小組:用來建立待辦專案與小組的關聯。 預設值是 System.AreaPath。 若要將小組與區域路徑分離,您可以指定不同的欄位,如 使用小組欄位而非支援小組的區域路徑中所述。
    對於意見要求表單:

注意

您不應該變更針對下列 TypeField 元素所做的預設指派。 這些指派應與用來擷取指派至意見要求分類之 WIT 中的對應資訊的欄位相對應。

  • ApplicationStartInformation:用來擷取執行應用程式的路徑。

  • ApplicationLaunchInstructions:用來擷取啟動指示。

  • ApplicationType:用來擷取應用程式的類型。 列出來的類型會對應到意見要求之 WIT 定義所指定的允許值。

TypeFieldValues

當 時 type="ApplicationType",TypeFieldValue的必要專案。 指定在意見反應要求表單中使用的 TypeFieldValue 元素集合。

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>

實作附註

  • 如果您在 TypeFields 區段中變更欄位,您應該在 WIT 定義中進行對應的變更。 例如,如果您變更指派給擷取工作 工作的欄位,則應該在產品待辦專案 WIT 定義中進行相同的變更,以及 Scrum) 的錯誤 (。

  • 您可以使用這個 索引來查閱欄位的參考名稱。

設定非工作日

非工作日會從容量規劃工具和待用圖表所做的計算中移除。 預設程式—AgileScrumCMMI—將星期六和星期日指定為非工作日。 建立專案之後, 每個小組都可以設定其特定的非工作日

<Weekends>
   <DayOfWeek>Saturday</DayOfWeek>
   <DayOfWeek>Sunday</DayOfWeek>
</Weekends>

週末元素的語法

Element

說明

DayOfWeek

Weekends元素的必要子系。

指定一週的某一天對應至一個非工作日。

<DayOfWeek>NameOfADay</DayOfWeek>

有效名稱會對應到一周的英文天: 星期日星期一、 星期二星期三、 星期四、 星期五星期六

注意

不論安裝哪個語言版本的內部部署 TFS,您都必須以英文指定一週的日次。

週末

選擇性。 用來指定非工作日的容器項目。

若要在計算產能和燃盡圖時將非工作日計入,請指定非工作日。

變更工作項目類型的色彩

一目了然,您可以根據指派給 WIT 的色彩和圖示來檢視查詢結果或待辦專案時區分 WIT。 系統會將為工作專案類型定義的色彩套用至 為 WIT 指定的圖示

顯示 wit 色彩、圖示和狀態色彩的查詢結果

Scrum 流程範本會定義下列的色彩指派。 會針對 Agile 和 CMMI 範本進行一個類似的指派。

<WorkItemColors>
      <WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="ProductBacklogItem" />
      <WorkItemColor primary="FF773B93" secondary="FFEEE2F2" name="Feature" />
   <WorkItemColor primary="FFFF7B00" secondary="FFFFD7B5" name="Epic" />
      <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" />
   <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Test Plan" />
   <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Test Suite" />
   <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Shared Parameter" />
</WorkItemColors>

WorkItemColors 專案的語法

Element

說明

WorkItemColors

選擇性。 指定工作項目類型色彩的容器項目。

WorkItemColor

指定在入口網站中用來顯示 WIT 的色彩。 主要色彩用於清單顯示中。 系統不再參考次要色彩,不過您必須指定它,才能驗證語法。

指定色彩時,請一律在六位數的十六進位色彩代碼前面加上 FF ,這表示色彩應該完全可見。

<WorkItemColor primary="HexColorCode" secondary="HexColorCode"  
name="witName" />

指定屬性和行為

您可以設定的前兩個屬性, BugsBehaviorHiddenBacklogs 設定專案的預設值。 不過,每個小組都可以透過小組設定來變更行為。 第三個屬性 StateColors 會定義與所有 WIT 工作流程狀態相關聯的色彩。 您設定的值會用於專案中的所有小組。

範例 Properties 組態:

 <Properties>  
      <Property name="BugsBehavior" value="AsTasks" />  
      <Property name="HiddenBacklogs" value="Microsoft.EpicCategory" />  
      <Property name="StateColors" value="Active=#FF00FF00,Resolved=#FFFF0000" />
      <Property name="WorkItemTypeIcons" value="Epic=Icon_Crown,Feature=Icon_Trophy,User Story=icon_book,
        Task=icon_clipboard,Bug=icon_insect,Issue=icon_traffic_cone,
        Test Plan=icon_test_plan,Test Suite=icon_test_suite,Test Case=icon_test_case,Shared Steps=icon_test_step,
        Shared Parameter=icon_test_parameter" />  
  </Properties>  

屬性 BugsBehavior 會決定 Bug 類別目錄中所定義的 Bug 和其他 WIT 如何顯示在待辦專案和麵板上。 基本上,您可以設定將 Bug 視為需求或工作處理,還是不在待處理項目和面板上顯示。 如需詳細資訊,請參閱 在待辦專案和麵板上顯示 Bug

屬性 HiddenBacklogs 會決定預設會出現哪些待辦專案/組合待辦專案。 預設值只是顯示產品待辦專案,以及一層組合待辦專案,也就是功能待辦專案。 Teams 可以判斷他們是否想要啟用 Epics 待辦專案,或進行其他變更。 如需詳細資訊,請參閱 組織待辦專案、為您的小組啟用待辦專案層級

Properties 元素的語法

Element

說明

屬性

選擇性。 用於指定預設屬性和行為的容器項目。

屬性

使用新功能更新專案時,指定對新小組或現有小組所做的預設指派。 小組可以透過其小組設定選擇所要的行為。

有效的屬性名稱包括:

  • BugsBehavior 會設定 待辦專案和麵板上顯示 Bug 的預設值。 允許的值對應至:
  • AsRequirements - Bug 會出現在待辦專案和麵板上,類似于 Scrum 程式預設的需求 ()
  • AsTasks - Bug 會出現在待辦專案和麵板上,類似于敏捷式和 CMMI 程式) 預設的工作 (
  • 關閉 — 待處理專案或面板上不會出現 Bug
  • HiddenBacklogs 預設會指定非 使用中的待辦專案
  • StateColors 會 設定工作流程狀態的色彩值。 (需要 TFS 2017 或更新版本)
    屬性的值是以逗號分隔的狀態名稱和十六進位色彩清單。 在六位數的十六進位色彩代碼前面加上 FF,表示色彩應該完全可見。
    <Property name="StateColors" value="stateName1=color1, stateName2=color2,..." />

注意

功能可用性: 如果您使用託管的 XML 或內部部署 XML,則可以指定工作流程狀態色彩,您已升級至 TFS 2015.2 或更新版本。
如需其他詳細資料,請參閱下一節: 指定工作流程狀態色彩

  • WorkItemTypeIcons 會定義要針對每個工作專案類型顯示的圖示。 圖示會顯示在工作專案清單和工作專案表單中。 敏捷式程式的預設專案如下所示。 您只能從 支援的圖示清單中指定圖示

<Property name="WorkItemTypeIcons" 
value="Epic=Icon_Crown,Feature=Icon_Trophy,  
User Story=icon_book,Task=icon_clipboard,Bug=icon_insect,  
Issue=icon_traffic_cone,Test Plan=icon_test_plan,Test Suite=icon_test_suite,  
Test Case=icon_test_beaker,Shared Steps=icon_test_step,Shared Parameter=icon_test_parameter" />

注意

功能可用性: 如果您使用託管 XML 或內部部署 XML,則可以自訂工作專案類型所使用的圖示,您已升級為 TFS 2017.2 或更新版本。

指定工作流程狀態色彩

注意

功能可用性:若要指定工作流程狀態色彩,您必須升級至 TFS 2015.2 或更新版本。

您與工作專案狀態相關聯的色彩會顯示在產品中。 這包括下欄區域:

在這裡,我們會示範它如何出現在工作專案表單中:

Bug 工作專案表單標頭,顯示狀態色彩

注意

用戶端工作專案表單或用戶端表單內舊連結控制項中不會顯示任何色彩。

詳細資料:

  • 您必須將色彩指定為八位數十六進位值,類似于針對 WIT 定義的色彩
  • 若要新增或編輯色彩,只需使用更新的屬性重新匯入您的進程組態
  • 狀態色彩會依名稱定義于所有工作專案類型,亦即,使用者劇本沒有辦法「作用中」是一種色彩,而 Bug 的色彩則不同
  • 未對應的色彩會根據其中繼狀態對應在執行時間預設
  • 未定義色彩的狀態,且沒有中繼狀態對應會顯示空的圓形。

指定 WIT 圖示

注意

功能可用性: 如果您使用託管 XML 或內部部署 XML,則可以自訂工作專案類型所使用的圖示,您已升級為 TFS 2017.2 或更新版本。

您可以為工作專案類型指定支援的圖示集如下所示。

icon_airplane、icon_asterisk、 icon_book、icon_car、icon_chart、icon_chat_bubble、icon_check_box、icon_clipboard、icon_code_response、icon_code_review icon_palette、icon_crown icon_database_storage、icon_diamond、icon_flame icon_gavel、icon_gear icon_gift、icon_government icon_headphone icon_insect、icon_key icon_list、icon_paint_brush icon_megaphone icon_paint_brush icon_parachute、icon_response、icon_review、icon_ribbon、icon_sticky_noteicon_star、icon_test_beaker、icon_test_parameter、icon_test_plan、icon_test_step、icon_test_suite、icon_traffic_cone icon_trophy

注意

Azure DevOps Services和 TFS 2017.3 和更新版本支援以星號表示的圖示。

系統會將工作專案類型所定義的色彩套用至圖示。 色彩和圖示會出現在入口網站中,其中一律會顯示工作專案。 這包括在 PR 中的 相關工作 、連結清單、 專案 頁面以及 工作 待辦專案、面板、查詢和計畫底下。

例如,您會在這裡看到清單檢視...

入口網站,包含圖示的工作專案清單

和,此處的圖示會顯示在工作專案表單中。

錯誤工作專案表單標頭、顯示的工作專案類型圖示

深入瞭解 Web 工作專案表單,以及如何從下列其他主題進行自訂:

如果您已新增自訂 WIT,而且想要將它新增至待辦專案或工作面板,您可以。 您只能讓它們出現在這兩個位置。 瞭解如何閱讀 將工作專案類型新增至待辦專案和麵板