Importing users

You can import users and their associated security role by clicking the import icon.

The supported file types are .csv and xml. The .csv file must contain a header. The supported variables in the header are:

  • PersonId
  • EmailId
  • FirstName
  • LastName
  • Title
  • Department
  • UserAlias
  • Status (Active, Inactive, and Draft)
  • UserName
  • UserIdentifier
  • UPN
  • Picture
  • MinglePicture
  • GenericProperty_<PropertyName>
  • SecurityRole1, SecurityRole2, SecurityRole3,...SecurityRoleN

This table lists the field mapping of headers and columns in the .csv and xml file with the user properties:

Field name in import file Mapping in IFS
PersonId The IFS Person ID displayed on the user details page
EmailId The Email Address displayed on the user details page
FirstName The First Name displayed on the user details page
LastName The Last Name displayed on the user details page
Title The Title displayed on the user details page
Department The Department displayed on the user details page
UserAlias The M3 User Alias displayed on the user details page
Status The Status displayed on the user's listing page
UserName This is not displayed in the user interface
UserIdentifier The User ID displayed on the user details page
UPN The UPN displayed on the user details page
Picture The image on the user details page if MinglePicture is not provided
MinglePicture The image on the user details page (this takes precedence over Picture)
GenericProperty_<PropertyName> The property for the Landmark Actor ID and LN User are displayed on the user details page. All the other properties are displayed under the Additional Properties tab on the user details page.
SecurityRole1, SecurityRole2….SecurityRoleN The security roles association is displayed under the Security Role tab on the user details page

The UserIdentifier and UPN fields are required in the header row.

Note: If you want to add Security Roles or Generic Properties through this import process, you must use the XML file format. While importing with the CSV file format, Security Roles or Generic Properties that do not exist in the system are ignored.

To append a domain to a user identifier, you must enter the domain name in the text box.

To update existing users, you must select the Update existing users check box.

To activate deleted users, you must select the Activate deleted users check box along with the Update existing users check box. These options are disabled when the Create Users in Draft Status setting is enabled.

To disable current users who are not in the import file, you must select the Disable users that are not present in the import check box.

The import results are displayed in a popup window after the import process is successfully completed. The results include the count of users that were created, skipped, and updated. The Download Results link provides the results for each entry in the import file along with its result.

Caution: 
A user's email address must be unique. An email address cannot be shared between users.