變更管理

“飛書審批整合”外掛已更名為“變更管理”，管理員可在空間配置-外掛管理-變更管理中升級版本。 詳細更新日誌見：

介紹

Meegle支援與飛書審批流程聯動，支援Meegle資訊變更/流轉時觸發飛書審批流程，並支援將Meegle欄位資訊同步飛書審批單，審批完成後自動完成Meegle的變更/流轉。適用於立項等嚴格專案管理流程。 同時，也支援配置在某些場景下，專案禁止變更。

本外掛支援審批場景：

1. 完成節點時發起審批，審批透過後自動完成節點
2. 狀態流轉時發起審批，審批透過後自動流轉狀態
3. 修改欄位值時發起審批，審批透過後自動修改欄位值
4. 修改節點估分與排期時發起審批，審批透過後自動修改估分排期資訊

5. 新建子任務時攔截 並支援配置：

6. 審批觸發必要條件

7. 若審批透過的節點/狀態回滾後再次流轉，支援配置是否需要重新發起審批

【使用者使用場景一】攔截變更

專案在某種場景下禁止變更，例如專案排期節點完成後，“專案開發”節點的排期變更將被攔截。

【使用者使用場景二】發起飛書審批

• 發起審批 當專案的節點完成時，提示“完成節點需要審批”，Meegle中需要審批的資訊表單將同步審批工單。

若需要審批的必填資訊還未填寫，則需要填寫後再發起審批工單。

點選“發起審批”後即可建立審批工單。

• 審批進展 在節點“審批詳情”後展示審批狀態。

點選檢視審批連結開啟審批詳情，檢視評審進展。

• 審批透過 發起審批工單，審批人將收到飛書訊息，對審批工單進行評估與確認。

審批透過後，節點將自動完成。

• 檢視審批記錄 在專案詳情頁“關聯審批”標籤頁中，可檢視專案所有審批記錄。

【使用者使用場景三】發起Meegle審批

• 發起審批 操作點選“完成節點”時，觸發Meegle審批

• 審批透過 將當前配置的審批工作項狀態流轉為“進行中“時，“需求“工作項對應的節點即可已完成

審批就結束了

【配置】外掛配置

安裝Meegle審批整合應用（位元組使用者無需此步驟，僅變更攔截無需此步驟）

飛書企業管理員需要在飛書中安裝Meegle審批整合聯結器應用。 若只需變更攔截，則無需配置此步驟。

飛書企業管理員在Meegle審批整合聯結器應用詳情頁中，點選“獲取”。

獲取應用後，可在飛書工作臺中檢查是否已存在“Meegle審批整合聯結器”應用。若存在，則安裝成功。

在企業管理後臺-工作臺-應用管理中，點選“Meegle審批整合聯結器”的配置；

在應用可見範圍中，可配置此應用可見使用者範圍。

發起審批人必須在此應用可見使用者範圍內。

安裝外掛

Meegle空間管理員需要在Meegle空間中安裝「變更管理」外掛。

空間管理員進入空間配置-外掛管理中，點選“新增外掛”； 或點選連結安裝：https://project.feishu.cn/openapp/plugin_share?appKey=MII_649EB6A8F904C004

在外掛商店中，搜尋“變更管理”，點選“新增外掛”。

新建規則

空間配置-外掛管理中，點選“變更管理”的配置；

點選新增規則 ，填寫規則名稱“專案立項審批”。

進行以下操作時

支援以下場景下發起飛書審批，可按需配置。

操作	配置	圖示
	選擇節點流工作項 選擇流程模板及節點 需要注意的是： 若節點的完成方式為自動完成，則無法觸發審批。 若節點的完成方式是單人確認完成，則節點完成時發起審批，審批完成後自動流轉節點。 若節點的完成方式是多人確認完成，則第一個節點負責完成後發起審批，全部節點負責人完成後節點完成。
	選擇狀態流工作項 選擇流程模板及狀態
	選擇工作項 選擇欄位 空值攔截：勾選後，欄位由空值變更為有值也需要審批
	選擇節點流工作項 選擇流程模板及節點 選擇節點估分和排期資訊
	選擇節點流工作項 選擇流程模板及節點
	選擇工作項 選擇角色 空值攔截：勾選後，角色由無人員到有人員的變更也需要審批 📢注意節點繫結角色後有部分場景目前不支援變更攔截

新增同時滿足的條件

配置發起審批的必要條件。 最多可配置 3 個條件，條件之間的關係為“且”。

條件型別	案例	圖示
	審批操作：變更開發節點的排期時需發起審批 增加發起審批條件：排期節點等於已完成
	審批操作：修改迭代描述 增加發起審批條件：“已結束”狀態到達
	審批操作：完成“製作專案主計劃”節點 增加發起審批條件：優先順序等於 P0
	審批操作：修改專案節點排期 增加發起審批條件：「專案經理」不包含當前登陸人員 （也就是專案經理修改自己負責的專案排期，無需發起審批）
	審批操作：“製作專案主計劃”節點完成時，發起審批 增加發起審批條件：“製作專案主計劃”節點的所有子任務全部完成

觸發以下行為

行為一：發起飛書審批

繫結的飛書審批 AppApproval Code

繫結對應飛書審批流程。 瞭解 AppApproval Code：https://open.larkoffice.com/document/server-docs/approval-v4/approval/overview-of-approval-resources#88f304a8

在飛書審批管理後臺，點選對應飛書審批流程後的“編輯”，進入飛書審批流程詳情；

在飛書審批流程頁面 url 中，複製此飛書審批流程 AppApproval Code；注意：飛書審批流程 AppApproval Code 為 url中definitionCode=後面的部分，並非id=後面的內容，參考下圖。

將飛書審批流程 AppApproval Code 貼上到「變更管理」外掛的規則配置中。

設定Meegle x 飛書審批資訊同步對映

配置飛書審批工單同步關聯Meegle的欄位資訊。

左側展示審批流程中必填資訊，可在右側配置將同步Meegle對應的欄位。配置欄位對映後，發起飛書審批流程時，將自動同步Meegle資訊至審批詳情。

Meegle角色人員對映至審批人

配置飛書審批人同步關聯Meegle的角色人員。 需要注意的是，飛書審批的審批人設定成“提交人自選”時，才可配置人員同步。

在欄位對映中，選擇審批環節名稱，並選擇對映來源為Meegle中的角色。

發起審批後，Meegle的人員將自動同步為飛書審批人。

附錄：已支援的欄位型別

Meegle支援的欄位型別如下：

• 文字：單行文字，多行文字，富文字
• 選擇：單選，多選，單選按鈕，級聯單選，級聯多選
• 人員：單選人員，多選人員
• 日期：日期，日期區間，日期+時間
• 其他：開關，數字，URL連結，附件
• 關聯工作項：單選關聯工作項，多選關聯工作項

飛書審批支援的欄位型別列表：

1. 單行文字
2. 多行文字
3. 日期
4. 數字
5. 聯絡人
6. 單選
7. 多選
8. 附件
9. 金額
10. 明細/表格（子欄位暫不支援日期區間）

審批透過後

操作	審批透過後
節點完成	審批透過後自動完成節點 審批透過後僅生效一次：勾選後，若審批透過的節點回滾後再次完成，需要重新發起審批
流轉至目標狀態	審批透過後自動流轉狀態 審批透過後僅生效一次：勾選後，若審批透過的狀態回滾後再次流轉，需要重新發起審批
修改欄位值	審批透過後自動修改欄位值
修改節點估分與排期	審批透過後自動修改估分排期資訊
新建子任務	審批透過後自動建立子任務

注意事項

1. 審批完成之後，失敗原因可能存在以下情況
2. 情況一：必填項
   1. 欄位必填可參考以下圖示

1. 必填角色未填寫可參考以下圖示

1. 情況二：欄位、角色、使用者組等許可權問題
   1. 許可權不足可參考以下圖示例
   2. 情況一

    1. 排查方向建議

  1. 情況二

    1. 排查方向：角色編輯許可權 + 例項檢視許可權

1. 有關人員欄位對映問題
2. 由於目前飛書審批的單、多選人員型別沒有透出，外掛感知不到。建議在配置側設定時統一用多選人員做對映
3. 互聯企業的人員在Meegle中發起飛書審批時，提示 “引數錯誤”

使用技巧

1. 飛書如何檢視被審批物件
2. 舉例場景：飛書審批在審批拒絕後如何增加提交的Meegle例項連結
   1. 可透過設定對映欄位：用飛書審批單行文字欄位 對映 Meegle內建欄位工作項鍊接

行為二：攔截變更

選擇“攔截變更”後，使用者將無法操作中的變更專案。同時，可配置觸發攔截時的提示內容，為空時將不提示。 例如，節點排期只能由節點負責人修改，非節點負責人修改將攔截。

行為三：發起Meegle審批

版本>= 4.0.0

配置側

選擇“Meegle審批”後，

新建審批工作項

選擇之後確定

配置完成之後，點選前往配置

例項側

最佳實踐

1、節點和子任務排期管控解決方案

• 場景：節點排期變更管控，當節點排期填寫後，修改節點排期必須提交審批
• 當使用者直接修改節點排期時，會觸發Meegle審批，必須提交併完成審批後才可變更排期
• 當使用者修改子任務時
  1. 當修改子任務排期影響了原節點排期，如超過原節點排期時間，或修改後原節點排期縮短，都會觸發攔截，不允許修改
  2. 當新建/刪除子任務，導致節點排期變更，會觸發攔截，不允許修改
• 如使用者需要修改子任務排期，需要先修改節點排期-提交審批，審批透過後可配置對應的子任務排期

• 具體配置

步驟	規則配置	截圖
一、配置「修改節點排期」審批	變更管理方式：飛書審批或Meegle審批 觸發變更管理的操作：操作節點/修改節點估分與排期
二、配置「修改子任務排期」攔截	變更管理方式：攔截變更 觸發變更管理的操作：操作子任務/修改子任務排期 修改子任務排期-配置：勾選空值變更攔截 同時滿足以下條件時：「目標排期」影響排期「所屬節點排期」 攔截提示：子任務排期變更影響節點排期
三、配置「新建子任務」攔截	變更管理方式：攔截變更 觸發變更管理的操作：操作子任務/新建子任務 同時滿足以下條件時：「目標排期」影響排期「所屬節點排期」 攔截提示：子任務排期變更影響節點排期
四、配置「刪除子任務」攔截	變更管理方式：攔截變更 觸發變更管理的操作：操作子任務/刪除子任務 同時滿足以下條件時：「目標排期」影響排期「所屬節點排期」 攔截提示：子任務排期變更影響節點排期

2、計劃表修改節點排期審批

在空間配置-外掛管理-變更管理外掛-新建規則；

• 選擇Meegle審批-「修改計劃錶行排期」；
• 選擇「根工作項為A」；
• 配置「子工作項型別等於A」，且「節點存在選項屬於a」；
• 並配置並選擇審批的工作項；
• 儲存規則後，在審批工作項詳情頁中配置「變更明細」控制元件；

觸發審批 在計劃表-點選編輯-修改a節點排期或估分併發布計劃時，即可觸發審批。

審批詳情 在專案「關聯審批」標籤頁和審批工作項內可檢視審批詳情。 點選審批單的「變更明細」可跳轉檢視計劃表詳細變更資訊，支援勾選僅檢視變更行，左右分欄對比變更前後內容。

3、與飛書審批功能整合

基於當前的實現，為了保證使用者使用時的流程穩定性，建議針對以下飛書審批功能進行配置：

1. 設定飛書審批被拒絕或撤回後，不允許在飛書審批中”再次提交“ 在飛書審批管理後臺-審批流程-基礎資訊-誰可以提交審批，設定成「均不可提交」

1. 關閉飛書審批「回退」功能
2. 在飛書審批管理後臺，點選對應飛書審批流程後的“編輯”，進入飛書審批流程詳情；
3. 在流程設計-審批-操作許可權，關閉「允許回退」後，儲存

1. 不在飛書審批內修改審批欄位值

4、審批次數度量

支援透過度量圖表來檢視工作項審批情況

開啟審批記錄開關

管理員點選空間配置 → 外掛管理→ 變更管理 → 全域性配置後，開啟審批記錄開關，會自動化建立「審批記錄」工作項

在詳情頁檢視審批次數

管理員點選“空間配置“ → “工作項管理” → 審批物件（如需求） → 頁面佈局 → 表單資源庫 → 圖表即可開始配置。

配置圖表元件

新建「審批記錄」標籤頁，選擇需要配置的圖表型別拖拽到標籤頁配置表單內

高階配置-切換資料來源

1. 高階配置中可以便捷切換資料來源，在詳情頁下點選圖表後，接著再右下角點選“高階配置”選項進入度量高階配置。
2. 點選右上角“源資料範圍”選項可以切換資料來源，改成工作項-審批記錄
3. 點選篩選條件-設定“審批物件-需求”欄位條件為“當前值”。

設定緯度和指標

圖表型別	篩選條件	緯度（欄位）	指標（欄位	效果
資料表	“審批物件”存在選項為“當前值”	審批型別 觸發行為 變更事件(顯示值)	工作項id（去重計數） 可修改名稱為審批次數

在度量圖表檢視整體審批次數

新建度量圖表

1. 在檢視列表中，新建一個度量檢視。
2. 在度量檢視右上角點選「新建」-「自定義圖表」
3. 選擇資料範圍：工作項
4. 工作項：審批記錄
5. 圖表型別：透視表

設定緯度和指標

圖表型別	緯度（欄位）	指標（欄位	透視表篩選	效果
透視表	審批物件 審批型別 觸發行為 變更事件(顯示值)	工作項id（去重計數） 可修改名稱為審批次數	「工作項id」不等於「0」

5、飛書審批的單工作項欄位值修改：支援在飛書審批單裡修改值內容進行回寫

版本>= 5.2.0 一期僅支援：單行文字、多行文字、連結、單選、多選、數字、日期 PS: 目前僅支援觸發審批的欄位回寫，不支援欄位對映中的欄位回寫

如何配置

如何使用

規則頁面設定

例項頁面展示

發起審批之後，飛書審批單可進行修改，修改完點選同意流程就走完了

6、支援批次新增欄位審批功能（目前僅在列表模式時支援）

版本>= 5.1.0

如何配置

如何使用

7、OpenAPI 攔截配置功能，該功能預設處於開啟狀態

版本>= 5.1.5

常見問題

有哪些操作是無法透過外掛進行攔截/審批的？

目前已知的操作行為有：

1. 自動化觸發的聯動修改欄位/節點排期
2. 空間聯動功能觸發的聯動修改欄位/節點排期
3. 透過API進行資料操作
4. 在工作項檢視內進行批次修改欄位
5. 透過工作項檢視控制元件匯入已有工作項的方式修改關聯工作項欄位
6. IPD 計劃表內編輯僅支援節點排期、估分、負責人、排期彙總項、行增刪的攔截，其餘操作均暫不支援

飛書審批已透過，但關聯的工作項刪除或終止了，如何設定透過的審批單不自動撤回？

在外掛配置-規則中取消勾選「終止或刪除工作項時撤回飛書審批」

飛書審批撤回後，Meegle節點是否重新發起審批？

需要再次發起審批。

Meegle節點回滾後，飛書審批是否需要重新審批？

• 勾選“審批透過後僅生效一次”後，若審批透過的狀態回滾後再次流轉，需要重新發起審批。
• 不勾選“審批透過後僅生效一次”，若審批透過的狀態回滾後再次流轉，無需重新發起審批。

發起審批後是否可以更新Meegle中需要審批的欄位資訊？

不可以。

關聯審批的詳情頁怎麼配置？

外掛預置功能無法配置，安裝外掛後即自動新增。

設定了節點排期變更/攔截，修改子任務排期時引起的節點排期變化是否會攔截？

暫不會攔截

報錯：請將"變更資訊"配置為內容對映來源

在飛書審批-配置-設定欄位對映-新增欄位對映，在內容對映來源下拉框中選擇變更資訊

終止工作項時，需要在審批裡輸入原因

版本>=5.8.0（終止或恢復工作項審批支援帶入使用者選擇的原因） 目前不支援工作項選擇的原因同步到飛書審批單

工作項審批支援角色和欄位的對映（不包括計劃表）

版本>=5.6.0

如何配置

如何使用

以下變更事件為：修改欄位，觸發變更單（關注人）對映到審批單（審批人專用角色）的演示

同步失敗原因排查

• 檢查建單人是否有審批單對應欄位的修改許可權，外掛以建單人的身份進行欄位更新，且在對映列表裡任意欄位、角色沒有修改許可權，都會導致全部對映列表同步失敗。

計劃表工作項審批支援欄位、角色同步到審批單

版本>=5.7.0

如何配置

計劃表可新增多組對映關係，根據被攔截的工作項做欄位、角色的對映

如何使用

以下變更事件為：修改計劃表，變更單（PM角色）對映到審批單（審批人角色）的演示

飛書審批出現：發生了未知錯誤，請稍等再試

建議從以下欄位型別排查（飛書審批/表單設計頁面）

1. 聯絡人：選擇方式更正為多選
2. 數字：是否設定數值範圍
3. 日期：是否限制提交人可選日期

飛書審批中使用了引用多維表格控制元件，發起飛書審批時提示此選項值不在飛書審批定義的選項中

目前變更管理發起的飛書審批暫不支援引用多維表格控制元件相關的欄位。

節點完成 完成節點時發起審批，審批透過後自動完成節點 流轉至目標狀態 狀態流轉時發起審批，審批透過後自動流轉狀態 修改欄位值 修改欄位值時發起審批，審批透過後自動修改欄位值 修改節點估分與排期 修改節點估分與排期時發起審批，審批透過後自動修改估分排期資訊 刪除/完成/取消子任務 刪除/完成/取消子任務時發起審批，審批透過後自動建立子任務 修改角色人員 版本不低於4.5.0支援該功能 修改角色人員時發起審批，審批透過後完成人員修改 節點 某個節點是否完成 狀態 某個狀態是否到達 欄位 欄位是否為某個值 角色 角色是否為某個人員 動態條件 當操作為“完成節點”時，可以設定動態條件：

• 此節點的負責人為某個人員
• 此節點的子任務是否全部完成
• 此節點的子任務狀態是否等於未完成 ，版本>=4.4.0