---
schema_version: "1"
id: 62d17b5e5860a04b65beabb207ef10f083af45f2a1e88c3e8f08d275c05245c8
title: 為檢視內嵌程式碼參數
collection: tableau
version: current
locale: zh-tw
portal_url: https://docs.salesforce.com/tableau/current/zh-tw/pro/desktop/embed_list.md
canonical_url: https://help.tableau.com/current/pro/desktop/zh-tw/embed_list.htm
source_site: help.tableau.com
content_type: documentation
content_hash: fb095502b3dbe36b7c1e82418b4f711c65f18f19613b606b1b3915363b01278f
description: Tableau Server 2022
---
[跳至主要內容](#main-content)

# 為檢視內嵌程式碼參數

> [!TIP]
> 
> Tableau Server 2022.3 及更高版本和 Tableau Cloud 的內嵌程式碼已變更為使用內嵌 API v3。有關內嵌 API v3 中的類別和方法的目前清單，請參閱[內嵌 API 描述](https://help.tableau.com/current/api/embedding_api/zh-tw/index.html)中的[內嵌 API 參考](https://help.tableau.com/current/api/embedding_api/zh-tw/reference/index.html)。本主題中的資訊適用於先前版本的內嵌（使用 Tableau JavaScript API v1 和 v2）。

先前版本內嵌的參數

您可以使用以下任一方法設定內嵌式檢視：

- [JavaScript 標記的物件參數](#Object_params)
- [iframe 標記的 URL 參數](#URL_params)

## JavaScript 標記的物件參數

<table class="table--plain"><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th>物件參數</th><th>值</th><th>描述</th><th>範例</th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>dataDetails</code></td><td><code>no</code></td><td>隱藏工具列中的 [資料詳情] 按鈕，讓使用者看到檢視中使用的資料相關詳情。</td><td><code>&lt;param name='dataDetails' value='no' /&gt;</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>showDataDetails</code></td><td><code>yes</code></td><td>若已啟用 Tableau Catalog，則會顯示已開啟「資料詳細資訊」窗格的檢視。</td><td><code>&lt;param name='showDataDetails' value='yes' /&gt;</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>alerts</code></td><td><code>no</code></td><td>隱藏工具列中的 [通知] 按鈕，該按鈕使使用者能建立資料驅動型通知。</td><td><code>&lt;param name='alerts' value='no'/&gt;</code><br></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>customViews</code></td><td><code>no</code></td><td>隱藏工具列中的 [檢視] 按鈕，該按鈕使使用者能儲存自訂檢視。</td><td><code>&lt;param name='customViews' value='no'/&gt;</code><br></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>device</code></td><td><code>desktop; tablet; phone</code></td><td>如果儀表板具有適用於行動裝置的版面設定，則會顯示一個特定版面設定，而不考慮螢幕大小。如果未設定此參數，則 Tableau Server 或 Tableau Cloud 會偵測螢幕大小並載入對應的版面設定。有關範例，請參閱<a href="https://help.tableau.com/current/pro/desktop/zh-tw/embed_dashboard.htm" class="xref">內嵌儀表板</a>。</td><td><code>&lt;param name='device' value='phone'/&gt;</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>filter</code></td><td>字串</td><td>篩選在檢視開啟時顯示的資料。您也可以使用 URL 參數進行篩選。</td><td><code>&lt;param name='filter' value='Team=Blue'/&gt;</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>host_url</code></td><td>字串</td><td>必需。顯示在 URL 中的伺服器名稱。</td><td><code>&lt;param name='host_url' value='http://myserver.exampleco.com/'&gt;</code><p><code>&lt;param name="host_url" value="http://localhost/"&gt;</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>linktarget</code></td><td>字串</td><td>外部超連結的目標視窗名稱。</td><td><code>&lt;param name="linktarget" value="_blank"/&gt;</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>load-order</code></td><td>數字</td><td>當內嵌多個檢視時，確定檢視在頁面上的載入順序。允許使用負數。</td><td><code>&lt;param name="load-order" value="2"/&gt;</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>mobile</code></td><td><code>yes</code></td><td>顯示針對行動裝置的觸控優化快速篩選器。</td><td><code>&lt;param
						name='mobile' value='yes'/&gt;</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>name</code></td><td>字串</td><td>所需的物件參數，具有此結構：[工作簿名稱]/[工作表名稱]/[可選自訂檢視名稱]<p> 按如下方式設定可選自訂檢視名稱的格式：username@domain/[custom view name]<br><br>如果參考 Tableau Server 或 Tableau Cloud URL 來確認 <code>name</code> 的值，請不要包括 URL 末尾的會話 ID (<code>:iid=<i>&lt;n&gt;</i></code>)。</p></td><td><code>&lt;param name='name' value='ExampleCoSales/Sales'/&gt;</code><p><code>&lt;param
name='name' value='ExampleCoSales/Sales/jsmith@example.com/EastRegionSales'/&gt;</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:original_view</code></td><td><code>yes</code></td><td>如果 <code>name</code> 參數引用工作簿或工作表 URL（並且未顯式引用自訂檢視），則包括此參數會將檢視顯示為原始檢視。</td><td><code>&lt;param name='filter' value=':original_view=yes'/&gt;</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>path</code><p>（僅限 Tableau Server。不適用於 Tableau Cloud。）</p></td><td>字串</td><td>僅適用于受信任的驗證，不能與 <code>ticket</code> 參數一起使用。覆蓋 <code>name</code> 參數的值並用作 URL。有關詳情，請參閱 Tableau Server 管理員說明中的<a href="https://help.tableau.com/current/server/zh-tw/trusted_auth_webURL.htm" target="_blank">顯示檢視及票證</a>。</td><td><code>&lt;param name='path' value='trusted/Etdpsm_Ew6rJY-9kRrALjauU/views/workbookQ4/SalesQ4'/&gt;</code><p><code>http://tableauserver/trusted/Etdpsm_Ew6rJY-9kRrALjauU/views/workbookQ4/SalesQ4?:embed=yes&amp;:tabs=yes</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>showShareOptions</code></td><td><code>true</code>；<code>false</code></td><td>控制是否在內嵌檢視中顯示 [共用] 選項。</td><td><code>&lt;param name='showShareOptions' value='true' /&gt;</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>site_root</code></td><td>字串</td><td>必需。網站名稱。預設網站值為空 (<code>value=''</code>)。如果伺服器為多網站伺服器，並且您希望使用受信任的驗證，請參閱 Tableau Server 說明中的<a href="https://help.tableau.com/current/server/zh-tw/trusted_auth_webURL.htm" target="_blank">顯示檢視及票證</a>。</td><td><code>&lt;param name='site_root' value='/#/Sales'/&gt;</code><p><code>&lt;param name='site_root' value=''/&gt;</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>subscriptions</code></td><td><code>no</code></td><td>隱藏工具列中的 [訂閱] 按鈕，該按鈕使使用者能設定電子郵件訂閱以定期接收檢視的快照集。</td><td><p><code>&lt;param name='subscriptions' value='no'/&gt;</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>tabs</code></td><td><code>yes; no</code></td><td>顯示或隱藏索引標籤。</td><td><code>&lt;param name='tabs' value='yes'/&gt;</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>ticket</code><p>（僅限 Tableau Server。不適用於 Tableau Cloud。）</p></td><td>字串</td><td>僅適用于受信任的驗證，不能與 <code>path</code> 物件參數一起使用。必須與 <code>name</code> 物件一起使用以構造受信任的票證兌現 URL。有關詳情，請參閱 Tableau Server 說明中的<a href="https://help.tableau.com/current/server/zh-tw/trusted_auth_webURL.htm" target="_blank">顯示檢視及票證</a>。</td><td><code>&lt;param name='ticket' value='9D1ObyqDQmSIOyQpKdy4Sw==:dg62gCsSE0QRArXNTOp6mlJ5'/&gt;</code><p><code>http://tableauserver/trusted/9D1ObyqDQmSIOyQpKdy4Sw==:dg62gCsSE0QRArXNTOp6mlJ5/views/workbookQ4/SalesQ4?:embed=yes&amp;:tabs=yes</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>toolbar</code></td><td><code>yes; no; top</code></td><td>工具列預設情況下顯示在底部。當您將此參數設定為 <code>top</code> 時，工具列放在檢視上方，當您將其設定為 <code>no</code> 時，則會將工具列從內嵌式檢視中排除。</td><td><code>&lt;param name='toolbar' value='top'/&gt;</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>tooltip</code></td><td><code>yes; no</code></td><td>如果將此參數設定為 <code>no</code>，則預設情況下顯示工具提示，但是，將從內嵌式檢視中排除工具提示。</td><td><code>&lt;param name='tooltip' value='no'/&gt;</code></td></tr></tbody></table>

## iframe 標記的 URL 參數

附註：在新增 URL 參數之前，請移除 URL 末尾的 `:iid=[#]`。這是目前瀏覽器會話的臨時檢視計數器。

<table class="table--plain"><colgroup><col><col style="width: 101px;"><col><col></colgroup><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th>URL 參數</th><th>值</th><th>描述</th><th>範例</th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:dataDetails</code></td><td><code>no</code></td><td>隱藏工具列中的 [資料詳情] 按鈕，讓使用者看到檢視中使用的資料相關詳情。</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:dataDetails=no</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:showDataDetails</code></td><td><code>yes</code></td><td>若已啟用 Tableau Catalog，則會顯示已開啟「資料詳細資訊」窗格的檢視。</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:showDataDetails=yes</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:alerts</code></td><td><code>no</code></td><td>隱藏內嵌檢視中的 [通知] 按鈕。</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:alerts=no</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:customViews</code></td><td><code>no</code></td><td><span class="uicontrol">[記住我的變更] </span>選項。</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:customViews=no</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:device</code></td><td><code>desktop; tablet; phone</code></td><td>如果儀表板具有適用於行動裝置的版面設定，則會顯示一個特定版面設定，而不考慮螢幕大小。如果未設定此參數，則 Tableau Server 或 Tableau Cloud 會偵測螢幕大小並載入對應的版面設定。有關範例，請參閱<a href="https://help.tableau.com/current/pro/desktop/zh-tw/embed_dashboard.htm" class="xref">內嵌儀表板</a>。</td><td><code>http://tabserver/views/sales/sales_dashboard?:device=tablet</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:display_count</code><p>（僅限 Tableau Public）</p></td><td><code>yes</code></td><td>按一下左下方的 Tableau 標誌時會顯示頁面檢視總數。</td><td><code>https://public.tableau.com/en-us/s/gallery/what-emoji-say-about-music?:display_count=yes</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:embed</code></td><td><code>yes</code></td><td>必需的 URL 參數。隱藏頂端巡覽區域，使檢視更好地混合到網頁中。</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:format</code></td><td><code>pdf; png</code></td><td>以 PDF 或 .png 檔案顯示檢視。</td><td><code>http://tabserver/views/Sales/Q2?:format=pdf</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:highdpi</code></td><td><code>false</code></td><td>在高解析度顯示幕和裝置上使用標準 DPI（每英寸點數）呈現檢視。</td><td><code>http://tableauserver/views/Sales/Q2?:highdpi=false</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:linktarget</code></td><td>字串</td><td>外部超連結的目標視窗名稱。</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:linktarget=_blank</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:openid_hd</code></td><td>字串</td><td>在使用 OpenID Connect 進行驗證時使用。指定使用者所屬的託管網域。例如，若不想轉譯網域選取窗格，則可以使用此選項。與 <code>:openid_login_hint</code> 結合使用，以指定完整的使用者識別碼。</td><td><code>http://tabserver/views/Sales/Q2?:openid_hd=example.com</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:openid_login_hint</code></td><td>字串</td><td>在使用 OpenID Connect 進行驗證時使用。指定完整的使用者識別碼（電子郵件地址）。與 <code>:openid_hd</code> 結合使用，以指定使用者所屬的託管網域。</td><td><code>http://tabserver/views/Sales/Q2?:openid_login_hint=tara@example.com</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td>：<code>record_performance</code><p>（僅限 Tableau Server。不適用於 Tableau Cloud。）</p></td><td><code>yes</code></td><td>為檢視啟動性能記錄。在緊靠會話 ID 之前的 URL 末尾新增此項 (<code>:iid=<i>&lt;n&gt;</i></code>)。有關詳情，請參閱 Tableau Server 說明中的<a href="https://help.tableau.com/current/server/zh-tw/perf_record_create_server.htm" target="_blank">建立性能記錄</a>。</td><td><code>http://tabserver/views/Sales2013/Regions?:recordperformance=yes</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><a name="refresh_param"></a><code>:refresh</code></td><td><code>yes</code></td><td>使用 Tableau Server 或 Tableau Cloud 中的最新資料來呈現檢視。有關詳情，請參閱<a href="https://help.tableau.com/current/pro/desktop/zh-tw/refresh.htm" class="xref">重新整理資料或暫停自動更新</a>。<p class="note"><b>提示：</b>若要不斷重新整理檢視，請在網頁的 <code>&lt;head&gt;</code> 部分中新增 <code>&lt;meta http-equiv="refresh" content="#"&gt;</code>，其中 <code>#</code> 是重新整理的間隔秒數。</p></td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:refresh=yes</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:render</code></td><td><code>true</code>; <code>false</code>; number</td><td>如果用戶端呈現已啟用（預設設定），將此項設定為 <code>false</code> 將會對該會話強制實現伺服器端呈現。將此項設定為 <code>true</code> 會對該會話強制實現用戶端呈現。<p>可以輸入從 1 到 100 的數字來設定複雜性閾值，超過該閾值時，伺服器將會呈現檢視。有關詳情，請參閱 Tableau Server 說明中的<a href="https://help.tableau.com/current/server/zh-tw/browser_rendering.htm" target="_blank">關於用戶端呈現</a>。</p></td><td><code>http://tabserver/views/Date-Time/DateCalcs?:render=false</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:revert</code></td><td><code>all; filters; sorts; axes; shelves</code></td><td>使該項返回到其原始狀態。</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:revert=all</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:showAppBanner</code></td><td><code>false</code></td><td>隱藏行動 Web 瀏覽器中的「在 Tableau Mobile 中開啟」橫幅。</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:showAppBanner=false</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:showAskData</code></td><td><code>false</code></td><td>在內嵌檢視中隱藏工具列中的「資料問答」(Ask Data) 按鈕。預設情況下，顯示「資料問答」(Ask Data) 按鈕。</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:showAskData=false</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:showShareOptions</code></td><td><code>true</code>；<code>false</code></td><td>控制是否在內嵌檢視中顯示 [共用] 選項。</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:showShareOptions=true</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:showVizHome</code><p>（僅限 Tableau Public）</p></td><td><code>yes; no</code></td><td>顯示或隱藏 Tableau Public 的內容導覽介面。當在其他網頁中內嵌視覺效果時，設定為否。</td><td><code>https://public.tableau.com/en-us/s/gallery/what-emoji-say-about-music?:showVizHome=no</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:subscriptions</code></td><td><code>no</code></td><td>隱藏內嵌檢視中的 [訂閱] 按鈕。</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:subscriptions=no</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:tabs</code></td><td><code>yes; no</code></td><td>顯示或隱藏索引標籤。</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:tabs=no</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:toolbar</code></td><td><code>yes; no; top</code></td><td>如果未設定此參數，預設情況下顯示工具列。當選取 <code>no</code> 時，工具列將從內嵌檢視中排除。當選取 <code>top</code> 時，工具列將置於檢視之上。</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:toolbar=no</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:tooltip</code></td><td><code>yes; no</code></td><td>如果未設定此參數，預設情況下檢視中將顯示工具提示。如果設定為 <code>no</code>，則會從內嵌檢視中排除工具提示。</td><td><code>http://tabserver/views/workbookQ4/SalesQ4?:embed=yes&amp;:tooltip=no</code></td></tr></tbody></table>