codecamp

使用禅道作为后台

禅道开源版11.0版本开始,增加了客户端集成功能。

客户端由 喧喧提供支持。喧喧是易软天创旗下另外一款免费、开源、安全的IM产品,支持私有部署,跨平台操作,内置大量插件,功能丰富。

禅道集成客户端配置成功后,客户端与禅道深度集成,支持成员沟通,小组讨论,文件传输,任务指派,更加方便的项目管理,更加流畅的团队协作。


下面给大家介绍具体的禅道客户端配置步骤。

一、禅道后台客户端集成配置

注:如果使用windows一键安装包安装的禅道,需要打开xampp/start.exe程序,将集成面板左下角的apache验证取消勾选。

1、查看禅道客户端服务器设置

超级管理员首次登录禅道时,页面会提示新增禅道客户端功能。

提醒超级管理员去后台--集成--客户端集成里配置客户端。

后台--集成--客户端集成里配置客户端的服务器设置。

备注:禅道服务器地址为完整的协议+地址+端口,示例:http://192.168.1.35 或 http://pms.zentao.com ,不能使用127.0.0.1。

2、修改 禅道客户端服务器设置

你可以点击服务器设置页面下方的 修改配置 来做调整。

修改配置页面:

说明:

1、禅道的客户端集成默认是开启的状态。

2、密钥是随机生成的32位密码,这个密钥要与禅道客户端的服务器里的配置一致。

3、上传文件大小默认是20M,可以根据实际使用需要调整。

4、是否启用https,默认是不启用。启用后,需要把https证书的内容和密钥复制粘贴到输入框了。

二、禅道客户端的服务器下载和运行

1、下载禅道客户端的服务器端

禅道客户端的服务器由易软天创旗下的另一款产品:喧喧提供驱动。点击后台--集成--客户端集成--服务器设置页面下方的 下载喧喧服务端。

下载之前需要注意:

必须先点击 修改配置 并保存。

选择对应的操作系统,目前支持windows32位,windows64位,linux32位,linux64位,macOS系统。

如果你之前已下载过喧喧服务端,那么可以仅下载配置文件。配置文件为xxd.conf,下载成功后替换掉原喧喧服务器端里的同名文件即可。替换后需要重启服务器端服务。

以下载windows64位服务端为例:

下载解压后会得到一个win_x86_64.zentao_chat_server的文件夹。

之前在禅道后台--集成--客户端集成--服务器设置里做的配置,都保存config文件夹里的 xxd.conf里。

2、运行禅道客户端的服务器端服务

双击目录中的 xxd.exe ,即可启用服务器端的服务。

如果使用的是linux的服务器端,解压后,直接运行 ./xxd 就可以了。

三、禅道客户端的安装和使用

禅道客户端的服务器端配置成功后,禅道页面会提示用户去下载禅道客户端。

点击禅道界面右下角的 下载客户端 即可进入下载页面。

说明:

只有超级管理员在后台配置了客户端服务器端信息,禅道界面的右下角才会显示 下载客户端 入口。

内网环境需要手动将禅道客户端的安装包放到服务器指定目录下,这样其他用户才可以通过禅道右下角 下载客户端 入口下载禅道客户端。(具体请参考: http://www.zentao.net/book/zentaopmshelp/302.html#3

下载页面:

下面以禅道客户端windows 64位的为例,给大家具体演示一下。

你可以根据自己使用的操作系统,选择下载对应的客户端。

选择适合你的操作系统,保存后进入下载页面:

请耐心等待一下。

禅道客户端下载成功后,解压得到zentao_chat_client.win64文件夹,到zentaoclient目录里,拖到底部,双击 zentaoclient.exe即可启动禅道客户端。

禅道客户端登录页面:

服务器填写的是客户端服务器端设置文件(xxd.conf)里的服务器地址。

注:如果没有单独修改xxd配置文件中的默认端口号,服务器地址后面不需要加端口。

例如:禅道在网页端访问地址为http://192.168.1.110:8080,在客户端的服务器填写http://192.168.1.110就可以了。

账号和密码,填写的是禅道里的用户名和密码。

禅道客户端登录成功页面,那么现在你可以跟你的小伙伴开始聊天讨论了。

可以点击客户端左侧导航的禅道图标,直接在客户端里查看浏览禅道里的内容信息。

特别说明:内网环境如何下载禅道客户端

如果是内网环境可以先从官网手动下载禅道客户端,然后放到指定的服务器目录下,其他用户再下载的时候就可以直接下载客户端了.

这里以禅道11.0为例进行说明,对应的禅道客户端为2.2.0。

1、先到禅道开源版11.0下载页面,找到禅道客户端下载,下载对应操作系统的安装包:                                           

2、创建对应目录

找到禅道所在目录,看目录下是否存在 “tmp/cache/client” 目录,

如果不存在则创建此目录。明确客户端的版本,在client目录下创建一个以客户端版本号为名的目录,这里的客户端版本号为2.2.0,则在client下创建2.2.0目录。

3、将安装包放到禅道服务器指定目录下

将下载的客户端安装包放到刚才创建的2.2.0目录下,linux服务器需要注意文件权限和属组的设置,最终的目录结构如下:

4、这样用户就可以直接通过禅道系统里右下角的“下载客户端“按钮来下载客户端了。

四、禅道客户端的具体操作使用

1、禅道和客户端的信息共享

禅道和客户端集成后:

账户和密码共用;

禅道页面可以直接在客户端打开,浏览;

禅道里的操作可以通过客户端发送消息提醒;

客户端消息可以直接右键创建Bug、需求、任务、文档、待办;

客户端卡片形式显示禅道里Bug、需求、任务、文档、用例的详情页,并且还提供具体的操作按钮。

2、客户端的具体操作使用

禅道客户端的基础使用,可以直接参考喧喧官网的客户端使用说明: https://xuan.im/page/client.html

在此不再赘述,下面给大家介绍禅道客户端的独有功能的操作使用。

2.1 客户端使用禅道账号和密码登录

禅道客户端和禅道的账号和密码是通用的。使用禅道的用户名和密码即可登录禅道客户端。

2.1.1 禅道管理员配置好客户端的服务器,在禅道--组织--用户里添加好用户。

2.1.2 其他用户只要下载客户端,使用禅道账号和密码,就可以登录到禅道客户端了。

2.2 客户端打开禅道页面

客户端左侧导航添加了 禅道的入口,点击即可进入禅道页面,进行浏览操作。

2.3 客户端消息提醒禅道里的操作

首先需要管理员到禅道后台--通知--设置--客户端里设置。

勾选需要发送提醒的操作即可,这样在禅道里做这样的操作,指派人就可以在客户端收到提醒。

以任务的指派为例,指派人的禅道客户端的通知中心里,会收到任务的指派信息。

可以直接查看任务的详情。

当客户端最小化在右下角时,有声音通知和信息提示。

2.4 客户端消息右键创建禅道Bug、需求、任务、文档、待办

禅道客户端消息右键,目前支持直接创建禅道Bug、需求、任务、文档、待办。

禅道里分配了这些权限,在禅道客户端里消息右键才可以进行创建。如果没有分配这些权限,那么客户端消息右键时,不会显示创建按钮。

下面我们以客户端消息右键创建Bug来给大家演示具体操作:

禅道客户端消息右键,点击创建Bug,即可跳转到Bug创建页面。

禅道客户端的Bug创建页面:

客户端的消息会直接同步过来,显示在Bug标题框里。

其他的信息可以在这个页面里补充一下,然后保存。

创建成功的Bug,客户端会直接跳转到Bug的详情页。

禅道界面也已同步记录创建成功的Bug:

客户端确认Bug:

客户端里指派Bug:

客户端里解决Bug:

客户端编辑Bug:

禅道客户端消息右键创建需求、任务、文档、待办,欢迎大家自行操作,体验客户端和禅道集成的便捷。

说明: 如果客户端信息只有链接地址,右键只可以创建类型是链接的文档。

创建类型为链接的文档:

创建成功后:

2.5 客户端里卡片显示需求、任务、Bug、用例、文档的详情页

在客户端聊天对话框,发送禅道中的需求、任务、Bug、用例、文档详情页面地址,发送成功后,将以卡片形式显示。

以下以发送任务的详情页地址为例:

发送成功后,链接自动变为卡片形式显示:       

2.6 客户端的小组讨论

点击讨论组右上角的添加 图标,即可选择成员添加讨论组。

比较方便禅道中项目团队成员之间的沟通和协作。

五、注意事项

5.1 windows一键安装包,请关闭Apache用户访问验证

如果你使用的是禅道windows一键安装包,那么禅道运行控制面板里是否启用Apache用户访问验证,这一项必须关闭掉,否则喧喧客户端登录不上。

禅道windows一键安装包,Apache用户访问验证默认是开启的,记得一定要手动关闭,不勾选即可。

注意:11.0之前的一键安装包升级过来的,需要确认下xampp/runner/res/apache/conf/httpd.con配置文件中,有没有x.php的配置文件。

如果没有,需要添加一下,然后重启下xampp服务。添加内容:

  <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错误。请先到后台--集成--客户端集成--服务器设置里查看服务器配置里是否是打开状态。 



    使用然之协同作为后台
    Windows 安装xxd服务
    温馨提示
    下载编程狮App,免费阅读超1000+编程语言教程
    取消
    确定
    目录

    关闭

    MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }