基本儀表板內嵌

本頁說明如何將儀表板內嵌為外部應用程式中的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 Knowledge 頁面中，請完成下列步驟：

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 值的組合，以波浪號 （）~ 分隔。

若要複製唯一識別碼：

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>"

具有唯一識別碼的更新內嵌網址應如下所示：

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

檢視內嵌儀表板

內嵌儀表板提供檢視者存取 Azure Databricks 外部儀表板資料的安全方式。 所有現有的共享設置都適用。 必須授與預期檢視者儀表板的存取權。 請參閱 誰可以存取您的儀表板？。 存取內嵌儀錶板時，系統會提示檢視者登入 Azure Databricks，除非他們有最近登入相同工作區的作用中工作階段。

若要檢視內嵌儀表板：

• 導覽至已內嵌儀表板的頁面。
• 如有必要，請使用 Azure Databricks 認證登入。

在嵌入式儀表板中詢問精靈

檢視已與 關聯的 Genie 空間一起發佈的內嵌儀表板時，檢視者可以存取 「詢問 Genie 」按鈕，以使用自然語言問題探索資料。

若要在嵌入式儀表板中使用 Genie，請參照以下步驟：

1. 導覽至內嵌儀表板頁面。
2. 如有必要，請使用 Databricks 認證登入。
3. 在儀表板介面中點擊 詢問精靈 。
4. 輸入有關儀表板資料的自然語言問題。

Genie 使用與已發佈儀表板相同的權限和資料存取權。 請參閱 Genie 空間與儀表板 ，以取得有關設定和使用 Genie 搭配儀表板的詳細資訊。

重新整理內嵌儀表板

內嵌儀表板的所有檢視者都可以視需要手動重新整理儀表板。 您也可以設定排程以定期重新整理儀表板。

請參閱 管理儀表板排程更新和訂閱。

疑難排解內嵌儀表板

關於使用嵌入式儀表板時常見的問題與解決方法，包括主題顯示問題與空白 iframe，請參見 「故障排除嵌入式儀表板」。

後續步驟

• 設定外部使用者的內嵌：請參閱 什麼是外部使用者的內嵌？。
• 管理嵌入權限： 控制哪些域可以託管嵌入式儀表板並配置工作區級別的嵌入設置。 請參閱 管理儀表板內嵌。
• 共享已發布的儀表板： 配置與不同用戶組的已發布儀表板的共享設置和權限。 請參閱共用儀表板。