뷰의 내장 코드에 필터 추가
Tableau Server 2022.3 이상 및 Tableau Cloud의 내장 코드가 Embedding API v3을 사용하도록 변경되었습니다. 필터링에 대한 최신 정보는 Embedding API 도움말에서 뷰 필터링(영문)을 참조하십시오. 본 항목의 정보는 이전 버전의 Embedding(Tableau JavaScript API v1 및 v2 사용)에 대한 것입니다.
원하는 데이터만 하이라이트되도록 내장된 뷰에 필터 값을 포함시킬 수 있습니다. 예를 들어 다른 웹 응용 프로그램의 부분에 특정 지역만 표시하는 내장된 매출 실적 뷰에 대한 하이퍼링크를 포함할 수 있습니다.
참고: 스토리는 내장된 필터를 지원하지 않습니다.
단일 필드 필터링
단일 필드에 필터를 전달하는 것은 특정 데이터의 내장된 뷰에 집중하게 만드는 빠른 방법입니다.
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의 예를 보여 줍니다.
두 번째 이미지에서는 showShareOptions
및 display_count
매개 변수를 삭제하고, Region 및 Segment에 대한 필터 매개 변수를 추가하고, 너비 및 높이 매개 변수를 추가하는 방식으로 URL을 수정하고 iframe에 추가하여 Central 및 South 지역의 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>
여러 날짜를 필터링하려면 각 날짜를 쉼표로 구분합니다.
측정값 필터링
하나 이상의 값을 포함하여 측정값을 필터링할 수 있습니다. 보다 큼, 보다 작음 또는 범위는 지원하지 않습니다. 아래 예제는 $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>