Skip to main content

JIRA 连接器

项目描述

贝塔 许可证:AGPL-3 OCA/连接器-jira 在 Weblate 上翻译我 试试我的 Runbot

该模块添加了 Jira 同步功能。

目录

<nav class="contents local" id="contents" role="doc-toc"> </nav>

安装

您需要以下 Python 包:

  • 要求

  • 吉拉

  • oauthlib

  • 请求-oauthlib

  • 请求工具带

  • PyJWT

  • 密码学

安装插件后,请按照下列步骤操作:

作业队列

odoo.conf中,类似地配置:

[queue_job]
channels = root:1,root.connector_jira.import:2

后端

  1. 打开菜单连接器 > Jira > 后端

  2. 创建一个新的 Jira 后端

    • 把你想要的名字

    • 设置 Jira 的 URL,例如https://jira.example.com

    • 您还可以选择将在其中创建记录的公司以及 Odoo 在 Jira 中创建项目时使用的默认项目模板

  3. 保存并继续进行身份验证

后端认证

  1. 在创建的后端,单击 Authenticate 按钮,将出现一个带有密钥的弹出窗口,在选项卡中保持这些打开

  2. 打开 Jira 并转到系统 > 应用程序 > 应用程序链接

  3. 输入应用程序的名称,例如:odoo,然后点击“创建新链接”

  4. 在弹出窗口中,设置 JIRA 可以访问 Odoo 的 URL。Jira 可能会抱怨并重新打开弹出窗口,再次确认并出现一个新的弹出窗口

  5. 在新的弹出窗口中,不要在字段中设置任何内容,然后单击继续

  6. 现在应该创建链接,用右边的笔编辑它

  7. 打开 Incoming Authentication 面板,被警告可能需要一些时间来加载

  8. 将消费者密钥和公钥从 Odoo 复制粘贴到 Jira 链接的传入身份验证。设置消费者名称(例如 odoo)并将消费者回调 url 和 2 legged auth 留空。

  9. 点击表格底部的保存(您需要滚动)

  10. 回到 Odoo,点击继续

  11. 将显示一个链接,单击它-您可能需要再次登录-然后单击“允许”。

  12. 再次返回 Odoo,单击继续

  13. 认证完成!

后端的配置

设置 webhook

建议设置 webhook,以便实时同步。

  1. 在 Jira 后端,将“Webhooks 的基本 Odoo URL”设置为 Odoo 的 URL,它必须可以从 Jira 访问。

  2. 点击“安装 Webhook”

配置 Epic 链路

如果您使用 Epics,您需要点击“配置 Epic Link”,Odoo 将搜索用于 Epic Link 的自定义字段的名称。

配置完成

您现在可以单击“配置完成”按钮。

用法

任务和工作日志总是从 JIRA 导入到 Odoo,在另一个方向没有同步。

初始同步

您已经可以在后端选择“导入”选项卡,然后单击“链接用户”和“导入问题类型”。用户将通过登录或电子邮件进行匹配。

创建和导出项目

项目可以在 Odoo 中创建并导出到 Jira。然后,您可以创建一个项目,并使用“Link with JIRA”操作并使用“Export to JIRA”操作。

当您选择将项目导出到 JIRA 时,如果您更改项目的名称或键,新的值将被推送到 JIRA。

项目问题类型

链接项目时,您必须选择要同步的问题类型。在 Odoo 中只会创建所选类型的任务。

如果将 JIRA 工作日志添加到未同步的问题类型,将按照以下规则附加到最近的任务:

  • 如果是子任务,则查找父任务

  • 如果没有父任务,则查找史诗任务(仅当它在同一个项目上时)

  • 如果没有史诗,附加到项目而不链接到任务

更改项目的同步配置

如果要更改项目的配置,例如同步哪些问题类型,可以在项目设置中打开“连接器”选项卡,并编辑与后端的“绑定”。

同步任务和工作日志

如果 webhook 处于活动状态,一旦在 Jira 中创建它们,它们就会出现在 Odoo 中。如果它们未激活,您可以打开 Jira 后端并手动运行同步,或激活计划操作以运行批量导入。选择问题类型很重要,所以不要错过这一步(需要改进)。

已知问题/路线图

  • 如果 odoo 用户没有链接的员工,工作日志仍将被导入,但没有员工。

每个项目允许多个绑定

该设计演变为允许在 Odoo 中的每个项目使用多个 Jira 绑定。这可以方便地获取 Jira 中许多项目的任务和工作日志,这些项目将仅在 Odoo 中的一个项目中进行跟踪。

为了将数据推送到 Jira,我们必须对这些“多绑定”项目应用限制,因为我们不知道必须将哪些绑定数据推送到:

  • 不超过一个项目(可以为零)可以将“同步操作”设置为“导出到 JIRA”。由于此配置将项目的名称和密钥推送到 Jira,因此我们不能将其推送到多个项目。

  • 如果我们将任务推送到 Jira,我们将不得不添加一种方法来限制或选择我们将任务推送到哪个项目,目前尚不支持(例如,在项目绑定上添加布尔“导出任务”,或明确选择任务上的目标绑定)

错误追踪器

在GitHub 问题上跟踪错误。如果遇到问题,请检查您的问题是否已被报告。如果您首先发现它,请通过提供详细且受欢迎的 反馈来帮助我们粉碎它。

不要就技术问题的支持或帮助直接联系贡献者。

学分

作者

  • 营地

贡献者

维护者

该模块由 OCA 维护。

Odoo 社区协会

OCA 或 Odoo 社区协会是一个非营利组织,其使命是支持 Odoo 功能的协作开发并促进其广泛使用。

该模块是GitHub 上OCA/connector-jira项目的一部分。

欢迎您贡献。要了解如何,请访问https://odoo-community.org/page/Contribute

项目详情


下载文件

下载适用于您平台的文件。如果您不确定要选择哪个,请了解有关安装包的更多信息。

内置分布

odoo_addon_connector_jira-15.0.1.0.1.7-py3-none-any.whl (191.1 kB 查看哈希

已上传 py3