PyCharm 2025.3 Help

教程:配置通用任务服务器

PyCharm 开箱即用地支持 与多种任务跟踪器集成。 但是,如果您使用 PyCharm 尚不支持的跟踪器,仍可通过配置所谓的通用任务服务器将其集成。

本教程介绍如何:

  • 以通用服务器的形式连接 JIRA Cloud。

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

  • 针对每个问题,获取其 ID、标题、描述以及问题的创建和更新日期与时间。

在开始配置与跟踪器的连接之前,请注意 PyCharm:

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

  • 支持 基本 HTTP 身份验证 ,或预先向服务器发送请求。

  • 支持 GET 和 POST 请求。

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

指定服务器 URL 和凭据

  1. Ctrl+Alt+S 打开设置,然后选择 工具 | 任务 | 服务器

  2. 点击 添加按钮 ,然后选择 通用

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

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

    密码(P) 字段中,输入您的 Atlassian API token

  4. 在对话框底部,选中 使用HTTP 身份验证(H) 复选框。

配置服务器设置

  1. 切换到 服务器配置 选项卡。

    请注意,由于您使用的是 HTTP 身份验证, 登录URL(G) 字段将被禁用。

  2. 任务列表URL(L) 中,输入用于从服务器获取问题的 URL。 您可以使用变量,或输入完整的 URL:

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

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

    {serverUrl} 是一个变量,表示您在 常规 选项卡上指定的 URL。

  3. jql?fields=*all&jql={JQL_Query} 表达式添加到任务列表 URL: {serverUrl}/rest/api/3/search/jql?fields=*all&jql={JQL_Query}

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

  5. 点击 添加按钮 ,在新字段中指定变量名 JQL_Query ,并添加其值 assignee = currentUser() AND resolution = unresolved

    这样将允许您获取分配给您的未解决问题。

  6. 点击 确定

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

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

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

    • 任务: $.issues

    • ID: key

    • 摘要: fields.summary

    • 描述: fields.description

    • 更新: fields.updated

    • 创建: fields.created

  3. 点击 测试(S) ,以确保所有参数均已正确配置。

从服务器加载问题

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

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

  3. Ctrl+Q 打开问题描述,并确保已获取所有所需的详细信息。

最后修改日期: 2025年 12月 2日