Skip to main content

Model Import & Export

Transfer model definitions between environments using .fsm files — export structure and optionally import with conflict resolution.

Updated today

Overview

Model Import & Export lets administrators transfer model definitions between Farseer environments using .fsm (Farseer Model) files. This is useful for migrating models, creating backups of model structure, or copying models between workspaces.

This feature is distinct from Backup & Restore, which backs up all data. Model Import & Export focuses specifically on model structure — dimension tables, variables, and optionally cell values and dimension members.

Exporting a Model

Exporting a model

To export your model, open Model Export from the settings menu. You will see a folder tree where you can select which items to include.

Export Options

  • Item selection: Choose specific dimension tables and variables to export using the folder tree. Use "Select All" to include everything.

  • Include cells: Optionally export cell values along with the model structure.

  • Include members: Optionally export dimension members (rows in dimension tables).

Click Export to download the model as a .fsm file (JSON format). The filename follows the pattern yourworkspace_model_export.fsm.

Importing a Model

Model import follows a guided 4-step process:

Step 1: Upload File

Drag and drop a .fsm file or click Browse to select one from your computer.

Step 2: Configure Options

Choose how the import should handle conflicts with existing data:

  • Allow deletions: A master toggle to enable or disable all deletion options at once:

    • Delete tables

    • Delete member rows

    • Delete columns

    • Delete variables

    • Delete cells

  • Clear everything: Removes all existing model content before importing. Use with caution.

Step 3: Preview Changes

A dry-run executes to show exactly what will be created, updated, or deleted — without making any actual changes. Review the list carefully before proceeding.

Step 4: Apply Import

Confirm and execute the import. All changes are applied and the workspace refreshes automatically.

Did this answer your question?