一、禅道集成
基础配置
使用指引：
1.账号密码为具有相应权限的Zentao账号，账号需要具有 超级model调用接口权限
2.保存 Basic Auth 账号信息后，需要在 MeterSphere 项目中手动关联 ID/key 和缺陷模板 马上关联项目
3.添加你的个人平台账号 马上添加
- 查找禅道专业版9.0.3版本配置文件config.php中，修改以下配置；
# 默认为false
$config->features->apiGetModel = true;
- 协调运维使用公司LDAP创建metersphere账户并设置密码；
- 使用管理员账户登录禅道专业版，在组织-用户查询到metersphere账户；
- 组织-权限，找到分组名称及metersphere用户列表，点击权限图标，打开页面后勾选API权限
- 另外最好向metersphere账户分配管理员权限，具有查看禅道产品或者项目的权限；
- 组织-权限，向系统测试人员分组分配API接口权限；
- 打开Metersphere-工作空间-服务集成-项目管理平台-禅道；
- 填写账号、密码以及禅道地址；
- 请求方式通过禅道配置文件my.php或者config.php查看并勾选配置；
# 一般为PATH_INFO
$config->requestType = 'PATH_INFO'; // 请求类型：PATH_INFO|PATHINFO2|GET。 The request type: PATH_INFO|PATH_INFO2|GET.
缺陷同步
- 管理员登录禅道，通过后台-自定义-流程，查看流程；
产品-项目 | 产品-迭代 | 产品-冲刺 需要填写产品ID
项目-迭代 | 项目-冲刺 需要填写项目ID
- 点击马上关联项目，选择其中一个项目点击编辑，输入禅道中该产品ID，并确定保存；
- 点击右上角个人信息，第三方平台账号，输入提交禅道缺陷的测试人员账号和密码；
- 选择对应项目，打开测试跟踪-缺陷管理，点击创建缺陷；
- 输入标题、缺陷内容、影响版本、处理人等，如下图；
- 确认无误后，点击保存，提示保存成功，并自动跳转只缺陷管理页面；
- 使用提交缺陷的账号登录禅道，打开对应产品Bug页面；
自定义字段
- 从上图可以看到，缺陷提交成功了，但是还缺少很多字段，需要在metersphere中自定义字段；
- 打开系统设置-工作空间-模板管理-缺陷模板，点击编辑；
[步骤]
1、
2、
3、
[结果]
1、
2、
[期望]
1、
- 点击自定义字段，进行如下设置，比如严重程度，字段类型选择单选下拉列表，选项值点击添加选项，输入键值对可参考禅道-后台-自定义-Bug页面；
- 可继续添加BUG类型、优先级、操作系统、浏览器、截止日期等字段；
- 然后店家添加字段，勾选所需要的自定义字段，如下图所示；
- 可根据需要选择默认值；
- API字段名参考/zentao/module/bug/lang/zh-cn.php中字段列表，如下图所示；
- 可根据需要选择是否必填；
- 然后进入测试跟踪-缺陷管理，选择项目且该项目已对应禅道项目ID；
- 点击创建缺陷，自定义字段已全部展示默认值，如下图所示；
- 填写完毕信息后，点击保存，跳转页面如下，可鼠标悬停预览，可点击操作按钮配置显示的字段；
- 打开禅道对应项目-测试-Bug列表页，可查看到该缺陷已同步；
备注：
1、MeterSphere 版本: v1.18.0-82ba1b94目前添加图片推送至专业版禅道后无法查看图片，正跟踪分析；
2、MeterSphere 版本: v1.18.0-82ba1b94推送带有图片的缺陷至开源版禅道图片展示正常；
二、对接LDAP
基础配置
sAMAccountName={0}
{"username":"sAMAccountName","name":"cn","email":"mail","phone":"mobile"}
- 点击保存，并测试连接，提示连接成功，，此时并不会直接将LDAP用户带过来，而是需要登录才能同步账户信息，点击测试登录，输入姓名和密码；
姓名：我司邮箱前缀
密码：我司邮箱密码
- 测试登录成功后，打开系统-用户页面，展示用户来源为LDAP，并点击编辑按钮为用户分配项目权限；
- 输入ID和对应密码即可登录成功，然后在系统设置-系统-用户可查看到LDAP登录的用户，然后可自由分配相关权限；
ldap的用户如果不存在于metersphere本地数据库中(userId或email有一个相同即为存在本地用户)，则新增，否则更新用户的name/phone/email
详见metersphere的LdapController.java
