Skip to main content
Eptura Knowledge Center

Download a report and prepare an import

Level: System Administrator

If you want to use an import that contains existing data, then you can download an import report. Complete the following steps.

Step 1. Download the report

These reports have been set up to assist with imports and the Import Reports are:

Import Report Import to Use Updates

139 My Workplace Occupancy Report

Occupancy Import

Bulk updates occupancy.

The update can be seen in the Block and Stack.

141 Workpoint Properties Report Workpoint Import

Bulk updates workpoints.

The update can be seen in the Block and Stack.

150 Asset Export Report

Asset Import

Bulk update to assets.

The update can be seen in either Storage, Lockers, or Parking. This will depend on what data was updated.

303 Import - Allocation to Desk Report Team Import

Bulk update of teams and neighborhoods to a desk level and this supports fixed teams, flexible teams and neighborhoods.

The update can be seen in the Block and Stack.

304 Import - Allocation to Floor Report Team Import

Bulk update of teams and neighborhoods to a floor level and this supports fixed teams, flexible teams and neighborhoods.

The update can be seen in the Block and Stack.

305 Import - Occupancy to Desk Report Occupancy Import

Bulk update of people to workstations.

The update can be seen in the Block and Stack.

306 Import - Occupancy to Existing Team Report Occupancy Import

Bulk update of people into existing teams.

The update can be seen in the Block and Stack.

307 Import - Occupancy to New Team Report Occupancy Import

Bulk update to create teams and import people into the new teams.

The update can be seen in the Block and Stack.

  Space Type Hierarchy Import

Bulk updates the Space Type Hierarchy.

The update can be seen in Admin Settings > Reference Data > Space Types.

Refer to Validate Space Type Hierarchy.

323 Space Classification Import Report

Space Type Classification Import

Bulk updates Space Type Classification.

The update can be seen in the keyword called Space Classifications.

In this example, the report 141 Workpoint Properties Report is used to set up an import file.

  1. Navigate to Insights > Reporting.
  2. Search and select 141 Workpoint Properties Report.
  3. Filter for the building and floor.
  4. Launch and download the report.
  5. Open the 141 Workpoint Properties Report in Excel. For report details, refer to 141 Workpoint Properties Report

Step 2. Complete the CSV file using the expected schema

The import contains an expected schema that you can use to complete the CSV file.

  • Click the Show expected schema link.

Expected Schema

worddav6b3e9b24d962652d2b4ea9c1134a0f16.png
The expected schema displays:

Column

Description

Column Name

The column name is used in the import file's column header and it must comply to the following:

  • must be an EXACT match - e.g. Cost Center will cause the import to fail.
  • are case sensitive - e.g. cost centre will cause the import to fail.
  • no additional spaces - e.g. CostCentre will cause the import to fail.

Column Required?

Is the column required?

  • Yes - Group 'XXX Unique Identifier' – You must have at least one of those identifier columns. For example, if you are running the Occupancy Import (to update the allocation of people to workpoints), there are three different ways to identify a person in your import - by EmployeeNo, Email or LogonName. The import will succeed if at least one is included (and all other data requirements are met).
  • Yes – You must include this column header, even if it is a column header with no data.
  • No – This is an optional column.

Value Required?

Is the value required?

  • Yes - Group 'XXX Must have a XXX name or number'
  • Yes – Every row to be imported must have data.
  • No – This is an optional value.

Unique?

Is the value unique?

  • Yes - Group 'XXX identification – The value must be unique.
  • Yes – The value must be unique.
  • No – The value can be non-unique.

Custom Fields

If you need to import data into custom fields then you will need a report that contains the custom fields. For more information on Custom Fields, refer to Custom Fields.

Step 3. Check that the column's header row matches the import schema's column names

The first row of the CSV file will contain the Column Names. Check that the header row matches the expected schema.

For example:

worddav16b00a8ea7722ccbc5d80f4222ed804b.png

Step 4. Remove unnecessary cells and worksheets

  • Remove additional tabs, even if they are blank. If you have more than one worksheet (tab) in your file, the file will not be read.
  • Remove all empty border columns and rows.
  • With non-required columns that do not have any data, you can delete them. The exception is when a column is required but a value is not then you can keep these columns as place-holders.

For example:
worddav5d324d6649b067e354166cfc4be3e29c.png

Step 5. Remove or preserve table formatting

If your data contains any values that starts with a zero you will need to prevent removal of zeros when you clear the table formatting. For example, employee numbers in the format of 00035463.

To prevent removal of zeros from columns.

  1. Open your file in Excel.
  2. Select the column(s) that contain number format that you want to preserve.
  3. Right-click the column. A popup menu displays.
  4. Select Format Cells.
  5. In the Category list.
  6. Select Text.
  7. Click the OK button.

To remove the number, text, etc formatting from columns.

  1. Open your file in Excel.
  2. Select the column(s).
  3. From the ribbon, click the Home tab.
  4. In the Editing group, click the Clear drop-drop arrow. The drop-down menu displays.
  5. Click the Clear Formats item.

Step 6. Test your import file

Serraview recommends that you always perform a trial run.

When your import file is ready and saved, you can complete a trial run. This will show you how you how Serraview will read the import file and if the file will be successful or cause warnings and errors. Refer to Trial Run Imports for details on how to complete a trial run.

Step 7. Run your import file

After you have completed the trial run and you know the file will be successful then you can complete the import .

  1. From the import screen, for the Trial Run untick the check box.
  2. For the Import File, click the Choose File button.
  3. Navigate to and select the import file.
  4. Click the RUN! button. The Import Summary displays.

The import file will be recorded in the Recent Imports, refer to View Recent Imports.