Skip to main content
Eptura Knowledge Center

Create your own Import File

Level: System Administrator

You can create your own import file from the sample import file. Complete the following steps.

Step 1. Download the sample import file

From the Imports screen, complete the following:

  1. Navigate to Admin Settings > Data Imports > Data Imports.
  2. Click an import heading. For example, Workpoint import.

worddav87e0b28307837fe6c808e7ddeeff6e09.png

3. Click the Get sample import file link. The sample .csv file downloads e.g. Import schema for Workpoint Import.csv

4. Open the csv file in Microsoft Excel.

worddava4e674ccb900f468564c29bfcea934d4.png

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.