Skip to main content
Eptura Knowledge Center

Import People Data

Eptura - Directory

Level: Administrator

Your Administrator can upload your people data into the directory.

Step 1. Open the Import People Data form

  1. From the Home screen, click the Directory tool and the Directory screen displays.
  2. From the People tab, click the Add person drop-down.

clipboard_97a1a251-81d9-4862-85a7-b4d74f4ec97d.png

  1. Select the Import people data and the People data import panel displays.

clipboard_50d534eb-a5b9-4c85-82e8-2c06f14a3592.png

Step 2. Download and prepare the file

  1. Click the sample_file.xlsx button and the file is downloaded.
  2. Navigate to the downloads folder and open the file.
  3. Complete the data in the spreadsheet and the People Data Requirements and Business Rules for the Standard Fields, Custom Fields, and App Access are listed below.

clipboard_e634c03be3bcc9ab618d6b3741f6c6c0c.png

Note there is a panel that contains the fields and the descriptions; click the View formatting requirements and business rules link.

clipboard_ff53d03c-d136-4b3a-ba21-60dcc76fcf4c.png

Step 3. Upload your file

  1. In the Upload your file area, either: drag and drop the file onto the area OR click the Browse file link to browse to the file and select it. Then the file uploads.
  2. Click the Review your data button.

clipboard_7b5c48c0-7780-4d8a-a07a-efc81e64151a.png

Data Error

If your data has errors, complete the following:

  1. Click the Download error list button and the .XLSX file will download.
  2. When you open the file, it will contain an error description and you can correct the error(s) in the original file.
  3. Click the < icon to return to the People data import.
  4. In the Upload file, click the Delete clipboard_12e64f72-6af1-4bd9-b6a1-abc79c4172b0.pngicon to remove the file.
  5. The Confirm deletion dialog displays, click the Yes, delete button.
  6. In the Upload your file area, either: drag and drop the file onto the area OR click the Browse file link to browse to the file and select it. Then the file uploads.
  7. Repeat the review procedure.

clipboard_8c879c80-75de-4176-b338-857998ed6ff6.png

  1. After you have reviewed and corrected any data errors, click the Complete Import button and the file is uploaded.

People Data Requirements and Business Rules


Standard Fields

Field Name Required Field Business Rules
First Name Yes

Accepts any value

Max 40 char

Middle Name No

Accepts any value

Max 40 char

Last Name Yes

Accepts any value

Max 40 char

Preferred Name No

By default, Preferred name = First Name

Accepts any value

Max 40 char

Email Yes

Format: xxx@yyy.zzz

Must be unique

If you need to change the email address, you will need to delete the user (this causes the removal of the historical records for the user), and then you can add a new person.

If you don't delete the user, then you will have duplicate records for the person.  For example: 

  • jon.smith@company.com
  • jonathan.smith@company.com

See the end of the table for details about the Delete flag.

Mobile Number No

Numeric values

Min 4 digits

Max 17 digits

Space not allowed

Phone Number No

Numeric values

Min 4 digits

Max 17 digits

Space is not allowed

Extension No

Numeric values

Min 1 digit

Max 4 digits

Space is not allowed

Person Type No From the drop-down, select either Internal, Partner accounts, Strategic Decision Maker, or Support,
Person finder opt out No

From the drop-down, select either No or Yes.

Default = No

Special requirements No

From the drop-down, select either No or Yes.

Default = No

Is form user Yes

From the drop-down, select either No or Yes.

Changing the user's authentication method, SSO/Form, will impact their login experience.

Comments No Accepts any value
Employee ID No

Accepts any value

Special characters not allowed

Job title No

Accepts any value

Special characters allowed

Department No Values provided must exactly match Department preconfigured in the system (Case insensitive)
Work Mode No

From the drop-down, select either In-office, Hybrid or Full-time Remote.

Default = None

Manager No

Format: xxx@yyy.zzz

Email provided must exactly match in the person records created in the system

HR Location No Accepts any value
Device login name No Accepts any value
Life Safety Role No

From the drop-down, select either Fire Warden, First Aid Officer, or CPR Certified.

Default = None

Preferred work schedule No

Default = None

Data format: *{Day of the week (Case insensitive)}~{Start hour in HH:00 format}~{End hour in HH:00 format}*

Sample data: *Saturday~15:00~19:00*sunday~15:00~19:00*Monday~09:00~05:00*TUESDAY~09:00~05:00*

Eptura Workplace 

No

From the drop-down, select either No or Yes.

Default = None

Eptura Asset No

From the drop-down, select either No or Yes.

Default = None

Eptura Engage No

From the drop-down, select either No or Yes.

Default = None

Eptura Visitor No

From the drop-down, select either No or Yes.

Default = None

Envision     No

From the drop-down, select either No or Yes.

Default = None

Devicehub No

From the drop-down, select either No or Yes.

Default = None

Delete No

From the drop-down, select either No or Yes.

Default = No

If the value is set to "Yes", the existing person's records will be deleted from the system.

Custom Fields

Inputs for the custom fields are optional.

Your Administrator will need to create the Custom Fields, before the data can be imported in.