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。
项目详情
哈希值 用于 odoo12_addon_connector_jira-12.0.1.7.0-py3-none-any.whl
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 6a5c86646c1f891cdf189d9ab1894d20b06df267eea70de739a09b7847ee330c |
|
MD5 | 64aa3be065116e11159da8d1e689ab26 |
|
BLAKE2b-256 | e89eb6ab367304db4294376d0b67df9a7dbec0cd8e48ebd829a361f9d58ded82 |