跳转到主要内容

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

项目详情


下载文件

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

源代码发行版

本发行版没有提供源代码发行版文件。请参阅生成发行版存档的教程

构建发行版

odoo12_addon_connector_jira-12.0.1.7.0-py3-none-any.whl (182.8 kB 查看哈希值)

上传时间 Python 3

支持