Trail TrailManageRoles, Trail TrailManageProfiles | IBM R1 guide

the user clicks Continue in the User search page and rostering has been successful]

<trail> fail</trail> [the message box displayed when the user clicks Continue in the User search page and rostering has been unsuccessful]

</trail>

[group search, roster from file, auto-roster trails]

</trail>

<trail>ManageRoles

etc.

</trail>

<trail>ManageProfiles

etc.

</trail>

<trail>ManageUsers

etc.

</trail>

</module>

The <module>, <trail>, and <step> tags: main pages and linked pages

A <module>…</module> block consists of the definition of the tabbed page followed by one or more <trail>…</trail> blocks, which themselves may contain <trail>…</trail> (or <step>…</step>) blocks. A <trail>…</trail> block contains the definition of a page to which the previous page contains a link. (A <step>…</step> block contains the definition of a page, such as a confirmation box, that the application displays as the result of a user action that doesn’t involve explicitly invoking a link. Navigation.xml is not consistent in its use of <step>…</step> blocks, sometimes benignly using <trail>…</trail> blocks instead.)

As an example of trails, the Users main page has a link to the Roster Users page, which in turn has a link to the User Search page, which (when rostering is successful) invokes a confirmation box:

The relative location of the <module>…</module> blocks in navigation.xml determines the order in which the tabs are displayed: the studenthome module is defined first, then the studentCatalog module, then the users module and, as a result, the order in which the tabbed pages is displayed is Home, Student Catalog, Users. You can change the order in which tabbed pages are displayed by cutting and pasting <module>…</module> blocks.

64 IBM Lotus Learning Management System Release 1 Customization Guide

Image 69

IBM R1 manual Trail TrailManageRoles, Trail TrailManageProfiles, Trail TrailManageUsers

Contents

Customization Guide Disclaimer Licensed Materials Property of IBMList of Trademarks Page Table of Contents Customization sets Creating a tabIndex Customizing the user interface Acronyms and abbreviations Disclaimer and a word about conventions Acronym or What it stands for Abbreviation Page Changing settings Chapter Changing settings through the user interface or XMLPage To add a role to the system Chapter Controlling access to features through permissions To assign a role to a user To modify permissions settings for an existing roleTo automatically assign a role to a user To explicitly assign a role to a user Controlling access to features Page Anatomy of a Help topic Chapter Customizing Help Script Background-repeat repeat-x Mosaic-bg Script Head Editing an existing Help topic Replacing a context-sensitive Help topicLmsform action=/prefSubmit.do % Adding your own Help topic HREF=shenrolled.html target=topEnrolled courses/Abr HREF=shnotifications.html target=topNotifications/Abr Overview Chapter Customizing JavaServer Pages Anatomy of a TLD file LMS JSP tag librariesServerNameWEB-INFtld Referencing the url tag in a JSP String formName = request.getParameterformNameDefining the url tag in the TLD file ServerNameWEB-INFclassescomlotuselearntaglib Rtexprvaluetrue/rtexprvalue Attribute Tag Learning Management System server Anatomy of a JSPDefining a page as a JSP Localizing page content Including tag library descriptor filesReferencing Struts tags Including the JSPs that comprise the main template Including JavaScript source code LogicnotPresent LogicnotMatch Td class=formBoxTitleBg colspan=3 valign=middle nowrapDiv class=formBoxPositionInner Div Logicpresent LogicnotPresent logicpresent name=invalidForm Localizing page text Delivery server Displaying errors to the user Script language=JavaScript src=js/delivery.js/scriptPopulating a frameset in a JSP Defining resizable frames Frameset Html Making global changes Changing the application style Applying customization sets ServerNamecsslanguageCodebrowserType Editing existing CSS filesLanguage-version Browser-version Replacing CSS files Adding your own CSS filesChanging the font size or font style of the application @import urlmyStyles.css ServerNameWEB-INFclassesresourcesserverNameproperties Updating page text Application.title = IBM Lotus Learning Management System Titlelmsmessage key=application.title //titleAdding and replacing graphics Lmslinklmsimg src=images/name.gif… //lmslink Learning Management System server Replacing the application logoImage.alt.logo = IBM Lotus Learning Management System Delivery server Replacing a reference to a CSS style Changing individual JSPsDeliverylogoURL resource=images/myCompanyLogo.gif Changing the style of an individual JSP Editing existing JSP tags Changing the functionality of an individual JSPSpecifying the next page to display Canceling the submission of a form Submitting a formEditing form Bean values with the lmshidden tag Lmshidden name=%=formName% property=unmodifiedKeywords Removing JSP tagsLmshidden property=userEvent Custom fields It then checks to see if its a text box type field LogicnotPresent Logicequal Page Customizing user searches Chapter Customizing SearchAdding Ldap attributes to User Search pages Attribute name=HealthPlanChoice type=java.lang.String Removing fields from User Search pages HealthPlanChoice = Employees Health Plan Customizing course management and resource searches Customizing Offerings Catalog searchesAdding custom fields to the Offerings Catalog Removing fields from Offerings Search pages Removing fields from the Search pages Creating a customization set Chapter Customization sets LMM De en Etc De en etc. SalesCSPage Attribute Name Type Modified Size Path Customization sets Page Users Chapter Creating a tab @ taglib uri=/WEB-INF/tld/lms.tld prefix=lms % Users.jsp Td width=1 valign=top Page Users.rosterUsers.subtitle = Roster Users Navigation.xml Users.rosterUsers.search.confirm Users.rosterUsers.search Trail TrailManageRoles TrailTrail TrailManageProfiles Trail TrailManageUsers Name tag page names and resourced text Content tag JSP file namesTarget tag struts action-mapping Label tag breadcrumbs Users.rosterUsers.search.confirm Title tag title bar text Adding custom permissionsPermissions tag permission to display HelpPage tag context-sensitive Help Oid UpdatetimeName Permid 0000000000000000PERM 0000000000003000PERM 0000000000009300PERM Copy the JSPs ExamplePage Creating a tab END Index Content Area Creating a tab Div Second linked page customGoodbye.jsp looks like this Page Create Help files Customtab.html Customtabb.html Select Maxpermid from Permission Add permissions to the LMS database Edit ApplicationResources.properties Navigation Edit navigation.xml Assign permissions Namestudenthome/name Creating a tab Page Index