教程:搭配使用 Confluence Cloud 和 Jira
Confluence 和 Jira 本身都是功能强大的工具。彼此联合更可带来变革,协助您的团队协作处理项目、开发软件和跟踪重要决策等。您可以通过多种方式来集成 Confluence 和 Jira,本教程将介绍如何完成此任务。
Confluence 和 Jira 为各种类型的团队提供了完整的解决方案,帮助他们完成最佳工作。团队可以使用 Jira 管理他们的项目,并使用 Confluence 为他们的任务嵌入相关上下文,这样每个人都能保持同步,更快地交付成果。当团队集成了 Confluence 和 Jira 后,他们就能协同工作,提供强大的项目管理和文档协作。
如果您是 Confluence Data Center 用户,请查阅此文档,了解如何搭配使用 Jira 应用和 Confluence。
链接 Confluence 和 Jira
Jira 是帮助团队计划和跟踪项目工作的得力助手。Confluence 的加入让您如虎添翼,轻松整理您和团队创建的所有创意、内容和文件,实现您的伟大愿景。
将 Jira 项目链接到存放所有项目文档的 Confluence 空间后,您便不再需要共享驱动器和文件夹了。查找内容变得无比轻松。我们言归正传!
将 Confluence 空间连接到 Jira 项目
这是集成 Confluence 和 Jira 的第一步。
- 导航到 Jira 左侧边栏中的项目页面
- 单击连接到 Confluence
- 搜索要连接的 Confluence 空间
很好!现在您可以在 Jira 中查看、创建和编辑页面和白板了。
添加 Jira 快捷方式到 Confluence 页面
通过添加快捷方式,您可在需要时轻松地在各产品之间切换。
- 复制 Jira 项目的 URL
- 导航到您要关联的 Confluence 空间
- 点击 Confluence 左侧边栏中的 +(添加快捷方式)选项
- 在“编辑空间快捷键”对话框中,粘贴您的 Jira 项目 URL,再给快捷方式取个名称以方便参考
现在,只需点击左侧边栏中的快捷方式,就能轻松导航至您的 Jira 项目了。任何人都可以在任何空间的侧边导航中添加快捷方式,管理员也可以创建键盘快捷键链接。
添加 Confluence 快捷方式到 Jira 项目
管理员可以向 Jira 项目添加 Confluence 快捷方式。
- 导航至您要链接到 Jira 的 Confluence 页面,例如您空间的概述页面
- 通过选择共享来复制页面 URL
- 在所选 Jira 项目中,选择中心导航栏中的添加快捷方式,然后再选择快捷方式
- 如同在 Confluence 中操作时一样,粘贴 Confluence 页面 URL 并为快捷方式取名
瞬间跳转到相关的 Confluence 空间,或者跳转回来。链接了 Jira 项目和 Confluence 页面后,您就能在 Confluence 通知中查看重要的 Jira 通知,例如分享、提及和评论等。即便在埋头处理 Confluence 工作,您也绝不错过任何重要的 Jira 通知。
观看以下视频中的分布指导说明:
在 Jira 中使用 Confluence
当您的 Jira 项目连接到 Confluence 空间时,您无需离开该产品即可查看、编辑和创建 Confluence 页面。这样便可在 Jira“项目页面”中实现更为集成化的体验,从而消除上下文切换。
查看页面操作十分简单。导航到您的“项目页面”,然后选择一个页面即可在嵌入式窗口中将其打开,而无需切换到 Confluence。
要在“项目页面”部分添加新内容,您可从空白 Confluence 页面或通过 Confluence 模板进行创建,且所有这些操作均在 Jira Software 内完成。
您也可以在 Jira 中使用嵌入式页面来编辑 Confluence 页面。在“项目页面”部分,只需将鼠标悬停在某一页面上即可显示铅笔图标,然后单击此图标即可进行编辑。
当您的 Jira 项目连接到 Confluence 空间时,您无需离开 Jira 就能查看、编辑和创建 Confluence 页面和白板。这样就能通过创建更加集成的体验来消除上下文切换。
从 Jira“项目页面”中查看、创建和编辑页面
在 Jira 中可以无缝管理 Confluence 页面和白板。在“项目页面”部分,您可以通过选择页面来查看页面,页面会在一个嵌入式窗口中打开,无需切换工具。
创建新内容也同样简单:从空白的 Confluence 页面开始,或者使用模板,所有这些都可在 Jira 中直接访问。编辑也很直观—将光标悬停在任何嵌入式页面上,点击铅笔图标,无需离开 Jira 即可进行更改。
这种简化的集成可确保您在一个地方高效地查看、创建和编辑内容。

将 Confluence 页面和白板直接添加到 Jira 工作项中
在 Jira 工作项中直接添加文档或信息,为任务提供重要的上下文。为此,您可以将页面和白板的链接添加到 Jira 工作项,或将 Jira 工作项的链接添加到 Confluence 页面。
将 Confluence 内容直接添加到 Jira 工作项中
“+ 添加”按钮
通过选择“+ 添加”按钮,您可以从下拉菜单中选择链接到现有的 Confluence 内容、“创建新的 Confluence 页面”或“创建 Confluence 白板”。
链接到 Confluence 内容
您可以轻松地将现有的 Confluence 页面链接到您的 Jira 工作项,以保持重要文档、会议记录或项目计划的可访问性。
- 打开要在其中添加 Confluence 内容的 Jira 工作项。
- 选择“+ 添加”按钮并选择“现有的 Confluence 页面”
- 这时会出现一个名为“Confluence 内容”的新部分,您可以通过搜索页面或粘贴链接来链接 Confluence 内容。您也可以按空间筛选。
- 指向所选 Confluence 页面的链接会填入,以显示页面标题、更新的状态和上次更新者。

创建 Confluence 页面
有时,您可能需要直接从 Jira 创建一个新的 Confluence 页面来记录任务或共享其他资源。
- 打开要在其中创建新 Confluence 页面的 Jira 工作项。
- 打开 + 添加按钮旁边的下拉菜单并选择新建 Confluence 页面
- 此时将创建一个新的 Confluence 页面,并将其自动链接到 Jira 工作项。
- 现在,您可以在 Jira 中编辑新的 Confluence 页面并添加相关信息。
- 指向新 Confluence 页面的链接将出现在 Jira 工作项中的 Confluence 内容下。
创建 Confluence 白板
Confluence 白板为直接与 Jira 工作项相链接的头脑风暴和协作提供了空间。
- 打开要在其中创建新的 Confluence 白板的 Jira 工作项。
- 打开“+ 添加”按钮旁边的下拉菜单,然后选择新建 Confluence 白板。
- 此时将创建一个新的 Confluence 白板并将其自动链接到 Jira 工作项。
- 您现在可以在 Jira 中编辑新的 Confluence 白板并添加相关信息。
- 指向新 Confluence 白板的链接将显示在 Jira 工作项的 Confluence 内容下。
智能链接
当您将 Confluence 内容网址复制并粘贴到 Jira 工作项描述中时,就会出现一个智能链接。Confluence 智能链接会直接在 Jira 工作项中显示有关该页面的重要上下文。要添加智能链接,请执行以下操作:
- 复制浏览器地址栏中的页面网址或选择共享和复制链接来进行复制。
- 将网址粘贴到 Jira 工作项视图描述中。
- 此时 Confluence 智能链接将会显示。要更改可查看上下文的级别,请点击描述,将光标悬停在智能链接上方,然后选择配置。然后,选择网址、内联、卡片或嵌入。
- 选择保存以保存您的 Jira 工作项描述。
此外,粘贴到 Confluence 页面和白板中的 Jira 工作项网址将显示在 Jira 工作项的 Confluence 页面部分,因此您可以轻松找到提及工作项的相关文档。
从 Confluence 创建 Jira 工作项
您可以直接从 Confluence 页面创建 Jira 工作项,以简化任务管理并确保跟踪重要的操作项。根据您的偏好,您可以:
- 创建单个工作项(<- 超链接)
- 创建多个工作项(<- 超链接)
在每种方法中,都有几种方法可以实现这一点。以下是关于一次创建一个 Jira 工作项和一次创建多个工作项的两个指南。
创建单个 Jira 工作项
从选中的文本创建 Jira 工作项
- 打开包含要用于 Jira 工作项的文本的 Confluence 页面。
- 选中要转换为 Jira 工作项的文本或部分。
- 选中文本后,选区上方将出现一个小工具栏。点击“+ Jira 工作项”按钮。
- 一个对话框将会打开,允许您指定 Jira 工作项的详细信息,如项目、类型、摘要、描述和任何其他必填或相关字段。选中的文本将自动插入描述字段。
- 查看工作项的详细信息并进行必要的调整。
- 点击“创建”以生成 Jira 工作项。工作项将在 Jira 中创建,并链接回 Confluence 页面,以便于参考。
使用 Atlassian Intelligence (AI) 从选中的文本创建 Jira 工作项
- 打开包含要转换为 Jira 工作项的文本的 Confluence 页面。
- 选中相关的文本或部分。
- 将出现一个上下文菜单,其中包含 + Jira 工作项选项。如果您已启用 Confluence Premium+ 或 Jira Premium+ 和 Atlassian Intelligence,您将在此菜单中看到一个额外的切换选项:使用 Atlassian Intelligence 生成摘要和描述。将其切换为启用。
- AI 将分析选中的文本,根据内容为您的 Jira 工作项建议摘要和描述。它将为工作项提供预填充的摘要和描述。
- 查看 AI 生成的详细信息。如有必要,您可以进行任何调整或接受 AI 的建议。
- 点击创建以生成 Jira 工作项。工作将根据 AI 提供的详细信息在 Jira 中创建,并将链接回 Confluence 页面以方便参考。
通过执行这些步骤,您可以手动或使用 Confluence Premium 或 Jira Premium+ 提供的高级人工智能功能,从 Confluence 页面高效地创建 Jira 工作项。
从 Confluence 页面编辑器创建 Jira 工作项
您可以在 Confluence 中起草新内容或编辑现有内容时创建 Jira 任务。在编辑模式下,使用“创建 Jira 工作项”宏无需离开 Confluence 即可创建 Jira 工作项。
- 在编辑页面时键入 /createjiraissue 或打开插入元素 + 中的下拉菜单并搜索“创建 Jira 工作项”
- 从下拉菜单中选择创建 Jira 工作项
- 填写工作项详细信息,然后选择创建
- 该工作项将自动添加到您选择的 Jira 项目和 Confluence 页面中。
观看以下视频中的分布指导说明:
创建多个 Jira 工作项
采集进度、结果和决策并不总是枯燥无味的。牵涉到许多利益相关者和团队时,具有良好的途径来分享信息至关重要。Jira 报告模板让您轻松制作 Jira 项目中工作情况的报告,从而分享当前发布的进度,或共享显示最新版本间变化的静态更改日志。
首先,使用 Jira 报告模板创建 Confluence 页面。选择您要制作报告的项目,模板会自动创建一个预配置的状态报告页面。报告会自动显示基于 Jira 项目字段的饼状图,如优先级和事务类型等。您可以选择报告所基于的字段来自定义报告。
将整个 Confluence 表格转换为多个 Jira 工作项
通过将整个 Confluence 表格转换为多个 Jira 工作项,您可以快速将项目计划和需求文档转化为 Jira 中的可跟踪工作。
- 打开包含要转换为 Jira 工作项的内容的 Confluence 页面。
- 选中要转换为 Jira 工作项的任意表格单元格中的文本。
- 选中后,选区上方将出现一个小工具栏。点击 + Jira 工作项按钮,然后从下拉菜单中选择“多个事务”(如果按钮不可见,您可能需要点击更多操作)。
- 在打开的对话框中,指定工作项的详细信息,例如项目和工作类型,并配置字段映射。
- 点击创建以生成所有工作项。
- 工作项将自动添加到您选择的 Jira 项目和表格内的 Confluence 页面。
使用 Atlassian Intelligence (AI) 创建多个 Jira 工作项
管理多个 Jira 工作项通常需要在工具之间导航、复制和粘贴内容,并确保任务之间的一致性。使用 Atlassian Intelligence,您可以直接从 Confluence 页面创建多个 Jira 任务,从而简化这一过程。
AI 会扫描您的页面,自动生成每个任务的摘要和描述,从而避免了人工操作,节省了时间,并使您的团队保持一致。通过减少上下文切换,您可以专注于您的任务,同时从 Confluence 中的规划无缝过渡到 Jira 中的任务执行,而无需离开页面。
注意:您需要启用 Confluence Premium+ 或 Jira Premium+ 和 Atlassian Intelligence 才能使用此功能。
- 访问 Confluence 页面
打开概述项目计划、需求或任何包含潜在任务的内容的页面。 - 启用 Atlassian Intelligence
确保在 Confluence 设置中启用 AI。如果不确定,请联系您的管理员以确认访问权限。 - 激活 AI 工作创建
1. 在您的 Confluence 页面上查找 AI Assist 按钮。
2. 点击该按钮启用 AI 以扫描页面。 - 扫描可操作的项目
1. AI 将分析内容并确定可操作的项目。
2. 这时会出现一个建议的 Jira 任务列表,其中包含预填充的摘要和描述。 - 查看和编辑任务
1. 查看建议的任务。
2. 您可以编辑详细信息、添加新任务或删除不必要的任务。 - 批量创建 Jira 工作项
1. 对列表感到满意后,选择全部创建以批量生成 Jira 任务。
2. 或者,通过逐个选择来创建各个任务。 - 在 Jira 中验证
1. 导航到 Jira 以确认所有任务均已成功创建。
2. 您的任务将准备就绪,您的团队可随时执行这些任务,而不会丢失 Confluence 中的上下文。
使用 Confluence 中的白板创建工作项
将白板上的便利贴转化为 Jira 工作项
将 Confluence 白板上的便利贴转化为 Jira 工作项,可以帮助您直接从头脑风暴会议中捕捉和跟踪操作项。请按照以下步骤从便利贴创建 Jira 工作项:
- 打开 Confluence 白板。
- 找到要转化为 Jira 工作项的便利贴。
- 点击便利贴以打开其选项菜单。
- 在选项菜单中,选择创建 Jira 工作项。
- 这时将打开一个对话框,您可以在其中输入 Jira 工作项的详细信息。便利贴的内容将自动插入到摘要字段中。
- 指定工作项的详细信息,如项目、工作类型、摘要和任何需要的其他信息。
- 点击创建以生成 Jira 工作项。工作项将在 Jira 中创建,并链接回 Confluence 白板,以便于参考。
- 便利贴的内容将替换为 Jira 工作项链接。
将 Jira 工作项添加到 Confluence
大多数人都不喜欢花时间在不同的应用之间跳来跳去。幸运的是,Jira 和 Confluence 的集成可以让您轻松地直接在 Confluence 中跟踪 Jira 的工作。不论您每天的大部分时间是花在 Confluence 还是 Jira 上,您都能拥有需要的上下文和可追溯性。也就是说,您的团队在每一天都能以更高的效率开展工作。
直接在 Confluence 中跟踪 Jira 工作
只需将 Jira 链接粘贴到 Confluence 页面,它就会自动在 Confluence 页面上放置一个动态的 Jira 工作项链接。在您发布页面后,该链接会显示工作项 ID 和标题、工作类型类别(长篇故事、任务,等等),以及工作项在工作流中的状态(待办、进行中、已完成,等等)。
在 Jira 工作项页面上,“Confluence 页面”部分中会出现相关 Confluence 页面的链接。
在 Confluence 页面上显示 Jira 事务动态列表
将 Jira 工作项导入到白板
将 Jira 工作项导入 Confluence 白板,可让您在协作空间中可视化和管理任务和项目。请按照以下步骤手动导入 Jira 工作项:
- 打开要添加 Jira 工作项的 Confluence 白板。
- 在底部工具栏中,选择从 Jira 导入
- 这时会出现一个菜单,您可以在其中筛选和搜索要导入的 Jira 工作项。
- 选择一个或多个工作项,然后点击导入。
- Jira 工作项现在将出现在您的白板上。您可以点击该工作项以在 Jira 的新选项卡中将其打开。
将整个白板嵌入到 Jira 工作项
通过将 Confluence 白板嵌入 Jira 工作项,可以直接在 Jira 中提供可视化上下文和协作详细信息。请按照以下步骤嵌入您的 Confluence 白板:
- 将您要嵌入的 Confluence 白板的网址复制到 Jira 中。或者,选择共享和复制链接。
- 打开要导入 Confluence 白板的 Jira 工作项。
- 将白板链接粘贴到 Jira 工作项的描述中。要更改可查看内容的级别,请将光标悬停在链接上,然后选择配置。然后,选择网址、内联、卡片或嵌入。选择嵌入将使白板在 Jira 工作项中的可见性最高。
- 现在,您可以直接从 Jira 工作项查看白板并与之交互。
在 Confluence 页面上显示 Jira 工作项的动态列表
要在 Confluence 页面上显示 Jira 工作项的动态列表,请执行以下操作:
- 在编辑页面时键入 /jira ,或点击 + 并选择 Jira
- 输入或在搜索栏中搜索 Jira 工作项
- 只选择您要显示的工作项
- (可选)选择“显示选项”以自定义它们的显示方式
- 选择“插入”
在选择您希望添加到页面中的 Jira 工作项时,您可以选择搜索现有工作项,创建新的工作项,或从最近查看的工作项中选取。搜索功能非常全面,您可以按工作类型关键字、搜索网址、Jira 链接、JQL、纯文本或筛选器来进行搜索。筛选器是节省时间的利器,您可以为一组工作项创建新的筛选器,甚至还能从 Jira 中搜索保存过的筛选器。
之后,您可以选择 Jira 工作项在页面上的显示方式:在一个表格中列出 Jira 工作项,或者仅显示与您的搜索相关的工作项数量。您创建的表格是动态的,它会在您每次刷新 Confluence 页面时更新。
观看以下视频中的分布指导说明:
嵌入 Jira 工作项收集器
您甚至还能创建 Jira 工作项收集器,进一步简化 Confluence 中的任务创建过程。
通过工作项收集器,您可以轻松地在 Confluence 页面或网站上嵌入 Jira 表单。配置了收集器并放入 Confluence 页面后,它会显示为一个按钮,选择该按钮就能生成 Jira 工作项创建表单。任何能够查看您的 Confluence 页面的人都可以选择该按钮,填写您自定义的表单,并为您链接到 Confluence 空间或页面的 Jira 项目创建一个新的 Jira 工作单。
Jira 工作项收集器非常适合收集客户反馈,也可让您组织中的人在内部测试时记录缺陷或工作项,或者只是让在 Confluence 中工作的人员更快速、更简单地在 Jira 中创建工作单,而不会中断他们的工作流。
在 Confluence 中包含您的 Jira 路线图
有两种简单的方法可以轻松地将实时路线图嵌入您的 Confluence 页面。这样,您就可以通过共享计划工作的上下文、提供状态更新等方式让团队保持一致。您可在一个位置找到所有内容,而无需切换应用,也不必手动复制和粘贴内容。也可以使用这些方法嵌入高级路线图,提供额外的规划和可视化功能。
使用智能链接添加 Jira 路线图
- 打开要添加 Jira 路线图的 Confluence 页面。
- 点击编辑按钮进入页面编辑模式。
- 在编辑器工具栏中,点击 +(插入)按钮。
- 从下拉菜单中选择 Jira Road Map。这将打开 Jira 集成对话框。
- 从 Jira 中的可用路线图或计划中进行选择。
- 点击插入将选定的路线图添加到您的 Confluence 页面。
- 根据需要调整所嵌入路线图的大小和位置。
- 点击保存或发布以完成对 Confluence 页面的更改。
使用宏添加 Jira 路线图
- 在编辑页面时,键入 /jira roadmap,或点击 +,然后选择 Jira Road Map
- 粘贴 Jira 实例 URL,选择您的项目和看板,然后选择保存

在 Confluence 中报告 Jira 数据
记录进度、结果和决策并不总是枯燥无味的。当涉及到众多利益相关者和团队时,拥有良好的信息共享方式至关重要。Jira 报告为利益相关者提供一个鸟瞰视图,他们只需点击几下就能全面了解您团队的进度情况。提高所有利益相关者的可见性可以让您的团队专注于任务,更快地完成工作。
使用智能链接将 Jira 内容嵌入 Confluence
智能链接提供了一种在 Confluence 中集成和查看 Jira 内容的直接方法,只需最少的设置。该功能支持嵌入以下 Jira 内容类型:
- Jira 面板
- Jira 待办事项列表
- Jira 仪表板和小工具
- Jira 版本
使用智能链接嵌入 Jira 内容的步骤
- 打开要嵌入的特定 Jira 内容(例如,面板、待办事项列表、仪表板、小工具或版本)。
- 从浏览器的地址栏中复制网址。
- 导航到要嵌入 Jira 内容的 Confluence 页面。
- 点击编辑按钮进入页面编辑模式。
- 将光标放在页面上的所需位置。
- 将复制的网址直接粘贴到 Confluence 页面中。Confluence 将自动识别该网址并将其显示为智能链接。
- 智能链接将呈现 Jira 内容的预览。如果需要,您可以点击该预览来调整设置或显示选项。
- 点击保存或发布以完成向您的 Confluence 页面添加 Jira 内容的操作。
使用 Jira 报告模板创建报告
Jira 报告模板简化了对您的 Jira 项目中正在进行的工作的报告。这是一种轻松分享当前版本的进度,或显示最新版本之间变化的静态更改日志的方式。
使用 Jira 报告模板的步骤:
- 使用 Jira 报告模板创建 Confluence 页面。
- 选择您要报告的 Jira 项目。该模板将自动生成预先配置的状态报告页面。
- 报告会根据 Jira 项目的优先级、工作项类型等字段显示饼图。
- 通过选择要报告的不同字段自定义报告,确保报告突出显示与团队和利益相关者最相关的信息。
观看以下视频中的分布指导说明:
在 Jira 中进行冲刺回顾
在 Jira 中结束冲刺后,您可以使用 Confluence 完成冲刺回顾—选择白板或页面来记录团队的想法和反思。回顾可以直接通过 Confluence 查看,也可以与 Jira 中的冲刺保持链接,以便于查看和参考。
使用 Jira 中的 Confluence 页面生成回顾
为使冲刺回顾顺利有序地进行,您可以直接从 Jira 轻松生成 Confluence 页面。这种方法简化了在 Confluence 中记录团队反馈和反思的过程,还有一个额外的好处,那就是保持与相关 Jira 冲刺的直接链接。
- 打开包含要为其创建回顾的冲刺的 Jira 项目。
- 导航到 Jira 项目中的当前冲刺或冲刺部分。
- 找到要为其生成回顾的冲刺,点击它以打开冲刺详细信息。
- 确保所有冲刺任务都已完成,然后选择完成冲刺。
- 这时会出现一个包含冲刺摘要的框,以及一个写有为该冲刺创建回顾的检查框。确保选中该检查框,然后选择完成冲刺。
- 这时会出现一个新框,用于在 Confluence 中设置回顾。选择 Confluence 空间或父项目等详细信息。选择 Confluence 页面,然后选择创建。
- Jira 将使用预定义的模板(如果有)自动为回顾生成一个新的 Confluence 页面。该页面将包含与冲刺相关的链接和信息。
- Confluence 页面将在一个新的选项卡或窗口中打开,您可以根据需要在其中自定义和添加其他内容。您可以使用此页面来记录团队的反馈和反思。
- 完成回顾后,保存或发布 Confluence 页面。
- 回顾页面将链接回 Jira 中的冲刺,便于从两个平台轻松访问和查看。
使用 Jira 中的 Confluence 白板生成回顾
为了简化冲刺回顾流程,您可以直接从 Jira 轻松生成 Confluence 白板。通过这种方法,您可以在 Confluence 的动态协作环境中记录团队的反馈和反思,还能方便地链接回相关的 Jira 冲刺。
- 打开包含要为其创建回顾的冲刺的 Jira 项目。
- 导航到 Jira 项目中的当前冲刺或冲刺部分。
- 找到要为其生成回顾的冲刺,点击它以打开冲刺详细信息。
- 确保所有冲刺任务都已完成,然后选择完成冲刺。
- 这时会出现一个包含冲刺摘要的框,以及一个写有为该冲刺创建回顾的检查框。确保选中该检查框,然后选择完成冲刺。
- 这时会出现一个新框,用于在 Confluence 中设置回顾。选择 Confluence 空间或父项目等详细信息。选择 Confluence 白板,然后选择创建。
- Jira 将使用预定义的模板(如果有)自动为回顾生成一个新的 Confluence 白板。该白板将包含与冲刺相关的链接和信息。
- Confluence 白板将在一个新的选项卡或窗口中打开,您可以根据需要在其中自定义和添加其他内容。您可以使用此白板来记录团队的反馈和反思。
- 完成回顾后,保存或发布 Confluence 白板。
- 回顾白板将链接回 Jira 中的冲刺,便于从两个平台轻松访问和查看。