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,点击继续。
身份验证完成!
后端配置
设置webhook。
建议设置webhook,以便同步是实时的。
在Jira后端,将“Webhook的基础Odoo URL”设置为Odoo的URL,它必须可以从Jira访问。
点击“安装Webhook”。
配置史诗链接。
如果您使用史诗,则需要点击“配置史诗链接”,Odoo将搜索用于史诗链接的自定义字段名称。
配置完成。
您现在可以点击“配置完成”按钮。
使用方法
任务和工作日志始终从JIRA导入到Odoo,没有双向同步。
初始同步
您可以在后端选择“导入”选项卡,然后点击“链接用户”和“导入问题类型”。用户将通过登录名或电子邮件进行匹配。
创建并导出项目
可以在Odoo中创建项目并将其导出到Jira。您然后可以创建一个项目,并使用“与JIRA链接”操作和“导出到JIRA”操作。
当您选择将项目导出到JIRA时,如果更改了项目的名称或密钥,新值将被推送到JIRA。
将项目与JIRA链接
如果您已经在JIRA上有一个项目或更愿意先在JIRA上创建它,您可以链接一个Odoo项目。在项目上使用“与JIRA链接”操作,并选择“与JIRA链接”操作。
此操作建立链接,然后任何一方的名称或密钥更改都不会推送。
项目上的问题类型
当您链接项目时,您必须选择要同步的问题类型。只有所选类型的工作将创建在Odoo中。
如果向未同步的问题类型添加了JIRA工作日志,则会根据以下规则附加到最近的任务
如果是一个子任务,找到父任务
如果没有父任务,找到史诗任务(仅当它在同一项目上时)
如果没有史诗,附加到未链接到任务的未链接项目
在项目上更改同步配置
如果您想更改项目的配置,例如要同步的问题类型,您可以在项目设置中打开“连接器”选项卡,并编辑与后端的“绑定”。
同步任务和工作日志
如果webhook处于活动状态,一旦在Jira中创建,它们应该就会出现在Odoo中。如果它们未处于活动状态,您可以在Jira后端手动运行同步,或激活计划任务以运行批量导入。选择问题类型很重要,不要错过此步骤(需要改进)。
已知问题/路线图
如果Odoo用户没有链接的员工,工作日志仍然会被导入,但没有员工。
允许每个项目多个绑定
设计已发展,使Odoo中的每个项目可以超过一个Jira绑定。这方便地允许从Jira获取多个项目的任务和工作日志,这些将在Odoo中的单个项目中跟踪。
为了将数据推送到Jira,我们必须对“多绑定”项目应用限制,因为我们无法知道数据必须推送到哪个绑定。
一个项目(可能为零)最多只能有一个“同步动作”设置为“导出到JIRA”。因为这个配置会将项目名称和密钥推送到JIRA,所以不能推送到多个项目。
如果我们实现将任务推送到JIRA,我们必须添加一种方法来限制或选择将任务推送到哪个项目,这目前还不支持(例如,在项目绑定中添加一个布尔值“导出任务”,或在任务上显式选择目标绑定)
错误跟踪器
错误在GitHub Issues上跟踪。如果遇到问题,请检查您的错误是否已被报告。如果您是第一个发现它的,请通过提供详细和受欢迎的反馈来帮助我们解决这个问题。
请不要直接联系贡献者寻求支持或帮助解决技术问题。
致谢
贡献者
Camptocamp: * Damien Crier * Thierry Ducrest * Tonow-c2c * Simone Orsi <simahawk@gmail.com> * Timon Tschanz <timon.tschanz@camptocamp.com> * jcoux <julien.coux@camptocamp.com> * Patrick Tombez <patrick.tombez@camptocamp.com> * Guewen Baconnier <guewen.baconnier@camptocamp.com> * Akim Juillerat <akim.juillerat@camptocamp.com>
-
Alexey Pelykh <alexey.pelykh@corphub.eu>
-
Son Ho <sonhd@trobz.com>
维护者
此模块由OCA维护。
OCA,即Odoo社区协会,是一个非营利组织,其使命是支持Odoo功能的协作开发并促进其广泛使用。
此模块是GitHub上的OCA/connector-jira项目的一部分。
欢迎您贡献力量。要了解如何贡献,请访问https://odoo-community.org/page/Contribute。
项目详情
散列 for odoo_addon_connector_jira-15.0.1.0.1.8-py3-none-any.whl
算法 | 散列摘要 | |
---|---|---|
SHA256 | 588d36077efdd4aaa0f8981c292f983cc65963fc69828a328418eab208d2245b |
|
MD5 | 85e02e2d31fa060dfba009a5934d335c |
|
BLAKE2b-256 | 798720d79380bd97330370b5540c78078c06e39735633ddda718a10f0bb89c12 |