---
schema_version: "1"
id: 46e8ae1cc6faef99355f50dfc8236ccb3ba6be7b549cf9474713b6797e256040
title: 新增篩選器以為檢視內嵌程式碼
collection: tableau
version: next
locale: zh-tw
portal_url: https://docs.salesforce.com/tableau/next/zh-tw/pro/desktop/embed_filter_add.md
canonical_url: https://help.tableau.com/v0.0/pro/desktop/zh-tw/embed_filter_add.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 0bce1ee5a02296cbe19c90e6e924ff0e126ce67771ad330debcb9b50e9d12e24
description: Tableau Server 2022
---
[跳至主要內容](#main-content)

# 新增篩選器以為檢視內嵌程式碼

> [!TIP]
> 
> Tableau Server 2022.3 及更高版本和 Tableau Cloud 的內嵌程式碼已變更為使用內嵌 API v3。有關篩選的目前資訊，請參閱[內嵌 API 說明](https://help.tableau.com/current/api/embedding_api/zh-tw/index.html)中的[篩選檢視](https://help.tableau.com/current/api/embedding_api/zh-tw/docs/embedding_api_filter.html)。本主題中的資訊適用於先前版本的內嵌（使用 Tableau JavaScript API v1 和 v2）。

使用先前版本的內嵌進行篩選

您可以在嵌入檢視中包括篩選器值，以便僅反白顯示所需的資料。例如，您可能希望將來自 Web 應用程式的其他部分的超連結包含到僅顯示特定區域的內嵌銷售績效檢視中。

**附註：** 故事不支援嵌入篩選器。

## 篩選一個欄位

在一個欄位上傳遞篩選器可以快速使嵌入檢視顯示特定資料。

![內嵌檢視，顯示篩選器已套用於欄位。](/tableau/next/zh-tw/pro/desktop/zh-tw/Img/embed_filter3.png)

**指令碼標記範例：**

<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\] （細分）新增篩選器參數，並新增寬度和高度參數以建立一個嵌入連結，該連結僅顯示中部和南部地區的消費者及家庭辦公室產品。

![連結和 iframe 程式碼](/tableau/next/zh-tw/pro/desktop/zh-tw/Img/embed_filter_iframe.png)

**附註：** 如果篩選器值包含特殊字元（例如逗號），請將該字元替換為 `\`（反斜線，`%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/Sales­Performance?: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>