Import and export
Skyve comes with a few different options for bulk importing and exporting of data out of the box. Some of these options are available in the Admin module. To access those described below, navigate to Admin -> DevOps -> Data Maintenance.
Bizport
Bizport is a powerful feature to allow sophisticated bulk data manipulation and offline data maintenance. If existing data is exported, the internal UUIDs will be exported in an Excel workbook, in the bizId column and also where references between records exist.
On import, if the bizId of the row of data is recognised by the system, the system interprets this as an attempt to update the data row. If the UUID is not recognised, the system assumes that the value in the bizId is actually a business key which will need to be replaced with a UUID to guarantee uniqueness.
Export Data
To use Bizport to export data:
- Login with a user which has the
DevOps
role - Switch to power user mode if not already in there
- Navigate to the Admin module, and select
Data Maintenance
- From the Import/Export tab, select the Document to be exported in the Bizport form
- Click
Export Data
- Your browser will download the data as a Microsoft Excel file
Import Data
To use Bizport to bulk import new data into an application, first follow the instructions to Export Data so that you have a spreadsheet in the correct format with the expected columns and tabs defined.
If the ID values provided in the sheet are found in your existing Skyve data, Bizport will update the existing record. If the ID value is not found, Bizport will insert the data. For new data, ID values for references between sheets need to be consistent for related data to be inserted correctly.
- Using your export file, add new data into the spreadsheet. Add your own id values to insert new records (e.g. 1,2,3… or any other values or legacy key values - using excel’s drag-down feature is an easy way to set these if you don’t have IDs from a legacy system), or modify existing exported data by re-using the exported ID. If adding records which are related (i.e. in multiple sheets), use the corresponding ID for the reference ID columns - each reference will have an ID column and a lookup column - drag down the lookup formula to check that your reference ID is referencing the correct record from the other sheet.
- Login with a user which has the
DevOps
role - Switch to power user mode if not already in there
- Navigate to the Admin module, and select
Data Maintenance
- From the Import/Export tab, select the destination Document for the import in the Bizport form
- Click
Import Data
- Click
Choose
to select the file to import - Click
Upload
- You will get a message that the import completed successfully if everything works, or the Problems table will highlight any issues if the import fails
Quick Import/Export
While Bizport allows import and export of complex relationships, an simpler option to bulk load data into or out of Skyve is to use the Quick Import/Export option.
Export Data
To export existing data from a Skyve application using the Quick Import/Export function:
- Login with a user which has the
DevOps
role - Navigate to the Admin module, and select
DevOps
->Data Maintenance
- From the Import/Export tab, click the
+
button in the Quick Import/Export table - Change the Mode to
Export Data
- Select the Module and Document you wish to export in the Configure Options section
- Click the
Download Data
button - Your browser will download the data as a Microsoft Excel file
- You can either Save this configuration to re-use it again, or click Cancel
Import Data
To import new data into a Skyve application using the Quick Import/Export function:
- Login with a user which has the
DevOps
role - Navigate to the Admin module, and select
DevOps
->Data Maintenance
- From the Import/Export tab, click the
+
button in the Quick Import/Export table - Leave the Mode as
Import Data
- Select the destination Module and Document for the import in the Configure Options section
- Click
Upload file
- Click
Choose
and use the file browser to locate your import spreadsheet. You can use an export with the Template only option selected to create an import spreadsheet, or select your own.xlsx
file. - Click
Upload
- Click the
x
in the top right corner to close the upload dialog - If the upload was successful, the Import Column table should be populated with the column headings from the spreadsheet.
- Modify any bindings in the Configure Import Column table to match the correct attributes of the destination Document
- Click
Import data from file
to load the data from the spreadsheet - You can either Save this configuration to re-use it again, or click Cancel