瞭解自動化¶
介紹¶
自動化提供開放靈活的規則指令，使用「觸發場景+篩選條件 + 執行動作」的配置方式，實現節點流轉、操作通知、欄位值修改等場景的個性化操作。 也可以透過規則執行測試和執行記錄功能，測試和檢視規則配置效果
相關手冊： 更多功能，等你體驗：
基礎概念¶
在使用Meegle自動化前，我們需要了解一下自動化相關的基礎概念。
流程圖¶
自動化提供了易上手的介面化流程編輯，先命名，接著設定觸發器，如果有條件選擇條件，再接著設定操作是否通知、執行 Webhook 等操作。
語義化¶
對流程圖的語義化解釋。
觸發器¶
在自動化配置中，觸發器配置的是“在什麼場景下觸發”，也就是自動化觸發的時機。
在某個場景下觸發自動化規則，例如：
- 需求建立時觸發。
- 需求的開發節點延期 1 天。
- 在某個時間點觸發，例如每週一的早上 10:00。
- 專案排期變更時觸發。
條件¶
在自動化配置中，條件配置的是“需要滿足什麼條件”，也就是過濾出滿足條件的任務列表。
對某條件下的例項執行自動化規則，例如：
- 對某條業務線下的需求進行通知
- 彙總未排期的需求列表
- 篩選出某個“人員”或“團隊”參與的任務列表
- 彙總“前端開發”角色參與的需求到前端小組群
操作¶
在自動化配置中，操作配置的是“執行什麼操作”。
執行某個對應的操作，例如：
- 通知
- 修改或同步指定的欄位值
- 將指定的節點狀態修改為指定值
- 向指定的節點/角色分配人員
- 變更指定的工作項狀態值
- 在當前空間中建立新的工作項
執行測試¶
- 支援指定資料（如某個需求）測試一次自動化規則，所有操作會在當前空間真實生效，如欄位、節點、狀態、人員修改，建立工作項、群組
- 如果卡片配置了拆分規則，如定時迴圈-個人僅收到當前負責人為自己的卡片，在執行測試的時候不會生效，收到的是符合條件值的資料集卡片
支援使用者手動觸發執行自動化規則，自行檢測規則執行是否符合配置預期，如測試「定時迴圈通知卡片效果」，操作步驟：
- 點選規則頁面對應操作
- 點選右上方的執行頁面
- 點選執行或選擇執行資料後點選執行
| 業務實踐場景 | 配置截圖 |
|---|---|
| 檢視飛書通知是否符合預期 使用者配置完成了定時任務的卡片，想看下自己配置的篩選條件是否準確，以及卡片的展現效果是不是符合自己的預期。 支援使用者手動觸發定時任務通知，對應卡片即刻可推送至個人賬號，檢視對應的卡片效果，若不符合預期即刻可調整規則再次測試，提升規則配置效率 |
 |
| 檢視自動化操作是否會生效 使用者配置完成了缺陷和關聯執行用例同步的規則，想看下對應規則生效以後的欄位值同步效果。 支援使用者在規則配置中直接調起對應符合規則配置的當前空間例項，檢視當前規則下的執行效果是否符合預期。 |
 |
執行記錄¶
- 點選空間配置>自動化>右上角的 執行記錄 按鈕，可檢視所有規則的執行情況。
- 點選編輯自動化規則> 上方的執行記錄頁面，也可以檢視對應規則的執行情況。 注：只支援查詢本功能上線時間後的執行日誌
使用場景¶
操作記錄支援按照分支+節點檢視執行成功/失敗的明細 1）若規則未觸發，則執行記錄不展現 2）若規則觸發但未執行操作，對應觸發節點執行成功，但操作節點執行失敗，支援檢視具體節點未執行/執行失敗的原因
| 業務實踐場景 | 配置 | 圖示 |
|---|---|---|
| 查詢自動化通知對應的規則名稱 可檢視所有規則的執行情況 |
場景：收到了飛書通知，想知道是哪個規則觸發的通知 排查：點選空間配置>自動化>右上角的 執行記錄 按鈕，透過觸發時間篩選對應的規則名稱 |
  |
| 自動化規則未生效排查 操作記錄支援按照分支+節點檢視執行成功/失敗的明細 |
場景：配置了訊息通知，如節點流轉通知，但實際未收到通知 排查：對應的需求未滿足條件配置 |
 |
| 自動化部分資料未生效排查 執行記錄支援檢視觸發/操作對應的工作項list |
場景：配置了一個定時任務進行批次的欄位修改，檢視哪些工作項同步成功 |  |
規則未生效排查方法¶
場景一：無執行記錄¶
若對應規則無執行記錄，則說明規則未被成功觸發，即觸發器配置有誤或未滿足觸發條件
| 觸發器分類 | 常見未觸發原因 |
|---|---|
| 欄位值修改 | 新建例項的時候不會觸發，必須是修改新建好的需求（或其他例項）欄位值，如果要新建的時候觸發應該用建立工作項觸發器 |
| 工作項狀態修改 | 確認每個節點是否配置了到達事件的狀態修改，既需要檢視示例操作記錄，確認狀態有變更才能觸發，節點流轉不一定會觸發 |
| 動態時間任務 | 需求停留時長已超過設定天數，狀態停留超期提醒為超過xx天時提醒，比如7月5號時設定超期3天時提醒，這個時候超期4天的歷史需求（如7月1號排期到期的需求）不會提醒 已完成和終止的工作項不會觸發，如需求在「已結束」狀態停留n天，不會生效 |
場景二：顯示執行成功，但規則未生效¶
- 顯示執行成功但未滿足篩選條件，操作不會生效，需排查條件配置
- 飛書通知執行成功但無執行物件，可透過下面方法排查
| 常見原因 | 排查方法 | 圖示 |
|---|---|---|
| 不滿足篩選條件組 | 條件最多隻能傳遞6000個工作項，如果條件或檢視資料篩選出來的工作項超過6000個，自動化不生效 |  |
| 欄位值：在條件的關聯關係裡選擇“透過檢視關聯”時，必須要檢視內所有工作項例項都滿足條件才算透過 |  |
|
| 飛書通知-訊息ID-無執行物件 | 自動化不會通知給操作人（包括指定人員）：所以測試的時候如果要通知給自己，可以設定通知到一個測試群，或者在通知人中配置「規則觸發人」，即觸發器操作人和通知的角色上是同一個人是，不會生效 舉個例子： 節點流轉通知給角色PM，如果你把PM角色填上你自己，就不會通知 通知給指定人員 @xx，指定人員是你自己時也不會通知 |
  |
| 通知至個人-指定角色：對應角色上沒有人員 在具體需求-詳情頁-檢視角色上是否有人，或者使用的是否為角色人員控制元件上的角色，而不是自定義欄位 如：節點流轉通知給角色PM，PM上沒填具體的人，就不會通知 |
 |
場景三：顯示執行失敗或部分成功¶
可透過下列操作及常見失敗原因進行排查
| 操作分類 | 失敗原因 | 排查方法 |
|---|---|---|
| 飛書通知 | 操作人主動關閉訊息通知 | - |
| 批次資料操作關閉訊息通知 | 勾選了「批次修改時,關閉訊息通知」 |
|
| 資料匯入關閉訊息通知 | 匯入資料時，勾選了「本次匯入關閉訊息通知」 |
|
| 計算欄位變更自動化關閉訊息傳送 | - | |
| 構造卡片失敗 | - | |
| 傳送卡片失敗，狀態碼：xxxx | - | |
| 接收人不在Meegle機器人的可用範圍內，或者是在禁用範圍內 | 在飛書內搜尋「Meegle」機器人，檢視是否有機器人使用許可權，若無許可權，聯絡企業管理員配置機器人可用範圍和可用成員>>配置  |
|
| 使用者已設定不再接收機器人訊息 | - | |
| Meegle機器人不在接收群內 | 在群「···」-設定-群機器人-檢視是否有「Meegle」機器人 注：位元組內部為「Meego專案管理」機器人  |
|
| 當前時間不在配置的傳送時間範圍內（如跳過節假日） | 自動化規則-飛書通知-勾選了「工作日通知設定，跳過法定節假日及週六日」 |
|
| webhook | 自動化系統異常 | - |
| 操作人主動關閉訊息通知 | - | |
| 批次資料操作關閉訊息通知 | 勾選了「批次修改時,關閉訊息通知」 |
|
| 資料匯入關閉訊息通知 | 匯入資料時，勾選了「本次匯入關閉訊息通知」 |
|
| 計算欄位變更自動化關閉訊息傳送 | - | |
| 商業化額度不足 | Webhook 每日觸發次數 商業版：1000次/天 旗艦版：10000次/天 行業專版： 30000次/天 |
|
| 失敗次數過多被熔斷 | - | |
| 呼叫webhook地址失敗，狀態碼：xxxx | - | |
| 欄位修改 | 不符合目標欄位的選項匹配策略（選項id一致才可匹配成功） | 配置選項欄位同步，需選項id一致才可成功；在空間配置-工作項管理-工作項（如需求）-欄位管理-欄位-檢視選項-高階配置，可檢視 如優先順序欄位，必須兩個工作項「P0」選項的id一致才能同步 已配置的選項id無法修改，可透過新建欄位-複用已有欄位選項或新建選項來實現一致   |
| 不符合目標欄位的欄位範圍（包含多選關聯欄位/多選丟棄部分無效值） | 確認欄位管理-關聯欄位-資料可見範圍，比如配置了資料範圍不等於已歸檔，已歸檔的不會同步 |
|
| 工作項例項不存在 | - | |
| 人員分配 | 不符合目標人員的限制範圍 | - |
| xx角色在例項中不可見，無法更新人員值 | 點選詳情頁-角色與人員控制元件，確認該需求對應角色是否預設出現，如未出現，可透過批次修改-參與人員-角色-批次新增角色 |
|
| 工作項例項不存在 | - | |
| 狀態/節點流轉 | 未滿足節點/狀態流轉條件（具體的必填項填寫完整、多人確認節點等） | 點選詳情頁-對應節點 該節點是否有必填項未填寫（節點配置的必填項沒有填自動化無法流轉） 是否為多人確認節點（節點流轉操作不支援完成多人確認節點） |
| 需流轉的節點/狀態暫未到達 | 點選詳情頁-對應節點，看節點是否未未開始（置灰），未到達的節點無法流轉成完成 |
|
| 工作項例項不存在 | - |
FAQ¶
自動化可以實現定時匯入資料麼？ 不支援。