NOTE: This is a DistributionDocument. Please help maintain high quality documentation: This is a wiki, please fix the documentation if you find errors or incomplete content. Put questions and suggestions concerning the documentation of this topic in the comments section below. Use the Support web for problems you are having using TWiki.

Bulk Registration

The TWikiAdminGroup can use BulkRegistration to register (i.e. create logins and UserTopics? ) for a group of people quickly. Create a table in the REGISTERTOPIC named below, setting each row to represent each user and each column to correspond to the metadata. Then press the button on this page to perform registration for those users. 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

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
• Email
• FirstName
• LastName

Optional fields

• LoginName - if not set will register with WikiName

Settings

• • Set REGISTERTOPIC = UnprocessedRegistrations?
  • Set LOGTOPIC = UnprocessedRegistrationsLog?

• • Set OVERWRITEHOMETOPICS = 0

Example format

| FirstName | LastName | Email | WikiName | CustomFieldThis | SomeOtherRandomField | WhateverYouLike |
| Test | User | you@example.com | <nop>TestUser | A | B | C |

To use this:

1. Make sure that the Custom fields appear on the UserForm
2. Copy the above table to your clipboard
3. Click through and paste this on UnprocessedRegistrations? , save the topic and return here.
4. Click the Bulk register button below
5. Read UnprocessedRegistrationsLog?
6. When you are ready, use the BulkResetPassword page to assign passwords and notify the users of their new accounts.

Notes:

1. The first row of the table dictates the heading format and that the fieldnames must be plain, i.e. must not contain bolded entries.
2. You are responsible for ensuring that the fieldnames appear in the Main.UserForm
3. Only members of the TWikiAdminGroup can run this.

UnprocessedRegistrations?

Warning: Can't find topic Main.UnprocessedRegistrations

UnprocessedRegistrationsLog?

Warning: Can't find topic Main.UnprocessedRegistrationsLog

Related Topics: AdminToolsCategory

Comments & Questions about this Distribution Document Topic

| Test | User | you@examplePLEASENOSPAM.com | TestUser | A | B | C |

When I try the above steps to bulk register, I get an error, "TWiki detected an internal error - please check your TWiki logs and webserver logs for more information.

Can't locate object method "new" via package "FileHandle" (perhaps you forgot to load "FileHandle"?)" The file /twiki/data/warn200605.txt has the below entry in the end:

| 29 May 2006 - 20:36 | Can't locate object method "new" via package "FileHandle " (perhaps you forgot to load "FileHandle"?) at /twiki/lib/TWiki/Data/DelimitedF ile.pm line 36. TWiki::Data::DelimitedFile::read('content','','delimiter','|') called at /twiki/lib/TWiki/UI/Register.pm line 215 TWiki::UI::Register::bulkRegister('TWiki=HASH(0x87ee640)') called at /tw iki/lib/TWiki/UI/Manage.pm line 59 TWiki::UI::Manage::manage('TWiki=HASH(0x87ee640)') called at /twiki/lib/ TWiki/UI.pm line 97 TWiki::UI::__ANON__() called at /twiki/lib/CPAN/lib///Error.pm line 387 eval {...} called at /twiki/lib/CPAN/lib///Error.pm line 379 Error::subs::try('CODE(0x8a1df94)','HASH(0x8a1e258)') called at /twiki/l ib/TWiki/UI.pm line 146 TWiki::UI::run('CODE(0x81d9cd8)') called

-- RaghuSarangapani - 29 May 2006

Please ask support questions in the Support web.

-- PeterThoeny - 29 May 2006