Bulk User Import

To create new users, navigate to Platform Configuration > Users > Groups and then click on the All Users Bulk Import button. This procedure allows administrators add new users as well as associated user roles, configuration bundles and other user parameters.

Create the User Upload File

1. Click on Bulk Add/Edit Users tab

2. Click to download either a sample CSV showing 10 of your users or all of your users

3. Edit the CSV file. Note Import of  CSV files is limited to 999 rows per import. The CSV format must be set to MS-DOS when saving from Excel and must contain the same column names as shown in the sample file

FieldDescription
First NameEnter the first name of the user (Required)
Surname (Last Name)Enter the surname of the user (Required)
EmailEnter the email address of the user (Required)
PasswordEnter a password for the user
Note Passwords must be set for all users even if they were provisioned using AD/LDAP or SSO. If the user already has a password from AD/LDAP or SSO the password set via CSV upload is ignored.
Groups:Administrator

Assign Group(s) and Group role(s) to to user
Note Group must be followed by a colon and a role value (e.g.- if the user should be a member of the A group without Group Administrator rights this would be shown as A:0). Multiple Group and Group Role assignments can be designated using a comma between designations.
Platform:file-encryption

Assign Platform permissions and File Encryption (if needed)
Note Platform permissions must be followed by a colon and a value for File Encryption (e.g.- if the user should have access to iOS and Web and use the platform's default encryption the value for this field would be shown as iOS:0,web:0). File Encryption is used on all bigtincan hub platforms and as such the encryption flag is only needed  for legacy Android platforms where encryption was an optional system setting.
Apple IDAdding the user's Apple ID will display it in the user's profile
Facebook PageAdding the user's Facebook ID will display it in the user's profile
LinkedInAdding the user's LinkedIn ID will display it in the user's profile
Skype IDAdding the user's Skype ID will display it in the user's profile
Twitter PageAdding the user's Twitter ID will display it in the user's profile
Custom 1 and Custom 2Adding a Custom value will add the value to the user's profile
User Default LanguageSets the default language.
Note This setting is not applicable to the Bigtincan mobile app, where the device language is used.
User Default Configuration Bundle
Choose the configuration bundle that you want to assign to the user. The Configuration Bundle name must be an exact match to an existing Configuration Bundle. To learn more on creating a configuration bundle, go to Creating a configuration bundle.
Enable Personal ReportsSets access to the Personal Reports feature. This is a numeric field. Use a 1 to allow the user to create and view personal reports or a 0 to disallow
TimezoneSet the timezone of the user. Note The timezone format is TZ
Digest EmailSets digest email delivery behavior. This is a numeric field.
0- Never
1- Daily
2- Weekly
3- Monthly
To learn more on configuring the digest email template, go to  Getting Started with Emails.

Upload the user import file

1. With the Bulk Add/Edit Users window open drag the user import CSV file on top of the window (or click the browse link to open a file browsing window).

2. Configure the import settings

Existing UsersIf users with an existing email address are found:
Skip- Skip existing users
Update- Update existing users
Send Invitation EmailDecides if invitations are sent to new users. This should be set to "No" when using SSO or AD/LDAP as the method for provisioning new users.
Default LanguageAdds/updates the default language settings for the web platform option
Import- Set from CSV file
Set Default- value is taken from User Default settings
Specific Language
GroupsAdds/updates Group membership and Group Administration rights (Required)
Import- Set from CSV
Set  Here- All users in CSV are assigned to 1 or more Groups selected from menu
Metadata attributesAdds/updates Metadata attributes
Import- Set from CSV
Set  Here- All users in CSV are assigned 1 or more Metadata attributes selected from menu
Configuration BundleAdds/updates the Configuration Bundle settings
Import- Set from CSV file
Set Default- value is taken from User Default settings
Specific Configuration Bundle
PlatformAdds/updates the Platform settings
Import- Set from CSV file
Set Default- value is taken from User Default settings
Specific Platform
Personal reportsAdds/updates Personal reports feature
Import- Set from CSV
Set  Here
TimezoneSets timezone for the user
Import- Set from CSV
Set Here
Send Digest EmailAdds/updates the Send Digest Email settings
Import- Set from CSV file
Set Default- value is taken from User Default settings
Set Here

3. Click Validate so that the system can preflight the CSV file.

4. Click Import.

Once the CSV has been accepted for processing a link to a status window will be shown at the bottom of the Bulk Add/Edit Users window. A large number of users import may take some time (e.g.- >1 hour for hundreds of users).