Importing data

You can import data into a grid page from:

  • Microsoft Excel Workbook
  • CSV (Comma-separated values)

  Note

For this feature to be available on a page, it must be added to the grid page, and the role that you belong to must have permissions to use this function on that page. Also, make sure that the file that you are going to import data from corresponds to the requirements in the configured action (has required unique fields). The fields that will be updated during import must be editable both for new records (the Editable on new check box must be selected in the grid field settings) and existing records (the Editable check box must be selected).

  Tip

To see how the imported file is expected to look, you can export data into Excel or CSV first. You can also use the combination of export and import when you need to edit a big number of records on a grid, and you'd like to do it in Excel: you export data, edit it in Excel, in then import it back into the portal. 

To import data from Excel/CSV

  1. Open a grid page where you want to import data from an Excel workbook or comma-separated values (CSV) file.

  2. Select the Import from Excel  action (the caption and icon are configurable, and may be different in you case).

  3. On the Choose file to import step, select the  icon, browse to the Excel or CSV file that you want to import data from, select Open, and then, select Upload.

      Note

    The format that you import data from depends on the configuration of the Import action. At this stage, the file is verified to satisfy conditions of the configured action (for example, it must contain columns (with field captions) that correspond to the unique fields configured for the action). If the file doesn't meet the requirements, an error message will be shown.

  4. In the Import options step, select data import options:

    1. Stop import on any error - If an error occurs, the import will be interrupted.

    2. Skip all errors and continue import - If errors occur, the import will continue. You will be able to see information about errors if any after the import is complete.

      You can see the number of records that will be imported and which fields will be updated.
      If duplicate validation is configured and enabled in the Import action settings, and during data import duplicated records are detected in the Excel/CSV file, information about duplicates is displayed in the Import options dialog window where you select how to handle errors during import.

  5. Select Continue.

  6. Wait until the import is completed.

  7. Once the import is completed, import summary is shown. Optionally, you can select Details to view detailed information about imported data.

      Note

    For the Details action to be available, the page that it opens must be configured and specified in the Report page field of the Import action settings. Otherwise, this button won't be shown on the import summary. See action settings for details on how to set up the report page.



    Select Hide to hide the details.

    If there were duplicate records during import, and you selected the Stop import on any error option, the import will stop on any error that occurs, including duplicated records. On the portal import data status report page (the PortalImportDataStatus source entity), which can be opened by using the Details button on the import summary page, duplicate records will be shown with the duplicate import status.

    If you selected the Skip all errors and continue import option, all records are imported except the ones with errors (duplicated records are also considered as records with errors). In this case, on the portal import data status report page (the PortalImportDataStatus source entity), which can be opened by using the Details button on the import summary page, duplicate records will be shown with the error import status.

  8. Select Close to close the import summary.

  9. Refresh the grid page to see imported records.