Lotus LearningSpace R5.01 Deployment Guide

Chapter 14. Populating with users 191

– If you plan to import users from text file and use auto-enrollment with

profiles during the import process. This is restricted by the import process,

where you can assign only one profile to a user per category.

– If you plan to create Profile Progress Comparison reports. If profiles had

common members, then the report would show the students in both

profiles, and this would be confusing.

14.1.3 Reduced database diagram for permissions

The reduced diagram in Figure 14-3 can help you understand the underlying

database structure. Note that the tables show only the profile-related fields.

Figure 14-3 Profile-related tables in LearningSpace

For details on the database structure, see Chapter 4, “Database Architecture” in

LearningSpace 5.01 System Administrator’s Guide.

14.2 Registering users

User registration is a necessary task, right from the beginning. According to the

scenario you use to deploy LearningSpace, there are several way to register

users:

򐂰 Manual user registration

򐂰 Importing users from a text file

Tip: A permission is granted if the PUINT contains the record describing the

relation between the Profile (UPROFS) and the Permission (PERMS). Every

record in PUINT stands for a granted permission for one profile item. There

are no explicit records that deny rights. The lack of a right-granting record

implicitly denies that right.

192 Lotus LearningSpace R5.01 Deployment Guide

򐂰 Importing users from existing HR systems

򐂰 Importing users from a Domino server

14.2.1 Manual user registration

For details about manual user registration and self-rostering, see Chapter 2 of

the LearningSpace 5.01 Course Administrator’s Guide, and Chapter 6 of the

LearningSpace 5.01 System Administrator’s Guide.

During registration the User Profiles can be selected.

Figure 14-4 All User Profile categories’ profile can be set during user registration

A precise description of the fields and their requirements can be found in the

LearningSpace 5.01 System Administrator’s Guide.

Important tip: Set up the user profiles before registering users. Although you

can do it after registration, that method is a little more complicated.

Tip: The Profile fields for each Profile Category are on the right side of the

panel. You can select several items by holding the CTRL key while clicking.

Tip: You can use the User ID field to connect the user data with another

RDBMS or HR system. Define the value to be a foreign key for the RDBMS

user table.

Chapter 14. Populating with users 193

14.2.2 Importing users from a text file

Importing users from a text file can be a much easier way of registering users.

You will need a structured list of the users in a delimited text file (see

Example 14-1). The format of the file is defined in Chapter 7 of the

LearningSpace 5.01 System Administrator’s Guide.

To be able to import users from a text file, you need to have the appropriate

permissions for one of your profiles (see 14.1.1, “User profiles - controlling

access” on page 187).

Example 14-1 Comma delimited text file to import users

'Last001','First001','lname001','password','001','No','[e-mail]','Stude

nt','Profile01','Profile03'

'Last002','First002','lname002','password','002','No','[e-mail]','Stude

nt','Profile01',''

'Last003','First003','lname003','password','003','No','[e-mail]','Stude

nt','Profile01','Profile03'

During the import, auto-enrollment for the obtained profiles can be set (see

Figure 14-5 on page 194).

Attention: Although you can define multiple columns for the same Profile

Category, the import process seems to ignore all but the latest occurrence.

However, you do not have to define a profile from each existing category. You

can even leave out some of the categories from the text file structure.

194 Lotus LearningSpace R5.01 Deployment Guide

Figure 14-5 Defining an input file, format, and auto-enrollment for importing users

Auto-enrollment is discussed in 16.2, “Auto-enrollment using user profiles” on

page 232.

In the next step you can describe the structure of the text file by providing the

field order, as shown in Figure 14-6.

Figure 14-6 Defining the import file structure