## Agenda
- Dashboard：儀錶板使用
- Custom process：客製化流程
- Custom work item field：工單欄位客製化
- Release and Bug ticket：透過客製化方式新增即調整 Release 及 Bug Ticket
## Map
[TOC]
## 1/ Dashboard
- 左邊選單列中的 Overview 下點選 **[Dashboards]**，點選 **[Add a widget]**
- 選擇 **[Assign to me]**，然後點選 **[Add]**
- 可再添加 **[New Work Item]**，**[Query Tile]** 或自行添加其他項目
- 完成後選擇 **[Done Editing]**
- 點選 **[Query Tile]**，**[Select Queries]** 選擇 **[Shared Query]** > **[Task in Active]**(先前在 query 內建立的)
- 新增 work item template 新增快捷鍵
- Project Settings > Team Configuration > Bug > ... > Copy link
- 新增 markdown
- 點選 configure
- 將複製的 template URL 貼於 () 中並複製貼上 Custom markdown 欄位

        - [API Bug ticket](將 copy link 貼於此)

## 2/ 自定義 Process
### 新增以 Agile 為基礎的 Process
- Organization Setting > Process > Agile > … > Create inherited process
- 填寫名稱後選擇 create process
- 選擇建立的 process 名稱
- **Work item types** 可新增 work item 類別及調整該 work item 之欄位
- Backlogs levels 調整 board 頁面上各層級所顯示的 work item type
- **補充**：Bug 要 by project 設定，如要將 bug 顯示在 Stories 這個層級，則在 boards setting 做設定
- Boards
- Sprints
- **Projects** 可察看目前套用此 process 的 project

### Process Workflow
#### Workflow 須遵循以下
- 須至少定義一個狀態於 Proposed 或 In Progress State categories
- 每個 work item type workflow 最多 32 個工作流程狀態
- 無法修改繼承的狀態 (無法變更其名稱、色彩或類別) ，但可以隱藏
- 只能在 **Completed** State categories 中擁有一個狀態，如將自訂狀態新增至 **Completed** 類別，則會移除或隱藏任何其他狀態
#### 調整 process workflow
- 添加 Task 工單狀態 : Task > State > New State
- 新增一個 `Review` 在 `Proposed` 的 State category
- 新增完成
### Fields
每個欄位由下列三個屬性所定義：
- 資料類型 (Type)：指定可以輸入欄位的資料類型，例如布林值、浮點數、整數、字串等
- 易記名稱 (Name)：指定指派給欄位的名稱，此名稱可能與工作專案表單上顯示的名稱不同
#### 調整 Work Item 欄位
- 添加 Task 工單欄位 : **Task > Layout > New Field**，新增一個欄位 `Follow Up`
- 如先前有新增過的欄位，可直接選擇 Use an existing field
- 設定該欄位是否必填及預設值
- 隱藏不需要的預設欄位
- 新增名為 `Information` 頁籤：New Page
- 於新增的頁籤中添加 `Action` 區塊：New group
- 將剛剛新增的 `Follow Up` 移動至 `Information` 頁籤
- Layout > Page > 選擇 Information
- 在 Information 的 Action 區塊中新增欄位
- 新增 `External Bug No` 欄位
### 設定 Process Rule
- 選擇 Rules > New rule
- 設定 **當狀態為 New 時僅能移動至 Review**
- Conditions 使用 A work item state moved from New
- Action 選擇 Restrict the transition to state Active
- 點選 New action 新稱第二個限制
- 新增第三個限制
- 完成後點選  (儲存前須先填寫 rule name)
- 設定 **僅有 Reviewer 成員能將狀態從 Review 移動至 Active、Completed 及 Closed**
- 設定後，非 group 成員者無法顯示其他無法移動的狀態

### 新增 Work Item Type
- 點選 Process Name > New work item
- 新增 `Release` work item type
- 新增完成
### 將現有 Project 更改 process
- Organization Setting > Agiles > 要更改的 Project Name > ... > Change Process
- 選擇自行新增的 process
## 3/ Release ticket
- 調整 Release 的 backlogs level 與 Feature 一致，選擇 Backlog levels > Features > ... > Edite/Rename
- 將 Release 做勾選
<!--  -->
- 回到 work item types 頁面，將 Feature 禁用
- 選到剛剛新增的 Release work item
### 調整 Workflow
- Proposed 中新增 `Apply`、`Reject` 及 `Preview`，移除預設的 New
- In Progress 中新增 `Testing` 及 `Review`，移除預設的 Active
- Completed 新增 `Release`
- 新增一個 Removed 的 State Category，並將 `Drop` 新增到此狀態類別
- 完成
- 為 State 設定 rule
### 調整 Field
- 新增 `Initiator` 欄位，Type 設定為 `Identity`
- Options 可設定必填
- 選擇 **Add field** 完成新增
- 新增 `SW Name` 欄位，Type 設定為 `Text (single line)`，並設定為必填
- 分別新增以下欄位，Type 設定為 `Text (single line)`
- `SW Version`
- `SW Part Number`
- `HW Part Number`
- `Product Module`
- 新增 `SW Type` 單選清單，Type 為 **Picklist (string)**，Picklist items 添加 `Application`、`Firmware`、`Preload`、`Others`

- 新增 `SW Status` 單選清單，Type 為 **Picklist (string)**，Picklist items 添加 `Release`、`Drop`、`Review`、`Testing`、`Preview`、`Reject`

- 新增一個區塊，點選 **New group**，填寫名字，並設定 Layout，完成後點選 Add group
- 在 Date 的區塊新增欄位
- 新增以下欄位，Type 設定為 Date/Time
- `Apply Date`
- `Target Date`
- `Release Date`
- 設定完成

### 設定 Process Rule
- Rules > New rule
- 系統依據 State=Release 時間寫入 Release Date 欄位的資料
- 狀態的 rule 調整
- Apply
- Preview
- Reject
- Testing
- Review
- Drop
- Release
- 限制 General User group 的使用者無法將狀態移動至限制的狀態
- 新增 Group，Organization > Permission > Group
- 新增 Project Manager 及 General User
- 設定 rules
### 新增 Release work item
- Project > Boards > New work item > release
- 新增 `BMC FW` release work item
- 新增版本，Releated Work > Add Link
- 查看 Board
## 4/ Bug ticket
- Process > 客製化的 process > Work Item types
### 調整 Workflow
- 分別新增狀態到對應的狀態類別下
### 調整 Field
- 隱藏欄位
- 選擇特定的欄位 > ... > Hide from layout
- 隱藏其餘不需要的欄位
#### Creator
- 新增 `Creator` group，**New group** > 填入名稱 > **Add group**
- 新增 `Creator` field，設定為 Identity
- 新增 `Create Date`，設定為 Date/Time
- 新增 `System` page，**New page** > 填入名稱 > **Add page**
#### Planning
- 在 `Planning` 區塊新增 field
- 使用既有的 field 新增`Closed Date`，此 field 會在 State 為 Closed 時填入日期，當狀態異動時則清除
#### System Releated
- 新增 `System` 頁籤，Layout > New Page
- 在 System 頁籤新增 `System Info` 的 field
- 分別新增 `System Impact`、`End User Impact` 及 `Likelihood`，Type 設定為 **Picklist(string)**
- 各欄位清單
- 新增 `RPN`，類型為 Picklist(String)，清單輸入 `severity 1`、`severity 2`、`severity 3`、`severity 4`
- 使用 Visual Studio Marketplace 自動填寫套件 [Auto Fill Field Control](https://marketplace.visualstudio.com/items?itemName=AviHadad.Analize-Value)
- 安裝
- 選擇要安裝的組織，點選 Install
- 安裝完成後重新整理，點選 Add custom control > Options
- **Control Name** 可自行定義，需與後續 csv 檔案上傳名稱相同，**AutoFill** 設定要自動填寫的欄位，**FieldValue** 則設定要參考的欄位
- 下載 CSV - [RPNCalculate](https://1drv.ms/x/s!AtAJk4ApWmAFhLYlN-JhRD_d7Ev_tg?e=H2Hhlg)
- 新增 CSV，Organization Setting > Extensions > Auto Fill
- Configurations > Upload auto fill values by CSV file > Choose files
- 如果上傳成功會跳出確認視窗
- 可看到上傳資訊，Control Name
#### Solution
- 新增 `Solution` 頁籤，Layout > New Page
- 新增 `Soultion` 及 `Solution Version` 欄位，類行為 **Text (multiple lines)**

### 設定 Process Rule
- Rules > New rule
- 當狀態為 **Apply** 時，僅能異動至 Bug MGR Review
- 當狀態為 **Bug MGR Preview** 時，僅能異動至 **Deferred**、**Cancel** 或 **Analyze**
- 當狀態為 **Analyze** 時，僅能異動至 **Solve** 或 **Bug MGR Preview**
- 當狀態為 **Solve** 時，僅能異動至 **Analyze** 或 **Bug MGR Review**
- 當狀態為 **Solve** 將 **Solution** 及 **Solution Version** 設定為必填
- 當狀態為 **Bug MGR Review** 時，僅能異動至 **Verify** 或 **Analyze**
- 當狀態為 **Verify** 時，僅能異動至 **Analyze**、**Close** 及 **Limit**
- 回到 board，新增 bug work item 驗證功能
- 當設定至 Solve 時，Solution 變為必填