Skip to main content

Importing and Exporting Forms

OSPROV Form Builder allows you to import and export form schemas, making it easy to share forms between environments, create backups, or use as starting points for similar forms.

Exporting a Form​

Exporting downloads the form's schema as a file named form-schema.txt containing the form's JSON. To export:

  1. Open the form in the Form Builder
  2. Click the Export button (download icon) in the top right corner
  3. The file form-schema.txt will be downloaded

Exported schemas can be used for:

  • Creating backups
  • Sharing forms with colleagues
  • Moving forms between environments (development, testing, production)
  • Starting a new form from an existing one

Importing a Form​

Importing loads a previously exported schema into the Form Builder. To import:

  1. Click the Import button (upload icon) in the top right corner
  2. Select a previously exported form-schema.txt file
  3. The form will be loaded into the Form Builder
  4. Review and make any necessary adjustments
  5. Save the form
warning

Import replaces the current form builder content entirely. Only use it on a new or empty draft form — not on a form you have already built. There is no undo.

When importing a form, you may need to adjust settings that are environment-specific:

  • Data source URLs
  • MasterData table names
  • Field keys if the form was restructured

Best Practices​

  • Keep exported schema files in version control alongside your workflow documentation
  • Include the form name and date in the filename when archiving (e.g. leave-request-2025-04.txt)
  • Test imported forms thoroughly before publishing — verify all data sources load and conditions fire correctly
  • Document any environment-specific settings that need adjustment after import