Einbettungscodeparameter für Ansichten
Der Einbettungscode für Tableau Server 2022.3 und höher und Tableau Cloud wurde geändert, um Embedding API v3 zu verwenden. Eine aktuelle Liste der Klassen und Methoden in Embedding API v3 finden Sie in der Embedding API Reference in der Embedding API-Hilfe. Die Informationen in diesem Thema beziehen sich auf frühere Einbettungsversionen (unter Verwendung der Tableau-JavaScript-API v1 und v2).
Sie können eine einbettete Ansicht mit einer dieser Methoden konfigurieren:
Objektparameter für JavaScript-Tags
Objektparameter | Werte | Beschreibung | Beispiele |
---|---|---|---|
dataDetails | no | Blendet die Schaltfläche "Datendetails" in der Symbolleiste aus, die Benutzern erlaubt, Details zu den in dieser Ansicht verwendeten Daten zu sehen. | <param name='dataDetails' value='no' /> |
showDataDetails | yes | Wenn Tableau Catalog aktiviert ist, wird die Ansicht mit geöffnetem Bereich für Datendetails angezeigt. | <param name='showDataDetails' value='yes' /> |
alerts | no | Blendet die Schaltfläche "Warnungen" in der Symbolleiste aus, über die Benutzer datengesteuerte Warnungen erstellen können. | <param name='alerts' value='no'/> |
customViews | no | Blendet die Schaltfläche "Ansicht" in der Symbolleiste aus, über die Sie benutzerdefinierte Ansichten speichern können | <param name='customViews' value='no'/> |
device | desktop; tablet; phone | Wenn ein Dashboard über Layouts für Mobilgeräte verfügt, zeigt es ein spezifisches Layout an, und zwar unabhängig von der Bildschirmgröße. Wenn dieser Parameter nicht festgelegt ist, ermittelt Tableau Server oder Tableau Cloud die Bildschirmgröße und lädt das entsprechende Layout. Beispiele finden Sie im Thema über Einbetten von Dashboards. | <param name='device' value='phone'/> |
filter | Zeichenfolge | Filtert die Daten, die beim Öffnen der Ansicht angezeigt werden. Sie können auch anhand von URL-Parametern filtern. | <param name='filter' value='Team=Blue'/> |
host_url | Zeichenfolge | Erforderlich. Der Servername, der in der URL angezeigt wird. | <param name='host_url' value='http://myserver.exampleco.com/'>
|
linktarget | Zeichenfolge | Der Zielfenstername für externe Hyperlinks. | <param name="linktarget" value="_blank"/> |
load-order | number | Legt bei Einbettung mehrerer Ansichten die Reihenfolge fest, in der sie auf der Seite geladen werden. Negative Zahlen sind zulässig. | <param name="load-order" value="2"/> |
mobile | yes | Zeigt berührungsoptimierte Schnellfilter für mobile Geräte an. | <param
name='mobile' value='yes'/> |
name | Zeichenfolge | Erforderlicher Objektparameter mit dieser Struktur: [Arbeitsmappenname]/[Blattname]/[Name der optionalen benutzerdefinierten Ansicht] Formatieren Sie optionale Namen für die benutzerdefinierte Ansicht wie folgt: username@domain/[custom view name] | <param name='name' value='ExampleCoSales/Sales'/>
|
:original_view | yes | Wenn der Parameter name auf eine Arbeitsmappen- oder Blatt-URL verweist (und nicht explizit auf eine benutzerdefinierte Ansicht), wird die Ansicht durch Einschließen dieses Parameters als die ursprüngliche Ansicht angezeigt. | <param name='filter' value=':original_view=yes'/> |
path (Nur Tableau Server. Gilt nicht für Tableau Cloud.) | Zeichenfolge | Nur für die vertrauenswürdige; Authentifizierung kann nicht mit dem Parameter ticket verwendet werden. Überschreibt den Wert des Parameters name und wird als URL verwendet. Weitere Informationen finden Sie unter Anzeigen der Ansicht mit dem Ticket(Link wird in neuem Fenster geöffnet) in der Tableau Server-Hilfe für Administratoren. | <param name='path' value='trusted/Etdpsm_Ew6rJY-9kRrALjauU/views/workbookQ4/SalesQ4'/>
|
showShareOptions | true ; false | Steuert, ob die Optionen "Teilen" in einer eingebetteten Ansicht angezeigt werden oder nicht. | <param name='showShareOptions' value='true' /> |
site_root | Zeichenfolge | Erforderlich. Der Name der Website. Der standardmäßige Sitewert lautet null (value='' ). Lesen Sie Anzeigen der Ansicht mit dem Ticket(Link wird in neuem Fenster geöffnet) in der Tableau Server-Hilfe, wenn Ihr Server mehrere Sites aufweist und Sie die vertrauenswürdige Authentifizierung verwenden möchten. | <param name='site_root' value='/#/Sales'/>
|
subscriptions | no | Blendet die Schaltfläche "Abonnements" in der Symbolleiste aus, über die Benutzer E-Mail-Abonnements einrichten können, um in regelmäßigen Intervallen Snapshots von Ansichten zu erhalten. |
|
tabs | yes; no | Registerkarten ein- oder ausblenden. | <param name='tabs' value='yes'/> |
ticket (Nur Tableau Server. Gilt nicht für Tableau Cloud.) | Zeichenfolge | Nur für die vertrauenswürdige Authentifizierung; kann nicht mit dem Objektparameter path verwendet werden. Muss zusammen mit dem Objekt name zum Erstellen der URL zum Einlösen vertrauenswürdiger Tickets verwendet werden. Weitere Informationen dazu finden Sie im Abschnitt Anzeigen der Ansicht mit dem Ticket(Link wird in neuem Fenster geöffnet) in der Tableau Server-Hilfe. | <param name='ticket' value='9D1ObyqDQmSIOyQpKdy4Sw==:dg62gCsSE0QRArXNTOp6mlJ5'/>
|
toolbar | yes; no; top | Die Symbolleiste wird standardmäßig unten angezeigt. Die Symbolleiste befindet sich über der Ansicht, wenn Sie diesen Parameter auf top festlegen, und außerhalb der eingebetteten Ansicht, wenn Sie ihn auf no festlegen. | <param name='toolbar' value='top'/> |
tooltip | yes; no | QuickInfos werden standardmäßig angezeigt, wenn Sie diesen Parameter auf no festlegen. In diesem Fall werden QuickInfos jedoch aus der eingebetteten Ansicht ausgeschlossen. | <param name='tooltip' value='no'/> |
URL-Parameter für Iframe-Tags
Hinweis: Bevor Sie URL-Parameter hinzufügen, entfernen Sie :iid=[#]
am Ende der URL. Dies ist ein temporärer Ansichtszähler für Ihre aktuelle Browsersitzung.
URL-Parameter | Werte | Beschreibung | Beispiele |
---|---|---|---|
:dataDetails | no | Blendet die Schaltfläche "Datendetails" in der Symbolleiste aus, die Benutzern erlaubt, Details zu den in dieser Ansicht verwendeten Daten zu sehen. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:dataDetails=no |
:showDataDetails | yes | Wenn Tableau Catalog aktiviert ist, wird die Ansicht mit geöffnetem Bereich für Datendetails angezeigt. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:showDataDetails=yes |
:alerts | no | Ausblenden der Schaltfläche "Warnungen" in einer eingebetteten Ansicht. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:alerts=no |
:customViews | no | Option Änderungen speichern. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:customViews=no |
:device | desktop; tablet; phone | Wenn ein Dashboard über Layouts für Mobilgeräte verfügt, zeigt es ein spezifisches Layout an, und zwar unabhängig von der Bildschirmgröße. Wenn dieser Parameter nicht festgelegt ist, ermittelt Tableau Server oder Tableau Cloud die Bildschirmgröße und lädt das entsprechende Layout. Beispiele finden Sie im Thema über Einbetten von Dashboards. | http://tabserver/views/sales/sales_dashboard?:device=tablet |
:display_count (Nur Tableau Public) | yes | Zeigt die Gesamtzahl der Seitenaufrufe, wenn Sie links unten auf das Tableau-Logo klicken. | https://public.tableau.com/en-us/s/gallery/what-emoji-say-about-music?:display_count=yes |
:embed | yes | Erforderlicher URL-Parameter. Blendet den oberen Navigationsbereich aus, wodurch sich die Ansicht besser in Ihre Webseite einfügt. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes |
:format | pdf; png | Zeigt eine Ansicht als PDF- oder .png-Datei an. | http://tabserver/views/Sales/Q2?:format=pdf |
:highdpi | false | Stellt eine Ansicht mithilfe von Standard-DPI (Dots Per Inch) für die Anzeige und Geräte mit hoher Auflösung dar | http://tableauserver/views/Sales/Q2?:highdpi=false |
:linktarget | Zeichenfolge | Der Zielfenstername für externe Hyperlinks. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:linktarget=_blank |
:openid_hd | Zeichenfolge | Wird bei der Authentifizierung mit OpenID Connect verwendet. Gibt die gehostete Domäne an, zu der ein Benutzer gehört. Sie können diese Option beispielsweise verwenden, wenn Sie den Domänenauswahlbereich nicht rendern möchten. Wird in Verbindung mit :openid_login_hint verwendet, um die vollständige Benutzerkennung anzugeben. | http://tabserver/views/Sales/Q2?:openid_hd=example.com |
:openid_login_hint | Zeichenfolge | Wird bei der Authentifizierung mit OpenID Connect verwendet. Gibt die vollständige Benutzerkennung (E-Mail-Adresse) an. Wird in Verbindung mit :openid_hd verwendet, um die gehostete Domäne anzugeben, zu der der Benutzer gehört. | http://tabserver/views/Sales/Q2?:openid_login_hint=tara@example.com |
:record_performance (Nur Tableau Server. Gilt nicht für Tableau Cloud.) | yes | Startet eine Leistungsaufzeichnung für eine Ansicht. Fügen Sie dies am Ende der URL direkt vor der Sitzungs-ID (:iid=<n> ) hinzu. Weitere Informationen finden Sie in der Tableau Server-Hilfe im Abschnitt Erstellen einer Leistungsaufzeichnung(Link wird in neuem Fenster geöffnet). | http://tabserver/views/Sales2013/Regions?:recordperformance=yes |
:refresh | yes | Stellt die Ansicht mit den neuesten Daten aus Tableau Server oder Tableau Cloud dar. Tipp: Um eine Ansicht fortlaufend zu aktualisieren, fügen Sie im Abschnitt | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:refresh=yes |
:render | true ; false ; Nummer | Wenn das clientseitige Rendern aktiviert ist (Standardeinstellung), wird durch die Einstellung auf false das serverseitige Rendern für die Sitzung erzwungen. Wenn Sie dies auf true setzen, wird das clientseitige Rendering für die Sitzung erzwungen.Geben Sie eine Zahl zwischen 1 und 100 ein, um den Schwellenwert für die Komplexität festzulegen. Wenn dieser überschritten wird, werden die Ansichten vom Server gerendert. Weitere Informationen finden Sie in der Tableau Server-Hilfe im Abschnitt Allgemeines zum clientseitigen Rendern(Link wird in neuem Fenster geöffnet). | http://tabserver/views/Date-Time/DateCalcs?:render=false |
:revert | all; filters; sorts; axes; shelves | Stellt den ursprünglichen Zustand des Elements wieder her. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:revert=all |
:showAppBanner | false | Blendet das Banner "In Tableau Mobile öffnen" in Webbrowsern von Mobilgeräten aus. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:showAppBanner=false |
:showAskData | false | Blendet die Schaltfläche "Frag die Daten" in der Symbolleiste in einer eingebetteten Ansicht aus. Standardmäßig wird die Schaltfläche "Frag die Daten" angezeigt. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:showAskData=false |
:showShareOptions | true ; false | Steuert, ob die Optionen "Teilen" in einer eingebetteten Ansicht angezeigt werden oder nicht. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:showShareOptions=true |
:showVizHome (Nur Tableau Public) | yes; no | Blendet die Inhaltsnavigationsschnittstelle von Tableau Public ein oder aus. Setzen Sie diesen Parameter auf "no", wenn Sie Visualisierungen auf anderen Webseiten einbetten. | https://public.tableau.com/en-us/s/gallery/what-emoji-say-about-music?:showVizHome=no |
:subscriptions | no | Ausblenden der Schaltfläche "Abonnieren" in einer eingebetteten Ansicht. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:subscriptions=no |
:tabs | yes; no | Registerkarten ein- oder ausblenden. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:tabs=no |
:toolbar | yes; no; top | Wenn dieser Parameter nicht angegeben wird, wird die Symbolleiste standardmäßig unten angezeigt. Wenn no angegeben wird, wird die Symbolleiste nicht in die eingebettete Ansicht aufgenommen. Wenn top angegeben wird, wird die Symbolleiste über der Ansicht angezeigt. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:toolbar=no |
:tooltip | yes; no | Wenn dieser Parameter nicht angegeben wird, werden die QuickInfos standardmäßig in einer Ansicht angezeigt. Wenn no angegeben wird, werden keine QuickInfos in der eingebetteten Ansicht angezeigt. | http://tabserver/views/workbookQ4/SalesQ4?:embed=yes&:tooltip=no |