Skip to main content

Export and Import Application

Users can export the entire app configuration and data into a file (mdy format) and import it into another organization to quickly replicate or migrate the app.

This feature is available in HAP SaaS paid plans and all versions of HAP Server.

1. Export Apps​

1. Export Settings​

1.1 Entry for Exporting Apps​

  • Export a Single App

    App admins can export the current app directly from the App Management page.

    If a worksheet in the app references a worksheet in another app, the relationship field will be converted to a text field during export and lose its association.
    To preserve relationships, export related apps together.

  • Batch Export Apps

    App admins can click their profile avatar and go to Org Admin > App Management > App, then click the More button in the top-right corner to export apps.

    Up to 20 apps can be exported at once. Relationships between exported apps will be preserved.

1.2 Exportable Record Limits​

  • Each worksheet can export up to 10,000 records

    • When selecting Export up to 10,000 records per worksheet, the maximum total export per worksheet is calculated as:
      100,000 ÷ number of worksheets in the app

    • When selecting Customize number of exported records, you can define the number of records per worksheet. Any value above 10,000 will be automatically capped at 10,000.

  • If the app contains multiple worksheets, the total export limit per app is 50,000 records.

  • When exporting multiple apps, each app can export up to 50,000 records.

1.3 Set Export File Password​

You can set a password for the exported app file. The password must be entered during import for verification.

Passwords can be generated automatically or set manually. If forgotten, they can be viewed in the export record list.

Password verification during import:

View import and unlock passwords:

1.4 Lock App Configuration After Import​

If enabled, the imported app will be locked by default.
All users will be unable to view or modify app configurations until the correct password is entered to unlock the app.

The password can be generated automatically or set manually. If forgotten, it can be viewed in the export record list.

App configuration can only be modified after unlocking:

1.5 Download the Export File​

The export process typically completes within 10 seconds. Click Download Now to download the file.

1.6 Export File Format​

2. Exported Content​

2.1 App Structure in Export​

The complete app structure can be exported, including worksheets, views, workflow, roles, charts, custom pages, and view/workflow plugins.

App

  • App name and icon
  • Groups
  • App description

Worksheet

  • Name and icon

  • Position within groups

  • View configurations (including custom button settings)

  • Field configurations (including relationships)

  • Data source tables and their data

  • Public filters

  • Form settings

  • Field display rules

  • Record title

  • Field aliases

  • Print templates (system templates and Word templates)

    Note: When importing an app from HAP SaaS into HAP Server, Word/Excel print templates must be re-uploaded.

  • Function switch

Custom Pages

  • Name and icon
  • Position within groups
  • All component configurations
  • Component size and position
  • Page description

App Roles

  • “Allow non-admins to view” settings
  • All configurations under roles

Workflow

  • Current published version (including subprocess)
  • Workflow configurations
  • Workflows triggered by custom actions, webhooks, or schedules

Public Charts and Configurations

View / Workflow Plugins

2.2 Data Limits for Export​

  • Each worksheet can export up to 10,000 records, and each app can export up to 50,000 records in total.

  • File fields are not supported for export (print templates are supported).

warning

When exporting an app, only partial data can be exported, and relationships between exported data may not be fully preserved.

To export complete and accurate data, use the data sync feature or contact your sales representative for data migration services.

2.3 Apps Not Supported for Export​

Apps that cannot be exported will not have an export button.

  • Apps distributed via the app distribution platform cannot be exported.
  • Locked apps cannot be exported; they must be unlocked first.

2.4 Handling Relationships​

If the exported app has relationships with other apps that are not included in the export, the relationship field will be automatically converted into a text field.

2. Import Apps​

When importing apps, you can either upgrade an existing app from the same source or create a new app.

Entry for Importing Apps​

  • Import when creating a new app from the homepage

    You can only create a new app, and only one app can be imported at a time.

  • Import from the Org Admin Console

    Organization admins can batch import multiple apps and choose to upgrade existing apps from the same source or create new ones.

    Path: Click the avatar → Org Admin > App Management > App, then click the top-right button and select Import App.
    Learn more