Dataphin支援設定對接企業內部、DingTalkOA等審批流,提供統一的IT管理和企業化的內部流程系統,給予使用者與原系統無差異的審批體驗。同時支援自訂審批規則,您可以將不同敏感等級的資產許可權申請配置成不同的審批規則,例如將低敏感等級的資產申請設定為自動審批,高敏感等級的資產申請設定指定審批人進行審批等。本文為您介紹如何對接外部審批系統。
相關文檔
選擇審批系統選擇三方審批時,支援使用第三方審批流。詳情請參見自訂審批系統對接介面。
背景資訊
Dataphin中在對接外部審批系統時,由於Dataphin內部的使用者與審批系統的使用者的匹配與映射、審批系統的介面各異,與Dataphin的資料的介面不同需要轉化處理等原因,往往需要開發Proxy應用,將Dataphin的介面與審批系統的介面進行對接。審批系統SDK則用於Proxy應用的研發,使用者可快速基於SDK打通基本的流程。

使用限制
僅超級管理員與系統管理員角色的帳號有許可權進行審批設定。
注意事項
變更審批流設定時,如已有審批單在處理,需注意:
若從Dataphin內部審批流切換為對接外部審批流,則已在途(已發起審批,但未完成審批)的審批單可繼續在Dataphin進行處理。
若從一個Dataphin外部審批流對接到另一個外部審批流,或變更審批流設定參數,則已在途的審批單按照新流程進行處理。若callbackURL已經變更(包括認證資訊),可能造成回調失敗,則不可以同步審批狀態到Dataphin,需要重新發起審批,原有的審批單可通過撤回(或強制撤回)關閉。
若從外部審批流變更為內部審批流,則在途的審批單在外部審批的結果無法同步至Dataphin,原審批單可通過撤回(或強制撤回)關閉。
配置審批設定
使用超級管理員或系統管理員帳號,登入元倉租戶。
在Dataphin首頁,在頂部功能表列中選擇管理中心 > 系統設定。
在左側導覽列中選擇系統設定 > 審批設定,開啟審批設定頁面。
配置預設審批系統。
當關閉外部審批系統時,預設審批系統為內建審批系統。當開啟外部審批系統時,預設審批系統支援選擇內建審批系統或第三方審批系統。開啟外部審批系統後,還需配置外部審批系統配置和審批服務配置。
說明此處預設審批系統選擇完成後,審批模板-審批系統的預設選項同此處的預設審批系統。
配置外部審批系統配置和審批服務配置。
審批系統名稱:自訂審批系統名稱,支援所有字元,不超過128個字元。
選擇審批系統:可選擇DingTalkOA或其他,不同審批系統需配置不同審批服務配置。
DingTalkOA
參數
描述
API地址
輸入DingTalkOA的API地址。
AppKey
輸入DingTalkOA的Key值。
AppSecert
輸入DingTalkOA的Secert值。
單擊測試連接,可以測試Dataphin與外部審批系統的連通性。如果測試不通過,請根據分頁錯誤提示排查處理。
DingTalk帳號映射
未配置DingTalkUID的使用者將自動匹配Dataphin中的Source_UID(即 SSO中的使用者UID),若匹配失敗則報錯。此外,除通過當前步驟批次更新外,您也可在管理中心 > 成員管理中單獨維護成員的DingTalkUID。
單擊批次更新,在批次更新對話方塊中,跟隨配置步驟進行匯入。
資料下載:僅匯出Dataphin中前10000個使用者,匯出的資料包含使用者名稱稱、Dataphin_UID、Source_UID、手機、郵箱、DingTalk使用者UserID。
上傳Excel檔案:僅支援上傳.xlxs格式且不超過10000行的檔案。
匯入配置:上傳的檔案中,使用者不存在則忽略,DingTalkUID若有值則更新,但不更新郵箱和手機號。
Callback URL
Dataphin接收DingTalkOA回調結果的URL地址,系統會自動產生Callback URL。支援自訂,格式為
https://{Dataphin部署的網域名稱}/task/callback。Encoding AES Key
輸入加解密所使用的密鑰。
單擊
表徵圖,可以自動產生Encoding AES Key。Token
輸入在DingTalkOA用戶端驗證的令牌。
可以單擊
表徵圖自動產生。AgentId
輸入DingTalkOA的AgentId。
其他
外部審批系統傳遞不同的參數時,Dataphin中展示說明請參見Dataphin中外部審批系統傳參的取值。
參數
描述
對接方式
可選擇僅顯示最終審批結果或顯示三方審批的所有節點,預設選擇僅顯示最終審批結果。
僅顯示最終審批結果:僅需返回審批系統的最終結果,系統中僅展示開始節點和結束節點。
顯示三方審批的所有節點:需返回審批系統每個節點的詳情,系統中將同步展示所有審批節點。
提交審批申請URL
對接外部審批系統的URL地址。Dataphin會將使用者提交的審批,通過該URL提交到外部審批系統中。
Access Token
Access Token是訪問外部審批系統的認證資訊,Dataphin提交審批單至外部審批系統的時候需要填寫。
單擊測試連接,可以測試Dataphin與外部審批系統的連通性。如果測試不通過,請根據分頁錯誤提示排查處理。
Callback URL
Dataphin接收外部審批系統回調結果的URL地址,系統會自動產生Callback URL。支援自訂,格式為
https://<Dataphin部署的網域名稱>/api/oa/bpms/integration/thirdparty/callback。Encoding AES Key
輸入加解密所使用的密鑰。
單擊
表徵圖,可以自動產生Encoding AES Key。Dataphin中外部審批系統傳參的取值
欄位名稱
條件
Dataphin中展示值
操作
無條件區分
node_name的值。結果
"node_status": "PENDING
待審批"node_status": "APPROVED
審批通過"node_status": "REJECTED
駁回"node_status": DELEGATED
加簽${使用者名稱稱}"node_status": TRANSFERRED
轉交${使用者名稱稱}操作人
"node_status": PENDING
"approverRelation":or
所有待審批人,取
pending_approvers中的user_name。"node_status": PENDING
"approverRelation":and
待審批:
${待審批人01}, ${待審批人02}, ${待審批人03}已審批:
${已審批人01}, ${已審批人02}, ${已審批人03}其餘情況
操作人操作說明
"node_status": PENDING
"approverRelation":or
任一審批人同意即通過。
"node_status": PENDING
"approverRelation":and
"operator"為空白
所有審批人同意才通過。
"node_status": PENDING
"approverRelation":and
"operator"不為空白
部分審批人已通過,${審批同意的使用者}(${同意的理由})、${審批同意的使用者}(${同意的理由})...
例如:部分審批人已通過,張三(同意)、李四(需求合理,准許上線)。
其餘情況
操作人的
reason。
參數配置完成後,單擊儲存。