为自定义视图嵌入代码
适用于: Tableau Cloud, Tableau Server
Tableau Server 2022.3 及更高版本以及 Tableau Cloud 的嵌入代码已更改为使用嵌入 API v3。有关嵌入自定义视图的最新信息,请参见嵌入 API 帮助中的嵌入自定义视图。本主题中的信息适用于嵌入的早期版本(使用 Tableau JavaScript API v1 和 v2)。
使用嵌入的早期版本嵌入自定义视图
在嵌入工作簿或工作表的自定义视图时,默认视图由以下因素确定:
- 如果嵌入代码 URL 明确引用自定义视图,则默认情况下将显示该视图。
- 如果嵌入代码 URL 未引用自定义视图,则默认情况下将显示“默认”自定义视图。
- 如果未定义“默认”自定义视图,,则默认情况下显示原始视图。
注意:要确保默认情况下将在嵌入视图中显示原始视图,请确保名称参数的嵌入代码 URL 没有明确指向自定义视图,并且在嵌入代码中包括了以下 filter
参数:<param name='filter' value=':original_view=yes'/>
。
在下例中,嵌入代码将始终显示 Profit Analysis 工作簿中的 Profit Analysis 工作表的原始视图,因为 filter
参数设置为 :original_yes
,而且 name
参数没有在该工作表的 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
参数的设置指明了名为 Furniture 的自定义视图(在 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/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>