Tableau → Power BI Migration

The extract step pulls the data embedded in your .twbx files, exports it as CSV files into your working folder, and makes it available to the deploy step so Power BI Desktop shows live data as soon as you open the converted project.

The converter itself does not require this step. Analyze and convert read the .twbx directly. This step only benefits the post-bind (data verification) workflow.

navis-extract spec.toml

No additional settings required beyond input, working, and output in spec.toml.

Scan .twb / .twbx files to assess what can be automatically migrated before committing to a conversion.

navis analyze spec.toml

Submit the License Request PDF to navis@cepheusonline.com. The PDF embeds cryptographic fingerprints of your workbooks. Cepheus replies with a license file.

1. Run navis analyze and save the License Request PDF
2. Email the PDF to navis@cepheusonline.com
3. Receive a license file back

[convert]
license = "cepheus-license.pdf"

navis verify-license spec.toml

navis convert spec.toml

What Navis produces

For each workbook: a .pbip folder (Power BI Project), plus a _CEC.zip Evidence Capsule.

How calculations are converted

Every DAX formula Navis produces has been individually tested against actual Tableau output to verify identical results. This isn’t approximate translation — it’s proven equivalence. If Navis encounters a calculation it cannot convert with proven accuracy, it flags it rather than guessing.

Windows only. The converter produces a .pbip project with the correct semantic model and DAX measures, but the M queries point to placeholder data sources. The deploy step writes the source data as CSV files alongside the project and repoints the M queries at those CSVs — so you can open the project in Power BI Desktop and see live data immediately.

Reads the data exported by the extract step from your working folder. No additional configuration required.

[deploy]
# No extra keys needed — Navis picks up the extracted data from your working folder automatically

navis-deploy spec.toml

After the deploy step, open the .pbip file in Power BI Desktop — all visuals will populate with data. Review the conversion, check the Evidence Capsule PDF for any fidelity gaps, and hand off to your data team.

Navigate to the _wired folder for any converted workbook and open the .pbip file in Power BI Desktop (File → Open report). Your report pages load with data immediately.

Connecting to production data

In Power BI Desktop: Home → Transform data → Data source settings. Select the CSV source and click Change Source. The semantic model and all measures are already correct — no other changes needed.

Review the PDF report inside the Evidence Capsule for anything flagged:

• Data connections — connect to your production data source after import.
• Unmapped calculations — formulas without a proven equivalent yet; clearly marked so you can write them manually.
• Dashboard actions (filter, URL, highlight) — noted as fidelity gaps; need manual recreation.
• Custom images and decorative elements — not transferred.
• Tableau Server / Cloud features — live connections, user filters, etc. need manual reconfiguration.
• Gantt charts — no direct Power BI equivalent; flagged.
• Parameters — preserved as metadata; wire to Power BI slicers manually.
• Nothing is ever silently skipped. If Navis can’t convert something, it tells you.

Power BI Project folder

SalesDashboard/
  SalesDashboard.pbip              <-- open this in Power BI Desktop
  SalesDashboard.Report/
    definition.pbir
    report.json
  SalesDashboard.SemanticModel/
    definition.pbism
    definition/
      model.tmdl
      database.tmdl
      tables/
  _CEC.zip                         <-- Evidence Capsule

Open SalesDashboard.pbip in Power BI Desktop. The semantic model and all DAX measures are fully defined — you only need to point the data source at your production data.

The _CEC.zip Evidence Capsule contains the PDF audit report with formula-level conversion evidence, SHA-256 checksums, and any fidelity gaps.

Every conversion produces a _CEC.zip alongside the converted output. It contains:

• A signed PDF with formula-level translation evidence
• SHA-256 checksums of all input files
• A machine-readable JSON manifest of all conversions and fidelity gaps
• A timestamp and license reference

The capsule is tamper-evident: any modification to the converted output invalidates the checksums in the PDF. Keep _CEC.zip alongside your converted project as your audit record.

The Evidence Capsule PDF is cryptographically signed by Cepheus. The signature certifies:

• The workbooks that were analyzed match the license issued
• The conversion was performed by an authentic, unmodified Navis binary
• The formula translations are the ones Cepheus has validated

Signature verification does not require internet access. The public key is embedded in the license file.

Every command writes a structured log alongside the output. Log entries include:

• Per-workbook conversion decisions and fidelity gaps
• SHA-256 of each input file at conversion time
• Formula translation records (source expression → target expression)
• Any warnings or skipped elements

Logs are in JSON Lines format for easy ingestion into SIEM or audit tooling.

License errors

Common issues

For other issues: navis@cepheusonline.com

To analyze or convert a specific subset of workbooks, name the batch in your spec file and list the files you want:

[pipeline]
input = "my_batch"
working  = "C:/Working"
output   = "C:/Output"

[pathlists.my_batch]
base  = "C:/Workbooks"
files = [
    "Sales.twbx",
    "Finance.twbx",
    "subfolder/HR.twbx",
]

Each path in files is resolved relative to base. Use a named batch when you want to hand-pick specific files rather than converting an entire folder.