Ajouter des filtres pour intégrer le code pour les vues
Le code incorporé pour Tableau Server 2022.3 et versions ultérieures et Tableau Cloud a été modifié pour utiliser l’API d’intégration v3. Pour obtenir des informations à jour sur le filtrage, consultez Filtrer la vue dans l’aide de l’API d’incorporation. Les informations de cette rubrique concernent les versions antérieures de l’incorporation (utilisant l’API Tableau JavaScript v1 et v2).
Vous pouvez inclure des valeurs de filtre dans les vues intégrées afin qu’elles ne mettent pas en surbrillance que les données souhaitées. Par exemple, il se peut que vous souhaitiez inclure l’hyperlien d’une autre partie de votre application Web dans une vue intégrée de performances de vente limitées aux résultats d’une région spécifique.
Remarque : les histoires ne prennent pas en charge les filtres intégrés.
Appliquer un filtre à un champ
L’application d’un filtre à un champ permet de concentrer rapidement une vue intégrée sur des données spécifiques.
Exemple de balise 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>
Pour appliquer plusieurs valeurs de filtre, séparez chaque valeur à l’aide d’une virgule. Par exemple :
<param name='filter' value='Region=East,West' />
Exemples de balise Iframe :
<iframe src="http://myserver/views/Superstore/Product?:embed=y&Region=East,West" width="800" height="600"></iframe>
Appliquer un filtre à plusieurs champs
Vous pouvez appliquer des filtres à autant de champs que vous le souhaitez, y compris ceux qui ne figurent pas dans la vue d’origine.
Exemple de balise 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>
Exemple de balise Iframe :
<iframe src="http://myserver/views/Superstore/Product?:embed=y&Region=Central,South&Segment=Consumer,Home Office" width="800" height="600"></iframe>
La première image ci-dessous montre un exemple d’URL que vous pouvez obtenir lorsque vous cliquez sur Partager dans une vue puis sur Copier le lien.
La seconde image vous montre comment vous pouvez modifier l’URL et l’ajouter à un iframe en supprimant les paramètres showShareOptions
et display_count
, en ajoutant des paramètres de filtre pour Region et Segment, ainsi que des paramètres de largeur et de hauteur, de manière à créer un lien intégré qui affiche uniquement les produits Consumer et Home Office pour les régions Central et South.
Remarque : Si une valeur de filtre contient un caractère spécial, comme une virgule, remplacez-le par la séquence d’encodage de l’URL pour \
(barre oblique inverse, %5c
) suivie de la séquence d’encodage de l’URL pour le caractère spécial. La barre oblique inverse est nécessaire pour l’échappement du caractère spécial. Par exemple, la séquence d’encodage de l’URL pour \,
(barre oblique, virgule) est %5c%2c
.
Filtrer les dates et les heures
Si vous souhaitez appliquer un filtre sur un champ Date/heure, insérez la valeur à l’aide du format Tableau par défaut présenté ci-dessous :
yyyy-mm-dd hh:mm:ss
La partie concernant l’heure utilise le format 24 heures. De nombreuses bases de données stockent toutes les valeurs de dates sous la forme de champs Date et heure. Il est donc possible que vous deviez inclure une valeur d’heure en même temps que votre date.
Exemple de balise 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>
Cet exemple applique un filtre sur un champ de date et un champ de date/heure :
<param name='filter' value='2012-12-01%2022:18:00' />
Exemple de balise Iframe :
<iframe src="http://myserver/Sales/SalesPerformance?:embed=yes&Date=2008-12-01%2022:18:00" width="800" height="600"></iframe>
Pour appliquer un filtre sur plusieurs dates, séparez-les à l’aide d’une virgule.
Filtrer les mesures
Pour filtrer des mesures, vous pouvez inclure une ou plusieurs valeurs. Les plages greater than, less than et or ne sont pas prises en charge. L’exemple ci-dessous applique un filtre pour n’afficher que les ventes d’un montant de 100 et 200 dollars.
Exemple de balise 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>
Exemple de balise Iframe :
<iframe src="http://myserver/views/Sales/Sales-Performance?:embed=yes&Profit=100,200" width="800" height="600"></iframe>