手把手教你如何高效落地專案管理，雲效Projex是新一代企業級研發協作平臺，集成了敏捷研發專案管理的最佳實踐，提供了針對專案、迭代、需求、缺陷等多個維度的協同管理以及相關的統計報告，讓研發團隊高效協作、踐行敏捷並持續交付產品價值。且提供了關於單專案管理工作項的模板管理能力，模板管理分為欄位模板及內容模板。通過欄位模板管理可以統一特定型別的屬性填寫規則，提高協作的規範性；內容模板可以給定協作過程中的內容格式，提高協作的高效性。 

工作項模板管理  

雲效Projex提供了工作項的模板管理能力，模板管理分為欄位模板及內容模板。通過欄位模板管理可以統一特定型別的屬性填寫規則，提高協作的規範性；內容模板可以給定協作過程中的內容格式，提高協作的高效性。   

1.進入到專案-專案設定-工作項設定.需求頁面，選擇某個具體型別進行配置。

2.欄位模板配置

支援屬性欄位的新增、刪除、預設值設定、必填設定、展示順序調整。

預設的系統欄位不支援刪除。

新增欄位：支援欄位檢索及資訊檢視。如果檢索不到所需欄位，可跳轉至基本資訊管理新建欄位（具體企業級欄位管理許可權），或者聯絡企業管理員新增。

3.內容模板設定

內容模板在配置後，新建的工作項會自帶內容格式。

工作流配置

工作流設定入口

雲效Projex支援為每一種工作項型別配置不同的工作流，包括需求、任務、缺陷、風險。

在工作項設定區域，首先選擇工作項型別，然後點選“操作”圖示，即可進入工作流設定頁面。

設定工作流狀態流轉規則

Projex的工作流設定採用“二維表”模式，表格的“行”和“列”都是該工作流中所有的狀態，如果某個cell被選中，代表這個cell的“行”狀態可以變更到“列”狀態，如下圖紅色cell代表狀態可以從“代處理”變化到“處理中”。

為工作流增加狀態

如果您需要將新的狀態新增到工作流，可以點選右上角的新增按鈕，並且選擇需要新增的狀態，然後新增到工作流。

這裡能新增的狀態，是由基本資訊管理好的狀態列表，如果列表中沒有合適的狀態，請聯絡企業管理員新增新的狀態。

每個狀態都歸屬於一個“階段”，例如“開發中”和“開發完成”都屬於“開發階段”。當狀態被新增到工作流中，會按照階段進行歸類排序。

修改操作步驟規則

您不僅可以設定狀態的變化步驟，還可以給某個狀態變化步驟設定規則。這裡的常用規則包括：

• 當變化到這個狀態時，某個工作項欄位必填

• 只有某些使用者或某些角色可以修改這個狀態

實際應用場景案例：

• 當需求完成時，需要使用者填寫花費的工時

• 缺陷關閉時要選擇缺陷原因

• 缺陷只有測試人員可以關閉

刪除狀態

在工作流中不需要某個狀態時，可滑鼠hover到對應狀態上從工作流中刪除該狀態。刪除後之前流轉到該狀態的關係將不再存在。

成員管理

雲效Projex提供了靈活的成員管理能力。專案管理員可以新增企業內已有角色到專案內，自行配置許可權。

角色新增及許可權配置。專案管理員預設具備所有專案許可權且不可取消。

 

專案許可權說明

服務	許可權點	說明
工作項 （包含需求、缺陷、任務、風險）	建立	是否可以建立工作項。當無許可權時建立會提示無許可權操作。
	評論	是否可以評論工作項。當無許可權時提交評論會提示無許可權操作
	關聯	是否可以操作關聯其他工作項、關聯/建立子項、關聯父項。
	批量匯入、匯出	是否可以批量匯出、匯入。
	欄位修改	是否可以除狀態、型別、歸屬專案、內容標題以外的欄位的修改。包含批量修改欄位許可權校驗。
	狀態修改	是否可以修改狀態。當無許可權時無法修改狀態。包含批量修改狀態許可權校驗。
	變更型別	是否可以修改型別。當無許可權時無法修改型別。包含批量修改型別許可權校驗。
	歸屬專案修改	是否可以修改歸屬專案。當無許可權時無法修改歸屬專案。包含批量修改歸屬專案許可權校驗。
	內容標題修改	是否可以修改內容標題。當無許可權時無法修改內容標題。包含批量修改內容標題許可權校驗。
	登記工時	是否可以登記工時。當無許可權時無法提交登記工時。
	歸檔	是否可以歸檔工作項。當無許可權時操作提示無許可權。
	刪除	是否可以刪除工作項。當無許可權時操作提示無許可權。
迭代	建立、編輯	是否可以建立、編輯迭代。當無許可權時建立或編輯提示無許可權。
檢視	公共檢視建立、編輯	是否可以建立、編輯公共檢視。當無許可權時建立或編輯提示無許可權。
里程碑	建立、編輯	是否可以建立、編輯里程碑。當無許可權時建立或編輯提示無許可權。
專案設定	配置	是否可以配置專案的設定，包括基本資訊、成員管理、導航服務、工作項配置等操作。當無許可權時操作提示無許可權。

通知設定

為了能夠更加靈活的支援使用者在企業層級和專案層級通知場景，雲效Projex在專案模板及專案中支援通知配置。在配置中可靈活定製通知範圍、通知渠道。

1.專案設定

專案的通知設定支援通知角色設定、通知渠道設定。當全部角色或渠道取消設定後，意味著當前通知事件關閉。

2.模板設定

基於模板建立的專案自動初始化模板配置的通知規則，使一套模板的專案具備相同的通知邏輯。同時支援在專案內自行調整，更加適配專案的協作場景。

Wehook 配置說明

在雲效Projex中支援研發工具整合。目前支援雲效自研雲效程式碼管理平臺Codeup的整合，後續會繼續擴充套件如Github等三方平臺的整合。

整合Codeup後，可以實現程式碼的提交、合併請求的狀態變更聯動工作項的變更，實現研發只關注開發工作而不需要維護工作項狀態變化的目的。

在專案設定中，進入webhook設定頁面。展現當前整合的平臺列表。

點選配置進入平臺配置詳情頁面，展現webhook配置的物料及說明。

根據配置說明，複製配置物料到Codeup中進行webhook配置。訂閱專案監聽的程式碼庫事件。

token複製及重新生成需要進行許可權鑑定，需要具備專案配置管理許可權的人員才可進行操作，其餘人員無法進行操作。

在重新生成token後，之前已經在Codeup中配置的token會失效。需要進行及時更新，否則會導致程式碼庫的事件無法監聽。

自動化規則

為什麼要用它？

在日常工作中使用協作工具你可能會遇到這些問題：

1.需求關聯的程式碼已經發布了，但是狀態還停留在待處理

2.這部分工作有固定介面人，但是每次我還要手動指定到這個人負責。

3.我負責的工作項已經快到期了，但是一點提醒都沒有，我錯過了交付時間。

這些問題造成了很大的手動維護成本，且往往會由於更新不及時造成交付效率降低。

為了更好的解決你的這些問題，我們提供了自動化引擎服務，它通過觸發-過濾-響應模式，完成狀態自動流轉、需求自動指派、自動催辦。繁瑣重複的事務交給自動化引擎，讓你有更多的時間精力投入有價值的工作。

在什麼場景下用到它？

通過制定自動化規則可以幫助你在日常協作中進行狀態自動流轉、需求自動指派、自動催辦、平臺整合。

• 狀態自動流轉

當需求與實際的產研工作結合時，狀態流轉往往是通過一些實際的動作觸發的。以往使用者在完成具體工作後，還需要手動到平臺上變更狀態。增加了手動操作成本，還造成了協作效率下降、協作流程不規範的問題。通過自動化引擎設定的狀態自動流轉可以很好的解決這一問題。

實際場景舉例

• 需求規劃到迭代中，狀態變更為開發中。

配置示例

 

• 需求自動指派

在專案的管理到達成熟階段後，每個部分都會有實際的負責人。以往使用者在建立需求時要多方詢問確定負責人，這對使用者建立非常不便，且增加溝通成本。如果隨意指派則可能造成需求交付不及時，甚至漏掉需求的風險。通過自動化規則的需求自動指派可以很好的解決這一問題。

實際場景舉例

• 需求的狀態變更為測試中，自動指派給測試人員。

配置示例

• 屬性自動變更

在一些協作場景中，需求的某些欄位值是由其他操作觸發的。以往使用者需要手動維護屬性值，增加了手動維護成本且會存在更新不及時或不準確的問題。通過自動化規則的屬性自動變更可以很好的解決這一問題。

實際場景舉例

• 需求的標籤添加了“KA需求”，優先順序自動變更為高。

配置示例

• 自動催辦

在需求或任務到期前，專案管理者是希望能夠及時提醒負責人進行處理的。以往手動提醒成本很高且提醒不夠及時。通過自動化規則的自動催辦可以很好的解決這一問題。

實際場景舉例

• 需求在計劃完成日期前3天，提醒需求負責人儘快完成。

配置示例

怎麼用它？

自動化規則引擎分為三個部分：觸發事件、執行條件、執行動作。為了減少使用成本，雲效提供了開箱即用的模板給到你直接使用。

只需要更改模板的欄位，即可完成規則建立。

當規則觸發後，對應工作項會展現規則執行記錄。

點選進入規則執行詳情頁面檢視具體資訊。

在自動化設定中聚合了所有專案內的規則執行記錄，可檢視規則建立、變更、執行記錄。

針對執行失敗的規則展現特殊標記，進入可檢視失敗詳情。

Devops聯動

在雲效Projex通過自動化規則配置實現使用者在協作場景中與實際工作內容（程式碼提交、合併請求狀態變更等）發生聯動，支援工作項與關聯的物件（包含工作項、研發物件、測試用例等）聯動。

1.程式碼提交與工作項狀態聯動

場景：當缺陷存在帶有fix ID的提交時時，變更狀態為已修復。

可以根據關聯工作項的提交包含的關鍵字，聯動工作項的狀態或者欄位的變更。如果設定不為空，則無需校驗提交內容。

2.合併請求與工作項聯動

當合並請求關聯時觸發工作項的變更。一旦關聯發生，則可以觸發後續的工作項狀態變更或欄位變更。

當關聯的合併請求狀態發生變更時觸發工作項的變更。為了能夠監聽到關聯的合併請求狀態變化，需要到對應程式碼庫進行webhook配置。若不進行配置，則會導致規則無法執行。

注：在模板層級配置的規則，需要具體專案的webhook配置到程式碼庫中才可生效。

3.分支與工作項關聯

當分支關聯時觸發工作項的變更。一旦關聯發生，則可以觸發後續的工作項狀態變更或欄位變更。

4.測試用例與工作項聯動

當測試用例關聯時觸發工作項的變更。一旦關聯發生，則可以觸發後續的工作項狀態變更或欄位變更。

釘釘群通知配置指南

在催辦場景下我們支援釘釘群通知到負責人待辦處理，提高協作的效率。

【釘釘群圖示例】

首先，需要在釘釘群建立一個催辦機器人。配置入口：「釘釘群」-「群設定」-「智慧群助手」-「新增機器人」具體配置請參見釘釘群自定義機器人配置說明。

之後在Projex自動化配置中選擇合適的催辦模板，我們目前提供的釘釘群催辦模板如下。

以工作項狀態流轉催辦為例，我們選擇第一個模板進行配置。

名稱：作為通知的標題出現，可以選擇符合場景的合適標題。

Webhook地址：複製釘釘機器人的Webhook地址貼上進來。

加簽金鑰：選擇釘釘機器人的金鑰貼上進來。

點選儲存完成釘釘群通知配置。

 

Webhook配置指南

在自動化規則中，支援聯動三方平臺進行協作的動作流轉。如工作項的狀態聯動企業的審批系統工單流轉。這種流轉方式我們採用Webhook進行支援。

對應模板如下圖所示：

目前支援欄位變更或者狀態變更觸發三方平臺的動作。

配置

Webhook URL：Webhook請求地址，http:// 或 https:// 開頭

HTTP Method：支援POST、GET

Secret：可選，用於對@Webhook請求進行校驗。設定了Secret後，發起Webhook請求時，會增加請求頭X-Projex-Signature，Value即為Secret的值。

Headers：可選，支援設定請求頭

Webhook Body：設定為【空資料】時，發起POST請求時，Body為空；設定為【工作項資料】時，Body內容為當前規則作用的工作項資料(需求、缺陷、任務)，示例規則：產品類需求建立時，觸發Webhook請求，此時發起Webhook請求時，會將需求的資料物件放在Body中。

【工作項資料】為JSON物件，其中欄位如下所示：

欄位名	欄位型別	欄位描述
identifier	String	工作項的唯一標識
gmtCreate	Long	建立時間，時間戳，單位毫秒
gmtModified	Long	建立時間，時間戳，單位毫秒
creator	User	建立者
modifier	User	最近更新者
assignedTo	User	負責人
status	Status	狀態
workitemType	WorkitemType	工作項型別，如 產品類需求……
space	Space	歸屬專案
subject	String	標題
document	Document	描述
parentIdentifier	String	父工作項的唯一標識，如父需求、父任務
customFieldValue	List<CustomValue>	自定義欄位值
sprint	List<Sprint>	迭代
tag	List<Tag>	標籤
tracker	List<User>	抄送人
participant	List<User>	參與人
verifier	List<User>	驗證者

使用者型別--User

欄位名	欄位型別	欄位描述
identifier	String	使用者的唯一標識
realName	String	使用者真名
nickName	String	使用者暱稱

狀態型別 -- Status

欄位名	欄位型別	欄位描述
identifier	String	狀態的唯一標識
name	String	狀態中文名稱
nameEn	String	狀態英文名稱

工作項型別 -- WorkitemType

欄位名	欄位型別	欄位描述
identifier	String	工作項型別的唯一標識
name	String	工作項型別的中文名稱
nameEn	String	工作項型別的英文名稱
categoryIdentifier	String	工作項類別： 需求 -- Req 缺陷 -- Bug 任務 -- Task

專案型別 -- Space

欄位名	欄位型別	欄位描述
identifier	String	空間的唯一標識
name	String	空間的名稱

文件型別 -- Document

欄位名	欄位型別	欄位描述
content	String	內容

迭代 -- Sprint

欄位名	欄位型別	欄位描述
identifier	String	迭代的唯一標識
name	String	迭代的名稱

標籤 -- Tag

欄位名	欄位型別	欄位描述
identifier	String	標籤的唯一標識
name	String	標籤的名稱
color	String	顏色

測試

配置完成後，可以點選“進行Webhook請求測試”，測試配置是否正確。

雲效Projex是新一代企業級研發協作平臺，集成了敏捷研發專案管理的最佳實踐，提供了針對專案、迭代、需求、缺陷等多個維度的協同管理以及相關的統計報告，讓研發團隊高效協作、踐行敏捷並持續交付產品價值。且提供了關於單專案管理工作項的模板管理能力，模板管理分為欄位模板及內容模板。通過欄位模板管理可以統一特定型別的屬性填寫規則，提高協作的規範性；內容模板可以給定協作過程中的內容格式，提高協作的高效性。 

---

點選下方連結，即可免費體驗雲效Projex

https://www.aliyun.com/product/yunxiao/project?channel=yy_0525

關於我們

瞭解更多關於雲效DevOps的最新動態，可微信搜尋關注【雲效】公眾號；

福利：公眾號後臺回覆【指南】，可獲得《阿里巴巴DevOps實踐指南》&《10倍研發效能提升案例集》；

看完覺得對您有所幫助別忘記點贊、收藏和關注呦；