文档首页/ 应用与数据集成平台 ROMA Connect/ 用户指南（新版）/ 连接器/ SaaS应用/ Jira Software
更新时间：2023-12-28 GMT+08:00
查看PDF
分享

Jira Software

JIRA是一个流行的项目和问题跟踪工具，它被广泛用于各种类型的团队和组织，包括IT、运营、销售、市场营销和人力资源等。JIRA的主要功能包括：项目管理、问题跟踪、工作流管理、报告和分析、整合和扩展，它是一个功能强大的项目和问题跟踪工具，可以帮助团队管理和协作，提高工作效率和质量。

创建JIRA连接

  1. 登录新版ROMA Connect控制台。
  2. 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。
  3. 选择“Jira Software”连接器。
  4. 在弹窗中配置连接器信息，完成后单击“确定”。

    参数

    说明

    连接名称

    填写连接器实例名称。

    连接类型

    选择JIRA的连接类型。

    • Cloud：指在云端部署的JIRA实例，用户可以使用任何Web浏览器从任何地方访问它。
    • On-Premise：指本地安装的JIRA实例，需要在自己的服务器或本地PC上安装和配置JIRA。

    连接地址

    填写JIRA的连接地址。

    • 当“连接类型”选择“Cloud”时，连接地址格式为https://your-domain.atlassian.net。

      your-domain指组织或团队的域名，需要有有效的Jira Cloud订阅才能访问该地址。如果不确定您的Jira Cloud连接地址，可以从Atlassian账户或管理员处获取。

    • 当“连接类型”选择“On-Premise”时，填写JIRA所在服务器的IP地址或主机名，例如：http://192.168.0.1:8080或http://jira.example.com:8080。

    认证类型

    选择JIRA的认证类型，支持选择“Basic”和“API Token”。

    用户名

    仅当“认证类型”选择“Basic”时需要配置。

    连接JIRA的用户名。

    密码

    仅当“认证类型”选择“Basic”时需要配置。

    连接JIRA的用户密码。

    邮箱

    仅当“认证类型”选择“API Token”时需要配置。

    JIRA的邮箱。

    API Token

    仅当“认证类型”选择“API Token”时需要配置。

    用户需要在JIRA的个人设置中生成一个API Token，API Token是一种用于身份验证的令牌，它允许JIRA用户通过API访问其账户和相关数据。

    描述

    填写连接器的描述信息，用于识别不同的连接器。

支持的动作

  • 创建项目
  • 更新项目
  • 查询项目详情
  • 删除项目
  • 创建issue
  • 修改issue
  • 修改issue状态
  • 查询issue列表
  • 查询issue详情
  • 查找issue可指派用户
  • 添加评论
  • 修改评论
  • 查询评论列表

配置参数

表1 创建项目

参数

说明

Project Name

项目名称。

Project Key

项目唯一标识。

Project模板类型

项目模板。

项目描述

描述。
表2 更新项目

参数

说明

update by Project Key

项目唯一标识。

Project Name

项目名称。

项目描述

描述。
表3 查询项目详情

参数

说明

Project Key

项目唯一标识。
表4 删除项目

参数

说明

delete by Project Key

项目唯一标识。
表5 创建issue

参数

说明

Project类型

项目类型。

Project Key

项目唯一标识。

Issue类型

issue类型。

优先级

issue优先级。

概要

issue概要。

提出者

请输入用户名称。

分配给

请输入用户名称。

描述

issue描述。
表6 修改issue

参数

说明

Project类型

项目类型。

Project Key

项目唯一标识。

名称

请输入issue名称或id。

Issue类型

issue类型。

优先级

issue优先级。

概要

issue概要。

提出者

请输入用户名称。

分配给

请输入用户名称。

描述

issue描述。
表7 修改issue状态

参数

说明

Issue名称

请输入issue名称或id。

转换目标状态

需要选择issue支持的状态。
表8 查询issue列表

参数

说明

Jql

jira查询请求表达式。

偏移量

分页offset，默认为0。

最大返回数

分页limit。
表9 查询issue详情

参数

说明

Issue名称

请输入issue名称或id。
表10 查询issue可指派用户

参数

说明

Project Key

项目唯一标识，新建issue情况下必填。

Issue名称

请输入issue名称或id，Project Key未填时该字段必填。

JIRA用户名称

用于精确查询。
表11 添加评论

参数

说明

Issue名称

请输入issue名称或id。

可见性

指定可见人范围。

描述

评论内容。
表12 修改评论

参数

说明

Issue名称

请输入issue名称或id。

评论ID

评论的id。

描述

评论内容。

可见性

指定可见人范围。
表13 查询评论列表

参数

说明

Issue名称

请输入issue名称或id。

偏移量

分页offset，默认为0。

最大返回数

分页limit。
父主题： SaaS应用