如何实现Kiwi TCMS与Redmine的集成？求清晰分步操作指南

前置准备 #

• 确认版本符合要求：Kiwi TCMS ≥ 10.0，Redmine ≥ 4.0
• 拥有两个平台的超级管理员操作权限
• 确保Kiwi TCMS所在服务器可以正常访问Redmine的服务地址，无防火墙或网络策略拦截

第一步：Redmine 端配置 #

1. 启用REST API支持
   登录Redmine管理员账号，进入「管理」-「设置」-「API」标签页，勾选启用REST API，点击保存配置。
2. 生成集成用API密钥
   建议单独创建一个专属集成账号，分配对应项目的「问题查看、创建、编辑、删除」权限后，进入该账号的「我的账号」页面，在右侧API区域点击「显示」，复制生成的API访问密钥留存备用。
3. 记录项目标识
   进入需要集成的Redmine项目设置页，复制项目的唯一标识符，后续用于和Kiwi TCMS项目做绑定。

第二步：Kiwi TCMS 端配置 #

1. 进入集成配置页
   登录Kiwi TCMS管理员账号，进入「管理」-「系统设置」-「缺陷跟踪器」板块，选择Redmine作为默认缺陷跟踪工具。
2. 填写基础连接参数

• Redmine服务地址：填写你的Redmine部署域名/IP，如http://192.168.1.100:3000，不要加末尾的斜杠
• 认证方式：选择API密钥认证，粘贴上一步复制的Redmine API密钥
• 状态映射规则：按照团队现有工作流，将Kiwi TCMS的缺陷状态和Redmine的问题状态一一绑定，比如Kiwi的「已确认」对应Redmine的「已接受」，Kiwi的「已解决」对应Redmine的「已关闭」
• 项目映射：将每个需要集成的Kiwi TCMS项目，和之前记录的Redmine项目唯一标识符一一对应绑定

3. 配置完成后点击保存，再进入对应Kiwi项目的权限设置页，给测试、开发等相关角色分配「关联外部缺陷、同步缺陷状态」的权限。

第三步：功能验证 #

缺陷上报关联验证 #

在Kiwi TCMS中执行测试用例时，点击用例操作栏的「上报缺陷」，选择Redmine作为跟踪源，填写缺陷信息提交后，会自动在绑定的Redmine项目中生成一条问题记录，同时Kiwi中的缺陷条目会直接关联该Redmine问题ID，点击即可跳转查看详情。

双向状态同步验证 #

• 在Redmine中修改对应问题的状态、备注信息，刷新Kiwi TCMS中的对应缺陷条目，信息会自动同步更新
• 在Kiwi TCMS中修改缺陷状态、添加备注，Redmine对应的问题条目也会同步更新，完全匹配之前配置的状态映射规则

测试关联验证 #

Kiwi TCMS的测试计划、测试运行报告中，所有关联Redmine缺陷的用例会直接展示Redmine问题的当前状态，无需跨平台切换即可跟踪缺陷处理进度。 #

常见异常排查 #

• 同步失败：首先检查Kiwi服务器是否可以正常ping通Redmine地址，确认无端口拦截、防火墙限制
• 权限报错：检查Redmine集成账号的项目权限是否足够，Kiwi侧用户是否分配了集成操作权限
• 状态不同步：确认状态映射规则配置是否正确，两个平台的状态枚举值是否存在匹配错误

内容的提问来源于stack exchange，提问作者Fran Pereyra