user manual

ManualsBrandsIBM ManualsWebcamWebcam R1

Table Of Contents

Customization Guide

Customization Guide June 2003

Learning Management System R1

sof twa re

Summary of content (94 pages)

PAGE 1
software Learning Management System R1 Customization Guide June 2003
PAGE 2
Disclaimer THE INFORMATION CONTAINED IN THIS DOCUMENTATION IS PROVIDED FOR INFORMATIONAL PURPOSES ONLY. WHILE EFFORTS WERE MADE TO VERIFY THE COMPLETENESS AND ACCURACY OF THE INFORMATION CONTAINED IN THIS DOCUMENTATION, IT IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. IN ADDITION, THIS INFORMATION IS BASED ON IBM’S CURRENT PRODUCT PLANS AND STRATEGY, WHICH ARE SUBJECT TO CHANGE BY IBM WITHOUT NOTICE.
PAGE 3
Pentium is a trademark of Intel Corporation in the United States, other countries, or both. Java, JavaServer Pages, JavaBeans, JavaScript, J2EE, JDBC, Sun Enterprise, and Sun Solaris are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. JReport and JReport Designer are trademarks of Jinfonet Software, Inc. in the United States, other countries, or both. Macromedia, Pathware, and Dreamweaver are registered trademarks of Macromedia, Inc.
PAGE 4
Table of Contents Chapter 1 Customizing the IBM Lotus Learning Management System User interface ........................................................................................................................... 1 A disclaimer and a word about conventions ....................................................................................... 2 Acronyms and abbreviations .................................................................................................................
PAGE 5
Removing fields from the Search pages ......................................................................................... 48 Chapter 7 Customization sets...................................................................................... 49 Creating a customization set................................................................................................................ 49 Installing a customization set on the Offline Learning Client.........................................................
PAGE 6
Chapter 1 Customizing the IBM Lotus Learning Management System User interface There are several ways you can tailor the IBM® Lotus® Learning Management System (LMS) interface to control the product's look and feel and the user's access to its features. Depending on the nature of the changes you want to make, customization can involve one or more of the following: • Changing default settings that affect what the user can see and do.
PAGE 7
Static text is resourced in .properties and .txt files in the properties (and, in the case of the LMM server, templates) directories for the LMM and Delivery servers and the Offline Learning Client (under source\resources). These directories contain resource bundles for the various languages that the LMS supports. Colors and fonts are typically specified in a Cascading Style Sheet (CSS) file.
PAGE 8
Acronyms and abbreviations Acronym or Abbreviation CSS DS DUC EAR (file) JSP LDAP LMM LMMS LMS LMSS SSO TLD (file) WAR (file) WAS WPS What it stands for Cascading Style Sheet Delivery Server Offline Learning Client (Disconnected Use Client) Enterprise Archive (file) JavaServer Page Lightweight Directory Access Protocol Learning Management Module Learning Management Module Server Learning Management System (can refer either to the application or just to the LMM) Learning Management System Server (same as L
PAGE 9
4 IBM Lotus Learning Management System Release 1 Customization Guide
PAGE 10
Chapter 2 Changing settings through the user interface or XML You can customize the application by changing various of the settings that are established when you first install and configure the system. There are three ways to do this: • Edit one or more of the XML files in which initial system values are stored. • Enter or change values in the Settings module of the Administrator interface. • Edit the application database directly, changing the appropriate record in the application_setting table.
PAGE 11
Changes that you make through the Administrator interface are written to the application_setting table in the application database and take precedence over settings in the XML files. If you want to revert to the values in the XML files, you need to delete the relevant record(s) in the application_setting table. Note: users can have the last word on preferences settings by making changes through the Preferences dialog box, which they can invoke from the Navigation bar.
PAGE 12
Chapter 3 Controlling access to features through permissions You can limit or expand users’ access to the application’s features and functionality by setting the permissions that define the roles that you assign to those users. These roles can either be ones that come prepackaged with the application (Anonymous, Student, Administrator, Instructor, and Manager) or ones that you create yourself.
PAGE 13
5. Enter the name of the new role and a description, and then click Save. This adds the role to the role list. 6. Click the name of the new role in the list. This displays the Role Details page. 7. Check the permissions you want to grant to users assigned this role in the various categories you can select from the category drop-down box. To modify permissions settings for an existing role 1. Open the Administrator interface. 2. Click the Users tab. 3. Click Manage Roles. 4.
PAGE 14
7. Click Continue. The application displays a dialog box from which you can assign roles by clicking Assign Roles. When you click Assign Roles, the application displays a list of the roles defined in the system. Select one or more of these to assign to the selected user(s). 8. Click Save to complete the role assignment(s).
PAGE 15
10 IBM Lotus Learning Management System Release 1 Customization Guide
PAGE 16
Chapter 4 Customizing Help Every Help topic consists of four files, all of which are editable: • The file that defines the layout of the graphical bar displayed at the top of every Help window. Student and Course Administrator Help topics have slightly different headers. • The file that defines the navigation bar containing a list of links at the left of every Help window. • The file containing the topic content. Topic content files are all named __b.
PAGE 17
The file sh_help_header_h.html defines the layout of the graphical bar that appears at the top of all Student interface Help topics, sh_help_navigation_l.html defines the navigation bar that appears on the left of each Student help topic containing links to other parts of the Help system, and sh_preferences_b.
PAGE 18
PAGE 19
} // -->

PAGE 20
Feedback on Help?

You can change the navigation bar’s display attributes by editing ns_style.css or ie_style.css (or both) or by pointing to a different Cascading Style Sheet of your own devising.
PAGE 21
You can ignore or remove the tags at the beginning of the file. These are used in generating the Index. Otherwise, you can edit this file as you would any other standard HTML file. Editing an existing Help topic Open the _b.html, edit it, and save your work. Replacing a context-sensitive Help topic You can replace a context-sensitive Help topic by linking to a different topic, which can be either another topic in the existing Help system or one that you write yourself.
PAGE 22
Note: You can replace a Help file with one in another directory by specifying the appropriate relative path and file name. For example, you might change the helpPage parameter in preferences.jsp to or, assuming that you had created and populated a myhelp directory at the same level as the student and course administrator Help directories, you might change the tag in the student home entry in Navigation.
PAGE 23
Your title goes here (for example, My Topic)
Your title goes here (for example, My Topic)

Your topic text goes here.
3. If you want to link to this topic from the Table of Contents, open sh_contents_b.html, enter the appropriate text, and save your work.
PAGE 24
Chapter 5 Customizing JavaServer Pages You can customize the Learning Management System application by customizing its JavaServer Pages.
PAGE 25
a user makes a request or performs an action, the server handles the action, and then retrieves the appropriate JSP to display the response in HTML. You can find documentation defining the JSP 1.2 specification, on which the LMS JSPs are based, at http://java.sun.com/products/jsp/. The servers in the LMS application display their responses to requests differently.
PAGE 26
Referencing the url tag in a JSP The following code is excerpted from the catalogManageCurriculumEntryManage.jsp: Populating a frameset in a JSP The next chunk of code uses the doReloadFrame, frame, and action tags from the delivery-js.tld file to create a JavaScript function that correctly reloads the specified frame when an action occurs in another frame.
PAGE 35
Defining resizable frames The final chunk of code defines the sizes of the resizable frames on the page: PAGE 36
The body of the delivery:action tag identifies the action used to display the frame. The body maps to the action path in the Struts-config.xml file on the Delivery server. The JSP defined in the path attribute of the forward tag is the JSP to display in the frame if the action results in that forward. For example, the activityTools delivery:action tag corresponds to the following action mapping: PAGE 37
• Images Applying customization sets When you create a customization set, you create a new branch in the application directory to house the files that contain alternative resources for the application, including graphics, style sheets, and .properties files. For details, see “Creating customization sets.” This chapter, which describes customizing JSPs, defines how to add and edit graphics, .properties, and CSS files.
PAGE 38
adminTemplate.jsp page, which is the page that defines the format for most of the pages on the Learning Management System server. For more information on the adminTemplate.jsp, see “The Anatomy of an LMS JSP.” The file directory containing the CSS files is structured as follows: [serverName]>css>[languageCode]>[browserType] where [serverName] equals one of the following: • lmm: Represents the Learning Management System server. • ds: Represents the Delivery server.
PAGE 39
Adding your own CSS files You can add your own CSS files for use in the application. You can reference styles from custom files in addition to the styles included in the CSS files that come with the LMS application by default. To add a CSS file: 1. Copy your custom CSS file into the [serverName]>css>[languageCode]>[browserType] directory. If you are adding a CSS file to a customization set, copy your custom CSS file into the [serverName]>customSetName>css>languageCode>browserType directory.
PAGE 40
To increase the default font size, change the “font-size:” value from xx-small to small or medium. To change the font style, replace the values in the “font-family:” setting with the fonts you want the application to use. Several of the classes in the CSS specify specific font sizes and styles that you have to change individually. These include the SPAN.hdrGeneral, DIV.hdrMainItem001, TD.hdrFolderDetails, and many other classes.
PAGE 41
A number of the tags in the lms custom tag library, such as the button or img tags, contain attributes that reference .properties file entries to supply language-specific text on the page. One tag, the message tag, is specifically designed to retrieve .properties file entries. For example, the title of the adminTemplate.jsp is supplied using the message tag. Instead of defining its title as IBM Lotus Learning Management System, the adminTemplate.
PAGE 42
To replace graphics: • Replace the existing image file in the [serverName]>images directory with the image you prefer to use. Retain the original image’s file name. Replacing the application logo The standard IBM Lotus Learning Management System logo which displays in the header of the application pages is included using custom tags.
PAGE 43
" alt="" width="209" height="22"> To replace the graphic used for the logo on the Delivery server, follow these steps: 1. Add the graphic file by copying it to the [serverName]>images directory. If you are adding the logo graphic to a customization set, copy it to the [serverName]>customSetName>images directory.
PAGE 44
} To customize the Help icon to align left instead of right, either: • Replace the class attribute with static HTML to define the alignment of the text as follows: This option works for quick fixes, but requires that you edit each individual setting any time you want to update an alignment style. Alternatively, if you reference a CSS class, by changing the setting in one place only -- the CSS class entry, you can update all references at once. • Create a new entry to the general.
PAGE 45
Submitting a form If you remove the nav attribute and add an onClick attribute, you completely change the functionality of the button. This code, for the Login button on the loginForm JSP for the Learning Management System server, executes a JavaScript submitForm() function when the button is clicked. This effectively logs the user into the application. PAGE 46
If no value attribute were supplied, the hidden input tag would retrieve a value for the destination property from the form Bean. The following lms:hidden tag, which is used in the catalogCourseMasterDetail.jsp keeps a copy of the current form’s keywords in the form Bean by supplying values for the name and property attributes.
PAGE 47
key from the appropriate .properties file. Similarly, the “tooltipKey” attribute defines the resource key to retrieve for display in the window status bar when the button is moused over to define the action the button performs. The “href” attribute defines the action to perform when the button is clicked. This href calls the customFieldsPopup() function, which is Javascript code that is defined in the page header.
PAGE 48
This code, which follows the check for drop-down box field, defines how to display the content of the drop-down box field, if present. Displaying the content of the drop down box requires denoting which of the available options is selected. If no option is selected, displays the default value as the selected option: <%-- ========== --%> <%-- select box --%> <%-- ========== --%> PAGE 49
%> <% } } //end getVal %>

Removing JSP tags from the page source has a powerful effect on the resulting pages in the interface. Remove with care.

PAGE 50

Chapter 6 Customizing Search You can perform these types of searches in the user interface: • User Search The User Search page appears when you roster or manage users in the Users module, when you enroll users or change their results in the Course Management module, when you supply contact information in the Course Catalog, and when you work with locations, rooms, or instructors in the Resources module.

PAGE 51

attribute HealthPlanChoice, the attribute link would look like this: 3. Modify the LMS file, ApplicationResources.

PAGE 52

Customizing Offerings Catalog searches The Learning Management System allows you to create a pool of custom fields that can be applied to course offerings to add more details. Adding custom fields to the Offerings Catalog The custom field editor appears when you click Edit at the bottom of a Course Details page. Although you add a field in the context of a single Course Offering, custom fields are available to anyone who creates a Course Offering.

PAGE 53

Removing fields from the Search pages If you want to remove fields from the Search pages, edit the appropriate .jsp to remove the code for the text and text box that you want to remove. • Course searches: searchCourses.jsp • Location searches: searchLocation.jsp • Room searches: searchRoom.jsp • Instructor searches: searchInstructors.jsp • Vendor searches: searchVendor.

PAGE 54

Chapter 7 Customization sets You can create what are in effect alternative versions of the application and send specified users to one or another of these rather than to the default interface when they log in.

PAGE 55

1. Copy the application’s Web directory on the LMM server to a new Web directory and give it an appropriate namefor example, SalesCSand then copy the application’s resource files to a directory with the new name: LMM CSS images etc. WEB-INF classes com resources LMM properties templates lib etc. Thus: LMM CSS images etc. SalesCS CSS images etc. WEB-INF classes com resources LMM properties templates SalesCS properties templates lib etc.

PAGE 56

2. Make whatever changes you want to the JavaServer Pages, Cascading Style Sheets, image files, properties files, and templates in the SalesCS directory hierarchy. 3. When you’ve finished, replicate your work (except for the templates folder) on the Delivery server (or servers). 4. Install your custom Help system. This is a three-step process: a. Install the default Help system, which means creating a directory on an HTTP server (in this example, myServer.myCompany.

PAGE 57

locations in the Delivery server directory tree. In that case, the resource directory would again be named SalesCS. • Delivery Server Web Directory the name of the directory in which the customization set’s JSPs, images, CSS, and (depending on your configuration) Help files reside (in this case, SalesCS) on the Delivery server(s). • Matching Sting Typethe type of LDAP entity (user, group, or attribute) identified by the matching string you enter below.

PAGE 58

Table of sample matching strings Type User Example Fulano de Tal/Cambridge/IBM cn=Fulano de Tal,ou=Cambridge,o=IBM cn=Jan Doe,ou=West5,ou=Weston,o=IBM Group Attribute */Cambridge/IBM *,ou=Cambridge,o=IBM * GroupCD/Groups/whatever cn=GroupCD,ou=Groups,o=whatever preferredLanguage=fr preferredLanguage=* preferredLanguage preferredLanguage= preferredLanguage!=* preferredLanguage!= preferredLanguage!=fr departmentNumber=1* sn=Jones matches A person (Fulano de Tal) at IBM in Cambridge Same as above A perso

PAGE 59

• 6. Use text unchecked, the customization set uses the files in the LMM properties directory; checked, the files in the customization set’s properties directory are to be used. Reboot the server(s) to complete the process of defining and assigning the customization. Installing a customization set on the Offline Learning Client You can create what are, in effect, customization sets for use on the Offline Learning Client. To do this: 1.

PAGE 60

file, inserting the custom files in the appropriate locations, overwriting any files in the default installation that have custom counterparts. Finally, if you changed lmsBrandingAbout.gif and included it in the Zip file (and the user entered the path to the Zip file at install time), the user will see the custom graphic file in the About box when he or she runs the Offline Learning Client. If you changed aboutDS.jsp and created a graphic for it (myAboutGraphic.

PAGE 61

56 IBM Lotus Learning Management System Release 1 Customization Guide

PAGE 62

Chapter 8 Creating a tab You can create a custom tabbed page to display along with the standard tabbed pages―Home, Student Catalog, Users, and so on. What you have to do to accomplish this depends on the sort of content you want the page to have. At a minimum, you need to do the following: 1. Create a JavaServer Page with the content you want to display when the user selects the tab. 2. Add a permission to the PERMISSION database table to control access to the page. (See “Adding custom Permissions.”) 3.

PAGE 63

navigationTab.users = Users users.manageUsers.task = Manage Users The navigationTab.users and users.manageUsers.task resources in turn are specified in the and attributes, respectively, in the definition of the Users module in ...classes/navigation.xml (which will be described in more detail later): <module> <name>users</name> <target>/userManagementInit.do</target> <content>users.jsp</content> <label>navigationTab.users</label> <title>users.manageUsers.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/ibm/webcam-r1/user-manual-english/page-64.html>PAGE 64</a></h6><p>block. (The table’s summary attribute refers to a resourced string that text-to-speech software can read, summarizing the contents of the table.) The permissionCheck tag encapsulates Java code that looks to see if the current user has the permission (or permissions) specified in the tag’s permissionName parameter. If the user doesn’t have the specified permission or permissions, LMS does not display the contents of the block.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/ibm/webcam-r1/user-manual-english/page-65.html>PAGE 65</a></h6><p><table cellpadding=0 cellspacing=0 border=0> <tr> <td valign=middle><lms:img src=images/bulletIndex.gif width=9 height=8 altkey=image.alt.select /></td> <td class=idxTaskItem valign=middle> </td> </tr> </table> </td> Cell B contains a <lms:link>…</lms:link> block followed by a non-breaking space followed by a resource string: <td width=100% valign=middle class=idxTaskPadding> <div class=idxTaskPadding> <lms:link styleclass=idxTaskItem nav="users.</p> </li> <li> <h6><a class=" text-decoration-none text-link fw-bold" href=/manual/ibm/webcam-r1/user-manual-english/page-66.html>PAGE 66</a></h6><p><required>false</required> <rtexprvalue>true</rtexprvalue> </attribute> <attribute> <name>tooltipKey</name> <required>false</required> <rtexprvalue>true</rtexprvalue> </attribute> <attribute> <name>permissionName</name> <required>false</required> <rtexprvalue>true</rtexprvalue> </attribute> </tag></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/ibm/webcam-r1/user-manual-english/page-67.html>PAGE 67</a></h6><p>resource strings referenced, and link. The other sections on the page (Roles and Profiles) differ from the Users section only in their details. navigation.xml Navigation.xml provides the following information about each of the JSPs to which a user can navigate: • Whether the JSP is a main page (such as the Users page) or a linked page (such as the Roster Users page). • The page name used in referring to the JSP’s resourced text in ApplicationResources.properties.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/ibm/webcam-r1/user-manual-english/page-68.html>PAGE 68</a></h6><p><label>users.rosterUsers.roster</label> <title>users.rosterUsers Roster_Users courseadmin/ch_add_users.html search /default.do usersRosterUsersUserSearch.jsp users.rosterUsers.search users.rosterUsers.search Roster_Users courseadmin/ch_users_ldapsearch.html

PAGE 69

the user clicks Continue in the User search page and rostering has been successful] fail [the message box displayed when the user clicks Continue in the User search page and rostering has been unsuccessful] [group search, roster from file, auto-roster trails] ManageRoles etc. ManageProfiles etc. ManageUsers etc.

PAGE 70

The tag: page names and resourced text The tag specifies the string to be used in the resource file ApplicationResources.properties when defining text elements displayed by a JSP. By convention, if a JSP is a link in a trail, its name is qualified by the name of the JSP that invoked it. So, for example, users is the name of the page from which the page named rosterUsers is invoked, and users.rosterUsers.desc is the string that ApplicationResources.

PAGE 71

If you don’t want to display the breadcrumbs for a given JSP, you can include the tag in the … or … block and set it to yes. For example, you could suppress the breadcrumbs in the roster users confirmation box shown above as follows: confirm /default.do usersRosterConfirm.jsp users.rosterUsers.import.confirm users.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/ibm/webcam-r1/user-manual-english/page-72.html>PAGE 72</a></h6><p>The <title> tag: title bar text The <title> tag tag specifies the string in ApplicationResources.properties whose definition is displayed in the JSP’s title bar. The <permissions> tag: permission to display the page The <permissions> tag specifies the name of the permission (as it appears in the PERMISSION table in the LMS database) that a user needs to have been granted in order to display the JSP. Permissions and how to create them are described in “Adding custom permissions.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/ibm/webcam-r1/user-manual-english/page-73.html>PAGE 73</a></h6><p>PERMISSION table Field oid name perm_id description Datatype CHAR(20) VARCHAR(128) INTN VARCHAR(255) Allow Nulls N N N Y category INTN Y status updatetime CHAR(1) DATETIME Y Y Values nnnnnnnnnnnnnn00PERM X_Y n A description of what the permission allows a user to do -1 = checked method, 0 = Home, 1 = Student Catalog, 2 = Course Catalog, 3 = Users, 4 = Course Management, 5 = Resources, 6 = Reports, 7 = Settings A = active, I = inactive, D = delete The application supplies the date and time the reco</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/ibm/webcam-r1/user-manual-english/page-74.html>PAGE 74</a></h6><p>Sample PERMISSION records OID PERM_ID NAME DESCRIPTION CATEGORY STATUS UPDATETIME OID PERM_ID NAME DESCRIPTION CATEGORY STATUS UPDATETIME OID PERM_ID NAME DESCRIPTION CATEGORY STATUS UPDATETIME OID PERM_ID NAME DESCRIPTION CATEGORY STATUS UPDATETIME OID PERM_ID NAME DESCRIPTION CATEGORY STATUS UPDATETIME OID PERM_ID NAME DESCRIPTION CATEGORY STATUS UPDATETIME 0000000000000000PERM 0 Home_Module Permission to see Home module 0 A 0000000000000100PERM 1 Home_Weeks_Activities View this week’s activities 0 A 00</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/ibm/webcam-r1/user-manual-english/page-75.html>PAGE 75</a></h6><p>CASCADED_PERMISSION table Field child_oid parent_oid Datatype CHAR(20) CHAR(20) Allow Null N N Values nnnnnnnnnnnnnn00PERM mmmmmmmmmmmmmm00PERM As mentioned earlier, if a user has been granted the parent permission, he or she is automatically granted the child permission. For example, a user who has been granted permission to manage user roles is automatically given permission to add roles to the system, that is, to execute the addRole method.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/ibm/webcam-r1/user-manual-english/page-76.html>PAGE 76</a></h6><p><module> <name>users</name> <target>/userManagementInit.do</target> <content>users.jsp</content> <label>navigationTab.users</label> <title>users.manageUsers.task User_Management courseadmin/ch_users_overview.html … Example The following example describes the process of adding and granting access to a simple custom tabbed page (customTab.jsp) with links to two other pages (customHello.jsp and customGoodbye.jsp).

PAGE 77

------------------------------------------------------------------------%>

PAGE 78

<%-----------------------------------------------------------------------END Hello ------------------------------------------------------------------------%> <%-----------------------------------------------------------------------START Goodbye ------------------------------------------------------------------------%>

PAGE 79

<%----------------------------------------------------------------------END Index Content Area ------------------------------------------------------------------------%> When a user with the appropriate permissions displays customTab.jsp, the page will look like this: The first linked page (customHello.jsp) looks like this: <%--------------------------------------------------------------------customHello.jsp Copyright (c) 2003, IBM Corporation. All rights reserved.

PAGE 80

PAGE 81

---------------------------------------------------------------------BEGIN Done button -----------------------------------------------------------------------%>

PAGE 82

The second linked page (customGoodbye.jsp) looks like this: <%--------------------------------------------------------------------customGoodbye.jsp Copyright (c) 2003, IBM Corporation. All rights reserved. Created: 05-30-02 The goodbye page for the auto greetings trail. ---------------------------------------------------------------------%> <%@ taglib uri="/WEB-INF/tld/lms.

PAGE 83

PAGE 84

2. Create Help files You need to associate a Help topic with each JSP so that when the user clicks? to display contextsensitive Help, the application will not display the Page Not Found screen. You could, of course, send the user to the index or table of contents or some other existing Help topic, but for the sake of illustration, assume that you would create a topic appropriate to the custom JSPs. You would then copy these files to the English-language course administrator Help directory (...

PAGE 85

Greetings PAGE 86

See “Chapter 4: Customizing Help” for instructions on how to create custom Help topics. 3. Add permissions to the LMS database A user needs permission to display the tabbed page and its two links. As in the case of Help, you could use existing permissions (making the appropriate changes in customTab.jsp’s … blocks and in navigation.xml’s tag), but custom permissions give you more precise control over access.

PAGE 87

INSERT INTO PERMISSION (OID, PERM_ID, NAME, DESCRIPTION, CATEGORY, STATUS) VALUES ('000000000042100PERM', 421,'Custom_Tab', 'Access Greetings page',7, 'A'); INSERT INTO PERMISSION (OID, PERM_ID, NAME, DESCRIPTION, CATEGORY, STATUS) VALUES ('000000000042200PERM', 422,'Say_Hello', 'Display Hello mesage',7, 'A'); INSERT INTO PERMISSION (OID, PERM_ID, NAME, DESCRIPTION, CATEGORY, STATUS) VALUES ('000000000042300PERM', 423,'Say_Goodbye', 'Display Goodbye message',7, 'A'); 4. Edit ApplicationResources.

PAGE 88

Say_Hello.name = Say Hello Say_Goodbye = Display Goodbye message Say_Goodbye.name = Say Goodbye 5. Edit navigation.xml You need to add a … block to navigation.xml to display the custom (Greetings) tab and the custom pages associated with it ( customTab.jsp, customHello.jsp and customGoodbye.jsp). Where you place this block relative to the other … blocks in the file determines the order in which the tab appears with respect to the other tabs in the user interface.

PAGE 89

customGoodbye.jsp customTab.goodbye.label customTab.goodbye.title courseadmin/ch_customtab.html studenthome etc. 6. Assign permissions Users need to be granted permission to display the tabbed page and either or both of the pages to which it offers links. You grant permissions through the LMS user interface.

PAGE 90

To create a role and assign it to users: 1. Open the Users page and click Manage Roles. 2. Click Add Role. 3. Enter the name of the new role (for example, Greetings) and a description of what users assigned that role can do. 4. Click on the name of the role when it appears in the Roles page. 5. Select the permission category in which the permissions are listed (in this case, Settings). 6. Check the appropriate boxes and save your work. 7. Back out to the Users main page and click Manage Users.

PAGE 91

86 IBM Lotus Learning Management System Release 1 Customization Guide

PAGE 92

Index abbreviations, 2 acronyms, 2 catalog, 47 context-sensitive Help, 16 course offerings, 47 CSS files adding custom, 34 editing, 34 replacing, 34 custom fields, 47 customization sets, 49 applying, 32 creating, 49 installing on the Offline Learning Client, 54 Delivery Server activity.jsp file, 30 delivery.

PAGE 93

Tag library descriptor files(TLD files), 20 users, 45 text XML settings files, 5 resourcing globally, 35 88 IBM Lotus Learning Management System Release 1 Customization Guide

PAGE 94

Printed in USA