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 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
  • Use this to define where to log the bulk registration process. It needs to be a topic name in this web.
  • 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.

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@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

Customized table example

Make sure that the extra fields also appear on the UserForm.
<noautolink>
%EDITTABLE{}%
| FirstName | LastName | Email | WikiName | CustomFieldThis | SomeOtherRandomField | WhateverYouLike |
| Test | User | you@example.com | TestUser | A | B | C |
</noautolink>


Sorry, the password system is currently read only, please contact wikiwiz@math.cornell.edu
 

Main.UnprocessedRegistrations

FirstName LastName Email WikiName LoginName OrganisationName
Tara Holm tsh@math.cornell.edu TaraHolm tsh33 Cornell University

-- SteveGaarder - 10 Feb 2009

Main.UnprocessedRegistrationsLog

Report for Bulk Register

TaraHolm

  • Added to users topic TWikiUsers:
  • Password set OK
    • Writing topic TaraHolm
      • RegistrationHandler: %SPLIT% * * %KEY%: %VALUE%%SPLIT% * * ---++ My Links * * * ATasteOfTWiki - view a short introductory presentation on TWiki for beginners * * WelcomeGuest - starting points on TWiki * * TWikiUsersGuide - complete TWiki documentation, Quick Start to Reference * * Sandbox - try out TWiki on your own * * UnprocessedRegistrationsLogSandbox - just for me * * * * * * ---++ My Personal Data * * Note: if personal data is being stored using a secret database, then it is only visible to the user and to administrators. * * | E-mail | %USERINFO{"UnprocessedRegistrationsLog" format="$emails"}% | * * ---++ My Personal Preferences * * Uncomment preferences variables to activate them (remove the #-sign). Help and details on preferences variables are available in TWikiPreferences. * * * Show tool-tip topic info on mouse-over of WikiWord links, on or off: * * #Set LINKTOOLTIPINFO = off * * ---++ Related Topics * * * ChangePassword for changing your password * * ChangeEmailAddress for changing your email address * * TWikiUsers has a list of other TWiki users * * UserDocumentationCategory is a list of TWiki user documentation * * UserToolsCategory lists all TWiki user tools * * * ---- * Notes to TWiki Administrator: * * Anything inside this "templateonly" section will not be copied to the home topic of the new user. It is a resource for the administrator to tailor the users home topic. * * On public TWiki's on the Internet user topics are often subject to spam so you may want to limit editing to the user himself. You can do this by moving these two lines to the Personal Preferences section above. Remove the small # in front of the "Set". * * Write protect your home page: (set it to your WikiName) * * #Set ALLOWTOPICCHANGE = TWikiGuest * * The default topic text above is for English speaking users. If you have a multilingual wiki community you can replace the "My Links", "Personal Preferences" and "Related Topics" sections above with the localized text below. Text enclosed in %MAKETEXT will be shown in the language selected by the user. Please note that the %MAKETEXT can be quite intimidating to new users. Consider translating above text to your own language if your community uses a non-English language. (Remove all text from %STARTSECTION{type="templateonly"}% to %ENDSECTION{type="templateonly"}% when you are done) * * Text for multilingual wiki community, copy from here to %ENDSECTION{type="templateonly"}% * * * ---++ My Links * * * ATasteOfTWiki - view a short introductory presentation on TWiki for beginners * * WelcomeGuest - starting points on TWiki * * TWikiUsersGuide - complete TWiki documentation, Quick Start to Reference * * Sandbox - try out TWiki on your own * * UnprocessedRegistrationsLogSandbox - just for me * * * * * * ---++ Personal Preferences * * Uncomment preferences variables to activate them (remove the #-sign). Help and details on preferences variables are available in TWikiPreferences. * * * Show tool-tip topic info on mouse-over of WikiWord links, on or off: * * #Set LINKTOOLTIPINFO = off * * ---++ Related Topics * * * ChangePassword for changing your password * * ChangeEmailAddress for changing your email address * * TWikiUsers has a list of other TWiki users * * UserDocumentationCategory is a list of TWiki user documentation * * UserToolsCategory lists all TWiki user tools * *
      • Using Form Fields

registrationsMade: 1

Related Topics: AdminToolsCategory

Edit | Attach | Watch | Print version | History: r5 < r4 < r3 < r2 < r1 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r5 - 2010-05-15 - TWikiContributor
 
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 1999-2019 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback
Note: Please contribute updates to this topic on TWiki.org at TWiki:TWiki.BulkRegistration.