> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira

> 一个用于通过已连接账户跟踪 bug、问题和敏捷工作的 Jira 应用。

# Jira

在你需要创建、更新、搜索或移动 Jira 工作项时使用此应用。它还可以帮助你管理评论、附件、工时日志、项目、看板和冲刺。

## 配置

| 选项 | 是否必填 | 描述 |
| - | - | - |
| 名称 | 否 | 工作流画布中此步骤的标签。 |
| Authentication | 是 | 此步骤要使用的已连接 Jira 账户。 |
| Action | 是 | 要执行的 Jira 操作（例如 Get Current User、Create Issue、Edit Issue、Get Issue）。 |
| Arguments | 是 | 根据操作的 schema 生成的每个操作表单字段。每个文本字段都有一个 **Insert Variable** 按钮，可用于插入 `{{placeholder}}` 值。高级用法可使用 **Raw JSON** 选项卡。 |
| When the step fails | 否 | 控制此步骤失败时工作流应当是 **Terminate Workflow** 还是 **Continue**。 |

在你配置此步骤之前，请先通过登录流程在工作区的 **Integrations** 中连接 Jira。如果没有可用的活动连接，此步骤会显示警告，并提供指向 **Integrations** 的链接，而不是账户选择器。

## Arguments 表单

当你选择某个操作时，**Arguments** 部分会根据该操作的输入 schema 显示一个表单。引用现有记录的字段包含下拉选择器。

如果你更愿意手动编写完整的参数对象，请切换到 **Raw JSON** 选项卡。任一选项卡中的更改都会保持同步。

## 常用操作

| 操作 | 描述 |
| - | - |
| **Get Current User** | 返回已连接 Jira 用户账户的详细信息。 |
| **Create Issue** | 在 Jira 项目中创建一个新的问题。 |
| **Edit Issue** | 更新现有 Jira 问题上的字段。 |
| **Get Issue** | 通过 ID 或 key 获取一个 Jira 问题。 |
| **Search Issues** | 使用筛选条件或 JQL 搜索 Jira 问题。 |
| **Transition Issue** | 将 Jira 问题移动到另一个工作流状态。 |
| **List Comments** | 列出 Jira 问题上的评论。 |
| **Add Attachment** | 上传文件并将其附加到 Jira 问题。 |
| **Add Worklog** | 向 Jira 问题添加一条工时日志记录。 |
| **Link Issues** | 将两个 Jira 问题关联起来。 |
| **Get All Projects** | 列出所有可见的 Jira 项目。 |
| **Get Project** | 获取某个 Jira 项目的详细信息。 |
| **List Boards** | 列出用户可见的 Jira 看板。 |
| **Create Board** | 创建一个新的 Jira 看板。 |
| **List Sprints** | 列出 Jira 看板上的冲刺。 |

删除记录等破坏性操作在工作流操作选择器中不可用。

## 输出

此步骤会将 Jira 响应存储为步骤输出。响应的结构取决于操作。

请在后续步骤中使用完整的输出引用：

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## 示例

1. 打开 **Integrations**，如果你还没有连接 Jira，请先连接。
2. 向工作流添加一个 **Jira** 步骤。
3. 在 **Authentication** 中选择一个已连接账户。
4. 在 **Action** 中选择 **Get Current User**。
5. 填写必填字段。使用 **Insert Variable** 来引用前面某一步的输出作为任意字段值。
6. 点击步骤标题栏中的 **Run** 来测试该操作，然后在 **Output** 中查看返回的载荷。

## 用例

### 从表单回复创建一个 bug

1. Create Issue
2. Add Comment
3. Add Attachment

### 通过工作流路由问题

1. Search Issues
2. Get Issue
3. Transition Issue

### 规划冲刺工作

1. List Boards
2. List Sprints
3. Create Sprint

## 备注

* 此步骤依赖于你工作区中已连接的 Jira 集成。
* 工作流操作选择器会显示一组精选操作。具有 Jira 工具的代理可以使用更多操作。
* 登录界面可能会显示第三方授权品牌标识。

## 将 Jira 作为代理工具使用

你也可以在 **Agent Editor** 中将 Jira 添加为工具。打开代理，点击 **Add tool**，然后选择 **Jira**。在工具设置面板中，选择代理应使用的已连接账户。代理会在相关于对话时调用 Jira 操作。

另见：[Integrations](https://docs.fetchhive.com/zh/workspace/integrations.md)、[Creating and Editing](https://docs.fetchhive.com/zh/workflows/creating-and-editing.md) 和 [Testing and Iteration](https://docs.fetchhive.com/zh/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.