1 安裝禪道
1.1  選擇適合您的安裝方法
1.2  使用云禪道在線項目管理服務!
1.3  (推薦)windows用一鍵安裝包安裝
1.4  (推薦)linux用一鍵安裝包
1.5  linux下用lampp集成包安裝
1.6  使用源碼包安裝(MAC系統)
1.7  MAC下用XAMPP安裝禪道
1.8  MAC下用XAMPP-VM安裝禪道
1.9  禪道一鍵安裝包里安裝蟬知和然之
1.10  使用源碼包安裝(各系統通用)
1.11  寶塔面板安裝禪道
1.12  華蕓NAS在線安裝
1.13  Centos7.4系統下安裝httpd,mariadb,php7.1環境運行禪道
1.14  安裝ioncube擴展
2 禪道介紹
2.1  關于禪道項目管理軟件
2.2  禪道介紹PPT下載
2.3  如何獲得支持
2.4  關注我們
3 升級禪道
3.1  選擇和自己環境對應的升級方式
3.2  通過源代碼方式升級(通用)
3.3  windows一鍵安裝包的升級
3.4  linux一鍵安裝包升級
4 創建分組和用戶
4.1  建立部門結構
4.2  添加一個用戶帳號
4.3  批量維護帳號
4.4  設置分組,建立權限體系
5 最簡使用
5.1  使用禪道來進行項目任務管理
5.2  只使用禪道來做bug管理
5.3  只使用禪道來進行產品管理
5.4  個人使用禪道來做事務跟蹤管理
6 基本使用
6.1  禪道使用的基本流程和產品、研發、測試之間的三權分立
6.2  敏捷開發及scrum簡介
6.3  禪道和scrum的對應關系
6.4  禪道的新手教程
6.5  創建第一個產品
6.6  添加第一個需求
6.7  開始第一個項目
6.8  確定項目要完成的需求列表
6.9  為需求分解任務
6.10  提交bug
6.11  視頻教程:第一個演示項目
6.12  維護聯系人
6.13  禪道的自定義功能
6.14  導入excel、csv參考文檔
6.15  文檔管理
6.16  工作方式的切換
6.17  操作獲取積分功能
6.18  自定義必填項功能
6.19  如何排查產品、項目是否有訪問權限
7 進階使用
7.1 使用流程
7.1.1  禪道使用流程圖解
7.2 個人管理
7.2.1  使用待辦進行個人事務管理
7.2.2  關注需要自己處理的任務、需求、bug
7.2.3  通過我的檔案查看或者修改個人信息
7.2.4  視頻教程:禪道使用之個人篇
7.3 產品經理篇
7.3.1  維護產品
7.3.2  維護產品線
7.3.3  創建和評審需求
7.3.4  變更和評審需求
7.3.5  需求的狀態和研發階段
7.3.6  需求的注意事項
7.3.7  維護產品模塊
7.3.8  建立發布計劃
7.3.9  建立發布
7.3.10  路線圖
7.3.11  文檔管理
7.3.12  主持產品會議
7.3.13  參與項目管理、演示和總結
7.3.14  需求的基本統計報表
7.3.15  視頻教程:禪道使用之產品經理篇
7.4 項目經理篇
7.4.1  建立項目
7.4.2  組建項目團隊
7.4.3  確定項目要完成的需求列表
7.4.4  組織進行任務分解
7.4.5  召開每天的站立會議
7.4.6  通過燃盡圖了解項目的進展
7.4.7  通過各種列表的各種功能了解項目進展
7.4.8  召開演示會議和總結會議
7.4.9  項目任務基本的報表統計
7.4.10  視頻教程:禪道使用之項目經理篇
7.5 開發團隊篇
7.5.1  參加項目計劃會議,分解任務
7.5.2  領取任務,并每天更新任務
7.5.3  通過看板和樹狀圖查看任務
7.5.4  創建版本
7.5.5  申請測試
7.5.6  解決bug
7.5.7  文檔管理
7.5.8  確認bug
7.5.9  視頻教程:禪道使用之開發團隊篇
7.6 測試團隊篇
7.6.1  維護bug視圖模塊
7.6.2  提交bug
7.6.3  驗證bug,關閉
7.6.4  激活bug
7.6.5  找到自己需要的bug
7.6.6  維護測試用例視圖
7.6.7  創建測試用例
7.6.8  測試套件、報告和公共用例庫的維護
7.6.9  管理測試版本
7.6.10  執行用例,提交Bug
7.6.11  查看報表統計
7.6.12  視頻教程:禪道使用之測試團隊篇
8 維護配置
8.1 維護禪道
8.1.1  初始化管理腳本
8.1.2  備份禪道
8.1.3  恢復刪除的資源
8.1.4  如何更新燃盡圖
8.1.5  一鍵安裝包如何實現mysql異機連接
8.2 配置禪道
8.2.1  設置是否允許匿名訪問
8.2.2  如何配置email發信
8.2.3  禪道云發信
8.2.4  如何成為超級管理員
8.2.5  配置禪道系統為靜態訪問
8.2.6  去掉禪道訪問地址中的zentao
8.2.7  集成禪道和svn
8.2.8  集成禪道和git
8.2.9  在第三方應用中集成禪道
8.2.10  第三方應用配置免密登錄禪道
8.2.11  第三方應用集成禪道客戶端進行消息通知
8.2.12  集成webhook
8.2.13  然之集成
8.2.14  客戶端集成
8.2.15  禪道的翻譯功能
8.2.16  瀏覽器通知的設置
9 定制開發
9.1  二次開發機制
9.2  禪道的目錄結構
9.3  找到要修改的文件
9.4  禪道的數據庫結構
9.5  公用模塊--common
9.6  如何登記菜單
9.7  如何登記權限
9.8  示例:如何修改禪道的語言提示?
9.9  示例:創建bug時可以設置優先級字段
9.10  使用在線擴展編輯器
9.11  二次開發編輯器和翻譯功能限制使用說明
9.12  禪道項目管理軟件打包規范1.1版本
10 其他相關
10.1  禪道所使用到的第三方代碼
10.2  禪道FAQ
10.3  如何幫助禪道項目
10.4  禪道商業服務
10.5  禪道項目的貢獻者
10.6  歷史修改記錄

在第三方應用中集成禪道

2017-10-27 10:46:56
剛哥
10518
最后編輯:先知 于 2019-11-22 16:31:31
簡介:本文講述如何在第三方應用中集成禪道。

禪道從9.6版本開始內置了在第三方應用中集成禪道的功能,可以方便的將禪道的數據和第三方應用打通。第三方應用必須以 GET 方式訪問禪道,禪道以 JSON 格式返回數據。下面我們介紹如何配置該功能。

一、配置

用超級管理員用戶登錄禪道,進入后臺 => 二次開發 => 應用,點擊【添加應用】按鈕新增一個應用,如圖:

應用名稱、應用代號、密鑰是必填項,代號只能為字母或數字的組合,密鑰由系統自動生成。 IP描述為選填項。此處的 IP 是一個白名單,默認沒有限制所有 IP 都可以訪問。

二、簽名機制

第三方應用在請求禪道數據的時候需要做簽名驗證,API 的請求格式為 /api.php? m=moduleName&f=methodName& params=params &code=code &time=timestamp &token=token。

m=moduleName&f=methodName& params=params 部分為數據請求參數,根據實際的需求進行設置。

code為應用代號,需要和禪道應用設置中保持一致。

time位時間戳,可以通過PHP的time函數得到。

token為數字簽名,其算法為:code、密鑰、time字符串合并,再進行 md5。

以上圖設置的應用為例,應用代號為 myApp,密鑰為 427c579384224abf9570779d82969d1e,請求id為1的項目詳情,其 token 計算過程如下:

$code  = 'myApp';
$key   = '427c579384224abf9570779d82969d1e';
$time  = '1557034496';
$token = md5($code . $key . $time);

算得 token = 020ec7c33a7f1a048743849d15fb218a,請求 API 為 /api.php?m=project&f=view&id=1&code=myApp&time=1557034496&token=020ec7c33a7f1a048743849d15fb218a。

注意:時間戳只能用一次,下次請求的時間戳必須大于該時間戳。

三、全局錯誤碼

300001 缺少 code 參數,檢查請求 API 中是否包含 code 參數。
300002 缺少 token 參數,檢查請求 API  中是否包含 token 參數。
310001 應用不存在, 檢查請求的應用在禪道中是否存在,或是否已被刪除。
310002 應用未設置密鑰,檢查請求的應用在禪道中是否設置密鑰。
320001 該IP訪問被限制訪問,檢查請求的應用在禪道中的 IP 設置。
330001 不合法的token參數,檢查請求 API 中的 token 是否計算正確。

有時會出現請求內跳轉的情況,如請求 index 模塊的 index 方法時默認會跳轉到 my 模塊的 index 方法,這時系統通過 session 來驗證跳轉后的請求是否合法。
340001 缺少session code,檢查跳轉后 $_SESSION['ENTRY_CODE'] 是否正確。
340002 session驗證失敗,檢查 session 驗證邏輯,檢查跳轉后 $_SERVER['REMOTE_ADDR'] 是否正確。

評論列表
風之子 2019-06-28 17:28:02
問下這里的api調用方式和http://devel.cnezsoft.com/book/extension/api-intro-43.html 這里介紹的有什么不同?是否能完全替代那個網頁介紹的方式。
馬超 2019-06-28 18:14:09
第三方應用集成到禪道中api集成是兩個功能,第三方應用集成到禪道中可以使用鏈接集成到禪道中,可以在禪道中直接訪問第三方應用,api 集成可以通過接口調用禪道中數據。
風之子 2019-06-28 18:38:07
這里api能用的模型和方法都有那些?有文檔么,還是要去看源碼來了解有那些可以用的模型和方法。
馬超 2019-07-01 08:56:33
可以參考下api手冊 http://devel.cnezsoft.com/book/extension/api-intro-43.html
1/1
發表評論
評論通過審核后顯示。
三肖中特期准黄大仙373745