사용자 지정 뷰를 위한 내장 코드
Tableau Server 2022.3 이상 및 Tableau Cloud의 내장 코드가 Embedding API v3을 사용하도록 변경되었습니다. 사용자 지정 뷰를 내장하는 것에 대한 최신 정보는 Embedding API 도움말에서 사용자 지정 뷰 내장(영문)을 참조하십시오. 본 항목의 정보는 이전 버전의 Embedding(Tableau JavaScript API v1 및 v2 사용)에 대한 것입니다.
통합 문서 또는 시트의 사용자 지정 뷰를 내장할 경우 다음과 같은 요소에 의해 기본 뷰가 결정됩니다.
- 내장 코드 URL이 사용자 지정 뷰를 구체적으로 참조하는 경우 기본적으로 해당 뷰가 표시됩니다.
- 내장 코드 URL이 사용자 지정 뷰를 참조하지 않는 경우 기본적으로 기본 사용자 지정 뷰가 표시됩니다.
- 기본 사용자 지정 뷰가 정의되지 않은 경우 기본적으로 원래 뷰가 표시됩니다.
참고: 기본적으로 원래 뷰를 내장 뷰로 표시하려면 name 매개 변수의 내장 코드 URL이 사용자 지정 뷰를 명시적으로 참조하지 않게 하고 내장 코드에 다음 filter
매개 변수를 포함하십시오. <param name='filter' value=':original_view=yes'/>
다음 예에서 filter
매개 변수는 :original_yes
로 설정되고 name
매개 변수는 Profit Analysis 통합 문서에 있는 Profit Analysis 시트의 URL에서 특정 사용자 지정 뷰를 참조하지 않으므로 내장 코드는 항상 이 시트의 원래 뷰를 표시합니다.
<script type='text/javascript' src='http://mysite.myserver.com/javascripts/api/viz_v1.js'></script> <div class='tableauPlaceholder' style='width: 1496px; height: 749px;'> <object class='tableauViz' width='1496' height='749' style='display:none;'> <param name='host_url' value='http://mysite.myserver.com' /> <param name='site_root' value='' /> <param name='name' value='ProfitAnalysis/ProfitAnalysis' /> <param name='tabs' value='yes' /> <param name='toolbar' value='yes' /> <param name='filter' value=':original_view=yes' /></object></div>
이 예에서 name
매개 변수의 설정은 Profit Analysis 통합 문서에 있는 Profit Analysis 시트에서 Furniture라는 이름의 사용자 지정 뷰에 대한 URL을 참조합니다.
<script type='text/javascript' src='http://mysite.myserver.com/javascripts/api/viz_v1.js'></script> <div class='tableauPlaceholder' style='width: 1496px; height: 749px;'> <object class='tableauViz' width='1496' height='749' style='display:none;'> <param name='host_url' value='http://mysite.myserver.com' /> <param name='site_root' value='' /> <param name='name' value='ProfitAnalysis/ProfitAnalysis/Furniture' /> <param name='tabs' value='yes' /> <param name='toolbar' value='yes' /></object></div>
이 예에서 name
매개 변수는 해당 시트의 URL에서 특정 사용자 지정 뷰를 참조하지 않으며 original_view
매개 변수는 지정되지 않았습니다. 여기서의 내장 코드는 Profit Analysis 통합 문서에 있는 Profit Analysis 시트에서 기본값으로 설정된 사용자 지정 뷰를 표시합니다. 하지만 원래 뷰가 계속 기본값인 경우 즉, 기본값으로 설정된 다른 사용자 지정 뷰가 없으면 원래 뷰가 기본 뷰로 표시됩니다.
<script type='text/javascript' src='http://mysite.myserver.com/javascripts/api/viz_v1.js'></script> <div class='tableauPlaceholder' style='width: 1496px; height: 749px;'> <object class='tableauViz' width='1496' height='749' style='display:none;'> <param name='host_url' value='http://mysite.myserver.com' /> <param name='site_root' value='' /> <param name='name' value='ProfitAnalysis/ProfitAnalysis' /> <param name='tabs' value='yes' /> <param name='toolbar' value='yes' /></object></div>