Class Index: jobs.job_rest_export.JobRESTExport

JobRESTExport

Configuration for job_rest_export.py

type

object

properties

  • credentials

Credentials

Tableau server credentials.

anyOf

type

string

TableauCredentials

  • server

Server

Tableau server configuration.

allOf

TableauServer

  • export

Export

Defines the Tableau export to perform.

anyOf

CSVExport

XLSXExport

PDFExport

  • destination_dir

Destination Dir

Directory in which the exported report will be saved.

type

string

default

/tmp/mitto/data

format

directory-path

additionalProperties

False

definitions

  • TableauCredentials

TableauCredentials

Tableau server credentials.

The Tableau REST API can accept two types of credentials for authentication:

  • username and password

  • token_name, and personal_access_token

For Tableau servers configured to require MFA, only the token_name, and personal_access_token form of credentials will be accepted.

For Tableaus servers that do not require MFA, either form of credentials will be accepted.

Note: Personal Access Tokens expire if unused for more than 15 days.

type

object

properties

  • username

Username

Tableau username.

type

string

examples

steve

  • password

Password

Tableau password.

type

string

examples

steve-password

  • token_name

Token Name

Tableau Personal Access Token Name

type

string

examples

test_token_name

  • personal_access_token

Personal Access Token

Tableau Personal Access Token Value

type

string

examples

F3QtOEOzRDKW8wGIe1LOmQ==:DlgqULXdhInxWqQMhM5WGjJ05hzRP3nM

additionalProperties

False

  • TableauServer

TableauServer

Tableau server configuration.

type

object

properties

  • server

Server

Tableau server to use.

type

string

examples

https://tableau.zuar.com

  • site

Site

The “site” has been deprecated in favor of “site_id”. "Default" value, provide a empty string value (i.e., a value of "").

type

string

examples

  • site_id

Site Id

Tableau site_id to use. Note: to use the "Default" site_id, provide a empty string value (i.e., a value of "").

type

string

examples

  • user_id_to_impersonate

User Id To Impersonate

Tableau username to impersonate when authenticating. If not provided, no impersonation is performed.

type

string

examples

3908c4ce-b171-46f3-b12b-d8827c162199

additionalProperties

False

  • CSVExport

CSVExport

Complete definition of the Tableau REST CSV export

type

object

properties

  • name

Name

Name that the export will be saved under. Do not include the extension; it will be determined automatically.

type

string

default

tableau-export

  • workbook

Workbook

_content_url of the workbook

type

string

  • view

View

_content_url of the view

type

string

  • view_filters

View Filters

View filters to apply to data.

type

object

examples

State

Louisiana

Texas

Category

Office Supplies

region

LATAM

NA

sub_region

plant_name

global_start_datetime

2020-06-12 00:00:00.000

global_end_datetime

2020-06-12 23:59:59.999

default

  • full

Full

Process all views in workbook, not just the view specified by view.

type

boolean

examples

true

false

null

  • timeout

Timeout

Maximum number of seconds to allow before killing request.

type

integer

default

300

  • retries

Retries

Maximum number of times to retry a failed request.

type

integer

default

5

  • maxage

Maxage

The maximum number of minutes the CSV data will be cached on the server before being refreshed. The value must be an integer between 1 and 240 minutes. 0 will be interpreted as 1 minute on server, as that is the shortest interval allowed.

type

integer

maximum

240

minimum

-1

default

-1

  • type

Type

Type of export being performed.

type

string

examples

csv

default

csv

additionalProperties

False

  • XLSXExport

XLSXExport

Complete definition of the Tableau REST XLSX export

type

object

properties

  • name

Name

Name that the export will be saved under. Do not include the extension; it will be determined automatically.

type

string

default

tableau-export

  • workbook

Workbook

_content_url of the workbook

type

string

  • view

View

_content_url of the view

type

string

  • view_filters

View Filters

View filters to apply to data.

type

object

examples

State

Louisiana

Texas

Category

Office Supplies

region

LATAM

NA

sub_region

plant_name

global_start_datetime

2020-06-12 00:00:00.000

global_end_datetime

2020-06-12 23:59:59.999

default

  • full

Full

Process all views in workbook, not just the view specified by view.

type

boolean

examples

true

false

null

  • timeout

Timeout

Maximum number of seconds to allow before killing request.

type

integer

default

300

  • retries

Retries

Maximum number of times to retry a failed request.

type

integer

default

5

  • maxage

Maxage

The maximum number of minutes the CSV data will be cached on the server before being refreshed. The value must be an integer between 1 and 240 minutes. 0 will be interpreted as 1 minute on server, as that is the shortest interval allowed.

type

integer

maximum

240

minimum

-1

default

-1

  • type

Type

Type of export being performed.

type

string

examples

xlsx

default

xlsx

additionalProperties

False

  • PDFLayoutOptions

PDFLayoutOptions

Defines all available Tableau REST page layout options.

type

object

properties

  • pageOrientationOption

Pageorientationoption

type

string

examples

landscape

portrait

default

landscape

  • pageSizeOption

Pagesizeoption

type

string

examples

a3

a4

a5

b4

b5

executive

folio

ledger

legal

letter

note

quarto

statement

tabloid

unspecified

default

letter

additionalProperties

False

  • PDFExport

PDFExport

Complete definition of the Tableau REST PDF export.

type

object

properties

  • name

Name

Name that the export will be saved under. Do not include the extension; it will be determined automatically.

type

string

default

tableau-export

  • workbook

Workbook

_content_url of the workbook

type

string

  • view

View

_content_url of the view

type

string

  • view_filters

View Filters

View filters to apply to data.

type

object

examples

State

Louisiana

Texas

Category

Office Supplies

region

LATAM

NA

sub_region

plant_name

global_start_datetime

2020-06-12 00:00:00.000

global_end_datetime

2020-06-12 23:59:59.999

default

  • full

Full

Process all views in workbook, not just the view specified by view.

type

boolean

examples

true

false

null

  • timeout

Timeout

Maximum number of seconds to allow before killing request.

type

integer

default

300

  • retries

Retries

Maximum number of times to retry a failed request.

type

integer

default

5

  • maxage

Maxage

The maximum number of minutes the CSV data will be cached on the server before being refreshed. The value must be an integer between 1 and 240 minutes. 0 will be interpreted as 1 minute on server, as that is the shortest interval allowed.

type

integer

maximum

240

minimum

-1

default

-1

  • type

Type

Type of export being performed.

type

string

examples

pdf

default

pdf

  • options

Options

default

pageOrientationOption

landscape

pageSizeOption

letter

allOf

PDFLayoutOptions

additionalProperties

False

TableauCredentials

Tableau server credentials.

The Tableau REST API can accept two types of credentials for authentication:

  • username and password

  • token_name, and personal_access_token

For Tableau servers configured to require MFA, only the token_name, and personal_access_token form of credentials will be accepted.

For Tableaus servers that do not require MFA, either form of credentials will be accepted.

Note: Personal Access Tokens expire if unused for more than 15 days.

type

object

properties

  • username

Username

Tableau username.

type

string

examples

steve

  • password

Password

Tableau password.

type

string

examples

steve-password

  • token_name

Token Name

Tableau Personal Access Token Name

type

string

examples

test_token_name

  • personal_access_token

Personal Access Token

Tableau Personal Access Token Value

type

string

examples

F3QtOEOzRDKW8wGIe1LOmQ==:DlgqULXdhInxWqQMhM5WGjJ05hzRP3nM

additionalProperties

False

TableauServer

Tableau server configuration.

type

object

properties

  • server

Server

Tableau server to use.

type

string

examples

https://tableau.zuar.com

  • site

Site

The “site” has been deprecated in favor of “site_id”. "Default" value, provide a empty string value (i.e., a value of "").

type

string

examples

  • site_id

Site Id

Tableau site_id to use. Note: to use the "Default" site_id, provide a empty string value (i.e., a value of "").

type

string

examples

  • user_id_to_impersonate

User Id To Impersonate

Tableau username to impersonate when authenticating. If not provided, no impersonation is performed.

type

string

examples

3908c4ce-b171-46f3-b12b-d8827c162199

additionalProperties

False

CSVExport

Complete definition of the Tableau REST CSV export

type

object

properties

  • name

Name

Name that the export will be saved under. Do not include the extension; it will be determined automatically.

type

string

default

tableau-export

  • workbook

Workbook

_content_url of the workbook

type

string

  • view

View

_content_url of the view

type

string

  • view_filters

View Filters

View filters to apply to data.

type

object

examples

State

Louisiana

Texas

Category

Office Supplies

region

LATAM

NA

sub_region

plant_name

global_start_datetime

2020-06-12 00:00:00.000

global_end_datetime

2020-06-12 23:59:59.999

default

  • full

Full

Process all views in workbook, not just the view specified by view.

type

boolean

examples

true

false

null

  • timeout

Timeout

Maximum number of seconds to allow before killing request.

type

integer

default

300

  • retries

Retries

Maximum number of times to retry a failed request.

type

integer

default

5

  • maxage

Maxage

The maximum number of minutes the CSV data will be cached on the server before being refreshed. The value must be an integer between 1 and 240 minutes. 0 will be interpreted as 1 minute on server, as that is the shortest interval allowed.

type

integer

maximum

240

minimum

-1

default

-1

  • type

Type

Type of export being performed.

type

string

examples

csv

default

csv

additionalProperties

False

XLSXExport

Complete definition of the Tableau REST XLSX export

type

object

properties

  • name

Name

Name that the export will be saved under. Do not include the extension; it will be determined automatically.

type

string

default

tableau-export

  • workbook

Workbook

_content_url of the workbook

type

string

  • view

View

_content_url of the view

type

string

  • view_filters

View Filters

View filters to apply to data.

type

object

examples

State

Louisiana

Texas

Category

Office Supplies

region

LATAM

NA

sub_region

plant_name

global_start_datetime

2020-06-12 00:00:00.000

global_end_datetime

2020-06-12 23:59:59.999

default

  • full

Full

Process all views in workbook, not just the view specified by view.

type

boolean

examples

true

false

null

  • timeout

Timeout

Maximum number of seconds to allow before killing request.

type

integer

default

300

  • retries

Retries

Maximum number of times to retry a failed request.

type

integer

default

5

  • maxage

Maxage

The maximum number of minutes the CSV data will be cached on the server before being refreshed. The value must be an integer between 1 and 240 minutes. 0 will be interpreted as 1 minute on server, as that is the shortest interval allowed.

type

integer

maximum

240

minimum

-1

default

-1

  • type

Type

Type of export being performed.

type

string

examples

xlsx

default

xlsx

additionalProperties

False

PDFLayoutOptions

Defines all available Tableau REST page layout options.

type

object

properties

  • pageOrientationOption

Pageorientationoption

type

string

examples

landscape

portrait

default

landscape

  • pageSizeOption

Pagesizeoption

type

string

examples

a3

a4

a5

b4

b5

executive

folio

ledger

legal

letter

note

quarto

statement

tabloid

unspecified

default

letter

additionalProperties

False

PDFExport

Complete definition of the Tableau REST PDF export.

type

object

properties

  • name

Name

Name that the export will be saved under. Do not include the extension; it will be determined automatically.

type

string

default

tableau-export

  • workbook

Workbook

_content_url of the workbook

type

string

  • view

View

_content_url of the view

type

string

  • view_filters

View Filters

View filters to apply to data.

type

object

examples

State

Louisiana

Texas

Category

Office Supplies

region

LATAM

NA

sub_region

plant_name

global_start_datetime

2020-06-12 00:00:00.000

global_end_datetime

2020-06-12 23:59:59.999

default

  • full

Full

Process all views in workbook, not just the view specified by view.

type

boolean

examples

true

false

null

  • timeout

Timeout

Maximum number of seconds to allow before killing request.

type

integer

default

300

  • retries

Retries

Maximum number of times to retry a failed request.

type

integer

default

5

  • maxage

Maxage

The maximum number of minutes the CSV data will be cached on the server before being refreshed. The value must be an integer between 1 and 240 minutes. 0 will be interpreted as 1 minute on server, as that is the shortest interval allowed.

type

integer

maximum

240

minimum

-1

default

-1

  • type

Type

Type of export being performed.

type

string

examples

pdf

default

pdf

  • options

Options

default

pageOrientationOption

landscape

pageSizeOption

letter

allOf

PDFLayoutOptions

additionalProperties

False