JIRA连接器
项目描述
此模块添加了Jira同步功能。
目录
安装
您需要以下Python包
requests
jira
oauthlib
requests-oauthlib
requests-toolbelt
PyJWT
cryptography
一旦安装了插件,请按照以下步骤操作
工作队列
在odoo.conf中,进行类似配置
[queue_job]
channels = root:1,root.connector_jira.import:2
后端
打开菜单连接器 > Jira > 后端
创建一个新的Jira后端
输入您想要的名称
设置您的Jira URL,例如 https://jira.example.com
您还可以选择创建记录的公司以及Odoo在Jira中创建项目时使用的默认项目模板
保存并继续进行认证
后端认证
在创建的后端上,单击“认证”按钮,将出现包含密钥的弹出窗口,请在标签页中保持打开状态
打开Jira并转到系统 > 应用程序 > 应用链接
输入应用程序的名称,例如:odoo,然后单击“创建新链接”
在弹出窗口中,设置JIRA可以访问Odoo的URL。Jira可能会抱怨并重新打开弹出窗口,再次确认并出现新的弹出窗口
在新弹出窗口中,不要在字段中设置任何内容,然后点击继续
链接应该已经创建,使用右边的笔进行编辑
打开“传入身份验证”面板,请注意,它可能需要一些时间来加载
将Odoo中的消费者密钥和公钥复制粘贴到Jira链接的传入身份验证中。设置消费者名称(例如odoo)并留空消费者回调URL和双因素认证
点击表单底部的“保存”(您可能需要滚动)
回到Odoo,点击继续
显示一个链接,点击它 - 您可能需要再次登录 - 然后点击“允许”。
再次回到Odoo,点击继续
认证完成!
后端配置
设置webhooks
建议设置webhooks,以便同步是实时的。
在Jira后端,将“用于Webhooks的基本Odoo URL”设置为Odoo的URL,它必须可以从Jira访问。
点击“安装Webhooks”
配置史诗链接
如果您使用史诗,需要点击“配置史诗链接”,Odoo将搜索用于史诗链接的自定义字段名称。
配置完成
现在可以点击“配置完成”按钮。
使用
任务和工作日志始终从JIRA导入到Odoo,没有其他方向的同步。
初始同步
您现在可以选中后端的“导入”选项卡,然后点击“链接用户”和“导入问题类型”。用户将通过登录名或电子邮件进行匹配。
创建并导出项目
可以在Odoo中创建项目并导出到Jira。然后可以创建一个项目,使用“与JIRA链接”操作和“导出到JIRA”操作。
当您选择将项目导出到JIRA时,如果更改了项目名称或密钥,新值将推送到JIRA。
将项目与JIRA链接
如果您已经在JIRA上有一个项目或更愿意首先在JIRA上创建它,可以链接一个Odoo项目。使用项目上的“与JIRA链接”操作并选择“与JIRA链接”操作。
此操作建立链接,然后任一端名称或密钥的更改都不会推送。
项目上的问题类型
链接项目时,必须选择要同步的问题类型。只有所选类型的工作将创建在Odoo中。
如果向未同步的问题类型添加了JIRA工作日志,则会附加到以下规则中最近的任务
如果是子任务,找到父任务
如果没有父任务,找到史诗任务(仅当它在同一项目上时)
如果没有史诗,则附加到未与任务链接的项目
在项目上更改同步配置
如果您想更改项目的配置,例如同步的问题类型,可以在项目设置中打开“连接器”选项卡并编辑与后端的“绑定”。
同步任务和工作日志
如果webhooks处于活动状态,一旦在Jira中创建它们,它们应该就会出现在Odoo中。如果它们未处于活动状态,可以打开Jira后端手动运行同步,或激活计划任务以运行批量导入。选择问题类型很重要,不要错过此步骤(需要改进)。
已知问题/路线图
如果Odoo用户没有链接的员工,工作日志仍然会被导入,但没有员工。
允许每个项目多个绑定
设计已演变,允许Odoo中的每个项目有多个Jira绑定。这方便地允许从Jira获取许多项目的任务和工作日志,这些将在Odoo的一个项目中跟踪。
为了将数据推送到Jira,我们必须对这些“多绑定”项目施加限制,因为我们不知道必须将数据推送到哪个绑定。
最多只能有一个项目(可以是零个)可以将“同步操作”设置为“导出到JIRA”。因为这个配置会将项目的名称和密钥推送到Jira,所以我们不能将其推送到多个项目。
如果我们实现将任务推送到Jira,我们就必须添加一种方法来限制或选择将任务推送到哪个项目,目前还不支持(例如,在项目绑定中添加布尔值“导出任务”,或在任务上显式选择目标绑定)。
错误跟踪器
错误在GitHub Issues上进行跟踪。如果遇到问题,请检查是否已经报告了您的问题。如果您是第一个发现它的人,请通过提供详细且受欢迎的反馈来帮助我们解决问题。
请不要直接联系贡献者以获取支持或技术问题的帮助。
鸣谢
贡献者
Guewen Baconnier <guewen.baconnier@camptocamp.com>
Akim Juillerat <akim.juillerat@camptocamp.com>
Damien Crier
Patrick Tombez <patrick.tombez@camptocamp.com>
Thierry Ducrest
Timon Tschanz <timon.tschanz@camptocamp.com>
jcoux <julien.coux@camptocamp.com>
Tonow-c2c
Simone Orsi <simahawk@gmail.com>
Alexey Pelykh <alexey.pelykh@brainbeanapps.com>
维护者
此模块由OCA维护。
OCA,即Odoo社区协会,是一个非营利组织,其使命是支持Odoo功能的协作开发并推广其广泛使用。
此模块是GitHub上OCA/connector-jira项目的组成部分。
欢迎您贡献。有关如何贡献的信息,请访问https://odoo-community.org/page/Contribute。
项目详情
哈希值 for odoo13_addon_connector_jira-13.0.1.1.0-py3-none-any.whl
算法 | 哈希摘要 | |
---|---|---|
SHA256 | ee233b753613b2869b752e36f8e2d8a8600d58efff82beeb9f0ae700789e90e3 |
|
MD5 | d8202432c1e23d104409622a28411325 |
|
BLAKE2b-256 | 6396b9c06d9e51135ca4bd2237ab64deea557d54ab6d62f62159fa5c0cd72874 |