TWiki > ManagingUsers > BulkRegistration	Daya Bay webs: Public | 中文 | Internal | Help
			Log In or Register

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

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 topic: create a table of new users. An example table is provided below to copy.
3. Return to this topic and press the button "Bulk Register" to create the new topics.
4. Read UnprocessedRegistrationsLog to verify if all has gone well.
5. 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
  • Set REGISTERTOPIC = UnprocessedRegistrations
• Use this to define where to log the bulk registration process. It needs to be a topic name in this 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

Example format

<noautolink>
%EDITTABLE{}%
| FirstName | LastName | Email | WikiName |
| Test | User | you@example.com | 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 - if not set will register with WikiName

Customized table example

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

Public.UnprocessedRegistrations

Public.UnprocessedRegistrationsLog

Report for Bulk Register

Registering DybGuest

You are already registered

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

Did you want to reset dybguest's password ?

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

Please contact mwang@ihep.ac.cn if you have any questions.

• Failed to add user: New password did not match existing password for this user at /home/twiki/lib/TWiki/Users/TWikiUserMapping.pm line 288.

Related Topics: AdminToolsCategory