Filters toevoegen aan insluitcode voor weergaven
De insluitcode voor Tableau Server 2022.3 en hoger en Tableau Cloud is gewijzigd om de Embedding API v3 te gebruiken. Zie De weergave filteren in de hulpsectie van de Tableau Embedding API voor meer actuele informatie over filteren. De informatie in dit onderwerp is bedoeld voor eerdere versies van insluiting (met behulp van de Tableau JavaScript API v1 en v2).
U kunt filterwaarden opnemen in ingesloten weergaven, zodat alleen de gewenste data wordt gemarkeerd. U kunt bijvoorbeeld een hyperlink opnemen vanuit een ander deel van uw webtoepassing naar een ingesloten verkoopprestatieweergave waarin alleen een specifieke regio wordt weergegeven.
Opmerking: verhalen ondersteunen geen ingesloten filters.
Op één veld filteren
Het toepassen van een filter op één veld is een snelle manier om een ingesloten weergave te focussen op specifieke data.
Voorbeeld scripttag:
<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>
Om meerdere filterwaarden door te geven, scheidt u de waarden met een komma. Bijvoorbeeld:
<param name='filter' value='Region=East,West' />
Voorbeelden iframe-tag:
<iframe src="http://myserver/views/Superstore/Product?:embed=y&Region=East,West" width="800" height="600"></iframe>
Op meerdere velden filteren
U kunt filters op zoveel velden toepassen als u wilt, ook op velden die in de oorspronkelijke weergave niet zichtbaar zijn.
Voorbeeld scripttag:
<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>
Voorbeeld iframe-tag:
<iframe src="http://myserver/views/Superstore/Product?:embed=y&Region=Central,South&Segment=Consumer,Home Office" width="800" height="600"></iframe>
De eerste afbeelding hieronder toont een voorbeeld van de URL die u krijgt wanneer u in een weergave op Delen klikt. Klik vervolgens op Link kopiëren.
De tweede afbeelding laat zien hoe u de URL kunt wijzigen en deze aan een iframe kunt toevoegen door de parameters showShareOptions
en display_count
te verwijderen, filterparameters voor Regio en Segment toe te voegen en breedte- en hoogteparameters toe te voegen, om een insluitlink te maken die alleen producten voor Consumenten en Thuiskantoor uit de regio's Centraal en Zuid weergeeft.
Opmerking: als een filterwaarde een speciaal teken bevat, zoals een komma, vervangt u het teken door de URL-coderingssequentie voor \
(backslash, %5c
) gevolgd door de URL-coderingssequentie voor het speciale teken. De backslash is nodig om het speciale teken weer te geven. De URL-coderingssequentie voor \,
(backslash, komma) is bijvoorbeeld %5c%2c
.
Datums en tijden filteren
Als u wilt filteren op een datum-/tijdveld, neemt u de waarde op in de standaard Tableau-indeling die hieronder wordt weergegeven:
yyyy-mm-dd hh:mm:ss
Voor het tijdgedeelte wordt een 24-uursklok gebruikt. Veel databases slaan alle datumwaarden op als Datum/tijd-velden. In dat geval moet u mogelijk samen met de datum een tijdwaarde doorgeven.
Voorbeeld scripttag:
<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 dit voorbeeld wordt gefilterd op zowel een datumveld als een datum/tijd-veld:
<param name='filter' value='2012-12-01%2022:18:00' />
Voorbeeld iframe-tag:
<iframe src="http://myserver/Sales/SalesPerformance?:embed=yes&Date=2008-12-01%2022:18:00" width="800" height="600"></iframe>
Om meerdere datums te filteren, scheidt u de datums met een komma.
Meetwaarden filteren
U kunt meetwaarden filteren door een of meerdere waarden op te nemen. Er is geen ondersteuning voor groter dan, kleiner dan of bereiken. In het onderstaande voorbeeld wordt gefilterd om alleen verkopen van $ 100 en $ 200 weer te geven.
Voorbeeld scripttag:
<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>
Voorbeeld iframe-tag:
<iframe src="http://myserver/views/Sales/Sales-Performance?:embed=yes&Profit=100,200" width="800" height="600"></iframe>