基本仪表板嵌入

本页演示如何在外部应用程序中将仪表板嵌入为 iframe。 查看者使用其 Azure Databricks 凭据访问仪表板。

生成嵌入代码

若要生成可粘贴到外部应用程序中的嵌入代码，请执行以下作：

1. 打开要嵌入的已发布仪表板。 请参阅 “查看和组织仪表板 ”，了解如何在工作区中查看和访问仪表板。

2. 单击右上角的“ 共享 ”。

3. 在“共享”对话框中单击“嵌入”仪表板。

4. 此时会打开 “复制嵌入代码 ”对话框。 如果存在允许的嵌入域的列表，则列出域。 单击 ，复制按钮以复制代码片段。

   

5. 将嵌入代码插入支持 HTML 嵌入的任何平台或应用程序中，并可以呈现 iframe 内容。 请参阅 示例。

例子

以下示例包括有关在应用程序中嵌入仪表板的分步指南。 每组说明都假定你已经复制了上一部分中概述的嵌入代码。

在 Confluence 中嵌入

生成的嵌入代码需要稍有调整才能满足 Confluence 的要求。 若要在 Confluence 页中嵌入仪表板，请完成以下步骤：

1. 编辑嵌入代码以仅包含生成的 URL，而不是 iframe 标记或其他标记值。

   在编辑之前，嵌入代码包括 iframe HTML 标记、指向仪表板的链接以使用 iframe 中的源，以及高度、宽度和边框的其他规范，如以下代码片段所示。 对于仪表板，示例占位符 <databricks-instance-name> 包含 <dashboard-and-workspace-ID> 与工作区和仪表板关联的实际值。 如下所示：

   • 登录工作区时，这是 <databricks-instance-name> URL 的第一部分。 请参阅获取工作区对象的标识符。
   • 这是 <dashboard-and-workspace-ID> 指向仪表板的 URL 的最后一部分。 它看起来类似于： a4bf23c498752e79f1a2d6b4c9087e31?o=3498561237865447

   <iframe src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>" width="100%" height="600" frameborder="0"></iframe>
   

   编辑字符串，使其仅包含链接文本，如以下示例所示。

   https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>
   

2. 将 iframe 元素插入页面。 若要了解如何在页面中插入 iframe，请参阅 Confluence 的文档。

3. 将编辑的嵌入 URL 粘贴到 URL 文本字段中，并将宽度设置为 100%。

4. 根据偏好调整其他设置。

嵌入 Salesforce 知识

若要在 Salesforce 知识页中嵌入仪表板，请完成以下步骤：

1. 创建 Visualforce 页面。 有关说明，请参阅 Salesforce 的文档。

2. 在 “页面编辑” 屏幕中，将光标移动到 Visualforce 标记 编辑器中。

3. 粘贴在两 <apex:page></apex:page> 个标记之间复制的嵌入代码。

4. 在嵌入代码周围添加两个段落标记（<p></p>）。

   以下示例使用占位符 <dashboard-embed-code> 来演示 Visualforce 标记的外观。 实例应包含复制的完整嵌入代码。

   <apex:page >
   <p><dashboard-embed-code></p>
   </apex:page>
   

5. 单击“ 保存” 保存所做的更改。

6. 单击 “预览 ”并确认仪表板呈现。

7. 复制组件预览的 URL 并创建新的 iframe 组件。 它应类似于以下代码片段。 占位符 <your-salesforce-domain> 应替换为 Salesforce 域。

   <iframe src="https://<your-salesforce-domain>/apex/<component name>" width="100%" height="600" frameborder="0"></iframe>
   

8. 转到要嵌入仪表板的“知识”页。

9. 单击“ 编辑 > 添加媒体组件”。

10. 将上一步中的 iframe 代码粘贴到 “嵌入 文本”字段中。

在 SharePoint 中嵌入

若要在 SharePoint 中嵌入仪表板，可能需要将 Azure Databricks URL 添加到 SharePoint 上嵌入内容的允许网站列表。 有关说明，请参阅 Microsoft的文档。 然后，完成以下步骤：

1. 转到要在其中托管嵌入式仪表板的 SharePoint 页面。
2. 将 Embed 元素添加到页面。
3. 将完整的嵌入代码粘贴到 网站地址中，或在屏幕右侧嵌入代码 字段。
4. 单击以确认。

嵌入单个小组件

若要从仪表板嵌入单个小组件，需要仪表板嵌入代码和要显示的小组件的唯一标识符。

复制唯一标识符

单个小组件的标识符是页面 name 值和小组件 name 值的组合，由 tilda （~） 分隔。

复制唯一标识符：

1. 在 Azure Databricks 工作区中打开已发布的仪表板。

2. 单击 要嵌入的小组件的 kebab 菜单。

3. 单击“ 查看全屏 ”或 “复制”链接到小组件。 URL 包含相关的页面和小组件 name 值。

4. 复制搜索参数 fullscreenWidget 和等号后的所有内容（=）。

   以下示例显示了全屏小组件的 URL 的最后一部分：

   fullscreenWidget=53eadf26~3490f286
   

调整生成的嵌入代码

1. 请参阅 “生成嵌入代码 ”，查找生成仪表板嵌入代码的步骤。
2. 添加到 &fullscreenWidget=<ID> 嵌入 URL，替换为 <ID> 组合 <page-name>~<widget-name> 值。

例如，如果基本嵌入 URL 如下所示：

src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>&fullscreenWidget=<ID>"

具有唯一标识符的已更新嵌入 URL 应如下所示：

src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>&fullscreenWidget=53eadf26~82f66691"

查看嵌入式仪表板

嵌入式仪表板为查看者提供了一种安全的方式来访问 Azure Databricks 外部的仪表板数据。 所有现有共享设置都适用。 必须向预期查看者授予对仪表板的访问权限。 请参阅谁可以访问仪表板？ 访问嵌入式仪表板时，系统会提示查看者登录到 Azure Databricks，除非他们具有从最近登录到同一工作区的活动会话。

若要查看嵌入式仪表板，请执行以下作：

• 导航到仪表板已嵌入的页面。
• 如有必要，请使用 Azure Databricks 凭据登录。

在嵌入式仪表板中询问 Genie

查看与 关联 Genie 空间一起发布的嵌入式仪表板时，查看者可以访问 “询问 Genie ”按钮，以使用自然语言问题浏览数据。

若要在嵌入式仪表板中使用 Genie，请执行以下步骤：

1. 导航到嵌入的仪表板页。
2. 如有必要，请使用 Databricks 凭据登录。
3. 在仪表板界面中单击 “Ask Genie ”。
4. 键入有关仪表板数据的自然语言问题。

Genie 使用与已发布的仪表板相同的权限和数据访问权限。 有关设置和将 Genie 与仪表板配合使用的详细信息，请参阅 包含仪表板的 Genie 空间 。

刷新嵌入式仪表板

嵌入式仪表板的所有查看者都可以按需手动刷新仪表板。 还可以设置计划来定期刷新仪表板。

请参阅管理计划的仪表板更新和订阅。

嵌入式仪表板疑难解答

有关使用嵌入式仪表板时的常见问题和解决方法，包括主题显示问题和空白 iframe，请参阅 嵌入式仪表板疑难解答。

后续步骤

• 为外部用户配置嵌入：请参阅 为外部用户嵌入哪些内容？。
• 管理嵌入权限：控制哪些域可以托管嵌入式仪表板并配置工作区级嵌入设置。 请参阅 “管理仪表板嵌入”。
• 共享已发布的仪表板：为已发布的仪表板配置共享设置和权限，其中包含不同的用户组。 请参阅共享仪表板。