Accessing the Web Server in Tableau Server

Version 12

    Important: Tableau does not support or test the procedures outlined in this article and any issues related to external content. This article is intended to provide general guidance on certain configurations that you might find useful with Tableau Server. Support cannot assist with any issues that arise as a result of this article.

     

    The web server built in to Tableau Server has been designed to host Tableau Server content. It is not intended to be used to host external content. However, you can use it to include additional dynamic content on your dashboards for proof-of concept or testing purposes. For production purposes, Tableau recommends that external web content be hosted outside of Tableau Server.

    Create web-friendly files

    To start this example, you need to create two simple HTML files and place them in:

    • To use the Error directory (e.g. http://localhost/errors/hello1.html):
      • The httpd folder located in the Tableau Server directory. For example, the httpd folder might be located here: C:\Program Data\Tableau\Tableau Server\data\tabsvc\config\httpd. If you need to create these files, complete the following steps. Otherwise you can skip to the next section.
    • To use the Desktop directory (e.g. http://localhost/desktop/hello1.html
      • The desktop folder located in the Tableau Server directory. For example, in Tableau Server v2018.2 folder will be located here: C:\Program Data\Tableau\Tableau Server\packages\wgserver.20182.18.0627.2230\public\desktop. If you need to create these files, complete the following steps. Otherwise you can skip to the next section.

     

    Step 1

    In a text editor, create a new file and insert this text: Hello World!

    This is page 1.

    Step 2

    Save the file as hello1.html in the httpd folder in the Tableau Server directory.

    Step 3

    For page 2, repeat the previous two steps, except this time name the file hello2.html.

    In the httpd folder, you now have hello1.html and hello2.html, each containing the text Hello World!

    Step 4

    Open each file in a browser to verify that the file is in the correct place. The URLs are http:lllocalhost/errors/hello1.html and http:lllocalhost/errors/hello2.html.

    Create a simple view on a worksheet to drive your dynamic web page

    Step 1

    Copy the following table into a new Tableau workbook:

    NamePage
    Hello World Pg1Hello1.html
    Hello World Pg2Hello2.html

    Note: When you copy and paste text, Tableau treats it like its own data source.

    Step 2

    On the Rows shelf, right-click the Page field and clear the selection for Show Header.

    Create a dashboard

    Step 1

    Select Dashboard > New Dashboard.

    Step 2

    From the Dashboard pane, drag Sheet 1 and drop it onto the Dashboard 1 tab.

    Step 3

    From the Objects pane, drag a Web Page object and drop it onto the Dashboard tab.

    Step 4

    Leave the Edit URL text box empty and click OK. The Web Page object does not need a name.

    Use Tableau actions to link the table and the web page object

    Step 1

    Select Dashboard > Actions.

    Step 2

    In the Actions dialog box, click Add Action, and then select URL.

    Step 3

    In the Add URL Action dialog box, under Run action on, click Select.

    Step 4

    In the URL text box, type http:lllocalhost/errors/, and then click the Test Link button. The web page doesn't open, but the URL is displayed in the dialog box next to the Test Link button.

    Step 5

    When finished, click OK.

    The base web directory for Tableau Server is http:lllocalhost/errors/. The page dimension is inserted into the URL to display your selected web page.