Skip to main content

Tableau - Trigger Workbook Refresh

Overview​

First time using this Blueprint? Make sure you follow our Tableau authorization guide.​

Manually trigger a refresh of a workbook in Tableau.

This Blueprint will only kick off the refresh and will almost always return a status of success. It will not wait around to verify if the created refresh job was successfully completed, but it will create and store the generated job ID to shipyard-artifacts/tableau-blueprints/variables/job_id.pickle

Recommended Setup:

  1. A Vessel built with the Tableau - Check Refresh Status Blueprint should be run immediately after this Vessel. This will ensure that you build your Fleet to act on the final status of your refresh.

Variables​

NameReferenceTypeRequiredDefaultOptionsDescription
Authentication MethodTABLEAU_SIGN_IN_METHODSelectβœ…username_passwordUsername & Password: username_password

Access Token: access_token
Determine which authentication method to use when connecting to Tableau.
Username or Access Token NameTABLEAU_USERNAMEAlphanumericβœ…--Your personal username or the name of the access token that you use to log in with Tableau.
Password or Access TokenTABLEAU_PASSWORDPasswordβœ…--The password associated with the provided username OR the access token associated with the provided access token name.
Server URLTABLEAU_SERVER_URLAlphanumericβœ…--The scheme, subdomain, domain, and top-level domain (TLD) of your Tableau URL.
Site IDTABLEAU_SITE_IDAlphanumericβœ…--Typically found in the URL as /site/YOURSITEID/
Project NameTABLEAU_PROJECT_NAMEAlphanumericβœ…--The project name that the Datasource belongs to.
Workbook NameTABLEAU_WORKBOOK_NAMEAlphanumericβœ…--Name of the published workbook you want to refresh.

YAML​

Below is the YAML template for this Blueprint and can be used in the Fleet YAML Editor.

source:
blueprint: Tableau - Trigger Workbook Refresh
inputs:
TABLEAU_SIGN_IN_METHOD: username_password ## REQUIRED
TABLEAU_USERNAME: null ## REQUIRED
TABLEAU_PASSWORD: null ## REQUIRED
TABLEAU_SERVER_URL: null ## REQUIRED
TABLEAU_SITE_ID: null ## REQUIRED
TABLEAU_PROJECT_NAME: null ## REQUIRED
TABLEAU_WORKBOOK_NAME: null ## REQUIRED
type: BLUEPRINT
guardrails:
retry_count: 1
retry_wait: 0s
runtime_cutoff: 1h0m0s
exclude_exit_code_ranges:
- "200-205"