Difference: BulkRegistration (1 vs. 5)

Revision 52010-05-15 - TWikiContributor

 
META TOPICPARENT name="ManagingUsers"

Bulk Registration

Changed:
<
<
Administrators can use this topic to register (i.e. create logins and user topics) for a group of people in one batch.
>
>
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
Changed:
<
<
>
>
 
  • 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.

Changed:
<
<
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.
>
>
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.
 
Changed:
<
<
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!
>
>
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

Changed:
<
<
Make sure that the extra fields also appear on the UserForm.
>
>
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>


<-- 
    • Set NOTMODIFYABLE =
-->
 

Main.UnprocessedRegistrations

Main.UnprocessedRegistrationsLog

Related Topics: AdminToolsCategory

Revision 42005-03-27 - TWikiContributor

 
META TOPICPARENT name="ManagingUsers"

Bulk Registration

Changed:
<
<
Administrators can use this topic 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.
>
>
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.

Deleted:
<
<
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.
Changed:
<
<
To announce them use the BulkResetPassword feature: this will assign a new random password and notify users.
>
>
To announce them use the BulkResetPassword feature: this will assign a new random password and notify users.
 

Bulk Registration usage

Added:
>
>
Note: this is an administrator job - only admistrators can run this.
 
Changed:
<
<
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 are administrator, you will take these actions:
Added:
>
>
  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.
 
Changed:
<
<
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!
>
>
Below are the details.
 
Deleted:
<
<

Mandatory fields

  • WikiName
  • FirstName
  • LastName

Optional fields

 

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
Added:
>
>

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

Changed:
<
<
The following should be inserted into your REGISTERTOPIC as a table.
>
>
The following should be inserted into your UnprocessedRegistrations as a table. This is the most simple format:
 
Changed:
<
<
FirstName LastName Email WikiName CustomFieldThis SomeOtherRandomField WhateverYouLike
Test User you@example.com TestUser A B C
>
>

<-- /editTable -->
Added:
>
>
FirstName LastName Email WikiName
Test User you@example.com TestUser
 
Changed:
<
<
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
>
>
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
Deleted:
<
<
  1. Read UnprocessedRegistrationsLog
  2. When you are ready, use the BulkResetPassword page to assign passwords and notify the users of their new accounts.
 
Changed:
<
<
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.
>
>

Customizing user data

Deleted:
<
<
  1. You are responsible for ensuring that the fieldnames appear in the TWiki.UserForm
  2. Only administrators can run this.
 
Added:
>
>
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>


 
<-- 
    • Set NOTMODIFYABLE =
-->
 
Changed:
<
<

UnprocessedRegistrations

>
>

Main.UnprocessedRegistrations

 
Changed:
<
<
Warning: Can't find topic Main.UnprocessedRegistrations
>
>
 
Changed:
<
<

UnprocessedRegistrationsLog

>
>

Main.UnprocessedRegistrationsLog

 
Changed:
<
<
Warning: Can't find topic Main.UnprocessedRegistrationsLog
>
>
 

Related Topics: AdminToolsCategory

Revision 32005-03-27 - TWikiContributor

 
META TOPICPARENT name="ManagingUsers"

Bulk Registration

Changed:
<
<
The TWikiAdminGroup can use BulkRegistration to register (i.e. create logins and UserTopics) for a group of people quickly.
>
>
Administrators can use this topic 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

Changed:
<
<
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.
>
>
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.
 
Changed:
<
<
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!
>
>
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

Changed:
<
<
>
>
  • WikiName
Deleted:
<
<
  • Email
 
  • FirstName
  • LastName

Optional fields

Settings

Added:
>
>
  • Define where to pick up the table of users to register
 
Added:
>
>
  • Use this to define where to log the bulk registration process. It needs to be a topic name in this web.
 
Changed:
<
<
>
>
  • Set this to 1 to make the bulk registration overwrite any existing user
Added:
>
>
topics. By default, existing user topics are left alone.
 
    • Set OVERWRITEHOMETOPICS = 0

Example format

The following should be inserted into your REGISTERTOPIC as a table.
| FirstName | LastName | Email | WikiName | CustomFieldThis | SomeOtherRandomField | WhateverYouLike |
| Test | User | you@example.com | TestUser | A | B | C |

To use this:

Changed:
<
<
  1. Make sure that the Custom fields appear on the UserForm
>
>
  1. Make sure that the Custom fields appear on the UserForm
 
  1. Copy the above table to your clipboard
  2. Click through and paste this on UnprocessedRegistrations, save the topic and return here.
  3. Click the Bulk register button below
  4. Read UnprocessedRegistrationsLog
  5. 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.
Changed:
<
<
  1. You are responsible for ensuring that the fieldnames appear in the Main.UserForm
  2. Only members of the TWikiAdminGroup can run this.
>
>
  1. You are responsible for ensuring that the fieldnames appear in the TWiki.UserForm
  2. Only administrators can run this.
 
Added:
>
>
<-- 
    • Set NOTMODIFYABLE =
-->
 
Changed:
<
<
 
>
>
 
Added:
>
>
 

UnprocessedRegistrations

Warning: Can't find topic Main.UnprocessedRegistrations

UnprocessedRegistrationsLog

Warning: Can't find topic Main.UnprocessedRegistrationsLog

Related Topics: AdminToolsCategory

Revision 22005-03-27 - TWikiContributor

 
META TOPICPARENT name="ManagingUsers"

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

Changed:
<
<
>
>
 

Optional fields

Changed:
<
<
>
>
 

Settings

Changed:
<
<
>
>
 
Changed:
<
<
    • Set OVERWRITEHOMETOPICS = 0
>
>
    • Set OVERWRITEHOMETOPICS = 0
 

Example format

The following should be inserted into your REGISTERTOPIC as a table.
| FirstName | LastName | Email | WikiName | CustomFieldThis | SomeOtherRandomField | WhateverYouLike |
| Test | User | you@example.com | TestUser | A | B | C |

To use this:

Changed:
<
<
  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.
>
>
  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:
Changed:
<
<
  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.
>
>
  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

Revision 12005-03-27 - TWikiContributor

 
META TOPICPARENT name="ManagingUsers"

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

Optional fields

Settings

    • Set OVERWRITEHOMETOPICS = 0

Example format

The following should be inserted into your REGISTERTOPIC as a table.
| FirstName | LastName | Email | WikiName | CustomFieldThis | SomeOtherRandomField | WhateverYouLike |
| Test | User | you@example.com | 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

 
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 1999-2024 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.