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>
Filteren met URL-parameters met behulp van eerdere versies van insluiting

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&param2=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
Bedankt voor uw feedback.De feedback is verzonden. Dank u wel.