嵌入仪表板

项目
11/04/2024

本文介绍如何在外部网站或应用程序中嵌入 AI/BI 仪表板。工作区管理员必须先定义潜在的嵌入图面，然后才能嵌入仪表板。有关配置工作区管理仪表板嵌入的详细信息。

具有至少 CAN EDIT 权限的用户可以从“ 共享 ”对话框为仪表板生成 iframe 代码。已发布仪表板的所有共享设置仍然有效。只有已被显式授予访问权限的用户才能查看嵌入式仪表板。请参阅 “共享仪表板 ”，了解有关共享仪表板的详细信息。嵌入式仪表板遵循与所有其他仪表板相同的缓存和刷新节奏。请参阅缓存和数据刷新。

若要嵌入仪表板，请使用以下步骤：

打开要嵌入的已发布仪表板。请参阅 “查看和组织仪表板 ”，了解如何在工作区中查看和访问仪表板。
单击右上角的“ 共享 ”。
单击“共享”对话框中的“嵌入仪表板”。
此时会打开“复制嵌入代码”对话框。如果存在允许的嵌入域列表，则列出域。单击 “复制”按钮以复制代码片段。
将嵌入代码插入支持 HTML 嵌入的任何平台或应用程序中，并可以呈现 iframe 内容。请参阅示例。

注意

如果“复制嵌入代码”对话框包含不包含目标域的允许域列表，则工作区管理员可以添加它。请参阅管理仪表板嵌入。

示例

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

在 Confluence 中嵌入

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

编辑嵌入代码以仅包含生成的 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>
```
将 iframe 元素插入页面。若要了解如何在页面中插入 iframe，请参阅 Confluence 的文档。
将编辑的 嵌入 URL 粘贴到 URL 文本字段中，并将宽度设置为 100%。
根据偏好调整其他设置。

嵌入在“Confluence”页面草稿中的仪表板。

嵌入 Salesforce 知识

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

创建 Visualforce 页面。有关说明，请参阅 Salesforce 的文档。
在“页面编辑”屏幕中，将光标移动到 Visualforce 标记编辑器中。
粘贴在两个'</apex：page> 标记之间复制的嵌入代码。
在嵌入代码周围添加两个段落标记（<p></p>）。

以下示例使用占位符 <dashboard-embed-code> 来演示 Visualforce 标记的外观。实例应包含复制的完整嵌入代码。
```
<apex:page >
<p><dashboard-embed-code></p>
</apex:page>
```
以保存更改。
单击“预览”并确认仪表板呈现。
复制组件预览的 URL 并创建新的 iframe 组件。它应类似于以下代码片段。占位符 <your-salesforce-domain> 应替换为 Salesforce 域。
```
<iframe src="https://<your-salesforce-domain>/apex/<component name>" width="100%" height="600" frameborder="0"></iframe>
```
转到要嵌入仪表板的“知识”页。
单击“编辑>添加媒体组件”。
将上一步中的 iframe 代码粘贴到 “嵌入 文本”字段中。

在 SharePoint 中嵌入

若要在 SharePoint 中嵌入仪表板，可能需要将 Azure Databricks URL 添加到 SharePoint 上嵌入内容的允许网站列表。请参阅 [Microsoft 的文档] 了解如何允许在 SharePoint 页面上嵌入内容。然后完成以下步骤：

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

嵌入在草稿 SharePoint 页面中的仪表板

查看嵌入式仪表板

嵌入式仪表板为查看者提供了一种安全方式来访问 Azure Databricks 外部的仪表板数据。所有现有的共享设置均适用。必须授予预期查看者对仪表板的访问权限。请参阅谁可以访问仪表板？。

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

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

注意

如果未被授予仪表板访问权限的已注册用户尝试查看仪表板，他们会收到一条错误消息，说明仪表板不可用。请参阅共享已发布的仪表板，了解如何调整共享设置。

刷新嵌入式仪表板

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

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

排查嵌入式仪表板问题

本部分列出了可能遇到的常见问题并提供了建议的解决方法：

嵌入的 iframe 为空

如果嵌入的 iframe 未显示数据，则可能是因为你禁用了第三方 Cookie。通常需要启用第三方 cookie 才能使外部内容（如嵌入式仪表板）在另一个网页中正常运行。

可以调整浏览器设置，以允许或取消阻止第三方 Cookie 来解决此问题。如果不想允许所有第三方 Cookie，许多浏览器允许为应允许第三方 Cookie 的特定网站添加例外。有关管理 Cookie 的详细说明，请参阅浏览器的帮助文档。

通过