使用禪道作為后臺

禪道開源版11.0版本開始，增加了客戶端集成功能。

客戶端由 喧喧提供支持。喧喧是易軟天創(chuàng)旗下另外一款免費、開源、安全的IM產(chǎn)品，支持私有部署，跨平臺操作，內(nèi)置大量插件，功能豐富。

禪道集成客戶端配置成功后，客戶端與禪道深度集成，支持成員溝通，小組討論，文件傳輸，任務指派，更加方便的項目管理，更加流暢的團隊協(xié)作。

下面給大家介紹具體的禪道客戶端配置步驟。

一、禪道后臺客戶端集成配置

注：如果使用windows一鍵安裝包安裝的禪道，需要打開xampp/start.exe程序，將集成面板左下角的apache驗證取消勾選。

1、查看禪道客戶端服務器設置

超級管理員首次登錄禪道時，頁面會提示新增禪道客戶端功能。

提醒超級管理員去后臺--集成--客戶端集成里配置客戶端。

后臺--集成--客戶端集成里配置客戶端的服務器設置。

備注：禪道服務器地址為完整的協(xié)議+地址+端口，示例：http://192.168.1.35 或 http://pms.zentao.com ，不能使用127.0.0.1。

2、修改 禪道客戶端服務器設置

你可以點擊服務器設置頁面下方的 修改配置 來做調(diào)整。

修改配置頁面：

說明：

1、禪道的客戶端集成默認是開啟的狀態(tài)。

2、密鑰是隨機生成的32位密碼，這個密鑰要與禪道客戶端的服務器里的配置一致。

3、上傳文件大小默認是20M，可以根據(jù)實際使用需要調(diào)整。

4、是否啟用https，默認是不啟用。啟用后，需要把https證書的內(nèi)容和密鑰復制粘貼到輸入框了。

二、禪道客戶端的服務器下載和運行

1、下載禪道客戶端的服務器端

禪道客戶端的服務器由易軟天創(chuàng)旗下的另一款產(chǎn)品：喧喧提供驅(qū)動。點擊后臺--集成--客戶端集成--服務器設置頁面下方的 下載喧喧服務端。

下載之前需要注意：

必須先點擊 修改配置 并保存。

選擇對應的操作系統(tǒng)，目前支持windows32位，windows64位，linux32位，linux64位，macOS系統(tǒng)。

如果你之前已下載過喧喧服務端，那么可以僅下載配置文件。配置文件為xxd.conf，下載成功后替換掉原喧喧服務器端里的同名文件即可。替換后需要重啟服務器端服務。

以下載windows64位服務端為例：

下載解壓后會得到一個win_x86_64.zentao_chat_server的文件夾。

之前在禪道后臺--集成--客戶端集成--服務器設置里做的配置，都保存config文件夾里的 xxd.conf里。

2、運行禪道客戶端的服務器端服務

雙擊目錄中的 xxd.exe ，即可啟用服務器端的服務。

如果使用的是linux的服務器端，解壓后，直接運行 ./xxd 就可以了。

三、禪道客戶端的安裝和使用

禪道客戶端的服務器端配置成功后，禪道頁面會提示用戶去下載禪道客戶端。

點擊禪道界面右下角的 下載客戶端 即可進入下載頁面。

說明：

只有超級管理員在后臺配置了客戶端服務器端信息，禪道界面的右下角才會顯示 下載客戶端 入口。

內(nèi)網(wǎng)環(huán)境需要手動將禪道客戶端的安裝包放到服務器指定目錄下，這樣其他用戶才可以通過禪道右下角 下載客戶端 入口下載禪道客戶端。（具體請參考： http://www.zentao.net/book/zentaopmshelp/302.html#3）

下載頁面：

下面以禪道客戶端windows 64位的為例，給大家具體演示一下。

你可以根據(jù)自己使用的操作系統(tǒng)，選擇下載對應的客戶端。

選擇適合你的操作系統(tǒng)，保存后進入下載頁面：

請耐心等待一下。

禪道客戶端下載成功后，解壓得到zentao_chat_client.win64文件夾，到zentaoclient目錄里，拖到底部，雙擊 zentaoclient.exe即可啟動禪道客戶端。

禪道客戶端登錄頁面：

服務器填寫的是客戶端服務器端設置文件（xxd.conf）里的服務器地址。

注：如果沒有單獨修改xxd配置文件中的默認端口號，服務器地址后面不需要加端口。

例如：禪道在網(wǎng)頁端訪問地址為http://192.168.1.110:8080，在客戶端的服務器填寫http://192.168.1.110就可以了。

賬號和密碼，填寫的是禪道里的用戶名和密碼。

禪道客戶端登錄成功頁面，那么現(xiàn)在你可以跟你的小伙伴開始聊天討論了。

可以點擊客戶端左側(cè)導航的禪道圖標，直接在客戶端里查看瀏覽禪道里的內(nèi)容信息。

特別說明：內(nèi)網(wǎng)環(huán)境如何下載禪道客戶端

如果是內(nèi)網(wǎng)環(huán)境可以先從官網(wǎng)手動下載禪道客戶端，然后放到指定的服務器目錄下，其他用戶再下載的時候就可以直接下載客戶端了.

這里以禪道11.0為例進行說明，對應的禪道客戶端為2.2.0。

1、先到禪道開源版11.0下載頁面，找到禪道客戶端下載，下載對應操作系統(tǒng)的安裝包：                                           

2、創(chuàng)建對應目錄

找到禪道所在目錄，看目錄下是否存在 “tmp/cache/client” 目錄，

如果不存在則創(chuàng)建此目錄。明確客戶端的版本，在client目錄下創(chuàng)建一個以客戶端版本號為名的目錄，這里的客戶端版本號為2.2.0，則在client下創(chuàng)建2.2.0目錄。

3、將安裝包放到禪道服務器指定目錄下

將下載的客戶端安裝包放到剛才創(chuàng)建的2.2.0目錄下，linux服務器需要注意文件權限和屬組的設置，最終的目錄結(jié)構如下：

4、這樣用戶就可以直接通過禪道系統(tǒng)里右下角的“下載客戶端“按鈕來下載客戶端了。

四、禪道客戶端的具體操作使用

1、禪道和客戶端的信息共享

禪道和客戶端集成后：

賬戶和密碼共用；

禪道頁面可以直接在客戶端打開，瀏覽；

禪道里的操作可以通過客戶端發(fā)送消息提醒；

客戶端消息可以直接右鍵創(chuàng)建Bug、需求、任務、文檔、待辦；

客戶端卡片形式顯示禪道里Bug、需求、任務、文檔、用例的詳情頁，并且還提供具體的操作按鈕。

2、客戶端的具體操作使用

禪道客戶端的基礎使用，可以直接參考喧喧官網(wǎng)的客戶端使用說明： https://xuan.im/page/client.html

在此不再贅述，下面給大家介紹禪道客戶端的獨有功能的操作使用。

2.1 客戶端使用禪道賬號和密碼登錄

禪道客戶端和禪道的賬號和密碼是通用的。使用禪道的用戶名和密碼即可登錄禪道客戶端。

2.1.1 禪道管理員配置好客戶端的服務器，在禪道--組織--用戶里添加好用戶。

2.1.2 其他用戶只要下載客戶端，使用禪道賬號和密碼，就可以登錄到禪道客戶端了。

2.2 客戶端打開禪道頁面

客戶端左側(cè)導航添加了 禪道的入口，點擊即可進入禪道頁面，進行瀏覽操作。

2.3 客戶端消息提醒禪道里的操作

首先需要管理員到禪道后臺--通知--設置--客戶端里設置。

勾選需要發(fā)送提醒的操作即可，這樣在禪道里做這樣的操作，指派人就可以在客戶端收到提醒。

以任務的指派為例，指派人的禪道客戶端的通知中心里，會收到任務的指派信息。

可以直接查看任務的詳情。

當客戶端最小化在右下角時，有聲音通知和信息提示。

2.4 客戶端消息右鍵創(chuàng)建禪道Bug、需求、任務、文檔、待辦

禪道客戶端消息右鍵，目前支持直接創(chuàng)建禪道Bug、需求、任務、文檔、待辦。

禪道里分配了這些權限，在禪道客戶端里消息右鍵才可以進行創(chuàng)建。如果沒有分配這些權限，那么客戶端消息右鍵時，不會顯示創(chuàng)建按鈕。

下面我們以客戶端消息右鍵創(chuàng)建Bug來給大家演示具體操作：

禪道客戶端消息右鍵，點擊創(chuàng)建Bug，即可跳轉(zhuǎn)到Bug創(chuàng)建頁面。

禪道客戶端的Bug創(chuàng)建頁面：

客戶端的消息會直接同步過來，顯示在Bug標題框里。

其他的信息可以在這個頁面里補充一下，然后保存。

創(chuàng)建成功的Bug，客戶端會直接跳轉(zhuǎn)到Bug的詳情頁。

禪道界面也已同步記錄創(chuàng)建成功的Bug：

客戶端確認Bug：

客戶端里指派Bug：

客戶端里解決Bug：

客戶端編輯Bug：

禪道客戶端消息右鍵創(chuàng)建需求、任務、文檔、待辦，歡迎大家自行操作，體驗客戶端和禪道集成的便捷。

說明： 如果客戶端信息只有鏈接地址，右鍵只可以創(chuàng)建類型是鏈接的文檔。

創(chuàng)建類型為鏈接的文檔：

創(chuàng)建成功后：

2.5 客戶端里卡片顯示需求、任務、Bug、用例、文檔的詳情頁

在客戶端聊天對話框，發(fā)送禪道中的需求、任務、Bug、用例、文檔詳情頁面地址，發(fā)送成功后，將以卡片形式顯示。

以下以發(fā)送任務的詳情頁地址為例：

發(fā)送成功后，鏈接自動變?yōu)榭ㄆ问斤@示：       

2.6 客戶端的小組討論

點擊討論組右上角的添加 圖標，即可選擇成員添加討論組。

比較方便禪道中項目團隊成員之間的溝通和協(xié)作。

五、注意事項

5.1 windows一鍵安裝包，請關閉Apache用戶訪問驗證

如果你使用的是禪道windows一鍵安裝包，那么禪道運行控制面板里是否啟用Apache用戶訪問驗證，這一項必須關閉掉，否則喧喧客戶端登錄不上。

禪道windows一鍵安裝包，Apache用戶訪問驗證默認是開啟的，記得一定要手動關閉，不勾選即可。

注意：11.0之前的一鍵安裝包升級過來的，需要確認下xampp/runner/res/apache/conf/httpd.con配置文件中，有沒有x.php的配置文件。

如果沒有，需要添加一下，然后重啟下xampp服務。添加內(nèi)容：

  <Files "x.php">
    SetHandler application/x-httpd-php
  </Files>
  <Files "upgradexuanxuan.php">
    SetHandler application/x-httpd-php
  </Files>

5.2 客戶端登錄失敗排查

如果配置好禪道客戶端后，使用禪道用戶名和密碼登錄客戶端失敗。

5.2.1 請先逐一排查禪道、禪道客戶端、禪道客戶端服務器端（xxd）是否都正常運行。

5.2.2 禪道、禪道客戶端、禪道客戶端服務器端（xxd）都運行正常的話，需要檢查禪道客戶端服務器端的xxd.conf的配置。 服務器名是否寫對，密鑰是否一致，是否加上了default。

5.2.3 禪道客戶端登錄頁面提示：服務器操作失敗，提示500錯誤。請先到后臺--集成--客戶端集成--服務器設置里查看服務器配置里是否是打開狀態(tài)。