飛書雲文件評論同步

介紹

當專案進行到評審階段時，對應的評審內容沉澱在飛書文件上。同時圍繞某個飛書文件評審時會產生一些評審意見，這些非常重要的評審意見需要有評估的流程來進一步跟蹤。 藉助Meegle評論同步外掛，可以實現將飛書雲文件中的全文評論同步建立指定的Meegle工作項資料。

啟用外掛

管理員前往空間配置 → 外掛管理 → 新增外掛 → 啟用“文件評論同步”外掛完成外掛啟用。

在外掛列表選擇或者搜尋“文件評論”，找到“文件評論同步”外掛，點選“新增外掛”按鈕，在彈層中確認許可權清單後，點選“確認”按鈕完成外掛新增。

外掛配置

在使用此外掛前，需要進行飛書應用憑證、外掛規則配置，以下規則配置請不要省略跳過流程。

飛書應用憑證配置

配置飛書應用憑證

1. 第一步：Meegle空間管理員或開發者參考如何開發企業自建應用？文件建立一個飛書應用。

1. 第二步：Meegle空間管理員或開發者申請文件、通訊錄、賬號相關許可權。具體可參考：申請許可權。

1. 第三步：Meegle空間管理員或開發者進行免登流程內容填寫，此選項設定是為了使用部分使用者能夠正常授權。前往安全設定中填寫重定向 URL 為下方連結。具體參考：免登流程

1. 第四步：Meegle空間管理員或開發者對應用進行釋出，釋出後該應用才能正式使用。具體可參考：應用釋出與使用

1. 第五步：飛書管理員對應用應用稽核，具體可參考：管理員如何稽核應用？

1. 第六步：飛書管理員設定應用可用範圍，將可用成員設定為“全部成員”，否則其他成員點選按鈕會提示：你沒有“xxxx”的使用許可權，請聯絡企業管理員開通。

1. 第七步：完成釋出後，開發者在飛書開發者後臺中複製 APP ID 和 APP Secret。

1. 第八步：Meegle空間管理員將複製的內容貼上至下方 APP ID 和 APP Secret 選項中。

如規則列表上方則提示“請先新增應用憑證，否則外掛規則無法生效”，是因為未填寫的應用憑證資訊，填寫即可。

規則配置

完成飛書應用配置後，接下來配置外掛規則。以實現專案下關聯的文件評論同步至評審管理為例：

1. 第一步：點選外掛規則列表中的配置選項，開始初步配置。

1. 第二步：點選右上的“新增規則”按鈕，新增第一個規則。

1. 第三步：填寫規則名稱，類似 TR5 評審內容。

1. 第四步：在“目標文件評論”選項中選擇目標工作項的文件連結。注意：請提前建立好該欄位，並配置在對應的工作項詳情頁或節點表單上。

1. 第五步：選擇“同步Meegle”到某個工作項，以選擇“評審管理”工作項為例，接著選擇承接同步評論的處理流程。之後關聯文件中的評論會自動在該工作項中建立一個評審問題。

1. 第六步：這一步，設定工作項自動關聯，即在評審管理工作項中建立的評審內容，自動關聯專案管理中當前專案（存放了評審連結的專案）。注意這一步需要配置好專案管理工作項與評審管理的關聯關係，具體可以參考：

控制元件配置

前往專案管理工作項的詳情頁配置，在表單資源庫中搜尋“文件評論同步”控制元件，拖拽到右側詳情頁。後續建立某個專案後，該專案詳情頁展示該同步按鈕。

至此，外掛配置部分已經配置完成。

外掛使用

配置步驟完成後，以一場評審會議為例來了解如何使用外掛。

建立評審文件

首先確定評審前，需建立一個評審文件，可以點此連結快捷建立：建立飛書文件。複製該文件的連結貼上在某個專案評審欄位內。

後續專案進入到評審環節，直接在該文件全文評論中留言具體問題即可。

操作授權

第一次點選“同步”按鈕會跳轉到授權頁面。

完成授權後即可開始同步。

點選同步

接著點選“同步”按鈕。

飛書文件全文評論將自動同步評審工作項，且自動關聯由該專案觸發的專案。

在同步過程中，可能會遇到以下情況：

1. 你沒有XXX、XXX的許可權無法同步文件評論，請申請許可權後再試：請獲取到文件的閱讀、編輯許可權。
2. XXX和XXX為欄位名稱，根據沒有許可權：請找空間管理員授權欄位編輯許可權。
3. 請檢查是否按照外掛規則進行了正確配置後再試：外掛規則配置錯誤，請重新參考外掛配置。

常見問題

請求非法, 請聯絡應用開發者

請前往安全設定中填寫重定向 URL。

文件評論刪除後會雙向同步麼？

不會，歷史評審記錄仍然存在。

評審的建立人是誰？

預設為點選“同步”按鈕的成員。 https://project.feishu.cn/m-api/v1/builtin_app/doc_cmt_sync/feishuApp/getCode