Class - jobs.job_rest_export.JobRESTExport

JSON Schema

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

JSON Schema Definitions

#/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

#/definitions/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

#/definitions/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

#/definitions/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

#/definitions/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

#/definitions/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