Adicionar filtros ao código inserido para exibições
O código de incorporação do Tableau Server 2022.3 e posterior e Tableau Cloud mudou para usar a Embedding API v3. Para obter informações atuais sobre filtragem, consulte Filtrar a exibição na ajuda da Embedding API. As informações neste tópico são para versões anteriores de incorporação (usando a API JavaScript do Tableau v1 e v2).
Você pode incluir valores de filtro em exibições inseridas para que destaquem somente os dados desejados. Por exemplo, convém incluir um hiperlink de outra parte do seu aplicativo Web em uma exibição de desempenho de vendas inserida que mostre apenas uma região específica.
Observação: o Histórias não oferece suporte a filtros inseridos.
Filtrar em um campo
Passar um filtro em um campo é uma maneira rápida de focar em uma exibição inserida em dados específicos.
Exemplo de marca de 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>
Para passar por vários valores de filtro, basta separar cada um com uma vírgula. Por exemplo:
<param name='filter' value='Region=East,West' />
Exemplos de marca de iframe:
<iframe src="http://myserver/views/Superstore/Product?:embed=y&Region=East,West" width="800" height="600"></iframe>
Filtrar em diversos campos
É possível passar filtros por quantos campos desejar, incluindo os campos ocultos na exibição original.
Exemplo de marca de 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>
Exemplo de marca de iframe:
<iframe src="http://myserver/views/Superstore/Product?:embed=y&Region=Central,South&Segment=Consumer,Home Office" width="800" height="600"></iframe>
A primeira imagem abaixo mostra um exemplo da URL obtida ao clicar em Compartilhar em uma exibição e depois em Copiar link.
A segunda imagem mostra como é possível modificar a URL e adicioná-la a um iframe excluindo os parâmetros showShareOptions
e display_count
, adicionando parâmetros de filtro para Região e Segmento e adicionando parâmetros de largura e altura, para criar um link inserido que exibe apenas produtos do Cliente e de Home Office das regiões Central e Sul.
Observação: Se um valor de filtro contiver um caractere especial, como uma vírgula, substitua o caractere pela sequência de codificação de URL para \
(barra invertida, %5c
) seguido pela sequência de codificação de URL do caractere especial. A barra invertida é necessária para o escape do caractere especial. Por exemplo, a sequência de codificação da URL para \,
(barra invertida, vírgula) é %5c%2c
.
Filtrar datas e horas
Se você deseja filtrar por um campo de Data/hora, inclua o valor usando o formato padrão do Tableau mostrado abaixo:
yyyy-mm-dd hh:mm:ss
A parte da hora usa um relógio de 24 horas. Muitos bancos de dados armazenam todos os valores de data como campos Datetime, de modo que talvez seja preciso passar um valor de hora juntamente com a data.
Exemplo de marca de 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>
Esse exemplo filtra por um campo de data e por um campo datetime:
<param name='filter' value='2012-12-01%2022:18:00' />
Exemplo de marca de iframe:
<iframe src="http://myserver/Sales/SalesPerformance?:embed=yes&Date=2008-12-01%2022:18:00" width="800" height="600"></iframe>
Para filtrar várias datas, separe cada data com uma vírgula.
Filtrar medidas
É possível filtrar medidas incluindo um ou mais valores. Não há suporte para maior que, menor que ou intervalos. O exemplo abaixo filtra para mostrar somente vendas de US$ 100 e US$ 200.
Exemplo de marca de 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>
Exemplo de marca de iframe:
<iframe src="http://myserver/views/Sales/Sales-Performance?:embed=yes&Profit=100,200" width="800" height="600"></iframe>