Generating user accounts

If you do not need to gather information about your users during the registration process we recommend generating accounts for your users. This means you do not have to wait for them to accept the invitation for their accounts to be generated and allows you to do things like viewing exam attempts and user profiles for them immediately.

As users can only be invited to one group at a time, generating accounts allows you to add them to additional groups immediately.

Finally, generating accounts means you can pre-generate accounts and passwords to be handed out to students via a proctoring solution or in person.

Using Synap's Generate accounts feature you can bulk generate users and passwords from a CSV or do a single account generation from the platform

✋ Before you start

• Make sure you have a group set up you want to generate users into

• Check the content assigned to that group is correct as users will have access right away

• Decide on how to handle passwords (will you ask your users to reset or will you give them their passwords separately)

• Decide whether you want your users to get a welcome email or not.

• Check your portals user attributes (more here) as you'll need to include 'required at registration' attributes on your import sheet

• If you're importing, get your import template from the import page of the group, this will include your attribute headers

Information for generating accounts

name = required

email = required

language = optional. See language codes below

timezone = optional. See format below

attributes = If required on registration If you have custom user attributes in your portal, you can add the ID of an attribute as a header in the CSV

password = If you want to give these users a known password, include a password column on the CSV, passwords must be at least 8 characters long, with at least one upper case letter, one lower case letter and one number. If not provided or left blank, a password will be generated for the user and provided to you by email.

📧 Disable welcome emails

On either option for generating accounts, welcome emails can be disabled which is recommended if you're generating accounts to use in test centres of for high stakes exams and you want to hand out passwords manually.

🧍‍♂️ Generating a single account

On a user group go to Manage > Import users > Generate account

From here you'll get a pop up modal to fill in all of the details of the account. Including name, email and password which are all required. If you disable the welcome email you must provide values for any attributes that are required on registration. Go to Settings > Data Management > User attributes to see which attributes are required on platform.

Once you've inputted all the information, as soon as you click generate a user account will be set up and you'll find them in the users table for the group. Be mindful that if you have any content set to that group that has automated emails - your new user will get those automatically.

Bulk Generating accounts

You can create a CSV with multiple accounts and passwords you want to generate. You must use different passwords for each user on your sheet. Go to the group you want to generate users in then Manage > Import users > Download CSV template > Generate accounts. The template you download will be custom based off the attributes you have on your portal. Your attribute values must be formatted properly and attributes that are set to required on registration must have values for each user in a row and those values must be in the correct format

Attribute types and required CSV format

Format your sheet set making sure you have all the correct and compulsory information set on each row. In the example below the sheet has been colour coded with the default compulsory fields of name, email, password are highlighted in yellow, with 2 compulsory at registration attributes shown in red. And the non compulsory attributes in green, you can see some of these are left blank

From here save that sheet as a CSV and upload it to platform. If there are any errors you'll be notified of any formatting errors and the upload won't happen for any users.

Once your accounts have been generated you'll be sent a summary sheet confirming the passwords and other information that was created with the user. Double check this to make sure all the information is right.