|||
-|-|-|
| 摘要 | Discourse Jira 同步项目、问题类型、字段、问题状态并管理问题。
| 存储库链接 | https://github.com/discourse/discourse-jira
| 安装指南 | 如何在 Discourse 中安装插件
功能
- Jira 项目、问题类型、字段和字段选项将自动同步。
- 使用动态问题创建表单为 Discourse 帖子创建新的 Jira 问题。
- 将现有 Jira 问题附加到 Discourse 帖子。
- 使用 webhook 同步 Jira 问题的状态。
屏幕截图
帖子菜单
配置
在启用插件之前,请设置以下站点设置的值。
discourse_jira_url: 输入 Jira 实例的 URL。它应该以 / 符号结尾。
discourse_jira_username: 将要创建问题的用户的用户名。
discourse_jira_password: 分配给创建问题的用户的 API 密钥。密码也可以使用,但不安全,并且 API 已被 Atlassian 弃用。
discourse_jira_enabled: 为 Discourse 启用 Jira 插件。
discourse_jira_allowed_groups: 选择有权访问 Jira 插件功能的组。默认为管理员和版主。
Webhook
设置一个密钥令牌以验证来自 Jira 的传入 webhook。
discourse_jira_webhook_token: 此令牌必须在 webhook 的 ‘t’ 查询参数中传递。
例如,假设 webhook 令牌是 supersecret,您的基本 Discourse URL 是 discourse.example.com,那么您将在 Jira 实例的 webhook 设置中将 webhook URL 设置为 https://discourse.example.com/jira/issues/webhook?t=supersecret。
仅用于检查 webhook 是否被触发以及发出的正文是否正确,您可以选择使用 RequestBin 或 Webhook.site 等外部网站来设置临时 webhook URL。
调试
discourse_jira_verbose_log: 启用此设置以记录传入 webhook 和传出 API 请求的负载。
\u003e:discourse2: 由我们托管?此插件在我们的 Enterprise 计划中可用。
10 个赞
@vinothkannans 我们注意到用户实际上看不到这些工单的状态,只有管理员才能看到。能否采取措施让用户更清楚地看到“状态”?
一种选择当然是让那个引用块可见,或者如果您能将 Jira 状态映射到标签,并且主题标签更新以反映工单进度(#backlog、#in-progress、#complete 等),那也将很棒。
为了呼应 Jordan 的观点,我有一些关于改进此插件的额外想法。
- 能够分离 JIRA 工单。我看不到分离或删除我链接到帖子的 JIRA 工单的选项。
- 选择哪些组可以看到附加的 JIRA 工单。目前似乎只有站点管理员可以看到它们,但我们希望可以选择一个或多个附加组来查看它们。
- 可见性级别。能够指定工单的哪些部分会显示给非管理员。例如,我们可能希望所有组都能看到工单编号和状态,但看不到工单标题,因为标题可能包含敏感信息。然后,我们可以指定可以查看工单标题的可信组。
2 个赞
是否有此内容的 OpenProject 版本?如果能有的话那就太好了,因为我们使用 OpenProject 来管理我们的任务。
@jordan-violet @colin.mckibben 这些都是让插件更有用的好建议。下次我开发它时会考虑这些。
1 个赞
您好,我有一个关于配置插件的问题。在创建/附加问题时,我一直收到 500 错误,所以我想我的设置不太对。我做错了什么?
首先,我将通常访问 Jira 实例的位置复制并粘贴到 discourse jira url 中,尽管我对 URL 不是很确定,因为 URL 会根据所选的 Jira 视图而有所不同。
首先,我设置了一个随机的 discourse jira username,并将 discourse jira password 从生成的 Atlassian API 令牌复制并粘贴。
然后我添加了一个 Jira Webhook,并将 Jira Webhook 的 URL 设置为我的 discourse 实例的 URL 加上 /jira/issues/webhook?t=
然后我设置了 Webhook 密钥,并将该密钥复制并粘贴回插件配置字段 discourse jira webhook token。
有什么想法吗?非常感谢您的帮助!谢谢。
有人能分享一下你们在 Discourse 中可用的插件设置(当然不包括密码/令牌)吗?我想看看你们是如何让它工作的。谢谢!
我将 webhook 令牌复制回 Jira webhook 设置中的 URL,因此它显示为 https://example.com/jira/issues/webhook?t=abcdefghijk,并且您的 discourse_jira_url 也应该是 https://modernsquared.atlassian.net/,不带路径。
@vinothkannans 我还有另一个问题:在附加主题后是否可以更改附加到主题的问题,或者简单地删除/移除附件?如果不行,您是否考虑过实现它?
ckshen
10
谢谢 @mikael.gundhus,我已成功将插件连接到 Jira。
但我遇到了一些奇怪的问题。我不确定是否只有我遇到了这个问题,但“创建并附加问题”按钮似乎颠倒了?当我点击“创建问题”按钮时,插件会带我到附加问题屏幕:
当我点击“附加问题”按钮时,插件会带我到创建问题屏幕:MS-155 是 Jira 中已存在的一个问题。如果我输入一个新问题,例如 MS-200,它在 Jira 中不存在,它会告诉我 发生错误:您无权查看所请求的资源。
@mikael.gundhus 是的,应该有一个删除现有附件的选项。@ckshen 看起来模态窗口的标题不正确。我们将在下一次迭代中处理这些问题。
putty
(Derek Putnam)
12
是否有计划让非管理员/版主用户也能使用此功能?我们有内部团队希望将他们的运营转移到 Discourse,但目前,他们使用 JIra 工具的唯一方法是授予他们全站管理权限。
4 个赞
benji
(Benji)
14
我刚刚更新了这个插件,加入了群组权限!它默认包含管理员,并且必须始终包含管理员,但通过这次更新,用户现在无需管理员级别即可创建 Jira 工单。祝您使用愉快!
5 个赞
各位朋友,
有人成功在 Jira Server 或 Datacenter 上使用过此插件吗?
我没有看到任何附件选项,并在日志中看到一个错误。
Job exception: DiscourseJira::InvalidURI
nat
(Natalie T)
16
1 个赞
谢谢 Natalie,在将我们的主机添加到“安全”下的允许的内部主机后,我们能够链接并创建问题。对于任何使用 Jira 内部实例的人来说,这可能很有用。评论同步仍在进行中,但我认为这是一个配置问题。
2 个赞
此功能是否也适用于 Jira Service Management 项目?
Moin
19
似乎 jira 和 reactions 之间存在不兼容问题
1 个赞