ビューの埋め込みコードへのフィルターの追加
Tableau Server 2022.3 以降と Tableau Cloud の埋め込みコードは、埋め込み API v3 を使用するように変更されました。フィルタリングに関する最新情報は、埋め込み API ヘルプの「ビューのフィルター」を参照してください。このトピックの情報は、埋め込みの以前のバージョン (Tableau JavaScript API v1 および v2 を使用) を対象としています。
希望するデータのみをハイライトするよう、埋め込みビューにフィルター値を含めることができます。たとえば、Web アプリケーションの別の部分から、特定地域のみが表示される売上実績の埋め込みビューへのハイパーリンクを含めるとします。
注:ストーリーは埋め込みフィルターをサポートしていません。
1 つのフィールドのフィルター
1 つのフィールドで 1 つのフィルターを通過すると、特定のデータ上の埋め込みビューに迅速にフォーカスできます。
Script タグの例:
<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 タグの例:
<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 の例を示しています。
2 つ目のイメージは、showShareOptions
および display_count
パラメーターを削除、[地域] と [セグメント] にフィルター パラメーターを追加、幅および高さパラメーターを追加して URL を変更、iframe に追加し、中部および南部地域から Consumer および Home Office 製品のみを表示する埋め込みリンクを作成する方法を示しています。
注:フィルター値にコンマなどの特殊文字が含まれている場合、特殊文字を \
(バック スラッシュ、%5c
) の URL エンコード シーケンスとその特殊文字の URL エンコード シーケンスに置き換えます。特殊文字をエスケープするには、バックスラッシュが必要です。たとえば、\,
(バックスラッシュ、コンマ) の URL エンコード シーケンスは %5c%2c
です。
日付と時刻のフィルター
日付/時刻フィールドでフィルターを使用する場合は、次に示す既定の Tableau 形式を使用して値を含めます。
yyyy-mm-dd hh:mm:ss
時刻部分では 24 時間制を使用します。多くのデータベースでは、日付時刻フィールドとしてすべての日付値が保存されているため、日付と共に時刻値を通過させることが必要な場合があります。
Script タグの例:
<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>
複数の日付をフィルターするには、各日付をコンマで区切ります。
メジャーのフィルター
1 つまたは複数の値を含めることによって、メジャーをフィルターできます。より大きい、より小さい、または範囲の指定はサポートされていません。次の例では、$100 と $200 の売上のみを表示するようにフィルターします。
Script タグの例:
<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>