IBM R1 Rtexprvaluetrue/rtexprvalue Attribute Tag, ServerNameWEB-INFclassescomlotuselearntaglib

Page 27

<rtexprvalue>true</rtexprvalue>

</attribute>

</tag>

The tag name is defined in the <name> tag:

<name>url</name>

The next line identifies the location of the Java source code to execute when this url tag is encountered on a JSP:

<tagclass>com.lotus.elearn.taglib.UrlTag</tagclass>

The source code for all of the Java classes specified in the LMS custom TLD files is stored in the following directory:

[serverName]>WEB-INF>classes>com>lotus>elearn>taglib

The url tag source is no exception; the UrlTag.java file is stored in the lmm>WEB- INF>classes>com>lotus>elearn>taglib directory.

The bodycontent tag provides information on the content of the body of the JSP tag and is intended for use by page composition tools:

<bodycontent>Jsp</bodycontent>

“Jsp” indicates that the body of the tag contains nested JSP syntax. Page composition tools know how to handle Jsp syntax. Some JSP tags have bodycontent tags that contain “Empty.” This specifies that no text can display in this tag when it is executed.

Once the properties of the JSP tag are defined, any attributes associated with the JSP tag are then defined before the closing JSP tag (</tag>) is reached. Each attribute has a name tag and two more informational tags, the “required” and “rtexpvalue” tags. If the required tag is set to “true,” any time you include the JSP tag in a page, you must provide a value for this attribute for the tag to be evaluated properly. The rtexpvalue tag indicates whether or not the value of the attribute may be dynamically calculated at request time, as opposed to being a static value determined at translation time.

The first attribute of the url tag, named encodeURL, is not required and its value cannot be dynamically calculated at request time. This attribute takes a Boolean value that indicates whether or not to call the HTTPResponse.encodeURL() method to encode the URL included in the body of the tag into a browser-readable format. This attribute should be set to true for URLs that target other pages in the application, since it encodes the URL with the session ID, if necessary. (For browser clients that do not accept cookies, this is the only way to pass the session ID and maintain the session state information for the application.)

<attribute>

<name>encodeURL</name>

<required>false</required>

<rtexprvalue>false</rtexprvalue>

</attribute>

The next two attributes, the useCustomDsPath and useCustomLmmPath attributes, are also not required. The values of these attributes can be dynamically calculated at request time. These attributes take Boolean values and indicate whether or not the customization set paths provided for the Delivery(DS directory) and Learning Management System (LMM directory) servers should be used in locating the URL included in the body of the tag. The default value for these tags is “true,” which indicates to apply the customization set path to the supplied URL, if a customization set exists. Setting these to false forces the retrieval of a resource from a specific URL regardless of whether customization sets are in effect for an application.

22 IBM Lotus Learning Management System Release 1 Customization Guide

Image 27
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 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 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/AbrOverview Chapter Customizing JavaServer PagesAnatomy 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 TagLearning 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 codeDiv Td class=formBoxTitleBg colspan=3 valign=middle nowrapLogicnotPresent LogicnotMatch Div class=formBoxPositionInnerLogicpresent LogicnotPresent logicpresent name=invalidFormLocalizing page text Delivery serverDisplaying errors to the user Script language=JavaScript src=js/delivery.js/scriptPopulating 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.gifEditing 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 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