IBM R1 manual Navigation.xml

Page 67

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.

The struts file that handles action mapping for the JSP.

The JSP’s file name.

A reference to the resource that identifies the page when it appears as a “breadcrumb,” that is, as an element in the navigation trail displayed in the upper right-hand corner of a linked page.

A reference to the resource that appears in the page’s title bar.

A reference to the permission that the user needs to have been granted in order to display the page.

The path to the Help topic to be displayed when the user clicks the context-sensitive Help icon (?) for the page.

For example, the section of navigation.xml that provides this information about the Users page and its links looks like this:

<!--

===/// users ///===

-->

<module> <name>users</name>

<target>/userManagementInit.do</target> <content>users.jsp</content> <label>navigationTab.users</label> <title>users.manageUsers.task</title> <permissions>User_Management</permissions> <helpPage>courseadmin/ch_users_overview.html</helpPage> <!—

Roster Users Trail --><!--users.rosterUsers -->

<trail>

<name>rosterUsers</name>

<target>/default.do</target>

<content>usersRosterUsers.jsp</content>

62 IBM Lotus Learning Management System Release 1 Customization Guide

Image 67
Contents Customization Guide Licensed Materials Property of IBM DisclaimerList of Trademarks Page Table of Contents Creating a tab Customization setsIndex Customizing the user interface Acronyms and abbreviations Disclaimer and a word about conventionsAcronym 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 permissionsTo explicitly assign a role to a user To modify permissions settings for an existing roleTo assign a role to a user To automatically assign a role to a userControlling access to features Page Anatomy of a Help topic Chapter Customizing HelpScript Background-repeat repeat-x Mosaic-bgScript Head Replacing a context-sensitive Help topic Editing an existing Help topicLmsform action=/prefSubmit.do % Adding your own Help topic HREF=shenrolled.html target=topEnrolled courses/Abr HREF=shnotifications.html target=topNotifications/AbrOverview Chapter Customizing JavaServer PagesLMS JSP tag libraries Anatomy of a TLD fileServerNameWEB-INFtld String formName = request.getParameterformName Referencing the url tag in a JSPDefining the url tag in the TLD file ServerNameWEB-INFclassescomlotuselearntaglib Rtexprvaluetrue/rtexprvalue Attribute TagAnatomy of a JSP Learning Management System serverDefining a page as a JSP Including tag library descriptor files Localizing page contentReferencing Struts tags Including the JSPs that comprise the main template Including JavaScript source codeDiv Td class=formBoxTitleBg colspan=3 valign=middle nowrapLogicnotPresent LogicnotMatch Div class=formBoxPositionInnerLogicpresent LogicnotPresent logicpresent name=invalidFormLocalizing page text Delivery serverScript language=JavaScript src=js/delivery.js/script Displaying errors to the userPopulating a frameset in a JSP Defining resizable frames Frameset Html Making global changesChanging the application style Applying customization setsBrowser-version Editing existing CSS filesServerNamecsslanguageCodebrowserType Language-version@import urlmyStyles.css Adding your own CSS filesReplacing CSS files Changing the font size or font style of the applicationServerNameWEB-INFclassesresourcesserverNameproperties Updating page textLmslinklmsimg src=images/name.gif… //lmslink Titlelmsmessage key=application.title //titleApplication.title = IBM Lotus Learning Management System Adding and replacing graphicsDelivery server Replacing the application logoLearning Management System server Image.alt.logo = IBM Lotus Learning Management SystemChanging the style of an individual JSP Changing individual JSPsReplacing a reference to a CSS style DeliverylogoURL resource=images/myCompanyLogo.gifChanging the functionality of an individual JSP Editing existing JSP tagsSpecifying the next page to display Submitting a form Canceling the submission of a formEditing form Bean values with the lmshidden tag Custom fields Removing JSP tagsLmshidden name=%=formName% property=unmodifiedKeywords Lmshidden property=userEventIt then checks to see if its a text box type field LogicnotPresent Logicequal Page Attribute name=HealthPlanChoice type=java.lang.String Chapter Customizing SearchCustomizing user searches Adding Ldap attributes to User Search pagesRemoving fields from User Search pages HealthPlanChoice = Employees Health PlanRemoving fields from Offerings Search pages Customizing Offerings Catalog searchesCustomizing course management and resource searches Adding custom fields to the Offerings CatalogRemoving fields from the Search pages Creating a customization set Chapter Customization setsLMM 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.jspTd width=1 valign=top Page Users.rosterUsers.subtitle = Roster Users Navigation.xml Users.rosterUsers.search.confirm Users.rosterUsers.searchTrail TrailManageUsers TrailTrail TrailManageRoles Trail TrailManageProfilesLabel tag breadcrumbs Content tag JSP file namesName tag page names and resourced text Target tag struts action-mappingUsers.rosterUsers.search.confirm HelpPage tag context-sensitive Help Adding custom permissionsTitle tag title bar text Permissions tag permission to displayPermid UpdatetimeOid Name0000000000000000PERM 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.htmlCustomtabb.html Select Maxpermid from Permission Add permissions to the LMS databaseEdit ApplicationResources.properties Navigation Edit navigation.xmlAssign permissions Namestudenthome/nameCreating a tab Page Index