新增篩選器以為檢視內嵌程式碼
Tableau Server 2022.3 及更高版本和 Tableau Cloud 的內嵌程式碼已變更為使用內嵌 API v3。有關篩選的目前資訊,請參閱內嵌 API 說明中的篩選檢視。本主題中的資訊適用於先前版本的內嵌(使用 Tableau JavaScript API v1 和 v2)。
您可以在嵌入檢視中包括篩選器值,以便僅反白顯示所需的資料。例如,您可能希望將來自 Web 應用程式的其他部分的超連結包含到僅顯示特定區域的內嵌銷售績效檢視中。
附註: 故事不支援嵌入篩選器。
篩選一個欄位
在一個欄位上傳遞篩選器可以快速使嵌入檢視顯示特定資料。
指令碼標記範例:
<script type='text/javascript' src='http://myserver/javascripts/api/viz_v1.js'> </script> <object class='tableauViz' width='800' height='600' style='display:none;'> <param name='host_url' value='http://myserver/' /> <param name='site_root' value='' /> <param name='name' value='Superstore/Product' /> <param name='filter' value='Region=East' /> </object>
若要傳遞多個篩選器值,只需用逗號將每個值分隔開。例如:
<param name='filter' value='Region=East,West' />
iframe 標記範例:
<iframe src="http://myserver/views/Superstore/Product?:embed=y&Region=East,West" width="800" height="600"></iframe>
篩選多個欄位
您可以根據需要針對任意多個欄位傳遞篩選器,包括原始檢視中不可見的欄位。
指令碼標記範例:
<script type='text/javascript' src='http://myserver/javascripts/api/viz_v1.js'> </script> <object class='tableauViz' width='800' height='600' style='display:none;'> <param name='host_url' value='http://myserver/' /> <param name='site_root' value='' /> <param name='name' value='Superstore/Product' /> <param name='filter' value='Region=Central,South&Customer Segment=Consumer,Home Office' /> </object>
iframe 標記範例:
<iframe src="http://myserver/views/Superstore/Product?:embed=y&Region=Central,South&Segment=Consumer,Home Office" width="800" height="600"></iframe>
下面的第一個圖顯示您在檢視上按一下 [共用] ,再按一下 [複製連結] 時可獲取的 URL 的範例。
第二個圖顯示您如何能透過以下方式修改 URL 並將其新增到 iframe:刪除 showShareOptions
和 display_count
參數,為 [Region] (區域)和 [Segment] (細分)新增篩選器參數,並新增寬度和高度參數以建立一個嵌入連結,該連結僅顯示中部和南部地區的消費者及家庭辦公室產品。
附註: 如果篩選器值包含特殊字元(例如逗號),請將該字元替換為 \
(反斜線,%5c
)的網址編碼順序,後接特殊字元的網址編碼順序。需要使用反斜線對特殊字元進行轉義。例如,\,
(反斜線,逗號)的 URL 編碼序列是 %5c%2c
。
篩選日期和時間
如果需要篩選 [日期/時間] 欄位,請使用下面顯示的預設 Tableau 格式將該值包括進來:
yyyy-mm-dd hh:mm:ss
時間部件使用 24 小時時鐘。許多資料庫將所有日期值存儲為 [日期時間] 欄位,因此,您可能需要與日期一起傳遞時間值。
指令碼標記範例:
<script type='text/javascript' src='http://myserver/javascripts/api/viz_v1.js'></script> <object class='tableauViz' width='800' height='600' style='display:none;'> <param name='host_url' value='http://myserver/' /> <param name='site_root' value='' /> <param name='name' value='Sales/Sales-Performance' /> <param name='filter' value='Date=2012-12-01' /> </object>
本範例將同時篩選日期欄位和日期時間欄位:
<param name='filter' value='2012-12-01%2022:18:00' />
Iframe 標記範例:
<iframe src="http://myserver/Sales/SalesPerformance?:embed=yes&Date=2008-12-01%2022:18:00" width="800" height="600"></iframe>
若要篩選多個日期,請用逗號將每個日期分隔開。
篩選度量
可透過包括一個或多個值來篩選度量。不支援大於、小於或範圍。下面的範例在篩選後僅顯示 $100 和 $200 的銷售。
指令碼標記範例:
<script type='text/javascript' src='http://myserver/javascripts/api/viz_v1.js'> </script> <object class='tableauViz' width='800' height='600' style='display:none;'> <param name='host_url' value='http://myserver/' /> <param name='site_root' value='' /> <param name='name' value='Sales/Sales-Performance' /> <param name='filter' value='Profit=100, 200' /> </object>
Iframe 標記範例:
<iframe src="http://myserver/views/Sales/Sales-Performance?:embed=yes&Profit=100,200" width="800" height="600"></iframe>