Codice di incorporamento per le viste personalizzate
Il codice di incorporamento per Tableau Server 2022.3 e versioni successive e Tableau Cloud è cambiato per consentire l’uso dell’API di incorporamento v3. Per informazioni aggiornate sulle viste personalizzate di incorporamento, consulta Incorporare viste personalizzate nella Guida dell’API di incorporamento. Le informazioni in questo argomento si riferiscono a versioni precedenti dell’incorporamento (con l’API JavaScript v1 e v2 Tableau).
Quando incorpori una vista personalizzata di una cartella di lavoro o di un foglio, la vista predefinita è determinata dai fattori seguenti:
- Se l’URL del codice di incorporamento si riferisce specificamente a una vista personalizzata, tale vista viene visualizzata per impostazione predefinita.
- Se l’URL del codice di incorporamento non fa riferimento a una vista personalizzata, per impostazione predefinita viene visualizzata la vista personalizzata predefinita.
- Se non è stata definita alcuna vista personalizzata predefinita, per impostazione predefinita verrà visualizzata la vista originale.
Nota: per assicurarti che la vista originale sia visualizzata per impostazione predefinita in una vista incorporata, verifica che l’URL del codice di incorporamento per il parametro name non faccia riferimento in modo esplicito a una vista personalizzata e che includa il parametro seguente filter
nel codice di incorporamento: <param name='filter' value=':original_view=yes'/>
Nell’esempio seguente, il codice di incorporamento visualizza sempre la vista originale del foglio Profit Analysis nella cartella di lavoro Profit Analysis, poiché il parametro filter
è impostato su :original_yes
e il parametro name
non fa riferimento a una specifica vista personalizzata dell’URL del foglio.
<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>
In questo esempio, l’impostazione del parametro name
di questo esempio fa riferimento all’URL di una vista personalizzata denominata Furniture (nel foglio Profit Analysis della cartella di lavoro omonima).
<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>
In questo esempio, il parametro name
non fa riferimento a una vista personalizzata specifica nell’URL del foglio e non è stato indicato il parametro original_view
. Qui il codice di incorporamento mostrerà la vista personalizzata che è stata impostata su Predefinito nel foglio Profit Analysis della cartella di lavoro omonima. Tuttavia, se la vista originale è ancora quella predefinita (nessun altra vista personalizzata è stata impostata su Predefinito), la vista originale verrà visualizzata come predefinita.
<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>