Help voor Tableau Desktop en webauthoring

U kunt statistieken insluiten om ze naast andere webinhoud weer te geven, in de context waarin ze het meest relevant zijn voor uw bezoekers. Wanneer u een ingesloten statistiek laadt, krijgt u de meest recente data die beschikbaar is, omdat u rechtstreeks verbinding maakt met uw data in Tableau Server of Tableau Cloud.

Als u statistieken in een webpagina wilt insluiten, kopieert u de HTML-insluitcode in Tableau Server of Tableau Cloud of gebruikt u het onderstaande JavaScript-voorbeeld. U kunt meerdere statistieken op één pagina insluiten, zolang de statistieken afkomstig zijn van dezelfde Tableau-site.

Ingesloten statistieken werken met dezelfde webbrowsers die worden ondersteund door Tableau Cloud en Tableau Server. Zie de Technische specificaties voor een lijst met ondersteunde browsers. Hoewel insluiten wordt ondersteund door Safari, moeten bezoekers 'Tracking tussen sites voorkomen' uitschakelen om ingesloten inhoud te kunnen zien.

De insluitcode en parameters voor ingesloten statistieken verschillen van die voor ingesloten weergaven. Zie Weergaven insluiten in webpagina’s voor meer informatie over ingesloten weergaven.

Opmerking: uw Tableau-beheerder kan de sites waar insluiting is toegestaan, beperken of insluiting volledig uitschakelen. Als uw ingesloten statistiek niet wordt geladen, neem dan contact op met uw beheerder om te controleren of de site waarop u de statistiek hebt ingesloten wel op de toelatingslijst voor insluitingen staat. Zie Tableau Site-instellingen voor insluiten voor meer informatie.

De insluitcode kopiëren

De snelste manier om een statistiek in te sluiten, is door de insluitcode van Tableau te kopiëren.

1. Navigeer in Tableau Cloud of Tableau Server naar de detailpagina voor de statistiek die u wilt insluiten.
2. Klik op de knop Statistiek delen.
3. Klik op Insluitcode kopiëren.
   
4. Plak de insluitcode op de webpagina waar u de statistiek wilt insluiten.

Uw eigen insluitcode schrijven

Wanneer u de insluitcode kopieert van Tableau Server of Tableau Cloud, kopieert u de HTML-insluitcode, zonder optionele parameters. Als u meer controle wilt over de ingesloten statistiek, kunt u de HTML aanpassen of het JavaScript-voorbeeld gebruiken om uw eigen script te schrijven.

HTML-voorbeeld

<tableau-metric
	src='https://mycompany/#/metrics/1'
	link-target='https://example.com'>
</tableau-metric>
<script type='module' src='https://mycompany/javascripts/api/tableau.metric.1.latest.min.js'></script>

JavaScript-voorbeeld

<div id='metricDiv'/>
<script type='module'>
	import { TableauMetric } from 'https://mycompany/javascripts/api/tableau.metric.1.latest.min.js';
				
	let metric = new TableauMetric();

	metric.src = 'https://mycompany/#/metrics/1';
	metric.linkTarget = 'https://example.com';document.getElementById('metricDiv').appendChild(metric);
</script>

Parameters voor insluitcode

Met de parameters voor de insluitcode kunt u zowel de HTML- als JavaScript-insluitopties aanpassen.

Verificatie voor ingesloten statistieken

Voor ingesloten statistieken gelden dezelfde licentie- en machtigingsbeperkingen als in Tableau Server en Tableau Cloud. Om een ingesloten statistiek te kunnen bekijken, moet de bezoeker zich aanmelden bij een account op de Tableau-site waarvan de statistiek is ingesloten. In tegenstelling tot ingesloten weergaven, is het bij ingesloten statistieken niet mogelijk om een gastaccount te gebruiken om statistieken weer te geven aan bezoekers die niet zijn aangemeld.

Viewers die zich niet in een ander tabblad hebben aangemeld bij Tableau Server of Tableau Cloud, worden gevraagd zich aan te melden via de ingesloten statistiek zelf. Om zich te kunnen aanmelden via een ingesloten statistiek, moet de browser van de bezoeker zo zijn geconfigureerd dat cookies van derden worden toegestaan.

Ingesloten statistieken ondersteunen alle verificatiemethoden voor Tableau Server en Tableau Cloud, met uitzondering van vertrouwde verificatie. Voor statistieken die zijn ingesloten vanuit Tableau Server, moet de server HTTPS gebruiken om de communicatie te beveiligen.

Om eenmalige aanmelding (SSO) voor ingesloten statistieken mogelijk te maken, moet uw Tableau-beheerder een vertrouwensrelatie configureren tussen Tableau Server en een externe autorisatieserver (alleen voor Tableau Server) of een met Tableau verbonden app en een webpagina. Zie Een EAS registreren om SSO in te schakelen voor ingesloten inhoud(Link wordt in een nieuw venster geopend) in de hulpsectie van Tableau Server of Verbonden apps in Tableau configureren om SSO in te schakelen voor ingesloten inhoud(Link wordt in een nieuw venster geopend) in de hulpsectie van Tableau Cloud voor meer informatie.

Hoe statistiek-URL's worden gestructureerd

Om een statistiek in te sluiten, geeft u de URL van de statistiek op en de URL van het JavaScript dat wordt gebruikt om de statistiek te renderen. Statistiek-URL's volgen enigszins verschillende patronen in Tableau Cloud, Tableau Server-omgevingen met één site en Tableau Server-omgevingen met meerdere sites. Als u niet zeker weet hoe u de URL moet opmaken, kopieert u de insluitcode, aangezien deze zowel de statistiek-URL als de JavaScript-URL bevat.

Statistieken moeten worden gehost op Tableau Server of Tableau Cloud. U kunt een statistiek niet insluiten vanuit een lokaal bestand.

Structuur statistiek-URL

• Tableau Cloud-site: https://<pod>.online.tableau.com/#/site/<sitename>/metrics/<metric>
• Tableau Server met één site (of de standaardsite): https://<servername>/#/metrics/<metric>
• Tableau Server met meerdere sites: https://<servername>/#/site/<sitename>/metrics/<metric>

Structuur JavaScript-URL

De statistiek-URL verandert op basis van de site waarvan u de statistiek insluit, maar de JavaScript-URL die de statistiek weergeeft verandert niet, omdat deze de site niet bevat.

• Tableau Cloud-site: https://<pod>.online.tableau.com/javascripts/api/tableau.metric.1.latest.min.js
• Tableau Server: https://<servername>/javascripts/api/tableau.metric.1.latest.min.js