技术指南 | 如何集成Perforce版本控制系统Helix Core (P4V) 与敏捷规划工具Hansoft

Helix Core是Perforce公司旗下一款集源代码管理和内容协作为一体的版本配置与管理工具，可以帮助您管理随时间推移而产生的数字资产（代码，文件等）变更，处理每天数以千万计的传输，上千TB的数据，以及一万多个并发提交。
Hansoft是一个企业敏捷规划工具，它为项目、项目群和项目组合级别的决策提供了一个单一平台，让您能够轻松计划、跟踪和管理产品。
通过集成Perforce Helix Core和Hansoft，规划和开发产品变得简单、快速、轻松。您的团队成员可以通过他们喜欢的版本控制系统来快速更新Hansoft，而高层可以随时了解到项目的最新进展。
龙智技术专家团队成员陈红华以简明扼要的方式呈现了Perforce Helix Core (P4V) 和Hansoft的集成方法，方便中国用户参考使用。如需了解更多关于Perforce Helix Core和Hansoft的相关信息，请联系Perforce授权合作伙伴——龙智。

准备环境

原厂文档：
https://help.perforce.com/hansoft/integrations/helixcore/Content/helixcore/
getting-started-helix-core.htm
环境：
Hansoft Client：192.168.80.58:50256
Hansoft Web Service：https://hansoft.example.com/
P4D：192.168.72.103:1666
Swarm: 192.168.72.103

依赖服务

提前安装准备以下服务：
Hansoft Web Service
Hansoft Server
Helix Visual Client (P4V) 2021.1 or later
在客户端机器设置Hansoft Web Service的服务IP的主机名：
C:\Windows\System32\drivers\etc\hosts
增加以下行：
192.168.80.58 hansoft.example.com

安装证书

在使用P4V的客户端安装证书。在Hansoft Web Service的服务器中的以下路径：
/opt/HPMWeb/nginx/certificates

下载web_ca.pem证书文件到客户端，并修改文件后缀为：web_ca.cer
导入该证书到计算机：控制面板->管理计算机证书->受信任的根证书颁发机构->证书->所有任务->导入，导入成功，如下图所示：

P4V里添加集成Hansoft快捷按钮

有以下两种方法设置快捷键：

1. 管理员为所有的用户在P4V里添加快捷按钮

（1）添加

# p4 property -a -n P4VJS.HTMLWindows -v "https://192.168.80.58:50256/htmlwindows.xml"

（2）检查

# p4 property -n P4VJS.HTMLWindows -l

（3）重启P4V
重启后，对Changelist右键查看，有了快捷按钮。
2. 手动到P4V里添加快捷按钮

（1）在P4V里，Tools > Manage Tools > HTML Windows
（2）点击New下拉选择Window
添加HTML Window对话框打开了。
（3）输入或者选择以下信息

• Name—输入快捷按钮名称, Add changelist to Hansoft item
• Placement—勾选 Add to applicable P4V context menus
• URL—输入要集成的URL, https://
  hansoft.example.com:443/web_integrations/helix_core
• Argument Type—建议下拉选择%C: Selected changelists
• Width—建议最少800
• Height—建议最少600

（4）点击OK保存更改
（5）点击OK关闭Manage HTML Windows对话框
（6）重启P4V
（7）右键一个Changelist可以看到集成的快捷按钮

Changelist添加到Hansoft项目里

从P4V，添加一个变更列表，到Hansoft待办事项列表中指定的项目。这是一个跟踪P4V中提交文件的好方法，并且这些文件和Hansoft中的任务相关联。
Changelist可以是Pending或者Submitted状态，Submitted必须属于当前账户。步骤如下：
1）P4V里，选择一个Pending/Submitted Changelist，右键Add Changelist to Hansoft item
2）输入Hansoft Web Service的用户名/密码后，按回车键。

如果提示ERR_CERT_AUTHORITY_INVALID报错，是因为证书不生效，则需要删除浏览器缓存。
3）进入Hansoft Web Service，选择item点击Add。
比如选择Demo1 ，点击Add。
4）添加成功，可以删除
Demo1关联changelist成功，按钮变成Remove，点击可以删除关联。点开Demo1，评论显示关联成功，如下所示：
5）在P4V里提交Changelist
在P4V里提交Changelist 32，过程如下：
提交成功，在Hansoft item查看，有了CL32超链接，显示如下：
6）Hansoft跳转到Helix Swarm
点击Hansoft项目关联的changelist CL32，自动跳转到Helix Swarm，输入用户名/密码后，显示如下：