
# Jira Software
JIRA是一个流行的项目和问题跟踪工具，它被广泛用于各种类型的团队和组织，包括IT、运营、销售、市场营销和人力资源等。JIRA的主要功能包括：项目管理、问题跟踪、工作流管理、报告和分析、整合和扩展，它是一个功能强大的项目和问题跟踪工具，可以帮助团队管理和协作，提高工作效率和质量。
#### 创建JIRA连接
1. 登录[CodeArts Link控制台](https://console.huaweicloud.com/codearts-link/)。
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       |
   
