Import Data
The Import feature enables you to import records from an external Excel/CSV file to database table.
How to Use
To enable the feature for a table, select the table and click the Table tab, then enable the Import checkbox.
After generation, an Import button will be displayed in the table list page.
To start importing the external records, click the Import button and an Import dialog box will be displayed. Click the
Choose button to select the file for import, and the import process will begin. Click the Close button once the import process
is completed to refresh the list page.
Important Notes
- Supported import file formats are native Excel spreadsheets (xlsx) and CSV (csv) only.
- The first row of the file should contain the field names to be imported. The field names MUST match the corresponding field names in the table.
You can manipulate the field names in the Page_Importing server event (see Server Events for Import) if the file contains pure data only.
- All data in the file MUST match the data types of the corresponding field in the table. For example, if you are importing into an Integer field, the data
is expected to contain an integer value or the import may fail. You can however modify the field values in the Row_Import server event
(see Server Events for Import below). Importing lookup fields from display values is NOT supported, but you can also use Row_Import event to support it in your own ways.
- If you are importing a lot of records, the import may take a long time to complete.
- For CSV file, the default quote character and delimiter used are " (double quote) and , (comma).
You can change in Advanced Settings or by Page_Importing server event.
- To ensure an ALL OR NOTHING import, you can enable the Import records by transaction in Advanced Settings.
The transaction will be rollbacked if there is any error during the import process.
- The default import operation is "Insert only". If you want also to update records if record with the same record key is found, you can disable the
Import records by insert only in Advanced Settings. Please make sure that you understand the implication of this
change before modifying the setting.
- If User Level Security is enabled, by default only the Administrators has the rights to import records.
To allow a non-admin user to import records,
use the TablePermission_Loaded server event
(see Server Events and Client Scripts) to set an user with Import permission, e.g. CanImport = true;.
Server Events for Import
- Page_Importing
- Row_Import
- Page_Imported
See Server Events and Client Scripts for details.
Advanced Settings for Import
- Import records by insert only
- Import records by transaction
- Import supported file extensions
- Import CSV delimiter
- Import CSV text qualifier
- Import CSV EOL
- Import CSV Encoding
- Import CSV Culture
See Advanced Settings for details.