跳转到主要内容

JIRA连接器

项目描述

Beta License: AGPL-3 OCA/connector-jira Translate me on Weblate Try me on Runbot

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

目录

安装

您需要以下Python包

  • requests

  • jira

  • oauthlib

  • requests-oauthlib

  • requests-toolbelt

  • PyJWT

  • cryptography

一旦安装了插件,请按照以下步骤操作

工作队列

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. 在创建的后端上,单击“认证”按钮,将出现包含密钥的弹出窗口,请在标签页中保持打开状态

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

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

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

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

  6. 链接应该已经创建,使用右边的笔进行编辑

  7. 打开“传入身份验证”面板,请注意,它可能需要一些时间来加载

  8. 将Odoo中的消费者密钥和公钥复制粘贴到Jira链接的传入身份验证中。设置消费者名称(例如odoo)并留空消费者回调URL和双因素认证

  9. 点击表单底部的“保存”(您可能需要滚动)

  10. 回到Odoo,点击继续

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

  12. 再次回到Odoo,点击继续

  13. 认证完成!

后端配置

设置webhooks

建议设置webhooks,以便同步是实时的。

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

  2. 点击“安装Webhooks”

配置史诗链接

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

配置完成

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

使用

任务和工作日志始终从JIRA导入到Odoo,没有其他方向的同步。

初始同步

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

创建并导出项目

可以在Odoo中创建项目并导出到Jira。然后可以创建一个项目,使用“与JIRA链接”操作和“导出到JIRA”操作。

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

项目上的问题类型

链接项目时,必须选择要同步的问题类型。只有所选类型的工作将创建在Odoo中。

如果向未同步的问题类型添加了JIRA工作日志,则会附加到以下规则中最近的任务

  • 如果是子任务,找到父任务

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

  • 如果没有史诗,则附加到未与任务链接的项目

在项目上更改同步配置

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

同步任务和工作日志

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

已知问题/路线图

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

允许每个项目多个绑定

设计已演变,允许Odoo中的每个项目有多个Jira绑定。这方便地允许从Jira获取许多项目的任务和工作日志,这些将在Odoo的一个项目中跟踪。

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

  • 最多只能有一个项目(可以是零个)可以将“同步操作”设置为“导出到JIRA”。因为这个配置会将项目的名称和密钥推送到Jira,所以我们不能将其推送到多个项目。

  • 如果我们实现将任务推送到Jira,我们就必须添加一种方法来限制或选择将任务推送到哪个项目,目前还不支持(例如,在项目绑定中添加布尔值“导出任务”,或在任务上显式选择目标绑定)。

错误跟踪器

错误在GitHub Issues上进行跟踪。如果遇到问题,请检查是否已经报告了您的问题。如果您是第一个发现它的人,请通过提供详细且受欢迎的反馈来帮助我们解决问题。

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

鸣谢

作者

  • Camptocamp

贡献者

维护者

此模块由OCA维护。

Odoo Community Association

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

此模块是GitHub上OCA/connector-jira项目的组成部分。

欢迎您贡献。有关如何贡献的信息,请访问https://odoo-community.org/page/Contribute

项目详情


下载文件

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

源代码分发

此版本没有可用的源代码分发文件。请参阅生成分发存档的教程。

构建分发

odoo13_addon_connector_jira-13.0.1.1.0-py3-none-any.whl (187.1 kB 查看散列)

上传时间 Python 3

由以下支持