1 环境准备

1.1 背景描述

Polarion ALM 提供了涵盖了应用程序全生命周期的解决方案。但在实际企业的生产环境中，可能不能在整个生命周期范围内仅使用Polarion ALM这一系统，往往需要与其他的第三方平台结合。
比如可以使用JIRA作为第三方平台，作为企业对供应商提供Issue管理的外部平台，但同时也需要在Polarion自动建立并同步这些Issue的内容。工程师在Polarion ALM中完成Issue的处理后，系统自动将处理状态同步到Jira中。

1.2 实验环境机器清单

实验环境基于VMware ESXi 6.7；
宿主机环境配置 CPU : 40 Cores @ 2.0GHz / RAM : 256GB / Storage : 800GB SSD

实验涉及到的虚拟机清单如下：

序号 机器名 IP地址 机器描述 硬件配置 软件配置
1 all-in-one 10.1.2.56 Polarion与 JIRA 测试服务器 CPU： 4 Cores @ 2.0GHz
RAM：8GB
Storage：64GB SSD		 Windows Server 2019 Standard
Polarion 19.2
Jira 8.5.1

1.3 实验环境系统信息

Polarion ：
管理员账号：admin
访问地址：http://10.1.2.56/
示例项目：TestProject
Jira：
管理员账号：admin
访问地址：http://10.1.2.56:8080/
示例项目：TestProject

2 新建Polarion访问凭证

1、使用管理员账户登入Polarion

2、点击页面右上角“设置”菜单，点击Administration，进入管理页面
image.png

3、点击Global Administration进入全局管理界面
image.png

4、展开User Management > User Account Vault
image.png

5、在Key中定义一个代号，在UserName中输入Polarion的管理员账户、密码
image.png

6、点击Save完成保存
image.png

3 新建连接器

1、切换到TestProject项目
image.png

2、点击页面右上角“设置”菜单，点击Administration，进入管理页面
image.png

3、展开Connectors > Settings
image.png

4、在Connections中，点击image.png新建一个连接

5、在弹出的选框中，选择Jira，点击Next
image.png

6、在ID中填写一个代号，在Server URL中填写Jira Server的地址，User填写Jira管理员账户，Password填写Jira管理员密码，点击Create完成创建
image.png

7、查看Connections，刚刚我们创建的连接器已经在页面中显示
image.png

4 新建同步链接对

1、依旧在Connectors的Settings页面中，在Synchronization Pairs下点击image.png

2、在Sync Pair ID中填写代号，点击Create完成创建
image.png

3、查看Connections，刚刚我们创建的链接对已经在页面中显示
image.png

5 配置同步链接对

5.1 配置Polarion Configuration

1、点击Synchronization Pairs中链接对的Edit进入编辑界面

2、配置Polarion Configuration，在Account valut key中配置访问凭证
image.png

3、点击Test Connection，完成验证
image.png

4、点击image.png，完成保存

5.2 配置Jira Configuration

1、在Project中填写Jira中对应的项目名称

image.png

2、点击Test Connection，完成验证
image.png

3、点击image.png，完成保存

5.3 配置工作项[Polarion]与问题类型[Jira]的映射表

5.3.1 介绍

此处的映射表就是配置Polarion中的工作项与Jira中的工作类型的映射
在本例子中，Polarion的工作项类型如下：
image.png

Jira的问题类型如下：
image.png

在这个配置例子中，我们需要将 Issue 与 故障 进行关联

5.3.2 配置

1、在Type Mapping中点击image.png

2、在Left Type中选择 Issue，在Right Type中选择 故障
image.png
3、点击image.png，完成保存

5.4 配置参数映射表

5.4.1 介绍

此处的映射表是用来配置Issue工作项与故障问题类型属性字段的配置关系的。
在本案例中，我们想实现：

Jira同步到Polarion：
1、故障的概要 映射到 Issue的Title
2、故障的优先级 映射到 Issue的严重度
3、故障的报告人 映射到 Issue的Repoter
Polarion同步到Jira:
1、Issue的Status 映射到 故障的状态
2、Issue的Assignee 映射到 故障的经办人

Polarion 中 Issue 的属性字段
image.png

Jira 中 故障 的属性字段
image.png

5.4.2 配置

1、在 From type Issue to type 故障 中点击image.png

2、按照需求，分别在Left Field和Right Field中选择相应的字段名，其中Primary Direction表示首选同步方向
image.png

3、在本案例中，Polarion的Severity存在多个选项值，同样的，Jira中的优先级也具有多个选项值，这里需要对两个属性值进行属性选项值的映射。点击Severity行的Edit进入编辑页面。
image.png

4、添加Severity属性选项值的对应关系
image.png

5、类似的，对Status也进行设置属性选项值对应关系
image.png

6、点击image.png，完成保存

6 测试同步状态

6.1 在Jira中新建故障

1、在Jira中新建一个故障
image.png

2、在Polarion的Synchronization Pairs中，点击执行
image.png

6.2 在Polarion中查看Issue

1、打开Work Items > Issue
image.png

2、此时已经可以看到一个Issue已经被创建了
image.png

6.3 在Polarion中完成状态更改

1、假设我们在Polarion完成了该Issue的处理，我们将整个Issue标记为Done
image.png

2、在Polarion的Synchronization Pairs中，点击执行
image.png

3、在Jira中查看，该故障的状态已经同步为完成了
image.png

7 配置Polarion计划任务

1、使用管理员账户登入Polarion

2、点击页面右上角“设置”菜单，点击Administration，进入管理页面
image.png

3、点击Global Administration进入全局管理界面
image.png

4、进入Scheduler
image.png

5、编辑Job XML，作用域范围为 TestProject，执行的动作为Sync 1，cron表达式为 每2分钟执行一次

  1. <job id="synchronizer" name="Connector Sync Job" scope="project:TestProject" cronExpression="0 0/2 * * * ? *">
  2.     <syncPair>Sync 1</syncPair>
  3. </job>

6、将该代码段插入之间，并保存

7、在Monitor界面可以查看任务的执行情况
image.png

image.png