跳转到主要内容

JIRA连接器

项目描述

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

此模块增加了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. 身份验证完成!

后端配置

设置webhook。

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

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

  2. 点击“安装Webhook”。

配置史诗链接。

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

配置完成。

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

使用方法

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

初始同步

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

创建并导出项目

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

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

项目上的问题类型

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

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

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

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

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

在项目上更改同步配置

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

同步任务和工作日志

如果webhook处于活动状态,一旦在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

项目详情


下载文件

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

源代码分发

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

构建分发

odoo_addon_connector_jira-15.0.1.0.1.8-py3-none-any.whl (191.4 kB 查看散列)

上传时间 Python 3

由以下机构支持

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误日志 StatusPage StatusPage 状态页面