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).
È 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.
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.
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/SalesPerformance?: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>