Bulk Registration

Administrators can use this topic to register (i.e. create logins and user topics) for a group of people in one batch.

Unlike normal registration the administrator is assumed to have correct e-mail addresses for the users, so no verification is required. Note that the new users are not notified that they have an account. This is so you can prepare and verify the accounts before announcing them. To announce them use the BulkResetPassword feature: this will assign a new random password and notify users.

Bulk Registration usage

Note: this is an administrator job - only admistrators can run this.

If you are administrator, you will take these actions:

1. (First time use) Create new bulk registration topics (see Settings below).
2. In the REGISTERTOPIC (UnprocessedRegistrations) topic: create a table of new users. An example table is provided below to copy.
3. Return to this topic and press the "Bulk Register" button to create the new topics.
4. Read UnprocessedRegistrationsLog to verify if all has gone well.
5. Visit WikiGroups if the new users need to be added to any groups.
6. When you are ready, use the BulkResetPassword page to assign passwords and notify the users of their new accounts.

Below are the details.

Settings

• Define where to pick up the table of users to register. It can be in any web, but defaults to the Main web.
  • Set REGISTERTOPIC = UnprocessedRegistrations
• Use this to define where to log the bulk registration process. It will be saved to the Main web.
  • Set LOGTOPIC = UnprocessedRegistrationsLog
• Set this to 1 to make the bulk registration overwrite any existing user topics. By default, existing user topics are left alone.
  • Set OVERWRITEHOMETOPICS = 0

The user table

This table is a template for user data that will be written to the new user topics. If you stick to these basic fields you can just use the first example below. If you want to write more data (like phone number or country) read the section Customizing user data as well.

If the Password field is not included, then use the BulkResetPassword topic to assign new passwords. If a password is included, it must be a valid password (> minimum length, etc.)

Your system is configured to use Login Names. Be sure to include the LoginName column in your table

Example format

The following should be inserted into your UnprocessedRegistrations as a table. This is the most simple format:

<noautolink>
%EDITTABLE{}%
| FirstName | LastName | Email | WikiName |
| Test | User | you@your.domain | TestUser |
</noautolink>

Usage:

1. Copy this text to your clipboard
2. Click through and paste this on UnprocessedRegistrations.
3. Add and customize entries, save table. Note that the first row must not contain bolded entries, so don't apply any formatting.
4. Return here

Customizing user data

You can write additional data to the new user topics. Do this by enhancing the user table with additional field names as table headers.

Any fields you define in this table will end up in the User's topic. If a form (such as UserForm) is attached to NewUserTemplate then the data will go in as META:FIELDS, meaning that you can use SEARCH formfield constructs to search.

If you use the UserForm then ensure that it contains all the fields you define here. Otherwise they will disappear when the user edits their home topic!

Mandatory fields

• WikiName
• FirstName
• LastName

Optional fields

• LoginName - Required if the system is configured to AllowLoginName (Commonly referred to as the UserName).
• Email - If not provided, you must set a password, or password reset will not be possible.
• Password - If not provided, set passwords later using BulkResetPassword.
• Confirm - If provided, it must match the Password field. If missing, it will not be checked.
• templatetopic - Template used when creating the User topic. If not provided, defaults to NewUserTemplate, or NewUserTemplate.
• AddToGroups - A comma-separated list of groups. When user is registered, they will be added to the listed groups. The groups must exist.

Customized table example

Make sure that the extra fields also appear on the UserForm.

<noautolink>
%EDITTABLE{}%
| FirstName | LastName | Email | WikiName | AddToGroups | CustomFieldThis | SomeOtherRandomField | WhateverYouLike |
| Test | User | you@example.com | TestUser | MyGroup, DocGroup | A | B | C |
</noautolink>

---

 

Main.UnprocessedRegistrations

FirstName	LastName	Email	WikiName	LoginName
Steve	Gray	swg2@cornell.edu	SteveGray	swg
Sasha	Temnykh	abt6@cornell.edu	SashaTemnykh	st
Ernie	Fontes	ef11@cornell.edu	ErnieFontes	ef11
David	Rice	david.rice@cornell.edu	DavidRice	dhr
Michael	Billing	mgb9@cornell.edu	MichaelBilling	mgb
David	Rubin	david.rubin@cornell.edu	DavidRubin	dlr
Yulin	Li	yulin.li@conrell.edu	YulinLi	yl67
Alexander	Mikhailichenko	aam10@cornell.edu	AlexanderMikhailichenko	mikhail
John	Sikora	jps13@cornell.edu	JohnSikora	jps
Suntao	Wang	sw565@cornell.edu	SuntaoWang	sw565
Sol	Gruner	smg26@cornell.edu	SolGruner	smg26
Ritchie	Patterson	ritchie.patterson@cornell.edu	RitchiePatterson	ritchie
Don	Hartill	dlh13@cornell.edu	DonHartill	dlh
Ralf	Eichhorn	r.eichhorn@cornell.edu	RalfEichhorn	rge39
Georg	Hoffstaetter	georg.hoffstaetter@cornell.edu	GeorgHoffstaetter	hoff
Ivan	Bazarov	bazarov@cornell.edu	IvanBazarov	ib38
Matthias	Liepe	mul2@cornell.edu	MatthiasLiepe	liepe

Main.UnprocessedRegistrationsLog

Report for Bulk Register

Registering StephenGray

You are already registered

You cannot register twice, the name 'swg' is already registered.

Did you want to reset swg's password?

Alternatively hit back to go back to UserRegistration and choose a different username.

Please contact twiki@lepp.cornell.edu if you have any questions.

• Failed to add user: New password did not match existing password for this user at /mnt/wiki/classe-1.1.7/lib/Foswiki/Users/TopicUserMapping.pm line 294.

Registering SashaTemnykh

• SashaTemnykh has been added to the password and user mapping managers
• Writing topic SashaTemnykh
• RegistrationHandler:
  • Using Form Fields

Registering ErnieFontes

You are already registered

You cannot register twice, the name 'ef11' is already registered.

Did you want to reset ef11's password?

Alternatively hit back to go back to UserRegistration and choose a different username.

Please contact twiki@lepp.cornell.edu if you have any questions.

• Failed to add user: New password did not match existing password for this user at /mnt/wiki/classe-1.1.7/lib/Foswiki/Users/TopicUserMapping.pm line 294.

Registering DavidRice

• DavidRice has been added to the password and user mapping managers
• Writing topic DavidRice
• RegistrationHandler:
  • Using Form Fields

Registering MikeBilling

• MikeBilling has been added to the password and user mapping managers
• Writing topic MikeBilling
• RegistrationHandler:
  • Using Form Fields

Registering DavidRubin

• DavidRubin has been added to the password and user mapping managers
• Writing topic DavidRubin
• RegistrationHandler:
  • Using Form Fields

Registering YulinLi

• YulinLi has been added to the password and user mapping managers
• Writing topic YulinLi
• RegistrationHandler:
  • Using Form Fields

Registering AlexanderMikhailichenko

• AlexanderMikhailichenko has been added to the password and user mapping managers
• Writing topic AlexanderMikhailichenko
• RegistrationHandler:
  • Using Form Fields

Registering JohnSikora

• JohnSikora has been added to the password and user mapping managers
• Writing topic JohnSikora
• RegistrationHandler:
  • Using Form Fields

Registering SuntaoWang

• SuntaoWang has been added to the password and user mapping managers
• Writing topic SuntaoWang
• RegistrationHandler:
  • Using Form Fields

Registering SolGruner

• SolGruner has been added to the password and user mapping managers
• Writing topic SolGruner
• RegistrationHandler:
  • Using Form Fields

Registering JRitchiePatterson

You are already registered

You cannot register twice, the name 'ritchie' is already registered.

Did you want to reset ritchie's password?

Alternatively hit back to go back to UserRegistration and choose a different username.

Please contact twiki@lepp.cornell.edu if you have any questions.

• Failed to add user: New password did not match existing password for this user at /mnt/wiki/classe-1.1.7/lib/Foswiki/Users/TopicUserMapping.pm line 294.

Registering DonaldHartill

• DonaldHartill has been added to the password and user mapping managers
• Writing topic DonaldHartill
• RegistrationHandler:
  • Using Form Fields

Registering RalfEichhorn

• RalfEichhorn has been added to the password and user mapping managers
• Writing topic RalfEichhorn
• RegistrationHandler:
  • Using Form Fields

Registering GeorgHoffstaetter

• GeorgHoffstaetter has been added to the password and user mapping managers
• Writing topic GeorgHoffstaetter
• RegistrationHandler:
  • Using Form Fields

Registering IvanBazarov

• IvanBazarov has been added to the password and user mapping managers
• Writing topic IvanBazarov
• RegistrationHandler:
  • Using Form Fields

Registering MatthiasLiepe

• MatthiasLiepe has been added to the password and user mapping managers
• Writing topic MatthiasLiepe
• RegistrationHandler:
  • Using Form Fields

---

---

Related topics: AdminToolsCategory