Create External Report from Tableau

This article will show you how to create an External Report that displays data from your Tableau server.

PREREQUISITES:

Established connectivity to Tableau Server

If your External Report Viewer is displaying duplicate Filters based on your BI Tool defaults, your Admin can reset the default behavior to remove the Metric Insights filters from Viewer display. Refer to How to Omit Filters from External Reports.

  • NOTE: If there is no Tableau Report Type in the list, you can create one by following instructions in this article: Create a New External Report Type
  • You can customize Tableau toolbar and tabs display under the Advanced tab (this will pass these parameter settings to URLs) instead of editing External Report Type. 

Just leave Viewer URL append and External URL append fields blank and customize External Reports the way your organization requires (see the screen below).

1. Create New External Report

Access New >External Report > Tableau

  1. Provide a descriptive phrase in Name
  2. Specify Category where External Report will be placed
  3. Define whether content has to be updated manually or automatically
    • For "Automatically Collected", specify Report Image Trigger 
  4. Choose Tableau Plugin Connection Profile 
  5. Select Tableau worksheet (Object) for External Report
    • NOTE: Tableau Plugin does not collect Objects from Personal Spaces.
  6. [Next: define details]

2. Specify Report Details

  1. Show Report in defaults to "External Webpage". For "Viewer", select to show the External Report:
    • "In iframe": to embed the Report into Metric Insights
    • "As static image": to show an image of the Report in Metric Insights. NOTE: For this option, make sure you Collect Image before going to Viewer.
    • "As PDF": to show a PDF version of the Report in PDF viewer in Metric Insights. Tableau Plugin supports getting native PDFs. NOTE: To display this option in the Editor, enable Collect additional files > PDF on the Advanced tab.
  2. Optionally, configure filtering via [Manage Filters]
  3. Optionally, [Edit URL] to modify the URL by appending a question mark (?) followed by any filter or parameter settings
  4. Optionally, [Test URL] to test how your Report will be displayed on External Webpage or in Viewer, depending on the display option selected in the previous step
  5. Select Report Image option:
    • "Always collect all instances of external report": collect all images and cache them on a schedule
    • "On Demand: only when needed for distribution": individual images are only collected when they need to be included in an email

3. Collect Image and Publish

Tableau Plugin collects images and PDFs by communicating with the tool via API. Web API is used by Tableau Plugin by default. Getting images and PDFs for Workbooks is always performed via REST API.

  1. [Collect Image]
  2. [Enable & Publish] to proceed to Viewer