嵌入仪表板

本文介绍如何在外部网站或应用程序中嵌入 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 上嵌入内容的允许网站列表。 请参阅 [Microsoft 的文档] 了解如何允许在 SharePoint 页面上嵌入内容。 然后完成以下步骤:

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

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

查看嵌入式仪表板

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

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

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

注意

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

刷新嵌入式仪表板

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

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

排查嵌入式仪表板问题

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

嵌入的 iframe 为空

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

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