# 教程：配置通用任务服务器

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

Procedure: 安装问题跟踪器插件

此功能依赖于 [问题跟踪器](https://plugins.jetbrains.com/plugin/11545-issue-trackers) 插件，需要安装并启用。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

2. 找到  问题跟踪器  插件，然后点击   安装  。 如果出现提示，请重启 IDE。

本教程描述了如何：

* 连接到 JIRA Cloud 作为通用服务器。

* 获取分配给您的问题列表。

* 对于每个问题，获取其 ID、标题、描述、创建和更新问题的日期和时间。

在开始配置与 您的 tracker 的连接之前，请注意 IntelliJ IDEA：

* 仅支持具有 REST API 的服务。

* 支持 [基本 HTTP 身份验证](https://en.wikipedia.org/wiki/Basic_access_authentication)或向服务器发送初步请求。

* 支持 GET 和 POST 请求。

* 不支持服务器响应中的分页。

Procedure: 指定服务器URL和凭据

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `工具 | 任务 | 服务器` 。

2. 点击 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 并选择   泛型的  。

3. 在   常规  选项卡上，指定您的任务跟踪器的 URL 和连接凭据。

在   用户名   字段中，输入您的电子邮件地址。

在   密码  字段中，输入您的 [Atlassian API token](https://confluence.atlassian.com/cloud/api-tokens-938839638.html)。

4. 在对话框底部选择   使用 HTTP 认证   复选框。

Procedure: 配置服务器设置

1. 切换到   [服务器配置](managing-tasks-and-context.html#server-configuration-tab-controls)   选项卡。

请注意，由于您正在使用 HTTP 认证，   登录 URL   字段将被禁用。

2. 在   任务列表 URL   中，输入用于从服务器获取问题的 URL。 您可以使用变量或输入完整的 URL：

`{serverUrl}/rest/api/3/search/`  或

`https://serverurl.atlassian.net/rest/api/3/search/`

`{serverUrl}`  是一个变量，代表您在   常规   选项卡上指定的网址。

3. 将  `jql?fields=*all&jql={JQL_Query}`  表达式添加到您的任务列表 URL：  `{serverUrl}/rest/api/3/search/jql?fields=*all&jql={JQL_Query}` 。

> **Tip:**
> 您可以在   登录 URL  、   任务列表 URL   和   单一任务 URL   字段中使用代码补全。

4. 请点击   管理模板变量   在对话框底部配置  `JQL_Query`  变量。

5. 点击 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)并在新字段中指定变量名称  `JQL_Query` 并添加其值  `assignee = currentUser() AND resolution = unresolved` 。

这样可获取分配给你的未解决问题。

6. 点击   OK  。

> **Note:**
> URL 字段中指定的所有变量，除了  `{serverUrl}`  外，默认都用  `application/x-www-form-urlencoded`  进行编码。

> **Tip:**
> 如需了解更多关于高级搜索的信息，请参阅 [高级搜索-字段参考](https://confluence.atlassian.com/jirasoftwarecloud/advanced-searching-fields-reference-764478339.html)。

Procedure: 配置响应类型并指定选择器

1. 在   服务器配置   对话框中，选择   JSON   响应类型。

2. 在表中指定选择器以获取问题的 ID 和标题及其描述。 还可以获取问题的创建和更新日期及时间：

* 任务： `$.issues`

* id: `key`

* 摘要： `fields.summary`

* 描述： `fields.description`

* 更新： `fields.updated`

* 创建： `fields.created`

3. 点击   测试   确保所有参数均已正确配置。

Procedure: 从服务器上传问题

1. 点击任务列表并选择   打开任务  。 IntelliJ IDEA 将从服务器加载符合您配置的所有问题。

2. 从列表中选择所需的 issue。

3. 请按 `Ctrl+Q` (Windows), `F1` (macOS), `⌃ J` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Ctrl+Q` (XWin), `Ctrl+Q` (GNOME), `Ctrl+Q` (KDE), `Ctrl+Q` (Emacs), `Ctrl+Q` (Sublime Text), `Ctrl+Q` (Sublime Text (macOS)), `Ctrl+K, I` (Visual Studio), `⌘ K, I` (Visual Studio (macOS)), `Ctrl+Q` (NetBeans), `Alt+Middle-Click` (Eclipse), `⌥ Middle-Click` (Eclipse (macOS)) 打开问题描述，并确保获取所有必需的详细信息。

## See also

### 外部链接

[Basic Authentication](https://en.wikipedia.org/wiki/Basic_access_authentication) [JSONPath](http://goessner.net/articles/JsonPath/)