Hoe weergave-URL's worden gestructureerd
De insluitcode voor Tableau Server 2022.3 en hoger en Tableau Cloud is gewijzigd om de Embedding API v3 te gebruiken. Met de Embedding API v3 hoeft u geen parameters meer toe te voegen om URL's te filteren bij het insluiten. In plaats daarvan filtert u door kenmerken toe te voegen aan een filterwebcomponent. Zie De weergave filteren in de hulpsectie van de Tableau Embedding API voor meer informatie. De informatie in dit onderwerp is bedoeld voor eerdere versies van insluiting (met behulp van de Tableau JavaScript API v1 en v2).
Om te begrijpen hoe Tableau weergave-URL's structureert, bekijkt u een voorbeeld in de adresbalk van de browser.
De structuur van de basis-URL
- In Tableau Server of Tableau Cloud is het basis-URL-patroon voor een Tableau-weergave als volgt:
http://<servername>/#/views/<workbook>/<sheet>
- In een omgeving met meerdere sites wordt voor weergaven die zijn opgeslagen op andere sites dan de standaardsite, de site-ID ook opgenomen in de URL:
http://<servername>/#/site/<sitename>/views/<workbook>/<sheet>
Parameters toevoegen aan de basis-URL
Een querytekenreeks toevoegen
Om een filter-URL te maken, voegt u een querytekenreeks toe aan de basis-URL. In een querytekenreeks zijn de weergavefilters de parameters. Een querytekenreeks samenstellen:
- Begin de querytekenreeks met een vraagteken (
?
). - Scheid de parameters met een en-teken (
&
). - Scheid meerdere waarden per parameter met een komma (
,
).
Bijvoorbeeld:http://<servername>/#/views/<workbook>/sheet?param1=value1,value2¶m2=value
Bovendien worden alle tekens in uw veld- of bladnamen die niet in URL's kunnen voorkomen, URL-gecodeerd. Een spatie wordt bijvoorbeeld geconverteerd naar %20
.
Opmerking: voordat u URL-parameters toevoegt, verwijdert u :iid=[#]
aan het einde van de URL. Dit is een tijdelijke weergaveteller voor uw huidige browsersessie.
Het weergeven van het hoofdlettergebruik van veldnamen
URL-parameters zijn hoofdlettergevoelig. Wanneer u querytekenreeksen toevoegt, moet u ervoor zorgen dat het hoofdlettergebruik van veldnamen in uw brondata nauwkeurig wordt overgenomen.
Hoe querytekenreeksen dashboards beïnvloeden
In tegenstelling tot zichtbare filters in een dashboard, die soms slechts op één blad van toepassing zijn, zijn URL-parameters van toepassing op alle bladen. Voordat u URL-parameters toevoegt, moet u vertrouwd zijn met de velden die in elk blad worden weergegeven. Zo voorkomt u dat u per ongeluk data filtert die u wilt behouden.
Een voorbeeldweergave selecteren om mee te werken
In de voorbeelden in dit artikel wordt gebruikgemaakt van de Prestatieweergave in de Superstore-voorbeelddata die bij Tableau Server wordt geleverd.
De voorbeeld-URL weerspiegelt de volgende kenmerken:
- De bladnaam is Prestatie
- De werkmapnaam is Superstore
- De servernaam wordt aangegeven met een tijdelijk IP-adres, waar de naam van uw server op locatie of
online.tableau.com
normaal gesproken zou verschijnen.
Om de voorbeelden te volgen, kunt u een vergelijkbare weergave van Superstore bekijken of de voorbeeld-URL's aanpassen om de veld-, blad- en andere namen uit uw eigen omgeving te gebruiken. Als u uw eigen weergave gebruikt, zorg er dan voor dat u deze eerst op de server publiceert.
De weergave filteren
Voor de voorbeeldweergave die in dit artikel wordt gebruikt, is de basis-URL:http:<servername>/#/views/Superstore/Performance
Alleen meubilair
Om alleen de verkoop van meubilair weer te geven, voegt u aan het einde van de URL de volgende querytekenreeks toe:?Category=Furniture
Bijvoorbeeld:http:<servername>/#/views/Superstore/Performance?Category=Furniture
Alleen voor consumenten
Om de weergave te beperken tot consumentenverkoop, wijzigt u de URL naar:http:<servername>/#/views/Superstore/Performance?Segment=Consumer
Thuiskantoor en consument
Om zowel de thuiskantoor- als de consumentenverkoop weer te geven, wijzigt u de URL naar:http:<servername>/#/views/Superstore/Performance?Segment=Home%20Office,Consumer
Houd er rekening mee dat in de veldnaam 'Thuiskantoor' %20 voor het URL-gecodeerde spatieteken staat, zoals beschreven in Parameters toevoegen aan de basis-URL.
Hierbij worden meerdere waarden per parameter gescheiden door een komma, maar niet door een spatie.
Meubilair in de regio Centraal
Om meerdere veld-/waardeparen weer te geven, scheidt u ze met een en-teken:http:<servername>/#/views/Superstore/Performance?Region=Central&Category=Furniture
Exclusieve filtering
Tot nu toe worden in de voorbeelden in dit artikel alle waarden voor de velden in de resulterende weergaven weergegeven. Voor meer flexibiliteit kunt u meerdere waarden voor een specifiek filter opgeven en een extra parameter opnemen die alleen bepaalde snijpunten van die waarden weergeeft.
De volgende URL beschrijft de ongefilterde basisweergave die in dit voorbeeld wordt gebruikt, waarin de afdelingsverkopen per regio worden weergegeven:http://<servername>/#/views/Superstore/Performance
Om vervolgens alleen de verkopen voor de afdelingen Meubilair en Technologie in de regio's Centraal en West weer te geven, voegt u de volgende querytekenreeks toe aan de basis-URL:?Region=Central,West&Category=Furniture,Technology
Om alleen de verkoop van Meubilair in de regio Centraal en de verkoop van Technologie in de regio West te tonen, voegt u de parameter ~s0
toe aan de querytekenreeks:?Region~s0=Central,West&Category~s0=Furniture,Technology
De uiteindelijke URL ziet er als volgt uit:http://<servername>/#/views/Superstore/Performance?Region~s0=Central,West&Category~s0=Furniture,Technology
Speciale overwegingen voor datumfiltering
Wanneer u datumvelden wilt filteren, moet u rekening houden met de manier waarop datums worden opgemaakt en zich gedragen in een databaseomgeving.
- Datum- (en tijd-)waarden die via een URL-parameter worden doorgegeven, moeten overeenkomen met de volgende standaardopmaak van Tableau:
yyyy-mm-dd hh:mm:ss
- Veel databases slaan datums op als datum/tijd-waarden. In dat geval moet u mogelijk een tijdsgedeelte opnemen in de waarde die u in de parameter opgeeft. Het tijdgedeelte is gebaseerd op een 24-uursklok, dus 22:18 uur wordt opgegeven als 22:18:00.
Voorbeeld datumparameters
De volgende voorbeeldquerytekenreeksen gebruiken een datumveld met de naam Besteldatum. Net als in de vorige voorbeelden in dit artikel voegt u deze toe aan de basis-URL van uw weergave.
- Als het veldtype Besteldatum alleen de datum bevat (zonder tijdstip) en u alleen data voor 8 juli 2018 wilt weergeven, ziet de querytekenreeks er ongeveer zo uit:
?Order%20Date=2018-07-08
- Als de Besteldatum wel het tijdgedeelte bevat, kan de querytekenreeks er als volgt uitzien om te filteren op 8 juli 2018 om 22:18 uur:
?Order%20Date=2018-07-08%2022:18:00
- Als de Besteldatum alleen de datum bevat en u op meerdere datums wilt filteren, gebruikt u komma's, zoals eerder in dit artikel beschreven. Bijvoorbeeld:
?Order%20Date=2018-07-08,2018-07-09,2018-07-10,2018-07-11
Parameters als DATEPART-filters
Als u op datumgedeelte wilt filteren, gebruikt u dezelfde nomenclatuur als in de standaarddatumhiërarchie van Tableau Desktop. Zie Datumfuncties(Link wordt in een nieuw venster geopend) in de hulpsectie van Tableau voor meer informatie.
jaar(Order%20Date) | Geheel getal |
kwartaal(Order%20Date) | Geheel getal tussen 1 en 4 |
maand(Order%20Date) | Geheel getal tussen 1 en 12 |
dag(Order%20Date) | Geheel getal tussen 1 en 31 |
uur(Order%20Date) | Geheel getal 0-23 |
minuut(Order%20Date) | Geheel getal 0-59 |
seconde(Order%20Date) | Geheel getal 0-59 |
week(Order%20Date) | Geheel getal 1-53 |
mijn(Order%20Date) | Zescijferig geheel getal: JJJJMM |
mdj(Order%20Date) | Achtcijferig geheel getal: JJJJMMDD |