Create a Conversion
Open Converter, choose New Conversion, and complete the conversion setup form.
Before you start
Section titled “Before you start”Prepare the Tableau source workbook and any supporting files before creating the job.
Use one of these upload options:
- Upload one Tableau workbook file with a
.twbor.twbxextension. - Upload one ZIP archive that contains the Tableau workbook and optional supporting folders.
Screenshots and data files are optional, but they improve conversion context when the workbook depends on visual layout details or external file-based data.
Project Name
Section titled “Project Name”Enter a readable project name for the conversion, such as a dashboard name, report name, migration wave, or business area.
The project name appears in the Converter list, conversion detail page, downloads, logs, and generated documentation.
Target BI Platform
Section titled “Target BI Platform”Choose the target BI platform for the conversion when more than one target is enabled.
The selected target controls the generated output, conversion guidance, scoring context, and deployment options.
| Target | Use when | Output focus |
|---|---|---|
| Power BI | You want Antares to generate Power BI-oriented report and semantic model artifacts. | Power BI project output, Power BI BRD, conversion report, optional cache, and Fabric deployment guidance. |
| Databricks AI/BI | You want target guidance for rebuilding Tableau content in Databricks AI/BI. | AI/BI migration guidance, SQL-native fit, target limitations, and rebuild recommendations. |
If the workspace has only one target enabled, Antares may select it automatically.
Conversion Source
Section titled “Conversion Source”Choose how to provide the Tableau source.
Individual files
Section titled “Individual files”Upload these files separately:
- Workbook: one
.twbxor.twbfile. Required. - Screenshots:
.png,.jpg,.jpeg, or.pdf. - Data files:
.csv,.tsv,.txt,.parquet,.xlsx,.xls, or.json.
Data files are only needed when the workbook uses file data sources that are not embedded in the .twbx.
For extract-based workbooks that use .hyper extracts, upload a CSV export for each table along with the workbook.
ZIP archive
Section titled “ZIP archive”Upload exactly one .zip file when you want to package the workbook and supporting files together.
Use this folder structure:
tableau-in-original/: one.twbxor.twbfile. Required.tableau-in-screenshots/: dashboard screenshots.data/:.csv,.tsv,.txt,.parquet,.xlsx,.xls, or.jsonfiles.
Data files are only needed when the workbook uses file data sources that are not embedded in the .twbx.
For extract-based workbooks that use .hyper extracts, include a CSV export for each table along with the workbook.
Do not mix a ZIP archive with separately uploaded workbook, screenshot, or data files in the same conversion.
Power BI options
Section titled “Power BI options”Power BI conversions can include Create Power BI cache.
Leave this option off for the fastest conversion setup when you plan to refresh or validate the data later in Power BI Desktop or Fabric. Turn it on when you want Antares to attempt preloaded cache output for the generated semantic model.
Cache generation can take much longer for large workbooks or large file-based data sources. If cache creation fails, the conversion may still produce useful project artifacts and documentation for manual validation.
Databricks AI/BI options
Section titled “Databricks AI/BI options”Databricks AI/BI conversions use target-specific guidance for SQL-native behavior, dashboard rebuild effort, and unsupported Tableau interactions.
If your Antares environment exposes additional AI/BI options, configure them before submitting the job. Otherwise, Antares uses the selected target to generate the available AI/BI documentation and recommendations.
Submit
Section titled “Submit”Choose Start Conversion to upload the files and create the job.
Antares validates the upload before processing. Common validation checks include file type, project name, upload size, workbook count, and whether ZIP and individual file upload modes were mixed.
After submission, open the conversion detail page to follow progress, review logs, and inspect generated documentation.