Aggiungere filtri al codice di incorporamento per le viste

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 sui filtri, consulta Filtrare la vista 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).

Filtrare con versioni precedenti dell’incorporamento

È possibile includere i valori di filtro nelle viste incorporate in modo che possano evidenziare solo i dati desiderati. È ad esempio possibile includere un collegamento ipertestuale proveniente da un’altra parte della tua applicazione Web in una vista delle prestazioni di vendita incorporata che mostra solo una regione specifica.

Nota: le storie non supportano i filtri incorporati.

Filtro su un campo

Il passaggio di un filtro su un campo è un modo rapido per concentrare una vista incorporata su dati specifici.

Vista incorporata che mostra un filtro applicato a un campo.

Esempio di tag 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> 

Per passare da più valori di filtro, è sufficiente separare ciascuno con una virgola. Ad esempio:

<param name='filter' value='Region=East,West' />

Esempi di tag iframe:

<iframe src="http://myserver/views/Superstore/Product?:embed=y&Region=East,West" 
width="800" height="600"></iframe> 

Filtro su più campi

È possibile passare i filtri in base su un numero di campi a piacere, inclusi quelli non visibili nella vista originale.

Esempio di tag 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> 

Esempio di tag iframe:

<iframe src="http://myserver/views/Superstore/Product?:embed=y&Region=Central,South&Segment=Consumer,Home Office" 
width="800" height="600"></iframe> 

Nella prima immagine riportata di seguito viene illustrato un esempio dell’URL visualizzato quando fai clic su Condividi su una vista e poi fai clic su Copia collegamento.

La seconda immagine mostra come modificare l’URL e aggiungerlo a un iframe eliminando i parametri showShareOptions e display_count, aggiungendo parametri di filtro per Regione e Segmento, oltre ai parametri di larghezza e altezza per creare un collegamento incorporato che visualizzi solo prodotti per consumatore e ufficio domestico delle regioni centrali e del sud.

Collegamento e codice iframe

Nota: se un valore di filtro contiene un carattere speciale, ad esempio una virgola, sostituisci il carattere con la sequenza di codifica URL per \ (barra rovesciata %5c) seguita dalla sequenza di codifica URL per il carattere speciale. La barra rovesciata è necessaria per marcare il carattere speciale. Ad esempio, la sequenza di codifica URL per \, (barra rovesciata, virgola) è %5c%2c.

Filtrare date e ore

Se desideri filtrare in base a un campo Data/ora, includi il valore utilizzando il formato predefinito di Tableau mostrato di seguito:

yyyy-mm-dd hh:mm:ss

La parte oraria utilizza un formato 24 ore. Poiché molti database memorizzano tutti i valori di data come campi di data e ora, potresti dover passare un valore di ora insieme alla data.

Esempio di tag 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> 

In questo esempio vengono filtrati sia un campo data che un campo data e ora:

<param name='filter' value='2012-12-01%2022:18:00' /> 

Esempio di tag iframe:

<iframe src="http://myserver/Sales/Sales­Performance?:embed=yes&Date=2008-12-01%2022:18:00" width="800" height="600"></iframe>

Per filtrare più date, separa ciascuna con una virgola.

Filtrare le misure

È possibile filtrare le misure includendo uno o più valori. Non è previsto il supporto per maggiore di, inferiore a o intervalli. Nell’esempio seguente è applicato un filtro per visualizzare solo le vendite di 100 $ e 200 $.

Esempio di tag 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> 

Esempio di tag iframe:

<iframe src="http://myserver/views/Sales/Sales-Performance?:embed=yes&Profit=100,200" 
width="800" height="600"></iframe>
Grazie per il tuo feedback.Il tuo feedback è stato inviato. Grazie!