您可以內嵌指標以將它們與其他 Web 內容一起顯示在與您的 Viewer 最相關的上下文中。當載入內嵌指標時,會直接連線到 Tableau Server 或 Tableau Online 上的資料,因此可獲得最新的可用資料。

要將指標內嵌網頁,請複製 Tableau Server 或 Tableau Online 上提供的 HTML 內嵌程式碼,或使用下面顯示的 JavaScript 範例。只要這些指標來自同一個 Tableau 站台,就可以在單個頁面上內嵌多個指標。

內嵌指標可與 Tableau Online 和 Tableau Server 支援的相同 Web 瀏覽器一起使用。有關支援的瀏覽器清單,請參閱技術規格。儘管 Safari 支援內嵌,但 Viewer 必須關閉「防止跨站台追蹤」才能看到內嵌的內容。

內嵌指標的內嵌程式碼和參數與用於內嵌檢視的程式碼和參數不同。有關如何內嵌檢視的詳情,請參閱將檢視內嵌網頁

附註:Tableau 管理員可以限制允許嵌入或完全停用嵌入的站台。如果未載入您的嵌入指標未,請與管理員聯繫,以確保嵌入其站台在嵌入允許清單中。更多資訊請參閱用於內嵌的 Tableau 站台設定

複製內嵌程式碼

內嵌指標的最快方法是複製 Tableau 提供的內嵌程式碼。

  1. 在 Tableau Online 或 Tableau Server 上,巡覽到要內嵌的指標詳細資訊頁面。
  2. 按一下「共用指標」按鈕。
  3. 按一下「複製內嵌程式碼」
    在共用對話方塊上複製內嵌程式碼紐按鈕
  4. 將內嵌程式碼貼上要內嵌指標的網頁中。

編寫自己的內嵌程式碼

當從 Tableau Server 或 Tableau Online 複製內嵌程式碼時,複製的會是 HTML 內嵌程式碼,沒有任何可選參數。如果想更好控制內嵌指標,可以自訂 HTML 或使用 JavaScript 範例編寫自己的指令碼。

HTML 範例

                    <tableau-metric
	src='https://mycompany/#/metrics/1'
	link-target='https://example.com'>
</tableau-metric>
<script type='module' src='https://mycompany/javascripts/api/tableau.metric.1.latest.min.js'></script>
                

JavaScript 範例

                    <div id='metricDiv'/>
<script type='module'>
	import { TableauMetric } from 'https://mycompany/javascripts/api/tableau.metric.1.latest.min.js';
				
	let metric = new TableauMetric();

	metric.src = 'https://mycompany/#/metrics/1';
	metric.linkTarget = 'https://example.com';document.getElementById('metricDiv').appendChild(metric);
</script>
                

內嵌程式碼的參數

內嵌程式碼的參數可用於自訂 HTML 和 JavaScript 內嵌選項。

參數 說明 範例
src
(必需)
字串 在 Tableau Server 或 Tableau Online 上指標的 URL。 https://mycompany/#/metrics/1

連結目標 (HTML)

連結目標 (JavaScript)

(可選)

字串 Viewer 按一下該指標將被導向到的 URL。如果未指定目標,則內嵌指標將連結到來源 URL。 http://example.com

內嵌指標的身份驗證

內嵌指標遵守 Tableau Server 和 Tableau Online 上使用的相同授權和權限限制。要查看內嵌指標,Viewer 必須登入內嵌該指標的 Tableau 站台上的帳戶。與內嵌檢視不同,內嵌指標不允許使用訪客帳戶向未登入的 viewer 顯示指標。

未在另一個索引標籤中登入 Tableau Server 或 Tableau Online 的 Viewer 將被提示須從內嵌指標本身登入。要從內嵌指標成功登入,必須將 Viewer 的瀏覽器配置為允許第三方 cookie。

內嵌指標支援 Tableau Server 和 Tableau Online 的所有身份驗證方法,受信任身份驗證除外。對於從 Tableau Server 內嵌的指標,伺服器必須使用 HTTPS 來保護通訊。

要為內嵌指標啟用單一登入體驗,您的 Tableau 管理員必須在 Tableau Server 與外部授權伺服器(僅限 Tableau Server)或與 Tableau 連線的應用程式和網頁之間配置信任關係。有關詳細資訊,請參見 Tableau Server 說明中的註冊 EAS 以啟用內嵌內容的 SSO(連結在新視窗開啟) 或 Tableau Online 說明中的配置 Tableau 連線的應用程式以啟用內嵌內容的 SSO(連結在新視窗開啟)

如何組建指標 URL

要內嵌指標,請指定指標 URL 和用於呈現指標的 JavaScript 的 URL。指標 URL 在 Tableau Online、具有單個站台的 Tableau Server 環境和多站台 Tableau Server 環境中遵循略有不同的模式。如果不確定如何設定 URL 格式,請複製內嵌程式碼,因為它同時包含指標 URL 和 JavaScript URL。

指標必須託管於 Tableau Server 或 Tableau Online 上。不能從本機檔案內嵌指標。

指標 URL 結構

  • Tableau Online 按台:https://<pod>.online.tableau.com/#/site/<sitename>/metrics/<metric>
  • Tableau Server 單個站台(或預設站台):https://<servername>/#/metrics/<metric>
  • Tableau Server 多站台:https://<servername>/#/site/<sitename>/metrics/<metric>

JavaScript URL 結構

指標 URL 會根據內嵌的站台而變化,但呈現指標的 JavaScript 的 URL 不會變更,因為它不包含該站台。

  • Tableau Online 按台:https://<pod>.online.tableau.com/javascripts/api/tableau.metric.1.latest.min.js
  • Tableau Server:https://<servername>/javascripts/api/tableau.metric.1.latest.min.js
感謝您的意見回饋!