We consistently aim to offer you flexibility through our RapidDox applications.
RapidDox BulkPro provides you with the capability to fully automate the generation of comprehensive output from your Tableau workbooks through two distinct approaches:
Option 1: Automatically download and process outputs with one command
Direct execution of commands, automating the download of workbooks, storage in a temporary server folder, and immediate processing of the output in the format you have configured.
- CLI command to generate documentation in PDF, MS Word, HTML, Excel, and CSV
- CLI command to export metadata to a database
Should you prefer to initially download all workbooks from your Tableau server to a shared location and subsequently process the outputs in a separate step, this flexibility enables you to incorporate any desired curation to the workbooks between the download and output processing stages.
- Step 1: Download workbooks
- Step 2: Curation to the workbooks
- Step 3: Process output using BulkPro CLI commands
Option 1: Automatically download and process outputs with one command
CLI command to generate documentation in PDF, MS Word, HTML, Excel, and CSV
Execute the following command to produce the output in one of the supported document formats:.
rapiddox start --tableau-server -f <<outputformat>> -o <<outputfolder>>
-f <<outputformat>>
The output format(s) that is/are to be generated by this start command.
Document output options: pdf | html | excel | csv
-o <<outputfolder>>
The full path of the output folder into which the output files are to be created.
Note: This command will process the workbooks that the configured Tableau user has access to. For more information about user permissions on Tableau Server, please check out this link.
EXAMPLE:
For generating PDF output documents, you can use the start command with the following parameters:
rapiddox start --tableau-server -f pdf -o /home/output
For generating HTML output documents, you can use the same command with the following parameters:
rapiddox start --tableau-server -f html -o /home/output
Similarly, you can create output documents in Excel or CSV format by adjusting the value passed to the -f parameter.
CLI command to export metadata to a database
Use the below command to generate the output to one of the configured database.
rapiddox start --tableau-server -f db -d <<databasetype>> -k <<keeplatest>> -o <<outputfolder>>
-f <<outputformat>>
The output format should be set to db if you want to export the data on to a database.
-d <<databasetype>>
Specifies the type of database to be used for exporting the output. This should be a database type that has been previously configured using the relevant configuredb command. This parameter is relevant only when the outputformat is set to db.
Possible options: mysql | mssql | postgres
-k <<keeplatest>>
Determines the behavior when processing the same twb/twbx file again. It denotes whether the existing records should be deleted or retained.
true : If true is passed as the option, then the output records pertaining to this file from the previous runs will be deleted and only the output records from this run will be created.
false : If false is passed as the option, then the database column “latest” for all the output records pertaining to this file from the previous runs will be updated to false and the output records from this run will be created with the “latest” column value as true.
Examples:
Exporting to a mysql database
rapiddox start --tableau-server -f db -d mysql -k true
Exporting to a mssql database
rapiddox start --tableau-server -f db -d mssql -k false
Exporting to a postgres database
rapiddox start --tableau-server -f db -d postgres -k true
Option 2: Download Tableau workbooks first with one command and execute separate command to process the outputs
Step 1: Download workbooks
Execute the below command to download your Tableau workbooks to a desired location.
rapiddox tableau download -o <outputfolder>
-o <<outputfolder>>
The full path of the output folder into which the workbooks are to be downloaded.
Example:
For generating PDF output documents, you can use the start command with the following parameters:
rapiddox tableau download -o /home/output
Step 2: Curation to the workbooks
Tailor and customize your workbooks according to your specific business requirements. For instance, you have the flexibility to add or remove Tableau workbooks as needed. Another scenario could arise when a user ID has access to the entire Tableau server; in such cases, you may opt to retain only the pertinent workbooks within the designated folder for BulkPro to efficiently process the output. These steps can be performed manually or programmatically. The RapidDox app does not provide any solution for these changes.
Step 3: Process output using BulkPro CLI commands
Using the CLI commands documented in this KB page, you can process output.
All these above steps can be scheduled via CronTab as described in this KB page.