演练：Jira集成

本演练可帮助您设置和使用专业云服务器的集成功能，通过云安装选项将您的Enterprise Architect模型与相应的 Jira Software 项目集成。

使用与 Jira 的集成，您可以：

将Enterprise Architect元素与 Jira 中的对应元素链接起来
根据 Jira 项目创建Enterprise Architect元素，反之亦然
根据需要同步Enterprise Architect和 Jira 之间的更改
执行可追溯性分析
从Enterprise Architect向 Jira 项目添加评论

当您的系统上安装专业云服务器时，它会提供一个提示来安装可选的集成插件组件；默认情况下，该组件安装在 C:\Program Files (x86)\ Sparx Systems \专业云服务器\SBPI\ 文件夹中（假设使用的是 64 位机器）。集成插件组件包括：

集成(SBPI)服务器(sbpi.exe)
许多集成工具的插件 .exe 文件，包括 Jira 的插件 .exe 文件（JiraSbpi.exe）

JiraSbpi.exe 插件与 Atlassian 的问题跟踪系统交互。它能够列出用户收藏的过滤器（也称为星号过滤器）。每个过滤器都会列出其返回的所有 Jira 项目。这些过滤器在 Jira 中配置在每个用户登录的“收藏夹”文件夹中，在Enterprise Architect请求集成插件连接到这些过滤器之前。您只能查看过滤器中包含的 Jira 项目，因此请在 Jira 中创建合适的过滤器。例如，如果您想将Enterprise Architect需求链接到 Jira用户案例，请创建一个显示相关用户案例过滤器。

Jira 本身有两个安装选项：Jira云和 Jira服务器。Jira服务器选项正在逐步淘汰，因此这些步骤假设您使用的是 Jira云。但是，如果您使用的是 Jira服务器，则步骤中有一些注释可以适应这种情况。

访问令牌

如果 Jira 托管在 Atlassian 服务器上而非本地，则需要使用 Atlassian 站点上创建的 TokenID，用于登录 Atlassian 的单个预定义用户集。请参阅 Atlassian 网站上关于访问令牌 -一般审阅的页面 ( https ) 以及关于创建令牌的讨论 ( https )。请参阅下方云了解更多”下的链接。

先决条件

为了建立 Jira 和Enterprise Architect之间的集成，您必须首先：

正如刚才所讨论的，将专业云服务器的许可安装与集成插件组件一起使用
在专业云服务器配置中为托管Enterprise Architect模型的每个数据库管理员系统选择“启用专业特征（OSLC、 WebEA和集成）”选项
在 PCS 服务器和托管外部 Jira 安装及其数据的 Jira 服务器之间具有网络访问
拥有访问外部数据的用户凭证
正如刚才讨论的那样，在 Jira 中设置一个包含合适过滤器的“收藏夹”文件夹
使用Enterprise Architect企业、统一或终极版本 v14 或更高版本

我们假设：

集成服务器和 Jira集成插件与专业云服务器在同一台机器上运行
您使用专业云服务器配置配置客户端端中的“集成服务器”选项卡来定义集成服务器选项，而不是通过手动操作注册表或配置文件或使用 WebConfig 界面

在 Jira 中定义加星标的过滤器

专业云服务器的 Jira 集成允许访问 Jira 星号过滤器返回的项目。在使用集成之前，您应该确保已设置一些星号过滤器，以返回您希望在Enterprise Architect中访问的项目。

要在 Jira 中定义加星标的过滤器，请按照以下步骤操作：

在 Jira 中，选择“过滤器”下拉菜单，然后选择“视图所有过滤器”。
在过滤器列表的右上角，点击“创建过滤器”按钮。
调整过滤器/搜索设置（例如项目和类型），然后使用“另存为”选项保存新的过滤器。
现在返回所有过滤器列表（“过滤器 |视图所有过滤器”）。在过滤器列表中，您可以使用星号图标将过滤器添加到已加星号的过滤器中。
此过滤器（及其返回的项目）现在应该可以通过专业云服务器的 Jira 集成进行访问

将 Jira 识别为专业云服务器和Enterprise Architect

请完成以下步骤：

双击“ Pro云Config”桌面图标，打开Pro云Config客户端窗口。
选择“集成”选项卡并选择“启用集成”复选框。在“端口”字段中，集成服务器正在侦听来自专业云服务器的请求的端口号。
单击添加按钮。将显示“添加数据提供者”对话框。
选中“已启用”复选框。
在“名称”字段中，输入适当的连接名称，例如“Jira”。
在“提供者”字段中，单击下拉箭头并选择“Jira”；这也会自动将“Jira”添加到“前缀”字段。
在“集成插件”面板的“端口”字段中，输入集成服务器用于与 Jira插件通信的端口号。
在“协议”字段中，单击下拉箭头并选择 Jira插件将用于与 Jira 通信的协议。
- 对于云默认安装，必须是“HTTPS”
- 对于 Jira服务器安装，默认值为“HTTP”
在“服务器名称/IP”字段中，输入 Jira插件将用于与 Jira 通信的服务器名称或 IP 地址。
- 对于云默认安装，这必须是 <account>.atlassian.net
- 对于 Jira服务器安装，默认值为 <服务器或主机名称>
在“端口”字段中输入 Jira插件用于与 Jira 通信的端口号。
- 对于云默认安装，此值必须是“443”
- 对于 Jira服务器安装，默认值为“8080”
离开基地对于 Jira云以及默认的 Jira服务器安装，“URL”字段为空。非默认 Jira服务器配置可能需要该字段。
注记：步骤 8 至 11 中的字段连接在一起形成一个网址；即： <protocol>://<server>:<port>/baseURL （如果字段不为空，则包含baseURL ）。
如果将“用户”和“密码”字段留空，则每个Enterprise Architect用户都会被提示输入他们的个人 Jira 凭据，这可以提供更好的可用性。
如果您希望在“用户名称”和“密码”字段中设置值，则这些值将组合使用以访问 Jira 中的数据。所有当前使用 Jira 安装的Enterprise Architect用户都将使用同一组凭据来读取外部数据。
根据需要选择“创建项”、“修改项”和/或“发布讨论”复选框，以允许 Jira插件的用户使用Enterprise Architect在 Jira 中创建和/或更新项目和/或创建讨论帖子。
如果您希望 Jira插件忽略与 Jira 通信时发生的 SSL 相关错误，请选中“忽略 SSL 错误”复选框。
您可以将其他字段留空或设置为其默认值。单击确定按钮完成配置。这将返回到专业云服务器配置客户端窗口的“集成”选项卡。

向 Jira 识别Enterprise Architect模型

在专业云服务器配置客户端窗口的“集成”选项卡上，您现在将看到：

在屏幕左下方，“数据提供者”面板将 Jira 列为数据提供者
在屏幕的右下方，“Jira”绑定到：”面板显示来自 Pro-enabled数据库管理员的Enterprise Architect模型的检查清单

您可以单击要绑定到 Jira 的每个Enterprise Architect模型对应的复选框，也可以单击

一次性选择所有模型。

单击退出按钮。

重新启动 PCS 服务以应用所做的更改。

您现在可以进入您的一个Enterprise Architect模型并检查与 Jira 的集成。

测试集成

在Enterprise Architect中打开您在列表中选择的模型之一： ‘Jira’ 已绑定到该模型。 S上图。

选择功能区选项特定>“工具”>系统集成。
在外部数据窗口的工具栏中，单击“地球”图标右侧的下拉箭头。
从列表中选择“Jira”；这会将提供商添加到工具栏中的面包屑路径中。
点击面包屑导航中的“Jira”即可显示已配置并绑定到此模型Jira 提供商列表。如果未列出任何内容，则表示尚未有任何提供商绑定到此模型。
单击已设置并绑定到此模型提供者，以显示现在可供选择在此Enterprise Architect模型中使用的 Jira 项目列表。
选择 Jira 项目以显示用户过滤器列表。

如果此处未显示任何内容，则您可能没有足够的权限查看项目。但是，如果您尚未创建任何用户过滤器，则列表仅包含“[ ]”或一条信息消息。