通过

嵌入仪表板

  • 项目

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

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

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

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

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

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

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

    “复制嵌入代码”对话框显示生成的 iframe 代码和可嵌入已发布仪表板的域。

  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. 根据偏好调整其他设置。

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

嵌入 Salesforce 知识

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

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

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

  3. 粘贴在两个 </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. 转到要嵌入仪表板的 Knowledge 页。

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

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

在 SharePoint 中嵌入

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

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

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

查看嵌入式仪表板

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

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

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

注意

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

刷新嵌入式仪表板

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

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

排查嵌入式仪表板问题

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

嵌入的 iframe 为空

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

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