Web Tailor 8.6.1 User Guide

Banner Web Tailor User GuideRelease 8.6.1March 2014/nBanner®, Colleague®, PowerCampusŽ, and Luminis® are trademarks of Ellucian Company L.P. or its affiliates and are registered in the U.S. and other countries. Ellucian®, Ellucian Adv anceŽ, Ellucian Degree WorksŽ, Ellucian Course SignalsŽ, Ellucian SmartCallŽ, and E llucian RecruiterŽ are trademarks of Ellucian Company L.P. or its affiliates. Other names may be trademarks of their respective owners. ©2003-2014 Ellucian Company L.P. and its affiliates. Contains confidential and proprietary information of Ellucian and its subsidiaries. Use of these materials is limited to Elluci an licensees, and is subject to the terms and conditions of one or more written li cense agreements between Ellucian and the licensee in question. In preparing and providing this publicati on, Ellucian is not rendering legal, accounti ng, or other similar professional service s. Ellucian makes no claims that an institution's use of this publication or the soft ware for which it is provided will guarantee compliance with ap plicable federal or state laws, rules, or regulations. Each organizati on should seek legal, accounting and other similar professional services from compe tent providers of the organization's own choosing. Prepared by: Ellucian 4375 Fair Lakes Court Fairfax, Virginia 22033 United States of America Revision History Publication DateSummary March 2014New version that supports Banner Web Tailor 8.6.1 software. /n 3Banner Web Tailor User Guide |Contents Contents Web Tailor Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12 Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Web menus and procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Menu items. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Information Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 User roles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Web rules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Web modules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Global user interface settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Web Tailor parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Graphic elements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Login return location. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Web Tailor overrides . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Advancement Self-Service rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Finance site preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 LDAP administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Channel maintenance and channel preference. . . . . . . . . . . . . . . . . . . . . . . . . 14 Changing the security question . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Changing a PIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Accessing Web Tailor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Technical Basics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16 Technical configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 Data flow process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 Accessing the Self-Service applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Security and the browser™s back button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Interaction with APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 User interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 Default theme. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Accessibility initiative/enhanced user interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 Frames. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 Cascade theme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 /n 4Banner Web Tailor User Guide |Contents Main menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Menu pages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Cascade theme accessibility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Naming conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Web Tailor object names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Web database object naming conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 Cascading Style Sheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 Style sheets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Home page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 Self-Service features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Keyword search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Configure search functionality (Cascade theme) . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Searching by keyword. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Adding keywords. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Search implementation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Help for Banner Self-Service products. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 Creating and modifying help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 Separating help text into paragraphs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Setting up a CSS for help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Help implementation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 TWBKWBIS.P_OPENDOC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 System-level CSS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 Web Tailor Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 Site Map. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Using the Site Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 Site Map implementation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 Display of personal information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 Institution identifier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 Printing web pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 Creating a printer-friendly pa ge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 Printing without Info Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 Using Web Tailor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39 Web Tailor menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 Web Tailor Utility Report pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 Compare reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 /n 5Banner Web Tailor User Guide |Contents Compare reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 View reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42View reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Web Tailor Utility Report pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Compare reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Compare reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 View reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44View reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Web menus and procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Web Page Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 Generating menu pages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 Menu items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 Reorder or customize menu items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 Web Page Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 Customize the Selected Menu Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 Web Page Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 Adding new menu items. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 Modifying existing menu items. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 Info Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 Select Info Text to customize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 Reorder or customize info text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 Web Page Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 Info Text in SSB footer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 Coding a link to open a new browser window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 User roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 Web rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 Web Page Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 Web modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 Web Page Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 Global user interface settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 Web Page Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 Web Tailor parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 /n 6Banner Web Tailor User Guide |Contents Web Page Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 Web Key Parameters Table (TWGRWPRM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 Graphic elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 Web Page Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 Login return location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 Web Page Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 Web Tailor overrides . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 LDAP administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 Web Page Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 PINs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .80 Secure logins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 PIN encryption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 Assigning PINs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 Assigning PINs via database triggers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 Resetting PINs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 Enterprise PIN preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 Info Text for Expired PINs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 Login options for user IDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 Log in with Social Security Number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 Ignore case of Login ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 Capture Banner User ID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 Technical Reference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86 Baseline and local records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 Web menus, procedures, and associated roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 Menu items. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 7Information Text (Info Text). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 Help Info Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 Internationalization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 /n 7Banner Web Tailor User Guide |Contents Web session processing and security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 Preventing break-ins. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 Monitoring ID/PIN instances. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 Using LDAP for user authentications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91Authentication process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92LDAP authenticated search in Luminis IV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 Self-Service and FGAC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 WEBUSER parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 Securing web pages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 Database Access Descriptors (DADs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 Browsers and caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 Packages and procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 Procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 6Modifying existing procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 Adding new menus and procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 Web roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 Standard Banner web roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 WEBUSER role . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 Manually assigned web roles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 Assigning the Web Tailor Administrator role. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 Modifying web roles for existing procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 Adding web roles for new procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 Printing text fields and processing date input . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 Breadcrumb validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 Empty back link URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 Invalid back link URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 Resolving breadcrumb/page issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 Handling pages with improperly coded HTML (Cascade theme) . . . . . . . . . . . . . . 105 Identify <!DOCTYPE> issues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 Identify

,

, and tag issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 /n 8Banner Web Tailor User Guide |Contents Resolve HTML issues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 Minified and Full JavaScript files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 Uses for minified and full versions of JavaScript file s. . . . . . . . . . . . . . . . . . . . . . . . . . 107 Identify minified and full versions of JavaScript files . . . . . . . . . . . . . . . . . . . . . . . . . . 107 Switch between minified and full versions of JavaScri pt files. . . . . . . . . . . . . . . . . . . . 107 Web Tailor Tables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .108 Web Tailor Image Information Table (TWGBIMAG) . . . . . . . . . . . . . . . . . . . . . . . . . 109 LDAP Settings Table (TWGBLDAP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 Web Tailor Override s Table (TWGBOVRR) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 Web Tailor Global User Interface Settings Table (TWGBGLUI) . . . . . . . . . . . . . . . 112 Web Tailor Web Parameters Table (TWGBPARM) . . . . . . . . . . . . . . . . . . . . . . . . . . 114 Web Tailor Login Return Code Base Table (TWGBRETC) . . . . . . . . . . . . . . . . . . . 114 Web Tailor Main Web Page Settings Table (TWGBWMNU) . . . . . . . . . . . . . . . . . . . 115 Web Tailor Web Rules Table (TWGBWRUL) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 Web Tailor Web SessionID Table (TWGBWSES) . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 Channel SourceInfo Master Table (TWGRCHNL) . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 Channel Mapping Table (TWGRCMAP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 Web Tailor Repeating Information Text Table (TWGRINFO) . . . . . . . . . . . . . . . . . . 122 Web Tailor Repeating Menu Item Table (TWGRMENU) . . . . . . . . . . . . . . . . . . . . . . 123 Web Tailor Login Return Code Repeating Table (TWGRRETC) . . . . . . . . . . . . . . . 124 Web Tailor User Roles Repeating Table (TWGRROLE) . . . . . . . . . . . . . . . . . . . . . . 124 Channel/Self-Service Preferences Table (TWGRUPRF) . . . . . . . . . . . . . . . . . . . . . 125 Web Tailor Menu Roles Table (TWGRWMRL) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 /n 9Banner Web Tailor User Guide |Contents Web Tailor User Parameters Table (TWGRWPRM) . . . . . . . . . . . . . . . . . . . . . . . . . 126 Web Tailor Module Validation Table (TWTVMODU) . . . . . . . . . . . . . . . . . . . . . . . . . 127 Web Tailor User Role Validation Table (TWTVROLE) . . . . . . . . . . . . . . . . . . . . . . . 128 Web Tailor Packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .129 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 TWBKAUSR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 Procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 30TWBKTABS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 TWBKSELS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 Cursors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 TWBKMODS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 TWBKFUNC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 Procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 32Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 TWBKBSSF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 TWBKAUTH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 Global variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 4Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 Procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 TWBKLDAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 Procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 35TWBKLOGN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 Procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 36TWBKINTE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 Procedures (used on remote side). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 /n 10Banner Web Tailor User Guide |Contents Procedures (used on Banner side). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 TWBKLIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 Procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 37TWBKFRMT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 Procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 41Tab-style navigation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 TWBKGLIB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 Cursors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 TWBKIMAG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 Procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 46TWBKJSCR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 Procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 47TWBKLIBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149 Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149 Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149Cursors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149Exceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150 TWBKMENU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150 TWBKMODU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151 TWBKRETC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 Procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 53TWBKSERR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 TWBKSLIB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 TWBKUROL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 /n 11Banner Web Tailor User Guide |Contents TWBKVALD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 Procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 55TWBKWBIS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156 Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157 Procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 60TWBKWRUL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165 TWBKWMNU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165 TWBKWINF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 Package Specs for Luminis Channels for Banner . . . . . . . . . . . . . . . . . . . . . . . . . . 168 twbccomn.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 8twbcmain.sql. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 68twbcmxml.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 8Graphic Elements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .169 Review and customize graphic elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 Delivered images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 Tag Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .170 Login page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171 Web Tailor Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172 Customize the selected module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173 /n 12Banner Web Tailor User Guide |Web Tailor Overview Web Tailor Overview This chapter provides a summary of the functions of BannerŽ Web Tailor, and specifies how users access the system. It also includes a description of features that are available for all the Banner Self-Service applications and are set up in Web Tailor. FunctionsBanner Web Tailor lets you build the look, feel, and unique personality of all your institution™s web applications, so you can personalize your institution™s interface to the world. Web Tailor delivers cust omizable global web rule definitions and procedures, customizable menus, menu items, graphics and text definitions. You must install Web Tailor befo re installing any other Banner Self-Service application. For more information, refer to the Banner Middle Tier Implementation Guide .The Web Tailor functions are available from the Web Tailor Menu, except for Change Security Question and Change your PIN , which are found on the Personal Information menu. The Web Tailor functions will be de scribed in detail later in this guide. Web menus and procedures This function allows you to define the menus that will appear on your institution™s web pages for the different Self-Service applications, and specify the procedures behind them. For more information, see fiWeb menus and proceduresfl on page45 .Menu items This function allows you to define the items that will appear on the menus on your institution™s web pages. For more information, see fiMenu itemsfl on page49 .Information Text This function allows you to add or customize Information Text (Info Text). Info Text can be: ŁInstructions on how to use a page ŁHelp for the page ŁError messages For more information, see fiInfo Textfl on page52 ./n 13Banner Web Tailor User Guide |Web Tailor Overview User roles This function allows you to change the role or roles that a person has been assigned to. For example, you can select the check boxes for Advancement Data Tailor and Development Officer to give someone those roles. For more information, see fiUser rolesfl on page55 .Web rules This function allows you to define certain rules for your institution™s web pages. For example, you can identify the number of minu tes a person can be inactive before they are timed out, or specify the fo rmat for the date and time information that appears on your pages. For more information, see fiWeb rulesfl on page56 .Web modules This function allows you to modify a specif ic Self-Service application, e.g., Accounts Receivable, Student Self-Service, Web Ta ilor Administration, etc. You can make specific changes to that one application. For example, you can enter a location UR L of the Cascading Style Sheet (CSS) that applies to Advancement Self-Service alone. The Advancement Self-Service application would use that CSS and the other applications at your institution could use different ones. Each of your modules could have a different look-and-feel. For more information, see fiWeb modulesfl on page62 .Global user interface settingsThis function allows you to set up rules that will apply to your institution™s web pages as a whole. You can specify: ŁHeader informationŁThe location URL of CSSs that control the pages™ look-and-feel ŁThe location URL of CSSs that control the look-and-feel of your Help text ŁThe location URL of where your Help text files are stored ŁImages that represent errors and warnings ŁAn image that indicates that a field is required For more information, see fiGlobal user interface settingsfl on page63 .Web Tailor parameters This function allows you to customize parameters used in Web Tailor processing, such as the maximum length of PINs. You must exercise great care when modifying these parameters. For more information, see fiWeb Tailor parametersfl on page65 .Graphic elements This function allows you to specify the imag es that will be available to be used on your web pages. For each image, you can spec ify its name, the directory where it is /n 14Banner Web Tailor User Guide |Web Tailor Overview located, and its height and width. For more information, see fiGraphic elementsfl on page74 .Login return locationUse this function to specify the page you would like to be displayed when a user is timed out, then logs back in . For more information, see fiLogin return locationfl on page75 .Web Tailor overrides This page allows you to replace certain procedures and functions with your own under certain circumstances. This is necessary because you may have a stand-alone product you would like to use with the Self -Service products, and you need to use some of the procedures and functions in the other system. If an override is defined, that code will be run instead of the W eb Tailor code. For mo re information, see fiWeb Tailor overridesfl on page76 .Advancement Self-Service rulesThis function, although stored in Web Tailor, is used only by those who want to customize Banner Advancement Self-Servi ce. For information on how to do this, please refer to the Banner Advancement Self-Service User Guide .You must have the Advancement Data Tailor role assigned to your user ID to see this menu item. Finance site preferencesThis function, although stored in Web Tailor, is used only by those who want to customize Finance Self-Service. For informatio n on how to do this, please refer to the Banner Finance Self-Service User Guide .You must have the Finance Data Tailor role assigned to your user ID to see this menu item.LDAP administrationThis function allows you to override the settings on the Enterprise PIN Preferences Form (GUAPPRF) in Banner General and use an LDAP server to authenticate user logons instead of the Web Tailor l ogic. For more information, see fiLDAP administrationfl on page77 .Channel maintenance and channel preferenceThese items will appear on your menu only if you are us ing Web Tailor with Luminis® Channels for Banner and Luminis. For more information, see the Banner Middle Tier Implementation Guide ./n 15Banner Web Tailor User Guide |Web Tailor Overview Changing the security questionThis function allows your end users to chan ge the security questions and answers that they can use to access th eir account if they forget their PINs. See the Banner Web General User Guide.Changing a PINThis function enables users to update their PINs. See the Banner Web General User Guide.Accessing Web Tailor The Self-Service applications provide two ty pes of web access, non-secured and secured. Users can access non-secured areas without needing to enter a user ID and PIN. Note: Web Tailor requires secured access so you must log on with an ID an PIN to access it. To access Web Tailor, perform the following steps: 1.Select Secure Area from the home page. 2.Enter your ID and PIN on the logon page. Note: The PIN is case-sensitive. Dependi ng on your institution™s settings, the User ID may also be case-sensitive. 3.Select Web Tailor Administration ./n 16Banner Web Tailor User Guide |Technical Basics Technical Basics This section describes basic technical information about BannerŽ Web Tailor. The following topics are covered: ŁfiTechnical configurationfl on page16 ŁfiData flow processfl on page16 ŁfiAccessing the Self-Service applicationsfl on page17 ŁfiInteraction with APIsfl on page18 ŁfiUser interfacefl on page18 ŁfiAccessibility initiative/enhanced user interfacefl on page20 ŁfiNaming conventionsfl on page22 ŁfiCascading Style Sheetsfl on page24 ŁfiSelf-Service featuresfl on page27 ŁfiPrinting web pagesfl on page37 Technical configuration Banner Self-Service uses PL/SQL stored pr ogram units, which st reamlines the call and retrieval process for query and update functionality. The Self-Service programs are written in PL /SQL and are stored as PL/SQL packages, procedures, and functions. The Self-Service applications are designed around a library of stored subprograms. The architecture eliminates SQL parsing for each PL/SQL statement by combining PL/ SQL stored program units with pre-compiled Oracle subprograms stored in the Oracle database. This design substantially reduces the call processing overhead required for the Self-Service applications to communicate with Oracle. It al so promotes memory sharing for multiple users executing procedures and functions within the same package. Data flow process The Self-Service applications share a common data flow, which consists of the following steps that exchange information betwe en a web client and the Oracle host: /n 17Banner Web Tailor User Guide |Technical Basics 1.The web client browser software accesses a web page or completes an HTML form that is sent to the institution™s web server. 2.The institution™s web server software inte rprets the URL (Uniform Resource Locator) and identifies it as either a CGI-comp liant (Common Gateway Interface-compliant) program or as a procedure to access stat ic HTML pages. If it is a CGI-compliant program, the web server software in vokes the Oracle Application Server. 3.The Oracle Apache PL/SQL Agent software reads and decodes the passed data, connects to the Oracle database via SQL/ Net and executes a remote Oracle stored procedure that resides on the Oracle database. 4.The stored procedure executes other stored procedures and functions to perform SQL operations and dynami cally generate HTML directives that will be passed back to the mod_plsql component of the Oracle HTTP server. 5.The mod_plsql component of the Oracle HTTP server passes the data back as reformatted HTML tags to the institution™ s web server software that communicates with the web client. Accessing the Self-Service applicationsTwo types of access are provided in the Self-Service applications: ŁNon-secured access - does not require users to enter an ID and PIN to log on to the homepage, providing your institution with a way to effectively market and publicize on the web. Typically, inst itutions display the Prospective Students , Apply for Admission, Campus Directory, General Financial Aid , Class Schedule , Course Catalog and Alumni and Friends links here. The home page displays several icons for Public Access (non-secured) information. Note: Part of the admissions process does require the user to create an ID and select a PIN, which will be requi red if the user ne eds to enter more application information at another time or if they want to view the status of their application after they submit it. ŁSecured access - requires users to enter a valid ID and PIN to log on, and gives them access to information from Banner. The home page displays Secure Area. After the user enters a valid ID and PIN, the Main M enu display includes the items that are valid for the user's web roles. For details about PINs, please refer to Chap ter 4, fiPINsfl. In addition, there is more information about web session processing and security in Chapter 5, fiTechnical Referencefl. Security and the browser™s back button Because Web Tailor assures security, the Back button can be used on many browsers. /n 18Banner Web Tailor User Guide |Technical Basics Of course, the only really safe way to prevent other users from logging in after a person leaves a computer terminal is to log out and cl ose the browser. That is the best protection against unauthorized access to personal informat ion. If users merely cleared the disk and memory cache, it would not erase the securi ty cookie, which would allow another user access. Interaction with APIsWeb Tailor supports the integration of Banner and Banner Self-Service with Application Programming Interfaces (APIs). An API is a program comprised of three different packages: 1.The primary package that contains th e create, update, and delete functions 2.A rules package that contains subprograms that support the primary package 3.A strings package that contains error messages and functions Programs within Banner (including forms, C processes, and the Self-Service packages) call common functions and procedures in the APIs as needed. External systems that create, update, or delete information stored in Banner tables can also call the APIs. Web Tailor calls the Third Party Access API ( GB_THIRD_PARTY_ACCESS ) for all insert and update processing for the GOBTPAC table. Any database rollbacks or commits have been changed to call the new gb_common.p_rollback or gb_common.p_commit procedures. This ensures that the appropriate actions are taken to publish or discard synchronization messages. API error handling for all the Self-Service products is done via the TWBKWBIS package. The TWBKSERR package handles all unhandled exceptions. User interfaceThe look and feel of the Banner Self-Service products are defined by the selection of one of two distinct themes, default and cascade. The use of themes allows the same content to be displayed in different ways. For more information on the av ailable themes, please see:ŁfiDefault themefl on page19 ŁfiCascade themefl on page21 To select a theme, perform the following steps: 1.Click WebTailor Administration .2.Click WebTailor Parameters ./n 19Banner Web Tailor User Guide |Technical Basics 3.Click UI_THEME.4.Enter the parameter value for the theme you would like to select. Available themes include the following: Łcascade - displays the Cascade theme. Łdefault - displays the Default theme. 5.Click Submit Changes .Default themeThe default theme has the following design elements. ŁUse the Verdana font ŁIncludes separate bars consistent with th e Banner 7 and 8, Luminis 5look and feel. ŁProvide a consistent place to render error messages to assist the user in determining when validation issues occur. It is recommended that you set the font size in your browser to Medium (View>Text Size>Medium). If yo u set the size to Largest , a small line will appear to the right of each tab. Note: In the Secure Area, the options on the Main Menu page (twbkwbis.P_GenMenu) are also displayed across the top of the page as tabs. (There are some exceptions to this, however, such as the WebCT menu item.) You can choose a menu item or a tab to pr oceed to the correspon ding page. The tab will remain at the top of the page while you access the pages as sociated with it, and it will be highlighted. While you are navigating thr ough any of the lower-level menus, that tab will still be highlighted. There are two exceptions: 1.If you reach a page that is not secured (you can access it without accessing the Secure Area), there are no tabs at the top of the Web page. 2.If you reach a page that is owned by a product that you do not have access to, there will be tabs, but none of th e tabs will be highlighted. For example, if a user who does not have Web Tailor Administrator access is on the Personal Information menu, the Personal Information tab is highlighted. However, when that user selects Change Security Question , the Personal Information tab is no longer highlighted because the Security Question and Answer page is owned by Web Tailor Administration. /n 20Banner Web Tailor User Guide |Technical Basics Accessibility initiative/enhanced user interfaceThe User Interface (UI) for Banner Web Tailor has been designed to be understood easily by casual users, and it in cludes accessibility features. The goal is to make the content understand able and navigable for any individual who uses adaptive technology such as screen readers and screen enlargers. This includes not only making the language clear and simple, but also providing easy steps to complete a user task and designing mechanisms for navigating within and between pages. Providing navigation features and orie ntation information in page s maximizes accessibility and usability. The look-and-feel settings for Web Tailor are stored in Cascading Style Sheets (CSS). By providing more CSS in Web Tailor, you can create and manage the look and feel for your institution. The benefits are: ŁImproved usability for all constituents, including the disabled ŁA more flexible user interfac e with greater ability to customize the look and feel to meet institutional needs ŁGreater extensibility for local modifications du e to increased use of industry standards, including W3C guidelines ŁAn improved foundation for future changes in web technology This includes: ŁText describing graphics appears in the Status Bar and Bubble Help. There are no text- based links under the graphics in the navigation section of the Page Header because this would cause redundancy when using a screen reader. ŁTags are included with graphics so screen readers can identify them. ŁHigh-level menu items are text, not graphics. ŁStyle sheets are used extensively. They support highly structured documents, which are easier for screen readers to process. ŁTables have been designed to make them easy to read and understand, and they have summaries and captions. ŁInformation Text (Info Text) has been designed to be easy for screen readers to process. ŁAbbreviations and acronyms are defined by ta gs to be spoken correctly. For example, screen readers would try to pronounce URL as a word if it was not marked correctly. ŁText size can be customized, increasing it from small to large, using the text size features found in the View menu in the browsers. ŁImbedded Skip links allow screen readers to move past repe titive text to the main content of the page. ŁKeyboard shortcuts are included for Help, Menu, and Exit: ŁALT + 2: Exit /n 21Banner Web Tailor User Guide |Technical Basics ŁALT + 3: Menu ŁALT + H: Help ŁText links or anchor links appear at the top of each page to allow users to go directly to the text they want to read. ŁGo To Top links appear at the bottom of pages to take users directly to the top. ŁForm field labels are associated with form fields. ŁUsers are warned when links will spawn new windows. ŁA DTD identifier exists on all web pages. ŁA language attribute exists in the HTML tag on all pages. ŁWeb pages are divided into sections via DIV tags. ŁTH tags are used for table headers (rather than TD tags), and they include a scope attribute. ŁDevice-independent alternatives have be en provided for device-dependent javascript (e.g., you can use either the keyboard or a mouse). FramesIt is recommended that your institution no t use HTML frames in new or future UI designs for Self-Service products. The use of frames in HTML design causes problems with accessibility, printing, compat ibility, and browsing on mobile devices. For these reasons, frames are not supported in Self-Service. Cascade themeThe Cascade theme provides Web 2.0 functio nality within Banner Self-Service. This theme adds rich user interaction to Bann er Self-Service such as auto complete functionality, button mouse-over state change s and in page refreshes to provide the end user a compelling user experience. Note: Javascript must be enabled for the Cascade theme to be used. The Cascade Theme introduces some new internet standard design concepts to Banner Self-Service.ŁThe page hierarchy is now provided on a pa ge by page basis through the use of a breadcrumb trail. A breadcrumb trail is a popular way to give end-users a way to keep track of their locations within Banner Self -Service. For more information, please see fiBreadcrumb validationfl on page103 .ŁA back button is provided next to the breadcrumb trail that uses the Back Link URL. This relationship is defined in Web Tailor through use of the Back Link URL field. If no Back Link URL is specified, th e back button will not display. /n 22Banner Web Tailor User Guide |Technical Basics ŁMore granular use of CSS to allow web designers to tailor the look and feel of the theme. This allows Banner Se lf-Service to have more flex ibility to adopt the look and feel of the institutions brand. With this fi ner granularity, however, there is an increased level of complexity when making these changes. ŁWith the Cascade Theme applied, Banner Self-Service provides a more robust way in the which the end-user can navigate throughout the system. Through in page menu refreshes the end-user no longer has to go from one page to another, but has the navigation brought into the page they are currently viewing. ŁThe fiSearchfl feature in Banner Self-Service is more accurately depicted in Banner Self- Service as fiFind a Pagefl. The new fiFind a Pa gefl functionality allows the user to type a few characters and automatically retrieve those pages that best match without ever having to leave the page. Main menuThe Cascade theme does not display a Main m enu in the secured area. If you have items on the main menu that do not display as tabs, you will nee d to either create a new main menu tab to display this content or move the items on the main menu that do not display as a tab to an existing tab. Menu pages Global Menu Bottom Links do not display on menu pages in the Cascade theme. Global Menu Bottom Links will only display on menu pages th at use the Default theme. Cascade theme accessibility The Cascade theme contains some items that are not accessible by a screen reader. The Cascade theme has been built with an accessibility mode opti on for users using a screen reader to access the application. In accessibility mode , the session will run under the default theme which is fully accessible. To enable accessibility mode, for a session, an accessibility URL can be created using the following format: http://:// twbkwbis.P_GenMenu?name=homepage&accessibility=true Naming conventionsThe Banner Self-Service products are made up of packages, C programs, HTML files, and GIF and JPG files, javascript, and Cascading Style Sheets (CSS). Each object™s name is eight characters long, and the position of each letter identifies a particular quality or attribute of the package or program. For example, the eight letters in BWGKOGAD identify it as a Web General package in the Overall module that is used for general ad dress processing. The package specification /n 23Banner Web Tailor User Guide |Technical Basics can be found in the file genweb/dbprocs/bwgkogad.sql , while the package body will be in the file genweb/dbprocs/bwgkoga1.sql .Exceptions to these rules are explained on t he next pages. Most notably, the packages TWBKLIBS and TWBKWBIS are the Web Tailor Library package and the Web Tailor Basic Support package, respectively, and the HTML file homepage.htm is the example homepage. Also, for all but very small packages , look for package bodie s in a file with the same first seven characters as the package name, but with a one (1) in the eighth position. Web Tailor object names All Web Tailor package names begin with the four characters TWBK , and do not have a module code in the fifth position. In a Web Tailor package, the characters in positions 5 through 8 are all devoted to the unique package name. In this respect they follow the same naming convention as the HTML, GIF and JPG files for the last four characters of a Web General object. Position(s)Assignment Positions 1 and 2 The letters BW occupy positions 1 and 2 in all Web General package names. The letters TW occupy positions 1 and 2 in all Web Tailor package names. Position 3Identifies the associated baseline product: A = Advancement Self-Service B = Web Tailor C = Common Web D = Advancement Officers (part of Advancement Self-Service) F = Finance Self-Service (part of Employees Self-Service) G = Web General L = Faculty and Advisor Self-Service P = Employee Self-Service R = Financial Aid Self-Service (part of Student Self-Service) S = Student Self-Service (incl udes Admissions Self-Service) T = Accounts Receivable (part of Student Self-Service) Position 4Identifies object type: K = Oracle database package R = C report A = C application support object H = HTML file G = GIF file or JPG file Position 5For packages and C files, identifies module: O = Overall Positions 6-8For packages and C files, a unique three-character name Positions 5-8For HTML, GIF, and JPG files, a unique four-character name For Web Tailor packages, a unique four-character name /n 24Banner Web Tailor User Guide |Technical Basics Web database object naming conventions Note: The Banner Object:Access product us es slightly different standards for its procedures and functions. Cascading Style Sheets Web Tailor uses Cascading Style Sheets (CSS) to control the way documents are presented via browsers and are printed. Cascading Style Sheet (CSS) specificati ons are maintained by the World Wide Web Consortium (W3C) to help introduce more consistency and structure into Web pages. Using them allows web developers to create a set of styles then apply them to all their Web pages uniformly. If a developer changes a st yle on the style sheet, all the pages that use that style are affected. For more information on CSS, see the W3C™s CSS page at http://www.w3.org/Style/CSS/ You can easily modify your style sheet file using any text editor in order to change the visual style of Banner Self-Service pages. Appendix A, Tag Mapping , has been provided to help you customize the Web pages. It shows how a number of items on the pages are created and influenced by specific tags. Note: When you modify CSS files, and when modified CSS files are redelivered, the new versions of the files must be copied to web server. See Chapter 2, fiConfiguring Self-Service Banner,fl in the Banner Middle Tier Implementation Guide , for instructions on dep loying files on the web server The style sheets delivered with the Self-Service products are external style sheets. If you place different styles in the tag of an HTML file, or within the HTML file itself, you will override the default styles. Using Web Tailor, you can specify a style sh eet file location at the following levels: ŁSystem - updated via Global User Interface Settings Database ObjectNaming Convention Cursors Up to 29 free-form characters followed by C. (For example, GetInfoC )FunctionsF_ followed by up to 28 free-form characters. (For example, F_ValidUser ).Procedures P_ followed by up to 28 free-form characters. (For example, P_OpenDoc )/n 25Banner Web Tailor User Guide |Technical Basics ŁModule - updated via Web Modules ŁWeb page - updated via Web Menus and Procedures These file locations are expressed as URLs; for example, /css/web_defaulthome.css is the location of one of the style sheets delivered with Web Tailor. As each page is displayed to the user, the browser formats the page and its contents according to the rules in one of the style shee ts (system, module, or Web page). The user- defined style sheet location that has the most specific information for that page is the one that the page uses. It places the location in an HTML tag inside the tag. Style sheets Web Tailor CSS files are stored in the wtlweb/htm subdirectory. During Banner implementation, the CSS files must be copied to your web server. See Chapter 2, fiConfiguring Self-Service Banner,fl in the Banner Middle Tier Implementation Guide, for instructions on setting up CSS files on the web server. Web Tailor includes the following CSS files for the default theme: Łweb_defaulthome.css This CSS contains the setting for the Self-Service home page. Łweb_defaultmenu.css This CSS contains the settings for the Self-Service menu pages. Łweb_defaultapp.css This CSS contains the settings for the Self-Service application pages. Note: web_defaulthome.css , web_defaultmenu.css and web_defaultapp.css are designed to be used together. It is recommended that your institution use them. Łweb_defaulthelp.css This CSS is present at all times, in addition to the CSS defined for the application pages. It defines any additional styles nec essary to present Help text to the user. Łweb_defaultprint.css This CSS controls the presentation of printed Web pages. You can modify it if, for example, you want web pages to print without their Info Text. Web Tailor includes the following CSS files for the Cascade theme: Łapp-overrides.css This CSS contains styles that override the default theme. Łcascasde.common.css /n 26Banner Web Tailor User Guide |Technical Basics This CSS contains common styles for the Cascade theme. Łcascade.css This CSS contains styles for the Cascade theme. Łcascade-luminis.css This CSS contains styles for th e Cascade theme when using Luminis. Łcommon-controls.css This CSS contains styles for common controls. Łcommon-platform.css This CSS contains styles for the common platform. Łie6.css This CSS contains styles to render pages in the Internet Explorer 6 browser. Łie7.css This CSS contains styles to render pages in the Internet Explorer 7 browser. Łie8.css This CSS contains styles to render pages in the Internet Explorer 8 browser. Łlogin.css This CSS contains styles for the Cascade theme login page. Łjquery.autocomplete.css This CSS is used by the autocomplete cont rol and is used for search functionality. Home page The home page is a Web menu rather than a static HTML page. You can customize it for your institution just as you would any other menu. To change the header information on the home page, choose Web Menus and Procedures , then select homepage from the pull-down list. You can specify the header text, header graphic, the CSS that controls the home page, etc. To change the contents of the home page , choose Menu Items, then select homepage from the pull-down list. You ca n specify the links that will app ear on the home page, and the order in which they will appear. For example, you may choose to display Secure Area, Campus Directory, and Apply for Admission on your institution™s home page. /n 27Banner Web Tailor User Guide |Technical Basics Self-Service featuresThis section describes the following feat ures available throughout Self-Service: ŁfiKeyword searchfl on page27 ŁfiHelp for Banner Self-Service productsfl on page30 ŁfiWeb Tailor Helpfl on page33 ŁfiSite Mapfl on page35 ŁfiDisplay of personal informationfl on page36 Keyword searchThis feature places a Search field at the top of the Web pages. Users can enter one or more words and search for the pages on which those words appear. The field can contain up to 35 characters. Note: In the Cascade theme, the keyword search has been renamed to Find a page .The search feature will only list pages that the user has permission to see. Banner Web Tailor will process the search and begin returning results as the user is typing. This increases the speed in which results are returned and the accuracy of the results because the user can see the results as the search is being entered. All search results will display on the current page to ensure that the user can easily refine the search if necessary. Note: This is applicable only for Cascade. Note: You can specify the minimum number of characters that must be entered before Ba nner Web Tailor will process the search. The application pages that match the search are displayed as links, sorted by the following priorities: 1.Info Text records with the label KEYWORD in the Web Tailor Repeating Information Text Table (TWGRINFO) 2.Menu names in the Web Tailor Repeating Menu Item Table (TWGRMENU) 3.Procedure and menu items in the Web Tailor Main Web Header Table (TWGBWMNU) 4.Info Text that does not have the label KEYWORD in the Web Tailor Repeating Information Text Table (TWGRINFO) /n 28Banner Web Tailor User Guide |Technical Basics Note: The Search field does not appear on the home page. Users must logon before Web Tailor can determine which pages they have the authority to access. The results page will not show duplicate entr ies or links to any web pages not used by your institution.You can include custom Web pages or additions to pages by adding them to your local Info Text with the label KEYWORD . This allows you to customize the search so that specific pages are returned for specific search strings since Info Text matches are the highest priority. For example, if you want the search string Location to also return an address update page, you can enter Location for the address update page as an Info Text Keyword entry. The number of results returned can be customized in the Web Tailor parameter MAXSEARCHRESULTS . You can change this value on the Web Tailor Parameters page. Note: Currently, the search will only reco gnize the first word search string as a single item. Multiple words will be treated as one string, so a search for Home Address will search for th e single phrase Home Address , not the word Home and the word Address .Configure search functionality (Cascade theme) To configure the minimum number of characters that must be entered before Banner Web Tailor will process the search, perform the following steps: Note: Search functionality can be configured only when using the Cascade theme. 1.Open the serviceProperties.js file. 2.Search for the SearchConstants section of the file. 3.Update the searchStartLengthto value from the default value of 1 to the desired value. var SearchConstants = { searchStartLength: '1' }4.Save the serviceProperties.js file. Searching by keyword To search for a Web page using a keyword: 1.In the Default theme, select the Search field at the top of the page or in the Cascade theme, select the Find a page field./n 29Banner Web Tailor User Guide |Technical Basics Note: The Search field does not appear on the home page. 2.Enter a string that pertains to the topic or page you want to see. 3.Select the Go button or press the Enter key. 4.If the search does not find any results, you can enter a different word or string into the Search field and try again. If the search does find results, a descriptive link to the page is displayed. The results are listed in priority order. Adding keywords To add keywords: 1.Logon to the Secure Area in Banner Self-Service. 2.Select Web Tailor Administration from the top links or the menu. 3.Select Information Text .4.Select the package name and corresponding procedure from the pull-down list. 5.Select Add a New Information Text Entry .6.At Select Label , skip over the pull-down list and enter KEYWORD in the field. You must enter it in capital letters. 7.Enter the keywords for that page in Information Text , separated by commas. 8.Select Submit Changes .You can customize the number of results returned: 1.Logon to the Secure Area in Banner Self-Service. 2.Select Web Tailor Administration from the top links. 3.Select Web Tailor Parameters .4.Locate the parameter MAXSEARCHRESULTS .5.Set the number to the value of your choice. 6.Save your changes. Search implementation The package TWBKSRCH is invoked when a user submits a search request. It presents links to each page on which the word is found and a description of that page. The links are displayed in the order in which they are found. This package searches through the Web Tailor Repeating Menu Item Table (TWGRMENU), looking for the values entered in the Search field.The search is conducted in the following order: /n 30Banner Web Tailor User Guide |Technical Basics 1.Items listed on the Web Tailor Repeating In formation Text Table (TWGRINFO) with the label KEYWORD , where TWGRINFO contains an occurrence of %Search String% .2.Items listed in the Web Tailor Repeating Me nu Item table (TWGRMENU), searching in the following columns: 2.1. TWGRMENU_NAME 2.2. TWGRMENU_URL_DESC 3.Items listed in the procedure/menu items table, the Web Tailor Main Web Header Table (TWGBWMNU), searching in the columns: 3.1. TWGBWMNU_DESC 3.2. TWGBWMNU_PAGE_TITLE 3.3. TWGBWMNU_HEADER 4.Items in the Web Tailor Repeating Information Text Table (TWGRINFO), searching on items that are not marked with the label KEYWORD.Help for Banner Self-Service products A system of help messages is now stored as Info Text with the label HELP . It was originally stored in the Self-Service produc ts in static HTML files. By ch anging it into Info Text, it will be much easier for non-technical users to customize and maintain. As with all other rows, Info Te xt Help records are stored in Web Tailor as Baseline. Info Text rows created by your institution using Web Tailor are stored as Local. You cannot modify Baseline rows. Info Text that is stored as Local is displayed fi rst. If there are no rows stored as Local, the Baseline rows are di splayed. This ensures th at your institution™s custom help will not be overwr itten with each Banner upgrade. This help is displayed when the user selects the Help link in the upper right-hand corner of the Web page. The help text appears in a new window, and includes an Exit link at the bottom of each window. A CSS for global-level help, web_defaulthelp.css , is provided. It will be used in addition to the CSS defined for that page. This style sheet will be present at all time s in addition to the CSS defined for the application pages. It defines any additional styles necessary to present help text to the user. Creating and modifying help To create or modify help text: 1.Logon to Banner Self-Service, entering the Secure Area. 2.Access Web Tailor Administration .3.Select Information Text ./n 31Banner Web Tailor User Guide |Technical Basics 4.Choose the web page where you want the text to appear from the pull-down list and select Customize Information Text .5.If you want to modify existing Info Text, select its label. To create new Info Text, select Add a New Information Text Entry. 6.If you are modifying existing Info Text, it will be displayed. Otherwise, select HELP from the pull-down list. 7.Enter the text in the Information Text field or modify the text being displayed. Note: You cannot include an image with Help Info Text. 8.If you have any information to add that you do not want to appear in the help, add it in the Comments field.9.Save your changes. 10. To enter an additional paragraph of text, select Add a New Information Text Entry , and continue from Step 6. Separating help text into paragraphs Web Tailor treats Info Text with the label HELP differently than other kinds of Info Text. For Info Text with other labels, Web Tailor concat enates all the fields of text, displaying it as one paragraph. To separate it into multiple paragraphs, you must use a

tag to indicate the end of each paragraph. Web Tailor puts Info Text labeled HELP into separate paragraphs if you enter it in separate fields with different sequence numbers. You do not need to use an HTML tag to do this. Setting up a CSS for help Note: You must have the Web Tailor Administrator role to set up a CSS. To use a CSS to format a particular help Web page: 1.Logon to the Secure Area. 2.Select Web Tailor Administration .3.Select Web Menus and Procedures .4.Choose the name of the procedure that generates the Web page for which you want to customize help from the pull-down list, and select Customize Web Menu or Procedure.5.Enter the location of yo ur help files in the Help URL field (this populates twtvmodu_help_url ).6.Select Submit Changes .To use a CSS to format all the help pages of a particular module: /n 32Banner Web Tailor User Guide |Technical Basics 1.Logon to the Secure Area. 2.Select Web Tailor Administration .3.Select Web Modules. 4.Choose a module from the pull-down list and select Customize Module .5.If you want to replace Info Text help with a st atic HTML page, enter the location of your file in the Help URL field (populates twtvmodu_help_url ).If you want to use Info Te xt help, clear this field. 6.Enter the location of the CSS that will determine t he format of your help text in the Help CSS field (populates twtvmodu_help_css ).7.Select Submit Changes. To use a CSS to format all the Help Info Text in all your Self-Service products: 1.Logon to the Secure Area. 2.Select Web Tailor Administration .3.Select Global User Interface Settings .4.If you want to replace Info Text help with a st atic HTML page, enter the location of your file in the Module Help URL field.If you want to use Info Te xt help, clear this field. 5.Enter the location of the CSS that will determine t he format of your help text in the Help CSS URL field.6.Select Submit Changes .Help implementation The following columns are provided for storing the locations of CSSs: 1.Package/procedure-level help ( TWGBWMNU_HELP_CSS )2.Module-level help ( TWTVMODU_HELP_CSS )3.Global- or system-level help ( TWGBGLUI_HELP_CSS )The procedure twbkwbis.p_opendoc will search the columns in the order listed. In addition, the same three levels of customiz ation exist for clients who choose to use their own static HTML help. Prior releases did not have this level of co ntrol for static HTML. TWBKWBIS.P_OPENDOCThis procedure has a parameter, suppress_header , which identifies the page as being a help page. This allo ws the page to be formatted according to the Help CSS instead of the same CSS that formats the rest of the page. It looks for the help URLs in order: /n 33Banner Web Tailor User Guide |Technical Basics First, twbkwbis.p_opendoc looks to see if the module /procedure-level help URL (twbklibs.twgbwmnu_rec.twgbwmnu_help_url ) is not null. If that is the case, it will display the help as defined by that URL. If the module/procedur e-level help URL is not populated, twbkwbis.p_opendoc looks to see if there are any Help Info Text records availabl e. If so, then they will be displayed in a help window. If the Help Info Text records do not exist, twbkwbis.p_opendoc now looks to see if the module-level help URL ( twbklibs.twtvmodu_rec.twtvmodu_help_url ) is populated. If that is the case , it will create the help link that corresponds to that URL. This is added functionality at the module level to correspond to the other three level feature enhancements to Web Tailor. If the module help link does not exist, the system will check to see if the global help link (twgbglui_rec.twgbglui_help_url ) is populated. If it is, it will create the help link using that URL. System-level CSSThe CSS for Help text is web_defaulthelp.css . The procedure twbkbwis.p_opendoc searches for this CSS if it cannot find a module-level or page- level Help CSS. It applies to all the Help Info Text in all your Self-Service. Web Tailor Help The static HTML files that describe Web Tailo r itself were not changed into Info Text. If you modify HTML files, or if they are redeliv ered in a future release, the modified files must be copied to your web server. See Chapter 2, fiConfiguring Self-Service Banner,fl in the Banner Middle Tier Implementation Guide , for instructions on se tting up HTML files on the web server. The following are the only remaining static HTML files that contain Help text. File NameDescription twbhcont.htm Web Tailor Contents twbhmenu.htm Web Tailor Help Menu twbhpmcu.htm Customize a Web Tailor Parameter twbhtero.htm Reorder or Customize Information Text twbhgrcu.htm Customize a Graphic Element twbhitro.htm Reorder or Customize Menu Items twbhmocu.htm Customize a Module /n 34Banner Web Tailor User Guide |Technical Basics Each Web Tailor menu item is documented online. You access Help by selecting Help from any Web Tailor page. You may also customize Web Tailor™s help files. As the Upgrade Guide for Web Tailor instructs, create a directory on the web server for the Web Tailor help pages ( wtlhelp ). Then customize the files using either of these methods: ŁMake changes to the pages in the existing directory by customizing the HTML. Using this method, the context-se nsitive links are preserved. However, when the Help is upgraded, the customized files are overwritten. ŁCreate a directory at the same level as wtlhelp for your custom help pages -- give the directory a unique name, such as myhelp . Copy the pages you wish to modify from wtlhelp into the new directory, and make your changes. When the next release of Web Tailor calls for Help to be installed in your wtlhelp directory, your customized pages in your myhelp directory will be preserved. If yo u want your new help pages to be context-sensitive, go to the corresponding application page in Web Tailor™s Web twbhpmfm.htm Create a New Web Tailor Parameter/Customize the Selected Web Tailor Parameter twbhuifm.htm Customize Global User Interface twbhgrfm.htm Create a New Graphic Element /Customize the Selected Graphic Element twbhjclr.htm Obsolete twbhmofm.htm Create a New Module/Customize the Selected Module twbhrufm.htm Customize Web Rules twbhwmcu.htm Customize a Web Menu or Procedure twbhindx.htm Web Tailor Online Help Index twbhlocu.htm Customize Login Return Location twbhovcu.htm Customize a Web Tailor Override twbhtecu.htm Select Information Text to Customize twbhwmfm.htm Create a Web Menu or Customize an existing one twbhitcu.htm Select Menu Items to Customize twbhlofm.htm Create a New Return Location/Customize the Selected Return Location twbhovfm.htm Create a New Web Tailor Override /Customize the Selected Web Tailor Override twbhtefm.htm Create a New Information Text Entry/Customize the Selected Information Text Entry File NameDescription /n 35Banner Web Tailor User Guide |Technical Basics Menus and Procedures, and change the Help URL to point to your myhelp directory instead of wtlhelp.Warning! If you choose the second method , the links to the Contents and Index for Web Tailor at the top of each page will not open your customized pages, because they point to wtlhelp . If you require the Contents and Index functions, you must open the HTML pages for the Contents and Index and change the link to point to your new directory. You may also disable the help if you choose. To do this, delete the Help URL in Web Menus and Procedures for the appropriate page. The delivered help is stored as Baseline. Any help you create is stored as Local, so your changes will not be overwritten by later releases. Site MapUsers go to a Site Map when they are looking for a specific piece of information from crowded menus. The Site Map is a simple list of links for all the web pages in the Self- Service product, which can help the users get a feel for the information architecture and how to find what they want. The Site Map appears on a separate web page accessible by selecting the Site Map link. It contains a list of all the items on all the menus in your installation. There are no fields on it, only links to the various web menus and pages. The items on the Site Map are indented to s how how the pages reside under the menus and submenus. The more an item is indented , the lower it appears on the menu tree. The Site Map shows up to three levels of menu items, although you can define any number of sublevels for your menus. Initially the Site Map displays two levels in a three- column display. Select the Show Details button to see three levels in a two-column display and select the Hide Details button to return to a three-column display. Site map links that contain submenu items will take you to a menu page. Items that are application pages will take you directly to that application page. All users will have access to the Site Map, but they will see only links to pages they have permission to access. Note: Bottom-of-the-page links do not appear on the Site Map. Using the Site MapTo see the Site Map, click the Site Map link.Note: The Site Map cannot be accessed from the home page because access to the links on the Site Map can only be determined after the user logs on./n 36Banner Web Tailor User Guide |Technical Basics To change the look and feel of the Site Ma p, update the CSS that controls its format, web_defaultapp.css . The following CSS classes control the presentation of the Site Map items: Ł-sitemaplevel1 controls first level (Main Menu) items Ł-sitemaplevel2 controls second level items Ł-sitemaplevel3 controls third level items. To add items to the Site Map, simply add them to the appropriate menu item in Web Tailor. They will appear automatically on the Site Map. For more in formation about adding items to a menu, refer to the Banner Middle Tier Implementation Guide .Site Map implementation The TWBKSITE package contains the proc edure that generates the Site Map, twbksite.p_dispsitemap . It searches through the Web Tailor menu tree and display all the links to the pages on one page. This package contains the following public items:ŁA procedure, twbksite.p_dispsitemap , which displays the Site Map ŁA function, getsitemap_c , which populates a PL/SQL table with an entire menu when passed the name of that menu Display of personal information You can display specific information for the current end-user at the top of the Web pages that user is accessing. For example, you can display: ŁThe student™s name ŁThe current term ŁThe date ŁThe time You can have a maximum of four lines of information in the headers. The information that appears in the headers depends on the Self-Service product the person is using. For example, the informati on the person sees in Advancement Self- Service would be different from what they see when they access Employee Self-Service. Web Tailor provides the mechanism for displayi ng the information; the individual products determine what information is shown to the users. For instructions on displaying specific information, please refer to the product-specific documentation. The style

supports this feature. You can add various attributes to modify th e look and feel of the text. /n 37Banner Web Tailor User Guide |Technical Basics For example, adding the attribute text-align with the value right will right-justify the text in the headers: DIV.staticheaders { text-align:right; }To prevent this information from appearing on your institution™s web pages, you can add the attribute display with the value none, for example: DIV.staticheaders { display:none; }Printing is controlled by a different CSS, web_defaultprint.css . You can keep the static header information from appearing on printed Web pages by including the following in web_defaultprint.css :DIV.staticheaders { display:none; }Institution identifierIf your institution is using Banner™s Multi-In stitution Functionality (MIF), an institution identifier can be displayed in th e header of all Self-Service web pages. This identifier will display only if your Banner implementation has been set up for MIF, and then only if the new Web Tailor HEADERDISP parameter is set to Y. (The HEADERDISP parameter can be set on the Customize a Web Tailor Parameter page.) When the institution identifier appears, it indicates the institution code, as in this example: Your current institution is OCC .If the web page displays user ID and date in the header, the institution identifier appears directly below the date. Printing web pages Creating a printer-friendly page This CSS is present at all times, in addition to the CSS defined for each page. It provides support for printing from the Web by helping the other CSS handle page breaks, page boxes, and media dependencies. It suppresses header links, bottom links and images present in header area, so the only thing that prints is the content of most interest to the user. If you have to make modifications to the web_defaultprint.css , keep in mind that the CSS will only be used when users invoke it with the Print option from the File menu of /n 38Banner Web Tailor User Guide |Technical Basics the browser. The browser picks up the web_defaultprint.css , the Self-Service products do not. Printing without Info Text Web Tailor can be set up to with a default to print a page without its Info Text. This may be useful in situations where there is a lot of data and you want to reduce the number of pages you will be printing. To suppress printing Info Text, edit web_defaultprint.css , adding the following: DIV.infotextdiv { display: none }/n 39Banner Web Tailor User Guide |Using Web Tailor Using Web Tailor Web Tailor lets you build, customize, and mo dify the pages in your institution™s Web systems. It is a component of ever y BannerŽ Self-Service application. Not every Self-Service application uses all of the pages of Web Tailor -- for example, the Advancement Self-Service Ru les page is used only with Advancement Self-Service. Although Web Tailor is a separate product, its effects appear only when used in conjunction with Banner Self-Service. All of the applications require both Web General and Web Tailor. Keep in mind that there are three levels of settings maintained in Web Tailor: 1.Global - applies to all the Self-Service products 2.Module - applies to a single module, e.g., Student Self-Service 3.Procedure - applies to a single procedure, e.g., bwgkomar.P_SelectMtypUpdate (Update Marital Status) This chapter describes the following Web Tailor features: ŁfiWeb Tailor menufl on page40 ŁfiWeb menus and proceduresfl on page45 ŁfiMenu itemsfl on page49 ŁfiInfo Textfl on page52 ŁfiUser rolesfl on page55 ŁfiWeb rulesfl on page56 ŁfiWeb modulesfl on page62 ŁfiGlobal user interface settingsfl on page63 ŁfiWeb Tailor parametersfl on page65 ŁfiGraphic elementsfl on page74 ŁfiLogin return locationfl on page75 ŁfiWeb Tailor overridesfl on page76 ŁfiLDAP administrationfl on page77 /n 40Banner Web Tailor User Guide |Using Web Tailor Web Tailor menu To get to the Web Tailor menu, select Secure Area and logon using your ID and password. The Main Menu appears. Select Web Tailor Administrator from the Navigation Bar links or from the menu, and the Web Tailor Menu appears. It includes the following options: ŁWeb Menus and Procedures ŁMenu Items ŁInformation Text ŁUser RolesŁWeb Rules ŁWeb Modules ŁGlobal User Interface Settings ŁWeb Tailor Parameters ŁGraphic Elements ŁLogin Return Location ŁWeb Tailor Overrides ŁAdvancement Self-Service Rules (Advancement Self-Service) ŁFinance Site Preferences (Finance Self-Service) ŁLDAP AdministrationŁPassed Planned Moves Exist (Advancement Self-Service) ŁChannel Maintenance (only if you are using Banner Channels for Luminis®) ŁChannel Preference (only if you are using Banner Channels for Luminis) Web Tailor Utility Report pages These six reports let you review Web menus/ procedures, menu items, information text, and role settings being delivered for specific Web products through a web browser instead of SQLPlus. The compare reports display the production baseline, local, and/or install data on the same web page. This allows you to decide which of the updates you want to apply to your production system, or which ones you might want to update manually, depending on the customizations you have done. Use these reports when you install the Self-Service upgrades. /n 41Banner Web Tailor User Guide |Using Web Tailor The view reports allow you to view the contents of four specific tables via the web page. Use these reports anytime, or when you install the Self-Service upgrades. Compare reports Three Web-based reports delivered with Web Tailor display the contents of the twgbwmnu, twgrinfo, twgrmenu, and twgrwmrl tables, enabling administrators to compare new delivered data with their existing data: Łcmprmenu.sql (twgrmenu table) Łcmprinfo.sql (twgrinfo table) Łcmprwmnu.sql (twgbwmnu and twgrwmrl tables) The scripts are located in the Web Tailor Plus directory. Logon to SQLPlus as the wtailor schema owner and run the scripts to create the packages. These scripts will create the public synonyms and grants the user needs to run them on the Web. To get to the reports on the Web, the user must point his Web browser to the following: http://///cmprwmnu.p_start where: is the name of your Web server running Oracle 10g is the Data Access Descriptor; use pls for iAS is the name of the Apache HTTP listener defined by your systems administrator You can substitute cmprinfo or cmprmenu in place of cmprwmnu .The compare reports are accessible only by users defined as Web Tailor Administrators. These reports are part of a menu, which is delivered as Not Enabled since the reports are not a standard option. To enable the menu, perform the following steps: 1.Login as a user that has a Web Tailor Administrator role. 2.Click the Web Tailor Administration tab. 3.Select Web Menus and Procedures 4.Enable bmenu.P_WTUtilityReportsMnu. Note: If the reports have been compiled, they are accessible by a Web Tailor administrator by entering the URL directly. Compare reports Procedures are as follows: 1.Select the name of the product 2.Select the type of table you wish to query. /n 42Banner Web Tailor User Guide |Using Web Tailor The wtailor user must have select privileges on the specified tables. Please ensure that any necessary synonyms or grants are in place before selecting from a non- wtailor table. If you choose to query other ta bles, please be sure to enter the table name correctly and select the appropriate table owner. 3.Select the Owner. View reports Three other Web-based reports delivered with Web Tailor display the contents of the twgbwmnu, twgrinfo, and twgrmenu tables, e nabling administrators to view production, install, or other local tables. They are simila r to the comparison reports, but only look at one table at a time. These scripts are: Łviewmenu.sql (twgrmenu table) Łviewinfo.sql (twgrinfo table) Łviewwmnu.sql (twgbwmnu and twgrwmrl tables) Logon to SQLPlus as the wtailor schema owner and run the scripts to create the packages. The scripts are located in the Web Tailor Plus directory. These scripts will create the public synonyms and grants the user needs to run them on the Web. To get to the reports on the Web, the user must point his Web browser to the following: http://///viewwmnu.p_start where: is the name of your Web server running Oracle 10g is the Data Access Descriptor; use pls for iAS is the name of the Apache HTTP listener defined by your systems administrator You can substitute viewmenu or viewinfo for viewwmnu .View reports Procedures are as follows: 1.Select the name of the product 2.Select the type of table you wish to query. The wtailor user must have select privileges on the specified tables. Please ensure that any necessary synonyms or grants are in place before selecting from a non- wtailor table. If you choose to query other ta bles, please be sure to enter the table name correctly and select the appropriate table owner. You must enter values for both copies of the parameters. /n 43Banner Web Tailor User Guide |Using Web Tailor 3.Select the Owner. The rest of this section describes, in detail, the Web Tailor options. Please refer to the product-specific user guides for the other options. For more information about channels, please refer to the Banner Channels for Luminis documentation. Web Tailor Utility Report pages These six reports let you review Web menus/ procedures, menu items, information text, and role settings being delivered for specific Web products through a web browser instead of SQLPlus. The compare reports display the production baseline, local, and/or install data on the same web page. This allows you to decide which of the updates you want to apply to your production system, or which ones you might want to update manually, depending on the customizations you have done. Use these reports when you install the Self-Service upgrades. The view reports allow you to view the contents of four specific tables via the web page. Use these reports anytime, or when you install the Self-Service upgrades. Compare reports Three Web-based reports delivered with Web Tailor display the contents of the twgbwmnu, twgrinfo, twgrmenu, and twgrwmrl tables, enabling administrators to compare new delivered data with their existing data: Łcmprmenu.sql (twgrmenu table) Łcmprinfo.sql (twgrinfo table) Łcmprwmnu.sql (twgbwmnu and twgrwmrl tables) The scripts are located in the Web Tailor Plus directory. Logon to SQLPlus as the wtailor schema owner and run the scripts to create the packages. These scripts will create the public synonyms and grants the user needs to run them on the Web. To get to the reports on the Web, the user must point his Web browser to the following: http://///cmprwmnu.p_start where: is the name of your Web server running Oracle 10g is the Data Access Descriptor; use pls for iAS is the name of the Apache HTTP listener defined by your systems administrator You can substitute cmprinfo or cmprmenu in place of cmprwmnu ./n 44Banner Web Tailor User Guide |Using Web Tailor The compare reports are accessible only by users defined as Web Tailor Administrators. These reports are part of a menu, which is delivered as Not Enabled since the reports are not a standard option. To enable the menu, perform the following steps: 1.Login as a user that has a Web Tailor Administrator role. 2.Click the Web Tailor Administration tab. 3.Select Web Menus and Procedures 4.Enable bmenu.P_WTUtilityReportsMnu. Note: If the reports have been compiled, they are accessible by a Web Tailor administrator by entering the URL directly. Compare reports Procedures are as follows: 1.Select the name of the product 2.Select the type of table you wish to query. The wtailor user must have select privileges on the specified tables. Please ensure that any necessary synonyms or grants are in place before selecting from a non- wtailor table. If you choose to query other ta bles, please be sure to enter the table name correctly and select the appropriate table owner. 3.Select the Owner. View reports Three other Web-based reports delivered with Web Tailor display the contents of the twgbwmnu, twgrinfo, and twgrmenu tables, e nabling administrators to view production, install, or other local tables. They are simila r to the comparison reports, but only look at one table at a time. These scripts are: Łviewmenu.sql (twgrmenu table) Łviewinfo.sql (twgrinfo table) Łviewwmnu.sql (twgbwmnu and twgrwmrl tables) Logon to SQLPlus as the wtailor schema owner and run the scripts to create the packages. The scripts are located in the Web Tailor Plus directory. These scripts will create the public synonyms and grants the user needs to run them on the Web. To get to the reports on the Web, the user must point his Web browser to the following: http://///viewwmnu.p_start where: is the name of your Web server running Oracle 10g /n 45Banner Web Tailor User Guide |Using Web Tailor is the Data Access Descriptor; use pls for iAS is the name of the Apache HTTP listener defined by your systems administrator You can substitute viewmenu or viewinfo for viewwmnu .View reports Procedures are as follows: 1.Select the name of the product 2.Select the type of table you wish to query. The wtailor user must have select privileges on the specified tables. Please ensure that any necessary synonyms or grants are in place before selecting from a non- wtailor table. If you choose to query other ta bles, please be sure to enter the table name correctly and select the appropriate table owner. You must enter values for both copies of the parameters. 3.Select the Owner. Web menus and procedures The Web Menus and Procedures option lets you create a new menu or procedure, or choose an existing one from the list by clicking its Procedure Name . Either choice brings you to the Web Menus and Procedures page. Note: The list order is controlled by Display Descriptive Names on the Web Rules page. If checked, then the list is ordered by Description; if unchecked, it is ordered by procedure name. You can optionally do a text search for a web menu or procedure, and then select from the list of search results. You can search by the Name of the web menu or procedure, or by its Description.To search for and select a web menu or procedure: 1.Type the full or partial name in the Search by Name field, or the full or partial description in the Search by Description field. Search text is not case-sensitive. Note: If you enter search terms in both fields, Search by Name will take priority and the terms in Search by Description will be ignored. 2.You can use % as a wildcard character in either field, or _ as a single-character wildcard.3.Select Search./n 46Banner Web Tailor User Guide |Using Web Tailor 4.Select the web menu or procedure from the list of search results, or search again. /n 47Banner Web Tailor User Guide |Using Web Tailor Web Page Fields ItemDescription Page Name The name of the web page you are creating or modifying. Required. Description The description of the page. Required. Module The name of the Self-Service product to which the page belongs. You can use this field to make queries, but you should not change the delivered values. If your institution creates its own entri es for this table, you may select your own modules. Required. Comments Enter any comments about the page. Enabled IndicatorIf the check box is selected, the page can be accessed from menus and other pages. Otherwise, it cannot. Non Secured Access AllowedSelect the check box if users can access this page without entering a user ID and password. Web Page Caching Override Sets the web page caching method for browsers that support it. Valid values are: Use the system setting Allow Caching Do Not Allow Caching Page Title The page title that displays at the top of the page. Header Text The page header. Header Graphic The name of the graphic you want at the top of the page. Page CSS URL The name of the cascading style sheet you want to use for the web page. Map Title The map name to use for the TITLE attribute in the htp.mapopen function called at the beginning of twbkfrmt.p_printmenu .Help Link URLThe URL that contai ns the help file for this page. Help CSS URLThe cascading style sheet you would like to use for the Help. Print CSS URLThe cascading style sheet you would like to use for the printing of the web page. Back Link URL:The URL of the previous page. Back Link Text:The text that appear s when the user places their mouse on the Back link./n 48Banner Web Tailor User Guide |Using Web Tailor The available roles are listed at the bottom of the page. You must select the appropriate check boxes to give different types of user s access to your menu. There may be other requirements, though. Please see the specif ic Self-Service product documentation for information about each one. When you customize a web menu or procedure, a local copy of the menu or procedure is created and you are actually customizing the local copy, not the baseline copy. The baseline data is shown alongside the local data, with a flag icon indicating where the data differs. Generating menu pages Menu pages can be easily generated by calling the existing procedure twbkwbis.P_GenMenu ; when you use the submenu indicator on the Customize the Selected Menu Item page, that procedure is automatically used. It is highly recommended that functional pages call twbkwbis.P_OpenDoc to generate the HTML document open, title, body, and header tags that begin a page. P_OpenDoc uses the information provided in twgbwmnu when it generates this code. The procedure twbkwbis.P_CloseDoc prints any bottom-of-page links associated with the page. P_OpenDoc also provides accessibility functionality. Parameter print_module_bottom-links was added to suppress module bottom links for printing. The default value for this parameter is true.All procedures which use P_OpenDoc to open the page must use P_CloseDoc to close the page, and vice versa, due to We b Tailor™s use of HTML tables for page formatting purposes. Note: P_CloseDoc cannot be used in a page unless P_OpenDoc is also called. Please refer to any of the General Web packages for a Back Link Image:The image you want users to select to move to the previous page. Back Link Menu Indicator: Select the check box if you want the back link URL to display. Admin SecuredIndicates if the Web page is secured under the VBS and PII rules set up in Banner. Valid values are: Y - an Oracle username and password will be required to access the pa ge, and the VBS a nd PII rules (as defined in Banner for the user™s role, e.g., Faculty ) will apply to the user™s activi ties for the duration of the user™s session. N - there are no special restrictions on this page. ItemDescription /n 49Banner Web Tailor User Guide |Using Web Tailor specific example of the P_OpenDoc and P_CloseDoc procedures (for example, twbkwbi1.sql ).Menu itemsThe Menu Items option lets you create or change the items on your menus. Click Create or click the Procedure Name of a menu from the list. Note: The list order is controlled by Display Descriptive Names on the Web Rules page. If checked, then the list is ordered by Description; if unchecked, it is ordered by procedure name. You can optionally do a text search for a web menu, and then select from the list of search results. You can search by the Name of the web menu or procedure, or by its Description .To search for and select a web menu: 1.Type the full or partial name in the Search by Name field, or the full or partial description in the Search by Description field. Search text is not case-sensitive. Note: If you enter search terms in both fields, Search by Name will take priority and the terms in Search by Description will be ignored.2.You can use % as a wildcard character in either field, or _ as a single-character wildcard.3.Select Search.4.Select the web menu from the list of search results, or search again. Reorder or customize menu itemsBaseline menu items cannot be modified. You must copy them to Local and change the Local version. For more information on Baseline and Local, please refer to fiTechnical Referencefl on page86 /n 50Banner Web Tailor User Guide |Using Web Tailor Web Page Fields To change the order in which the menu it ems will appear, change t he sequence numbers and select Reorder these Elements .To customize a menu item, select its link. Customize the Selected Menu ItemA menu item can be customized by modifying the following values: ItemDescription Sequence NumberThe number that orders the display of menu or procedure items. Required. SourceIndicates if the item is Baseline or Local. Display-only. Link TextThe text that will appear on the menu for this link. Optional. URLThe URL of the page that is displayed when the user selects the menu item. Required. EnabledIndicates whether the page is enabled or not. YŠEnabled N ŠNot enabled /n 51Banner Web Tailor User Guide |Using Web Tailor Web Page Fields ItemDescription Associated Web PageThe package.procedure of the menu that the item appears on. Sequence NumberThe number that orders the display of menu or procedure items. Required. URLThe URL of the page that is displayed when the user selects the menu item. The package.procedure or menu name that will be call ed when the user selects the item. A string of text or an HT ML image tag can be specified as the hyperlink. Required.Link TextThe text that will appea r on the menu for this link. Optional. Link DescriptionThe description that appears below the link on the menu. Status Bar TextThe text that appear s on the Status Bar when you rest your cursor over the menu item. Bullet Override ImageThe Web Tailor name for the image at the left side of the link.Menu Link ImageThis field contains the optional image name to be displayed before the hyperlink defined in the Link field for menu definitions only. Enabled Indicates if is field is used by web procedures to determine which menu or procedure items will be displayed on the web page. For example, if you do not want users to be able to change their Emergency Contacts from the Personal Information Menu, set that item™s Enabled Indicator to N, and the link will not appear in that menu. Valid values are: Selected - enabled Cleared - disabled Null - disabled Database ProcedureSpecifies if the menu item is a database procedure. Valid values are: Selected - The item is a stored procedure Cleared - It is a menu item, a regular URL Null - It is a menu item Submenu IndicatorIndicates if the URL will call a Web Tailor menu. Valid values are: Selected - Submenu Cleared - Not a submenu Null - Not a submenu /n 52Banner Web Tailor User Guide |Using Web Tailor Adding new menu itemsThere are two types of menu items, those disp layed on a menu page and those displayed at the bottom of a functional page, also called bottom-of-page links .It is recommended that you use the existing procedure twbkwbis.P_GenMenu to display menu pages. In fact, if you set a menu item's Sub(menu) indicator to checked, P_GenMenu will automatically be called when that link is selected. Bottom-of-page links are best displayed by calling twbkwbis .P_CloseDoc .Modifying existing menu itemsWhenever you add, delete, or make a menu it em inactive, you should examine the menu items on the page which is being linked. Generally, if you can get from page A to page B through a bottom-of-page link, you should also be able to get from B back to A through another link. So, if you add a link from the View E-mail Addresses page to the View Addresses and Phones page, you should probably also add a link to View Addresses and Phones which will take the user to View E-mail Addresses. Also, remember that menu items can only be accessed if the user has appropriate roles. For example, you should not move the Display Grades item to an Employee menu, because students would not be able to access it. Menu items may be temporarily disabled with out deleting them. This may be very useful for pages which allow student registration or employee open enrollment. When these functions are not allowed by your institution, simply clear the Enabled indicators. Your menu item information will be preserved for the nex t time the function should be available. Whenever you enable or disable menu items, make sure you find all the occurrences of the link. For example, View Addresses an d Phones is available from the Personal Information menu, the Update Addresses an d Phones page, and Update Addresses and Phones page. Info Text Info Text is a brief set of instructions or information that the user may find helpful when looking at a page. In certain cases, such as for the login procedures, Info Text may be error messages that your institution can cust omize. You may also specify a graphic which will call attention to the text, and HTML tags ca n be embedded directly into the text. The delivered data is displayed after a text graphic with the letter i in the center (web_info.gif ). The text usually has a paragraph break (

) at the end. Info Text is broken into multiple records, each with a sequence number and label. All records belonging to the sa me procedure name and the same label will be printed together in the order indicated by the sequ ence numbers. Most pages display Info Text only at the top of the page, and those records are usually labeled DEFAULT. However, if a page has special uses for Info Text, as the twbkwbis.P_ValLogin procedure does, the labels will contain text that indicates their use. /n 53Banner Web Tailor User Guide |Using Web Tailor All of the labels have been used in the so urce code, and they should not be modified in any case. You may however, add, delete, or modify records for existing procedure name/ label combinations.Select Info Text to customize To create or modify Info Text, select Information Text from the Web Tailor menu. Click Create or choose an item from the list by clicking its Procedure Name .Note: The list order is controlled by Display Descriptive Names on the Web Rules page. If checked, then the list is ordered by Description; if unchecked, it is ordered by procedure name. You can optionally do a text search for a web menu, and then select from the list of search results. You can search by the Name of the web menu or procedure, or by its Description .To search for and select a web menu: 1.Type the full or partial name in the Search by Name field, or the full or partial description in the Search by Description field. Search text is not case-sensitive. Note: If you enter search terms in both fields, Search by Name will take priority and the terms in Search by Description will be ignored.2.You can use % as a wildcard character in either field, or _ as a single-character wildcard.3.Select Search.4.Select the web menu from the list of search results, or search again. Reorder or customize info textWith the exception of DEFAULT all labels are triggered by the logic programmed into the page. The program that generates the Web page has specific locations where it may look to display Info Text with a specif ic label. You can customize the text, but you cannot change the place on the page that the text is displayed. To modify this text, Select Copy Baseline entries to Local , then select the label of the text you want to change. The Customize the selected Information Text Entry page appears. Make your changes and save them. Info Text has been written to be used with all the Self-Service products. If your institution has not licensed all the products, you may want to customize some of the messages to refer to only those which you have. /n 54Banner Web Tailor User Guide |Using Web Tailor Warning! It is very easy to affect the en tire page™s appearance by making an HTML error in the Info Text. Please test your changes thoroughly. Web Page Fields Info Text in SSB footer Beginning with the 8.4 release, you can add in formation text at the bottom of a page. Previously, the user could enter information text only at the top of the page. There were occasions when additional information was required on a page, but adding this information at the top of the page cluttered it. 1.Users can now create info text for any pages desired using FOOTER_BEFORE_LINK or FOOTER_AFTER_LINK (the link that is the separator is the list of hyperlinks typica lly listed at the bottom of a web page). 2.Users can now add an info text for GLOBAL_FOOTER or GLOBAL_FOOTER_xxx associated with the twbkswbis.P_WWWLogin procedure that would then be displayed on all pages. Here xxx refers to the package name that starts with xxx. For example, GLOBAL_FOOTER_BWP would be displayed on all the payroll pages (since ItemDescription Associated Web PageThe package.procedure for the Web page. Sequence NumberThe sequence number indicates in which order this text will appear, if more than one item is to be displayed. LabelIdentifies the individual re cord of Info Text that will be displayed in a single area of the web page. Multiple records of information can be displayed anywhere that Info Text appears on any web page. Required. Your labels should consis t of capital letters only. Information TextThe text that should display for this record. Text may include HTML tags such as italics, line breaks or images, although it is recommended th at you minimize your use of HTML for the sake of simplicity, and because it is difficult to diagnose page display problems caused by incorrect HTML in Info Text. You may continue text in the next record with the same label if you need more space. Be sure to set up the sequence numbers to display your text appropriately. Image The file name of the image to be displayed before the Info Text. Comment A comment to describe the record. /n 55Banner Web Tailor User Guide |Using Web Tailor those packages all begin with BWP, BWS would be for student), and then GLOBAL_FOOTER which would be displayed on all pages. 3.The FOOTER_BEFORE_LINK and FOOTER_AFTER_LINK would be info text created on the specific page where the GLOBAL_FOOTER_xxx and GLOBAL_FOOTER would be created on the twbkwbis.P_WWWLogin page. Note: Due to the nature and flexibility of this infotext, you cannot use the image on the Customize In fo Text. Instead of this, you will have to include the image in the infotext. Coding a link to open a new browser windowYou can manually add target="blank" to HTML tags in link text entries as needed to make the links open in a new browser window. The example below demonstrates how this works. User rolesUser roles in Self-Service determine what me nus are displayed after logging on and what each person has access to. Users can see and access only those menu items that their roles authorize them to see. A user may have more than one role. Note: Do not confuse the concept of web user roles with the Oracle roles used in Banner security. For information about Banner security™s use of roles, see the Banner Security Administration Handbook. To assign roles to a person, select User Roles from the Web Tailor menu. Enter the person™s user ID, then select Submit.Select the check boxes that correspond to the roles you want that user to have, then save your changes. For more information and a partial list of roles used in Banner Self-Service, see fiWeb rolesfl on page99 .This link will open the specified page in the same window:Social Security Online This link will open the specified page in a new browser window: Social Security Online /n 56Banner Web Tailor User Guide |Using Web Tailor Web rules Web rules are global settings. They affect all your Self-Service applications. Note: The programming logic in Web Tailor that authenticates user credentials is bypassed if your institution uses LDAP to authenticate Banner Self-Service. Any web rules that pertain to user logons will be ignored. To define and customize web rules, select Web Rules from the Web Tailor Menu. /n 57Banner Web Tailor User Guide |Using Web Tailor Web Page Fields ItemDescription CGI-BIN Directory Enter the path of the Web server (CGI-BIN) directory. This column specifies th e Oracle Apache PL/SQL Agent service name and OWA program name that is used to construct URLs. This can also specify a third- party Web server™s CGI binary directory that will execute the Oracle Apache PL/SQL Agent program. Required. CGI-BIN Admin Directory Suffix Contains the suffix of the administrative path for the Oracle DAD. This is used when the Oracle FGAC utility is being used in Banner Self-Service. VBS allows you to restrict access to what users can see and update on various Web pages. You must set up the restrictions in Banner General. For more information, please refer to the Banner Data Security Handbook .Web Timeout in minutesEnter the number of minutes without activity before the current session is disabled. Required. Beginning with Release 8.4, the Web Rules page enables the setting of timeout values by role. This will enable users that have certain roles to have a longer timeout period than the one system value that has been used in the past. The user timeout value will now be the greater of the system value or any of the roles that are associated with the individual user. If the system timeout is 30 minutes and a student role has an override of 15 minutes and employee override of 45 minutes, a student only ro le person will have a timeout of 30 minutes, and an employee who is also a student will have 45 minutes. /n 58Banner Web Tailor User Guide |Using Web Tailor Maximum Number of Login Attempts Enter the maximum number of incorrect logins allowed before the user™s Web account is disabled. This applies to both internally-authorized Banner users (students, faculty, employees) and external users (admissions applicants, alumni). When this limit is reached, the Web ID record is locked and the person is not allowed to access the Web system. Required. When an authorized Banner user™s account is locked, the PIN Disabled indicator on the Third Party Access Form (GOATPAC) is automati cally selected. To unlock the account, clear the check box. When an external user™s account is locked, the Web Access Locked indicator on the Change PIN block of the Electronic Application Process Form (SAAEAPS) is automatically selected. To unlock the account, clear the check box. If your institution uses LDAP to authenticate user logons, this value is ignored. Date Display Format MaskEn ter the date format mask you would like to use. Format masks are used to convert Oracle values to character strings that can be printed. For example, MM/DD/YYYY prints 03/13/2004. The string must be a valid ORACLE date format. Required. Date Input Format MaskChoose the date input format mask you would like to use from the pull-down menu. Format masks are used to convert Oracle values to character strings that can be printed. For example, MM/DD/YYYY prints 03/13/ 2004. This string must be a valid ORACLE date format. Required. Time Format Mask Enter the time form at mask you want to use. Format masks are used to convert Oracle values to character strings that can be printed. For example, HH:MI:SS prints 08:30:59. This string must be a valid ORACLE time format. Required. Start Page Choose, from the pull-down menu, the page that will display immediately after a successful login for the Self-Service applications running in non-integrated mode. The delivered value is bmenu.P_MainMnu . Required. Start Page is a Dynamic Menu Indicates if the Start Page is a dynamic menu. Valid values are: Selected - Web Tailor generates the Start Page dynamically. Cleared - The Start Page is a static html file. ItemDescription /n 59Banner Web Tailor User Guide |Using Web Tailor PIN Expiration in daysWhen a PIN is cr eated or reset, a new expiration date is calculated for it. This va lue indicates how many days will elapse before the PIN expires. If your institution™s policies do not call for PIN expiration, leave this field blank. If your institution uses LDAP to authenticate user logons, this value is ignored. Display Usage PageSelect this check box to display Acceptable Usage page when the user first logs into Banner Self-Service. Your institution may place general information on this page about the user™s resp onsibilities for changes made to their records via the Web. Use Web Tailor to specify the contents of the page. The user can accept the Terms of Usage, or exit. If the user accepts, the system selects Web Access Terms Accepted on the Third Party Access Form (GOATPAC) in Banner General. If your institution wishes to change the contents of the Terms of Usage page later, you can clear the Web Access Terms Accepted check box on GOATPAC. Next, select the Display Usage Page check box in Web Tailor to display the new page to every validated user the next time they logon. Display Descriptive NamesSelect this check box to displa y the information entered in the Description field in the Web Tailor pull- down lists. Valid values are: Selected - display the information in the Description fieldCleared - display the name of the package.procedure Enable Web Page CachingIndicates whether Web caching is enabled for the entire system. Valid values are: Selected - Web page caching is enabled Cleared - Web page caching is disabled ItemDescription /n 60Banner Web Tailor User Guide |Using Web Tailor Use HTTP Redirection After Login Indicates how you want to determine the page to which users are sent when they are redirected. Valid values are: Selected - Web Tailor uses the URL specified in the OWA redirect utility to determine the page users will be sent to when they are redirected. Cleared - Web Tailor uses an HTML META refresh tag to specify the page. Oracle recommends not using the OWA redirect utility, so the check box should be cleared. Java ClasspathObsolete Document Type DefinitionContains high level information about the Document Type Definition (DTD) that the web page was coded to. The value delivered in this column is: HTML PUBLIC .The HTML string indicates the top level element type declared in the DTD. The PUBLIC string indicates whether the identifier is a publicly accessible object (PUBLIC) or a system resource (SYSTEM) such as a local file or URL. HTML DTDs are specified by PUBLIC identifiers. Document Type Definition FPIContains the Formal Public Identifier (FPI) portion of the DTD. The value delivered in this column is: -//W3C//DTD HTML 4.01 Transitional//EN .The Registration is indicated by a plus ( +) or minus ( -). A plus indicates that the organization name that follows is ISO-registered; a minus indicates that it is not. The IETF and W3C are not registered ISO organizations; they use a minus. The W3C string is the Organization . This is the OwnerID - a unique label indicating the name of the entity or organization respon sible for the creation and maintenance of the artifact (DTD, etc.) being referenced by the ! DOCTYPE. The IETF and W3C are the two originating organizations of the official HTML DTDs. DTD is the Public Text Class - the type of object being referenced. There are many different keywords possible here, but in the case of an HTML DTD, it is fiDTDfl - a Document Type Definition. ItemDescription /n 61Banner Web Tailor User Guide |Using Web Tailor HTML 4.01 Transitional is the Public Text Description - a unique descri ptive name for the public text being referenced. EN is the Public Text Language; the natural language encoding system used in the creation of the referenced object. It is written as an ISO 639 language code (2 uppercase letters. ) HTML DTDs are usually written in English ( EN).Document Type Definition URLContains the URL portion of the DTD. Together, the previous two columns and this one make up the !DOCTYPE tag used by Self-Service applications. If you do not alter the delivered values, the !DOCTYPE tag for each Web page will look like this: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> This tag is used almost exclusively for validation purposes. Validation occurs when someone (usually a Web developer) takes the static HTML that is generated for each Web page and inputs it to a validation tool. The tag forces the tools to valid ate according to the HTML 4.01 Transitional DTD which includes all elements and attributes of HTML 4 Strict but adds presentational attributes, deprecated elements, and link targets. The !DOCTYPE statement tells the browser how to interpret your page. Based on how your DTD is built, the browser will switch between Standard and Quirk mode. In Standard mode, the browser will render the HTML in compliance with the latest standards. In Quirk mode, the browser will render the HT ML as though it were written for older, quirkier browsers. Quirk mode allows workarounds for older browsers to work in the latest browsers. Since the Self-Service Web pages need to work on both older and newer browsers, the values delivered in the three new column s will make up an !DOCTYPE tag that will force the brow sers to render in Quirk mode. From Web tailor 8.3 onwards to support cascade theme on all browsers use the URL http://www.w3.org/ TR/html4/loose.dtd. ItemDescription /n 62Banner Web Tailor User Guide |Using Web Tailor Web modules You can customize each Self-Service product individually by setting up rules that apply only to that product. Note: If your are using the Cascade theme, modules cannot be customized on an individual basis. Cascade cannot be turned on or off on a module by module basis; it is applied to all Self-Service Banner modules. Select Web Modules from the Web Tailor Menu. Choose the application you want to customize (or Common to change them all), and select Customize Module.Language ISO 639-1The value in this field is assigned to the LANG attribute in the HTML tag on all Self -Service web pages. This attribute specifies the base language of an element's attribute values and text content. Values should conform to ISO 639 standards. ItemDescription /n 63Banner Web Tailor User Guide |Using Web Tailor Web Page Fields Global user interface settingsFrom the Web Tailor Menu, select Global User Interface Settings .The User Interface in Banner Self-Service includes a table, TWGBGLUI, which stores settings that affect the look and feel of all dynamic Web pages. In Global User Interface Settings , you will find the following fields: Item Description Module Code The code that represents the Self-Service product. Module DescriptionThe corresponding description. Required. Module CSS URL The URL that points to the location of the module-wide Cascading Style Sheet. Module Help URL The URL that points to the location of the application™s html Help files. Help text is in Info Text, not HTML files. Use this only if you want to override the delivered Info Text help system. Help CSS URL The URL that points to the location of the Cascading Style Sheet (CSS) that determines the look-and-feel of all the application™s help text. Global Menu Bottom LinksSpecifies the link that appears at the bottom of each of the application™s pages for the module. It is a web page, in package.procedure format. Global Menu Bottom Links do not display on menu pages in the Cascade theme. Global Menu Bottom Links will only display on menu pages that use the Default theme. Current Release NumberSpecifies the re lease number that will appear at the bottom of all the application™s pages. Display Exit Link Indicates if t he Exit link should appear on the application™s pages. Back ImageSpecifies the image th at will appear befo re the Back link, if any. /n 64Banner Web Tailor User Guide |Using Web Tailor Web Page Fields ItemDescription System or Institution NameEnter the name of your system and institution that you want to appear at the top of every Banner Web page. Required.Header ImageEnter the name of the image to be displayed at the top of each page. This is not the actual file name of the image, but the name specif ied for it in Web Tailor. Select the link to see the actual image in a pop-up window. Name of Main MenuEnter the name of the main menu as you want it to appear in other systems like Luminis Platform. CSS URLThis is the name of the Cascading Style Sheet (CSS) that controls the look-and-feel of all application pages throughout the system. This style sheet is invoked when no page-specific or m odule-specific style sheet has been defined. It must be a URL. Help URLEnter the URL of the help page to go to when a user selects the help text. Only enter this if you want to override the delivered Info Text help system and use your own static HTML help instead. Help CSS URLEnter the URL of the CSS that specifies the format of the help text. Error ImageEnter the name of the Error icon image. This is not the actual file name of the image, but the name specified for it in Web Tailor. This im age will be displayed with all error messages. This field is optional, but highly recommended. A default graphic is provided. Select the link to see the actual image in a pop-up window. Warning ImageEnter the name of t he Warning icon image. This is not the actual file name of the image, but the name specified for it in Web Tailor. This image will be displayed with all warning messages. This field is optional, but highly recommended. A default graphic is provided. Select the link to see the actual image in a pop-up window. Required ImageEnter the name of the Required icon image. This is not the actual file name of the image, but the name specified for it in Web Tailor. This image will be displayed with all required fiel ds. This field is optional, but highly recommended. A default graphic is provided. Select the link to see the actual image in a pop-up window. /n 65Banner Web Tailor User Guide |Using Web Tailor Web Tailor parameters Web Tailor parameters control a wide variety of Se lf-Service functions, such as credit card payment settings, Luminis integration settin gs, and the CSS to use when printing web pages. Select WebTailor Parameters from the Web Tailor Menu to access the Customize a Web Tailor Parameter page. The Web Parameters table includes several records that enable Luminis Platform integration. Examine the parameters with an asterisk () carefully in the igbparm.sql script before running twupprod.sql . The Luminis Platform properties mentioned here are set in the configurat ion file located at $ CP_ROOT/config/site- site.directory .Back ImageEnter the name of the Back icon image. This is not the actual file name of the image, but the name specified for it in Web Tailor. This image will be displayed as a link to the previous page. This field is optional, but highly recommended. Select the link to see the actual image in a pop-up window. Submenu ImageEnter the name of th e Submenu icon image. This is not the actual file name of the image, but the name specified for it in Web Tailor. This image will be displayed to the left of full-page menu items that point to a submenu. This field is optional, but highly recommended. Select the link to see the actual image in a pop-up window. Application Page ImageEnter the name of the Application Page icon image. This is not the actual file name of the image, but the name specified for it in Web Tailor. This image will be displayed to the left of full-page menu items that point to an application page. This field is optional, but highly recommended. Select the link to see the actual image in a pop-up window. Homepage URLThis field indicates the URL to be associated with the Powered By logo at the bottom of each web page. Select the link to see the actual image in a pop-up window. ItemDescription /n 66Banner Web Tailor User Guide |Using Web Tailor Web Page Fields TWGBPARM_PARAM_NAME TWGBPARM_PARAM_VALUE (Example/Description) * CPBASEURL Fully qualified base URL for Luminis Platform system. Example: http://machine.university.edu:8080 * CPCOOKIEDOMAIN The domain in which the shared global cookie is valid. The entry should contain a leading dot ( .). The Self- Service and Luminis web servers must both be in this domain for successful maintenance of the global cookie. Luminis property name: sctip.sharedCookieDomain Example: .university.edu * CPCOOKIENAME Name of the shared global cookie to be used by the application and Lum inis. This should match the name of the cookie defined in the Luminis configuration files. Luminis property name: sctip.sharedCookieName Example: CPSESSID ALLOWSSNLOGINIf Y, users can enter their Social Security Numbers in place of their IDs when logging in. For more information, see fiLogin options for user IDsfl on page83 .AUDITUSERIDThis parameter controls what user ID is stored when data is changed through Self-Service. For more information, see fiCapture Banner User IDfl on page84 .BANNERID - the Self-Service user™s Banner logon ID is captured and stored where possible. WEBUSER - the generic Self-Service user ID specified by the WEBUSER parameter is captured and stored. CCMAXPIPESIZE (Obsolete)This parameter is obsolete as of the 8.3 release. The size of the DB pipe used for Credit Card processing. Example: 8192. /n 67Banner Web Tailor User Guide |Using Web Tailor CCREADPIPETIME (Obsolete)This parameter is obsolete as of the 8.3 release. The amount of time, in seconds, before pipe messages time out. Example: 300 CCRESPONSEPIPETIME (Obsolete) This parameter is obsolete as of the 8.3 release. The amount of time, in second s, that the Self-Service applications should wait for responses from the credit card payment server. Example: 300 CCUSEADDRESS (Obsolete)This parameter is obsolete as of the 8.3 release. Specifies if the system should use the address information for credit card verification. Valid values are: Y - Use the address information for verification N - Do not use the address information for verification CCWRITEPIPETIME (Obsolete)Th is parameter is obsolete as of the 8.3 release. The time, in seconds, required for the information from the pipe to be written to the database. Example: 5 CPCOOKIEPATH This specifies the subset of URLs on the origin server to which the cookie applie s. This normally will not require modification. Luminis property name: sctip.sharedCookiePath Example: /CPINUSE This parameter is no longer used. CPPASSWDEXP This specifies if you want to use the PIN expiration feature in Banner or in Luminis Platform. Valid values are: Y - User IDs and PINs will be authenticated using the settings in the Third Party Access Table (GOBTPAC) in Banner. N - User IDs and PINs will be authenticated in Luminis Platform, and the Banner settings will be ignored. TWGBPARM_PARAM_NAME TWGBPARM_PARAM_VALUE (Example/Description) /n 68Banner Web Tailor User Guide |Using Web Tailor CPTIMEOUTURLURL relative to the CPBASEURL which will call the CP timeout authentication logic. External system sct represents the CORBA-based method of SSO, whereas the external system sctssb represents the CPIP delivered with 7.0 Example for sct : /cp/ip/timeout?sys=sct&api= Example for sctssb :/cp/ip/timeout?sys=sctssb CSSURL This specifies the URL fo r the external cascading style sheet file used to implement the new user interface. This may be a fully qualified URL, or be relative to your web server document root directory. The default is /css/twbhstyl.css EPOSPAYMENTSERVER (Obsolete) This parameter is obsolete as of the 8.3 release. The name of the EPOS payment server. Example: http://maldevl6.sct.com/ scripts/ips.dll ESS_TO_EFC_URL The URL for the link from the Employee menu in Employee Self-Service to Effort Certification. HEADERDISPFor Banner implementations that have been set up for Multi-Institution Functionality (MIF). Select this parameter to displa y the institution identifier in the header of Banner Self-Service pages. For more information, please refer to the fiInstitution Identifierfl topic in Chapter 2, fiTechnical Basics.fl HELP_HEIGHTThis parameter allows the user to override the default height 500 of the help window. HELP-WIDTH This parameter allows th e user to override the default width of 450 of the help window. HELPURL (Obsolete) This specifies the URL for the global help file delivered with Web Tailor 1.0.2. This may be a fully qualified URL, or be relative to your web server document root directory. The default is /wtlhelp/ twbhhelp.htm This parameter is no long er used by Web Tailor. HOMEPAGE_BANNER_URLThis specifies the URL to an image which is shown on non-secured home page. TWGBPARM_PARAM_NAME TWGBPARM_PARAM_VALUE (Example/Description) /n 69Banner Web Tailor User Guide |Using Web Tailor IDMCOOKIE IDMCOOKIEDOMAIN IDMCOOKIEPATH IDMHEADER IDMLOGINURI IDMSSOIDMTIMEOUT These parameters support single sign-on (SSO) setup through Banner Enterpri se Identity Services. For information on how to use these parameters, refer to the Banner Enterprise Iden tity Services Handbook .You will use these parameters only if you are using the Banner Enterprise Identity Services product. IGNORELOGINCASE If Y, user IDs during login will not be case-sensitive. Lowercase and uppercase ch aracters in user IDs will be treated as equivalent. For more information, see fiLogin options for user IDsfl on page83 .IPAYMENTSERVERFor web credit card processing. This parameter is only required if your paymen t gateway is Oracle iPayment11i Server. Do not use this parameter if you are using the TouchNet Payment Gateway or EPOS Payment Server. For more information about web credit card processing, please refer to the Web Credit Card Payments Handbook . LDAPFUNCTIONSpecifies which functi on will be used to perform the LDAP user mapping during authentication. You will use this parameter on ly if you are using LDAP to authenticate user credentials. LDAPL4FLAGFor authenticated searches against a Luminis IV LDAP server. Set the value to Y to enable login to SSB using LDAP authentication with Luminis IV. Leave the default value of N if you are not using LDAP with Luminis IV. For more information, see fiLDAP authenticated search in Luminis IVfl on page93 .LDAPL4FLTRFor authenticated searches against a Luminis IV LDAP server. This parameter™s value indicates the prefix used for searching LDAP. The default value is uid . For more information, see fiLDAP authenticated search in Luminis IVfl on page93 .TWGBPARM_PARAM_NAME TWGBPARM_PARAM_VALUE (Example/Description) /n 70Banner Web Tailor User Guide |Using Web Tailor LDAPMAPUSERSpecifies where LDAP mapping is defined. This parameter will be used by other products and twbklogn.p_ValidatePin to see where to look for LDAP mapping. Valid values are: DEFAULT - The SPRIDEN ID is the same as the LDAP IDEXTERNALUSER - Treat the LDAP user as an external user defined in GOBTPAC LDAPUSER - Treat the LDAP user as an LDAP user defined in GOBTPAC PROMPT - Prompt each LDAP user for ID You will use this parameter on ly if you are using LDAP to authenticate user credentials. LDAPPWDLENGTHSpecifi es the length of the LDAP password. You will use this parameter on ly if you are using LDAP to authenticate user credentials. LUMINIS_STU_SECURITY_INDDeter mines if the Select Term (bwlkostm.P_FacSelTerm ) and the Student and Advisee ID Selection ( bwlkoids.P_AdvIDSel or bwlkoids.P_FacIDSel ) pages are displayed in future sessions when the Add or Drop Classes page (bwlkfrad.P_FacAddDropCrse ) is accessed through Luminis. Y - The Select Term and the Student and Advisee ID Selection pages are displaye d in future sessions when the Add or Drop Classes page is accessed through the Luminis. N - The Select Term and the Student and Advisee ID Selection pages are not displayed in future sessions when the Add or Drop Classes page is accessed through Luminis. MAXSEARCHRESULTSThe maximum number of results returned when a user performs a keyword search. Example: 10 TWGBPARM_PARAM_NAME TWGBPARM_PARAM_VALUE (Example/Description) /n 71Banner Web Tailor User Guide |Using Web Tailor ONEVENT_ Activates or disables input an d output validation for fion eventfl HTML, such as onblur, onclick , and so on. The parameters are named ONEVENT_ . represents the first four characters of a package. For example, ONEVENT_BWCK.By default, parameters are set to IGNORE and are updated to REPORT ERRORS when each application posts their required changes. IGNORE disables input and output validation for packages that start with the characters identified with the ONEVENT_xxxx parameter. This same convention can be used for local packages if required. If the parameter is set to a value other than IGNORE (for example, REPORT ERRORS or NULL), input and output validation is activated for the package. The following parameters are supported: ŁONEVENT_BWCK ŁONEVENT_BWFK ŁONEVENT_BWGK ŁONEVENT_BWLK ŁONEVENT_BWPW ŁONEVENT_BWRK ŁONEVENT_BWSK ŁONEVENT_EWKW PAYVEND_TRANS_TIMEOUTNumber of minutes after which the payment vendor's Web site times out if there is no activity. An update received from the payment vendor after this time limit is treated as fitransaction not foundfl. An error message indicates the current date/time, transaction date/time, and the expiration date/time. The suggested value for th is parameter is 15. PAYVEND_URLPayment vendor's URL. The user's browser is redirected from Banner Self-Service to this URL to complete a transaction payment. Only one vendor can be active at a time. For example: http://server.domain.com:8100/pci/gateway If the Self-Service Banner session is initiated with fihttpfl, then the payment vendor URL must be also be fihttpfl. If the session is star ted with fihttpsfl, then the URL must also be fihttpsfl. If this is not the case, the user will be forced to log in again at the end of the process. TWGBPARM_PARAM_NAME TWGBPARM_PARAM_VALUE (Example/Description) /n 72Banner Web Tailor User Guide |Using Web Tailor PINLENGTH The maximum length of a PIN. PINNAMEThe label you want to us e for the PIN field on your LDAP logon page. You can customize this for your institution. You will use this parameter on ly if you are using LDAP to authenticate user credentials. PRINTCSSURL This specifies the C SS to be used to format web pages for printing unless overridden on a specific page. Example: /css/web_defaultprint.css SELECTNULLDISPThis specifies the value to be displayed in each pull- down menu when no items are selected. Example: NoneSSL_PASSWORD Password for the key storeSSL_STORE Path where the keystore is created. This keystore will contain the necessary certificates. Example: E:/ keystore/oas1013.jks. SSL_TYPEKey store type. Exampl e: JKS - Java Key Store SYSTEM_NAME Value which will repres ent the browse start point Example: Banner_SSB TOUCHNETPAYMENTGATEWAY (Obsolete) This parameter is obsolete as of the 8.3 release. This parameter is required only if your payment gateway is TouchNet Paymen t Gateway. It should be set to the value TPG. If you are using the EPOS Payment Server you can disregard this entry. For more information about web credit card processing, please refer to the Web Credit Card Payments Handbook . UI_MINIFYDetermines if minified JavaScript files are used. By default, the parameter is set to use the minified version of the JavaScript f iles. For more information, see fiMinified and Full JavaScript filesfl on page107 . The following values can be used: Y or if the parameter does not exist - minified JavaScript files are used by Cascade. N - full versions are used by Cascade. TWGBPARM_PARAM_NAME TWGBPARM_PARAM_VALUE (Example/Description) /n 73Banner Web Tailor User Guide |Using Web Tailor Web Key Parameters Table (TWGRWPRM) In normal web page processing, parameter values are passed between the web pages and the database packaged procedures. This works well for pages that handle address updates or the display of grades. However, there are many pages which share the same key parameter, such as registrati on term, financial aid year, or CRN. UI_THEMEThis parameter allows yo u to select a user interface theme. The following themes are available: Łcascade Łdefault USERIDLENGTHSpecifies the length of the LDAP user ID. USERIDNAMEThe label you want to us e for the user ID field on your LDAP logon page. You can customize this for your institution. WEBCTINUSEThis specifies whether WebCT is implemented and in use at the institution. Valid values are: Y - the institution has implemented and is using WebCT N - no WebCT implementation (the default) WEBCTLOGINThis indicates the URL where the installation™s instance of WebCT has been installed. Example: http://webctserver:port/webct/ homearea/homearea where webctserver:port would be replaced with the correct value for the institution. WEBUSERThis parameter™s value is the Oracle user name that Banner Self-Service will use to connect to Banner™s Oracle database. See the related AUDITUSERID parameter. The value delivered with this parameter is UPDATE ME. You must change this value to the appropriate Oracle ID. Example values are WWW_USER and OAS_PUBLIC .If this parameter™s value is not set, Banner™s FGAC functionality (VBS and PII) will not work in Self- Service.TWGBPARM_PARAM_NAME TWGBPARM_PARAM_VALUE (Example/Description) /n 74Banner Web Tailor User Guide |Using Web Tailor Typically, when a user navigates to a page t hat requires a key parameter, the web system displays the parameter selection page first. For example, if a student attempts to register for a class, he or she will first have to select a registration term from the Select Term page. Once a valid term is selected, the Add/Drop Courses page w ill appear. If the student wants to view his or her schedule, there should be no need to reselect a term, because one has already been chosen. To make this possible, the key parameter is stored in the Web Key Parameters Table (TWGRWPRM). Because the table is used only for background processing in the Self- Service products, a form is not associated with it. Whenever a key parameter (such as registration term) is selected, it is stored in TWGRWPRM wit h the user's PIDM. Each time the user goes to a page that requires a key pa rameter, the table is checked. If a value is found, it is used; otherwise, the user will be shown the parame ter selection page to make a choice. If the user wants to change the value he or she had selected, the parameter selection page can be chosen from the appropriate web menu page. Selected parameter values are used until the user changes his or her selection, or logs out. The TWGRWPRM table maintains itself by updat ing rows whenever po ssible, rather than inserting new records for each value selected. All existing records for a PIDM are deleted when the user logs out, and again at the next login (in case the Web user forgot to log out correctly). For more information on the different parameters, refer to fiWeb Tailor Tablesfl on page108 Graphic elements Graphic Elements lets you create a graphic element, or modify an existing one. To create or modify a graphic element, select Graphic Elements from the Web Tailor menu. Click Create or choose an item from the list by clicking its Image Name .Note: The list order is controlled by Display Descriptive Names on the Web Rules page. If checked, then the list is ordered by Image Description; if unchecked, it is ordered by Image Name .You can optionally do a text search for a grap hic element, and then select from the list of search results. You can search by the image™s Name , or by its URL .To search for and select a graphic element: 1.Type the full or partial name in the Search by Name field, or the full or partial file name or URL in the Search by URL field. Search text is not case-sensitive. Note: If you enter search terms in both fields, Search by Name will take priority and the terms in Search by URL will be ignored.2.You can use % as a wildcard character in either field, or _ as a single-character wildcard.3.Select Search.4.Select the graphic element from the list of search results, or search again. /n 75Banner Web Tailor User Guide |Using Web Tailor Web Page Fields Login return locationLogin return locations define the page that will appear automatically when the user logs on, depending on where they were when they timed out. Login return locations can be used to: ŁCreate a direct link to a secure Self-Service page from another site, where the user must then login to Banner Self-Service before they can be taken to the page they want to access. ItemDescription Graphic Element NameThe name of the element you are creating or modifying. Required. Image URLThe location of the element, as a URL. Required. DescriptionThe description of the image. CommentsEnter any comments about the image. Image Width in pixelsEnter the image™s width. Image Height in pixelsEn ter the image™s height. Highlighted Image URLThe URL of the image to switch to when the user selects or moves the mouse over the graphic. Alternative TextFor user agents that cannot display images, this value specifies alternate text. Status Bar TextEnter the text that should appear on the status bar when the user™s cursor rests on the graphic. This text will only appear if the image is being used as a URL.Image Align Enter the position of the image with respect to its context. Image Border in pixelsEnter the size of the border that should appear around the graphic. Vertical Spacing in pixelsEnter the amount of white space to be inserted above and below an image. Horizontal Spacing in pixels Enter the amount of white space to be inserted to the left and right of an image. /n 76Banner Web Tailor User Guide |Using Web Tailor For example, an e-mail to employees about their paycheck stub may include a URL to view their specific paycheck stub. After logg ing on the user should be directed to the paycheck stub page an d not have to navigat e through the SSB menus. ŁIdentify, by page or module, where the user is taken when they must log back in because their session had timed out. If, for exam ple, the user is in Student Self-Service and the session times out, the user is usua lly returned to the home page. You can, however, set up a login return location for the Student Main Menu; when anyone times out while using Student Self-Service, they will be taken to the Student Main Menu instead. Web Page Fields Web Tailor overrides Banner Self-Service has been designed to pr ovide you with a great deal of control over your institution™s Web pages. Banner Web Tailor was originally designed to be used as a reusable module for generating and controlling HTML presentation interfaces. While primarily designed to ItemDescription Return Code Characters that i dentify the return location. For ease and consistency of use in a URL parameter, the only valid characters for the return code are A-Z, az, 0-9, and the special char acters $-_.!'(), . These values will be edited upon cr eation or modification so that existing values will st ill work. However, if you are using any additional characters, they should be converted when possible. Description The description that corresponds to the code. Return Location The package.procedure or menu name where the user will return after they log back in after timing out. Location is Identifies if the return location is a procedure or a menu. Add New Package Associations The package.procedures iden tified with this return location code. You can enter others, as necessary. Add New Module Associations The modules for which this re turn location code is in effect. Choose module codes from the pull-down menus to add them to this return lo cation code. You can add up to three module codes at one time. /n 77Banner Web Tailor User Guide |Using Web Tailor implement the Self-Service products, it wa s also used as the underlying presentation manager for other products. Because of this flexibility, Web Tailor will allow you to replace programming logic stored in package/procedure combinations with your own logic. Select Web Tailor Overrides from the Web Tailor Menu. Enter the package/procedure combination as the Override Condition , then enter your package/procedure (in package.procedure format) as the Replacement Value .Programming logic in the Self-Service applications will fi rst check an fioverridefl table to see if an alternate API (procedure/function) is defined. If so, then that code would be run via dynamic SQL. Otherwise, the standard Web Tailor logic is run. The packages/procedures you can override are: Łtwbkslib.f_centurypivot Łtwbkslib.f_dateinputfmt Łtwbkslib.f_fetchpidm Łtwbkslib.f_fetchpinformatind Łtwbkslib.f_formatname Łtwbkslib.f_proceedafterlogin Łtwbkslib.f_userisdead Łtwbkslib.p_create_gobtpac Łtwbkslib.p_fetchroles Łtwbkslib.p_update_gobtpac Note: The TWBKSLIB package consists of a series of utility procedures and functions for dealing with session state, user identity, etc. LDAP administrationThis web page contains your LDAP settings. Th ese settings override the settings on the Enterprise PIN Preferences Form (GUAPPRF) in Banner General.You can use the LDAP authentication process to authenticate all your users™ IDs and passwords. They can use their LDAP user IDs and passwords to logon to the Self-Service applications they need to use. The mapping between the LDAP user ID and the Self- Service user ID can be stored on the LDAP server as an attribute, or it can be stored on the Third Party Access Table (GOBTPAC) in Banner General. /n 78Banner Web Tailor User Guide |Using Web Tailor If the user starts by logging on to Banner Self -Service, the page displa yed is very similar to the existing logon page, but the Forgot PIN? button does not appear . That feature is only available if you use the GOBTPAC table to perform user authentications. Since your institution may use different term inology for your authentication process, Web Tailor allows you to create custom labels for the user ID and PIN on the LDAP logon page. You can also specify the descriptions and the length of these items. For example, you may want the LDAP PIN to be longer than the six-character Self-Service PIN. You can specify that on the Web Tailor Parameters page - no coding changes are necessary. Web Page Fields ItemDescription LDAP Protocol Select a protocol used for Self-Service authentication from the pull-down menu. Valid values are: LDAP - LDAP authentication without Secured Socket Layer (SSL) LDAP_S - LDAP authentication with SSL NONE - authentication is performed via the GOBTPAC table in Banner General Required. Search IndicatorSpecifies if an an onymous search will be performed to locate the DN entry. Valid values are: Selected - an anonymous sear ch will be performed Cleared - an anonymous search will not be performed (default) Clear this indicator if anonymous search is not enabled on your LDAP server. LDAP Server NameEnter the LDAP server name. LDAP PortEnter the LDAP port number. Search Base for LDAPSpecify where on the LDAP server you want the search for the DN entry to begin. This will reduce the response time for the authentication. Suffix for LDAP UserEnter the suffix that will be part of the LDAP user ID for all your users. The true LDAP user ID consists of the Search Base, prefix, suffix, and individual user ID. Prefix for LDAP UserEnter the prefix th at will be part of the LDAP user ID for all your users. The true LDAP user ID consists of the Search Base, prefix, suffix, and individual user ID. /n 79Banner Web Tailor User Guide |Using Web Tailor Attribute for Banner in LDAP Enter the name of the LDAP attribute that stores Self- Service IDs. SSL Wallet LocationEnter the directory and folder that will contain the SSL wallet information. SSL Wallet PasswordEnter the password for the SSL wallet. SSL Authentication ModeThis specifies the SSL authentication mode. Valid values are: 1 - No authentication is required 2 - One-way authentication is required 3 - Two-way authentication is required ItemDescription /n 80Banner Web Tailor User Guide |PINs PINsThis chapter includes the following topics: ŁfiSecure loginsfl on page80 ŁfiAssigning PINsfl on page81 ŁfiLogin options for user IDsfl on page83 Secure loginsThe information stored in the BannerŽ databas e and presented to the users in the Self- Service products is highly confidential. Theref ore, users must log into the Secure Area to view and update it. To gain access to the Secure Area, users must enter a user ID and a PIN (Personal Identification Number). The programming logic that controls user IDs and PINs for all the Self-Service products exists in Banner General and Banner Web Tailor. Note: The programming logic in Web Tailor that authenticates GOBTPAC user credentials is bypassed if your institution uses LD AP to authenticate Banner Self-Service. For more information about LDAP, see fiTechnical Referencefl on page86 .For processes that synchronize data with Luminis ® and WebCT, the current Banner PIN ( GOBTPAC_PIN ) is supplied as the Password/PIN value.All the user IDs and PINs are stored in the GOBTPAC table in Banner General and can be maintained using the Third Party Access Form (GOATPAC) or the Third Party Access Audit Form (GOATPAD). Web Tailor uses this information to grant the appropriate access to authorized users. Warning! The major difference between GOATPAC and the Third Party Access Audit Form (GOATPAD) is the se curity assigned to the two forms. GOATPAC is available to various ad ministrative users. GOATPAD should be restricted to key se curity administrators. PINs are managed based on a number of in stitutional PIN control rules, which are displayed and maintained on the Enterprise PIN Preference s Form (GUAPPRF) in Banner General. For more information, see Banner Online Help and the Banner General User Guide./n 81Banner Web Tailor User Guide |PINs PIN encryptionBeginning with Release 8.0, PI Ns are stored in the database in encrypted form. A cryptographic hash is used to transform the PIN before it is stored, so that the unencrypted form of the PIN can never be retrieved from the database. See the fiWeb Managementfl chapter of the Banner General User Guide for more information on PIN encryption.Assigning PINsIn Banner, PIN values can be created in a number of ways, and can be updated by authorized administrative users or the Self-Service users themselves. There are three distinct ways in which PINs can be crea ted by authorized administrative users: ŁPINs can be assigned one user at a time, using one of two online forms: the Third Party Access Form (GOATPAC) and the Third Part y Access Audit Form (GOATPAD). See fiManaging User PINsfl in the fiWeb Managementfl chapter of the Banner General User Guide for specific instructions. ŁPINs can be assigned for a group of pers ons simultaneously, using the PIN Creation Process (GURTPAC). See the fiReports and Processesfl chapter of the Banner General User Guide for information on the GURTPAC process. ŁPINs can be assigned, at institutional opti on, by database triggers on the General Person Base Table (SGBSTDN), Faculty Member Base Table (SIBINST), or the Financial Aid Applicant Status Table (RORSTAT). See below for details. Note: If your institution is using an LD AP server to authenticate user logons, you cannot assign PINs in Banner General. They must be assigned in LDAP. Web Tailor™s GOBTPAC user credential authentication is bypassed if your institution uses LDAP to authenticate Banner Self- Service.Assigning PINs via database triggers Data synchronization currentl y focuses on students and in structors. (Employees and alumni can also be synchronized with t he Luminis Platform alone.) Outside of synchronization processing with partner systems, PINs are also required for access to the other Self-Service applications and Voice Re sponse. Because a PIN is required to access all of these Self-Service applications, you ma y want to create PINs based upon standard operating practices when the end-user first requests access. Automatic PIN generation can be accomplis hed by implementing database triggers processing on three source tables asso ciated with student-related processing. /n 82Banner Web Tailor User Guide |PINs The three tables are: When trigger processing is implemented for a table, a database trigger fires when a record is inserted into a source table. The triggers call a standard PIN generation function, which will create a PIN record if one do es not exist, using the rules maintained on the Enterprise PIN Preferences Form (GUAPPRF). Because th e standard PIN processing function is called by the triggers, all appropriate a ssociated records (GOBPTAC, GOBSRID, AND GORPAUD) are also generated. Rules for each source table control whether PIN trigger creation is implemented. These rules are maintained on the Enterprise PIN Preferences Form (GUAPPRF). One row displays in the Table PIN Creation Controls Block for each source table that has associated PIN creation trigger processing. The PIN creation trigger fires on insert of a new record into each table when Create PIN? is set to Y.Note: As delivered, the Create PIN? value is Y for all three tables. If you don™t want to use it on GUAPPRF, then you must manually set the Create PIN? to N so the GOBSRID, GOBTPAC, and GORPAUD tables will not be automatically updated. PIN creation controls can also be main tained in the Crosswalk Validation Form (GTVSDAX). In GTVSDAX, the PIN creation controls are identified by the Internal Group Code CREATEPIN . PIN creation controls are displayed and maintained on the GUAPPRF so that all PIN controls can be displayed and maintained on one form. The Enterprise PIN Preferences Form (GUAPPRF) is described in greater detail in Banner Online Help and the Banner General User Guide .Resetting PINsAn administrator can reset a user™s PIN in the GOATPAD form. See fiManaging User PINsfl in the fiWeb Managemen tfl chapter of the Banner General User Guide for specific instructions. The Third Party Access Audit Form (GOATPAD ) also displays a history of PIN changes. Enterprise PIN preferencesPIN processing in Banner is controlled by a number of PIN rules that are displayed and maintained on the Enterprise PIN Preferen ces Form (GUAPPRF). Va lues maintained on this form control the format of generated PINs, and whether PINs are automatically Role AssignmentSource Table Student: SGBSTDN Instructor: SIBINST Financial Aid: RORSTAT /n 83Banner Web Tailor User Guide |PINs created based upon insertion of records into source tables. It also controls other items associated with PIN processing. GUAPPRF™s Maximum PIN Length setting establishes a maxi mum length for PIN values at your institution. This setting also affects the size of the PIN field on the Self-Service login page. GUAPPRF is described in Banner Online Help and the fiWeb Managementfl chapter of the Banner General User Guide .Note: The PIN characteristics set up on GUAPPRF are ignored when you are using LDAP to authenticate your users. Warning! Although GUAPPRF provi des an option to reset PINs to the user™s birth date, U.S.-based institutions should not use the birth date option. According to the U.S. Fam ily Policy Complianc e Office (FPCO), using a student™s birth date when as signing PINs is a violation of the Family Educational Rights and Policy Act (FERPA). Info Text for Expired PINs Beginning with Release 8.4, information text is used for messages that are displayed when a user gets a PIN expired message, instead of the hard coded messages. The hard coded messages for the following messages can now be overridden with info text on twbkwbis.P_ValLogin . If no info text is foun d, then the existing messages will still be displayed. * EXPIRED Your PIN has expired. Please change it now. * EXPIRE1 Your PIN will expire in 1 day. You ma y change it now, othe rwise enter your PIN in the Re-enter Old PIN field and click the Login button. * EXPIREDAYS Your PIN will expire in <V ALUE1> days. You may change it now, otherwise enter your PIN in the Re-enter Old PIN field and click the Login button. Note: You must use <VALUE1> in the location of the message where you want the number of days to appear. Login options for user IDsThree Web Tailor parameters control institut ion-wide options for Self-Service logins. /n 84Banner Web Tailor User Guide |PINs Log in with Social Security NumberYou can set the ALLOWSSNLOGIN parameter to Y to allow users to enter a Social Security Number (SSN) in place of their ID when logging in. If the value entered for ID is not found in SPRIDEN_ID , the system will check SPBPERS_SSN for a unique matching value. There are some situations where SSN login cannot be used. ŁIf the SSN value is not unique (if it matches more than one person record), a login using SSN will fail. This means that users who have been assigned a gene ric SSN value (for example, 999999999 ) because their actual SSN is unknown will not be able to use SSN login even if the feature is enabled. ŁThis feature should not be used at institut ions where the values in the SSN field are longer than 9 characters. The ALLOWSSNLOGIN option does not increase the size of the login ID field, which remains limited to 9 characters, while the SSN field has been expanded to allow values with up to 15 characters (depending on the institution™s SSN preference). Since a user can enter only 9 characters in the login ID field, a comparison with a 10-digit or longer SSN value will fail. Ignore case of Login IDYou can set the IGNORELOGINCASE parameter to Y to indicate that lowercase and uppercase letters in User IDs should be treated as equivalent during login. For example, if a user™s ID is ABC12345 , and the user types abc12345 , the user will get a login error if this parameter is set to N, but will log in successfully if this parameter is set to Y.Note: Although a U.S. Social Security Number typically does not include alphabetic characters, the IGNORELOGINCASE parameter applies to any alphabetic characters in the SSN field when the SSN is used in place of the user ID for login. In other words, if both ALLOWSSNLOGIN and IGNORELOGINCASE are enabled, the case of any SSN entered during login will be ignored. Warning! With IGNORELOGINCASE enabled, if there happen to be two users (two PIDMs) whose IDs are identical except for case differences, neither user will be able to log in. Fo r example, if User 1 has an ID of ABC12345 and User 2 has an ID of abc12345 , then both users will find that they cannot log in. The syste m will not be able to determine which user is trying to log in and will unable to process the login. Capture Banner User IDThe Web Tailor parameter AUDITUSERID controls how the user ID is stored with data records changes through Banner™s self-service applications. /n 85Banner Web Tailor User Guide |PINs Banner™s self-service products connect to the Oracle database with a proxy ID. This is the ID specified by the WebTailor parameter WEBUSER. In many cases the WEBUSER parameter value is set to WWW_USER or OAS_PUBLIC . The self-service proxy ID is the same for all users of the self-service products. The default value of the AUDITUSERID parameter is WEBUSER . With this value, when Banner data is changed through Self-Service, the self-service proxy ID is the only identifier stored in Banner tables as the user ID associated with the updated record. If you need to audit Banner data and find out which Banner user made a specific change to the data, you must set the AUDITUSERID parameter to a value of BANNERID . Then the Self-Service user™s Banner ID will be captured by the function twbklogn.f_get_banner_id according to the rules below:1.If the user is logged in with an Oracle ID that is not the WEBUSER -specified ID, then that ID is captured and preceded by W:Šfor example, W:SAISUSR .2.If the user is logged in as the WEBUSER -specified ID, and the user has a GOBEACC record, then the user™s logon Oracle ID is captured (again preceded by W:).3.If there is no GOBEACC record, the user™s SPR IDEN ID is captur ed (again preceded by W:).4.If no SPRIDEN ID exists, then the WEBUSER -specified ID is captured (again preceded by W:).In any case, the W: indicates that the record was updated by a Self-Service user. A WS: prefix indicates that the user was a non-secured Student user. Note: The AUDITUSERID parameter is not implemented in all Banner Self-Service products. Check the documentation for each product to find out if this feature has been implemented. /n 86Banner Web Tailor User Guide |Technical Reference Technical Reference This chapter includes the following technical topics: ŁfiBaseline and local recordsfl on page86 ŁfiInternationalizationfl on page89 ŁfiWeb session processing and securityfl on page89 ŁfiUsing LDAP for user authenticationsfl on page91 ŁfiSelf-Service and FGACfl on page94 ŁfiBrowsers and cachingfl on page95 ŁfiPackages and proceduresfl on page96 ŁfiWeb rolesfl on page99 ŁfiPrinting text fields and processing date inputfl on page103 ŁfiBreadcrumb validationfl on page103 ŁfiHandling pages with improperly coded HTML (Cascade theme)fl on page105 ŁfiMinified and Full JavaScript filesfl on page107 Baseline and local recordsMenus, menu items, roles, and Info Text are separa ted into two categories: 1.Baseline - you cannot change base line records in any way. 2.Local - you can create local records a nd modify them, and they will never be overwritten by later versions of Banner. Yo u can customize menus, menu items, roles, and Info Text as much as you want without losing anything during upgrades. When BannerŽ attempts to display a record, it first checks for a local record. If it cannot find one, it looks for a baseline record. The TWGBWMNU, TWGRWMRL, TWGRMENU, and TWGRINFO tables have a source indicator field. Baseline rows contain a B and local rows contain L. All existing rows are delivered with B in this field. It is not possible to display a combination of baseline and local rows. Each package/ procedure combination will show all baseline rows or all local rows. When you copy item s from baseline to local, Banner will on ly display the local rows for that menu or procedure. If you th en delete any of the local ro ws, the baseline version will not reappear. The only way to redisplay the original baseline rows is to de lete all of the local /n 87Banner Web Tailor User Guide |Technical Reference ones for that package/procedur e combination. As long as th ere is a local row for that package/procedure, no baseline rows are displayed. If you create a local version of a menu, you will need to check each upgrade to see if there is a change to the baseline version of that menu. If a new item has been added to the baseline version, you will need to add it ma nually to your menu. It is not added automatically. Likewise, if the items on a baseline menu are reordered and you want that order, you must change the order on your local menu manually. Th e order will not be changed automatically. Web menus, procedures, and associated roles You can maintain Web menus and procedures, and their associated roles from Web Menus and Procedures on the Web Tailor Administration menu. They are stored in the TWGBWMNU and TWGRWMRL tables. Select the menu or procedure from the pull-down list, then choose Customize Web Menu or Procedure . You will see the attributes for the menu or procedure, and its associated roles. Select Copy Baseline to Local to make local copies of all the baseline records. Both the baseline records and the local copies are displayed. You cannot edit the baseline records. Change the local records as necessary, then select Submit Changes . To delete a menu or procedure, select Delete this Local Entry .Menu itemsYou can maintain the items t hat will appear on menus from Menu Items on the Web Tailor Administration menu. They are stored in the TWGRMENU table. Select the menu or procedure from the pull-down list, then select Customize Menu Items . You will see the menu items fo r the menu or procedure. Select Copy Baseline to Local to make local copies of all the baseline records. Both the baseline records and the local copies are displayed. You cannot edit the baseline records. To add menu items, select Reorder or Customize Menu Item , then Add New Menu Item. A page appears that allows you to enter the new item. If you choose a sequence number that is lower than an existing sequence number, the new elem ent will be placed in the sequence you chose, and the other elements will be moved down on the menu. To delete a menu item, select Reorder or Customize Menu Item . Select the item by clicking on its URL. The Customize the Selected Menu Item page appears. Select Delete this Local Entry .When there are multiple items on the menu, the sequence numbers become select lists. You can change the order of the items by ch oosing appropriate numbers from the select lists. When finished, select Reorder these Elements . The page appears with the elements in the new order. /n 88Banner Web Tailor User Guide |Technical Reference Information Text (Info Text) You can maintain Info Text by selecting Information Text on the Web Tailor Administration menu. It is stored in the TWGRINFO table. Select the appropriate menu or procedure from the pull-down list, then choose Reorder or Customize Information Text . You will see the Info Text for the menu or procedure.Select Copy Baseline to Local to make local copies of all the baseline records. Both the baseline records and the local copies are displayed. You cannot edit the baseline records. The labels of the local entries are links, which you can select to modify the Info Text item. The system will only copy baseline records with no corresponding local record; no existing local records can be modified by this option. To add Info Text, select Reorder or Customize Information Text , then Add New Information Text Entry . A page appears that allows you to enter the new item. If you choose a sequence number that is lower than an existing sequence number, the new element will be placed in the sequence you c hose, and the other elements will be moved down on the menu. To delete an Info Text entry, select Reorder or Customize Information Text . Select the item by clicking on the link on the label. The Customize the Selected Information Text Entry page appears. Select Delete this Entry.When there are multiple Info Text items for a label, the sequence numbers become select lists. You can change the order of the item s by choosing appropriate numbers from the select lists. When finished, select Reorder these Elements . The page appears with the elements in the new order. Note: It is recommended that you use the existing procedure twbkwbis.P_DispInfo to retrieve and display Info Text on new pages you create, or existing pages t hat you modify to display Info Text. Please refer to the Web General packages for specific examples of the P_DispInfo procedure. Help Info Text A system of help messages stored has been stored as Info Text with the label HELP . It was originally stored in the Banner Self-Service products in static HTML files. By changing it into Info Text, it will be much more ea sy for non-technical users to customize and maintain. Note: The static HTML help system will c ontinue to be supported. It was modified to conform to the same ac cessibility standards as Info Text. As with all other rows, Info Te xt Help records are stored in Web Tailor as baseline. Info Text rows created by your institution usin g Web Tailor are stored as local. You cannot modify baseline rows. Info Text th at is stored as local is displayed first. If there are no rows stored as local, the baseline rows are displa yed. This ensures that your institution™s custom help will not be overwr itten with each Banner upgrade. /n 89Banner Web Tailor User Guide |Technical Reference Note: Web Tailor still has help messages st ored in static HTML files (help text that describes them). This help is displayed when the user selects the Help link in the upper right-hand corner of the Web page. The help text appears in a new window, and includes an Exit link at the bottom of each window. A CSS for global-level help, web_defaulthelp.css , is provided. It will be used in addition to the CSS defined for that page. InternationalizationThe Banner Self-Service products contain logic to facilit ate translating text to targeted languages, and to support other date and number formats. Appropriate hard-coded strings in the Web packages have been replaced by calls to the package called G$_NLS so that they can be translated into various languages. These changes are transparent to the user, and do not affect clients using American English. The schema owner NLSUSER owns the package G$_NLS and the version table TMURVERS. A record has been added to the GENERAL.GTVSYSI table, with GTVSYSI_CODE=TM and GTVSYSI_DESC=Translation Manger .Note: If you need to implement multilingua l support for your Banner Self- Service products, it is recommended that you contact Professional Services to help you set up this feature. Web session processing and security There are two important security consideratio ns to address with respect to allowing end users access to the Banner administrative database through the Web: ŁYou must ensure that any attempt to break into the system with existing Banner IDs (e.g., by guessing PINs) is tracked and Web account access is disabled if appropriate. ŁYou must track Banner database access and ensure that the ID currently logged on is accessing and updating only reco rds associated with that ID. The Web Session Information Table (TWGBWSES) supports session security for both of these concerns. /n 90Banner Web Tailor User Guide |Technical Reference Preventing break-insTo address the first situation, a counter fo r tracking login attempts associated with an existing ID is updated in the Web Se ssion Information table (TWGBWSES). The counter ( TWGBWSES_LOGIN_ATTEMPTS ) has an initial value of zero. If the ID is valid but the PIN is not, the value of the counter is incremented by one. Additional attempts for the same ID are permitted, up to the value specified for the number of Login Attempts in Web Tailor. When the counter reaches the value specified for Login Attempts, the account is disabled, and the counter is reset to zero. There is always a possibility th at unauthorized individuals may obtain and use the valid ID and PIN of a user. To help someone detect unau thorized use of his or her ID and PIN, an information message displays the last access date and time on the Main Menu after login. This information co mes from the Last Web Access date stored in the TWGBWSES table. The date field ( TWGBWSES_LAST_ACCESS ) stores both the date and time the ID last accessed the Web (initial login date and time of the session, not the logout date and time). It may be helpful to remind users that if the la st login date and time is suspicious (that is, they did not access the system at that time), they should su spect fraudulent use of their ID and PIN, and report it to the system administrator. Monitoring ID/PIN instances To address the second concern, Banner Self-Service uses hidden and randomly- generated Web IDs during the entire Banner Self-Service session to track whether the ID and PIN logged on are, in fact, the same ID and PIN for the duration of the session. The TWGBWSES_WEBID field and the TWGBWSES_PREV_WEBID fields track this information. A function to generate a random WEBID initially populates the TWGBWSES_WEBID field after successful login. At the start of eac h new database access, the current value of TWGBWSES_WEBID is moved to TWGBWSES_PREV_ID , and a new randomly- generated Self-Service ID populates TWBKWSES_ID . With each access, a check is performed, comp aring the value of the Web ID on the Web page with the value stored in the database. If they are the same, the user can continue. If they are not the same, it is assumed that a break-in has been attempted, and a message will be displayed requiring the user to login again. If Self-Service session inactivity has caus ed a timeout (no database access for the number of minutes specified in TWGBWRUL_TIME_OUT ), TWGBWSES_WEBID and TWGBWSES_PREV_WEBID are set to null. The system displays a message indicating that a timeout has occurred and that the user must log in again. Both fields are also set to null when the user logs out of the Self-Service session. Tracking a current Self-Service ID and a previous Self-Service ID accomplishes two security goals: /n 91Banner Web Tailor User Guide |Technical Reference 1.It prevents a user from running two sessions simultaneously for the same ID and PIN, as the updates to TWGBWSES will conflict with each other. One of the sessions will receive the break-in attempt message. 2.It prevents a completely different user from copying the URL information and attempting to enter the URL in an effort to illegally gain access to the person's information. Because most of the fields in the TWGBWSES table are for background processing in the Self-Service products, there are no online forms associated with the table, with the exception of one of the fields. A single row of data is created in the TWGBWSES table when an end user first logs on to the system. This row, which is keyed by the Banner PIDM associated with the end user, is never deleted, but is updated as described ab ove. The row is not deleted when the user logs out, the next login will determine that a row for the PIDM exists in the table, and updates will be perfor med as described. Using LDAP for user authenticationsOverviewYou can use the LDAP authentication process to authenticate all your users™ IDs and passwords. They can use their LDAP user IDs and passwords to logon to the Self-Service applications they need to use. The mapping between the LDAP user ID and the Self- Service user ID can be stored on the LDAP server as an attribute, or it can be stored on the Third Party Access Table (GOBTPAC) in Banner General. Note: The programming logic in Web Tailor that authenticates user credentials in GOBTPAC is bypassed if your institution uses LDAP to authenticate Banner Self-Service. If your institution is using an LDAP se rver to authenticate user logons, you cannot modify PINs in Banner Genera l. They must be changed in LDAP. Authentication processThe authentication process is as follows: 1.The Web Tailor package TWBKLOGN checks to see what protocol you have chosen to use, that is, what you selected from the LDAP Protocol pull-down menu on the new LDAP Administration page in Web Tailor: ŁIf you have selected LDAP , you will use generic LDAP to authenticate your users ŁIf you have selected LDAP_S, you will use LDAP with Secured Socket Layer (SSL). /n 92Banner Web Tailor User Guide |Technical Reference ŁIf you selected NONE, you will use the values in the GOBTPAC table for authentication 2.When a user first tries to logon, TWBKLOGN checks to see if the Search indicator was selected ( TWGBLDAP_SEARCH_IND = Y ) on the new LDAP Administration page in Web Tailor. 2.1. If this option is selected, an anonymous search will be perfor med to see if the user exists in LDAP, or if the user ex ists in more than one place. LDAP will use the Distinguished Name (DN) found in the search in the bind. If either of these conditions generate an exception, TWBKLOGN displays an error message and does not allow the user to logon. The error message is Info Text, and you can customize it in Web Tailor. 2.2. If this option is not select ed, the bind will be performed directly using the param- eters you specified on the LDAP Administration page in Web Tailor. 3.Banner Self-Service provides two ways of mapping LDAP users to Self-Service IDs: 3.1. The LDAP user can be mapped to Banner Self-Service by storing Self-Service IDs as an attribute in LDAP. 3.2. The LDAP user can be stored in the GOBTPAC_LDAP_USER column of the GOBTPAC table in Banner General. When you logon for the first time, you are pr esented with a Terms of Usage page. This feature has not been changed for the LDAP enhancement. For additional technical information, please refer to the Banner Middle Tier Implementation Guide. PrerequisitesIf you are planning to use LDAP to authenticat e your users™ credentials, you must also have the following Oracle packages in your LDAP directory. Note: The creation scripts can be found in /rdbms/ admin . When you run them, you should be connected as sysdba. Package Name Creation Scripts dbms_pipe dbmspipe.sql prvtpipe.plb Run these scripts as part of catproc.sql during a standard Oracle install. dbms_random dbmsrand.sql Run this script as part of catproc.sql during a standard Oracle install. /n 93Banner Web Tailor User Guide |Technical Reference LDAP authenticated search in Luminis IVYou can set up Banner Self-Service to do authenticated searches against a Luminis IV LDAP directory. 1.In Web Tailor™s LDAP Administration page, enable the Search Indicator. 2.In the Web Tailor Parameters page, set these parameters: ŁSet LDAPL4FLAG to Y.ŁSet LDAP4FLTER to uid . This is the prefix used for searching LDAP. dbms_ldap and dbms_ldap_utl prvtldh.plb dbmsldap.sql prvtldap.plb These are run in the proper sequence in the catproc.sql script. dbms_obfuscation_too lkit dbmsobtk.sql prvtobtk.plb These are run in the proper sequence in the catproc.sql script. utl_raw utlraw.sql prvtrawb.plb These scripts are run as part of catalog.sql during a standard Oracle install. utl_encode utlenc.sql prvtenc.plb These scripts are run as part of catalog.sql during a standard Oracle install. utl_url utlurl.sql prvturl.plb These scripts are run as part of catalog.sql during a standard Oracle install. WEB PL/SQL Toolkit htp, htf, owa, owa_util owainst.sql This script condit ionally runs the owacomm.sql package. To force an install, run owacomm.sql .Package Name Creation Scripts /n 94Banner Web Tailor User Guide |Technical Reference Self-Service and FGACBanner™s Value-Based Security (VBS) uses the Oracle FGAC tool, and is applicable throughout all of Banner. VBS restricts the access of your end users to the database, regardless of how they accessed it. Their access depends upon institution-defined rules that control what data they can select, update, and delete. You can implement VBS with FGAC for all Bann er processing, includ ing the Self-Service products. When you access Banner Self-Service and VBS restrictions exist for your ro le in Banner (e.g., Faculty ), nothing will appear different to you until you try to access a Web page that has been restricted on the Cust omize a Web Menu or Procedure page (twbkwmnu.P_ModifyPgWebMain). You will then be asked to en ter your Oracle username and password. All the VBS restrictions for your role will be applied to your access during your session. You do not have to enter your Oracle username and password again, even if you try to access another Web page that has been restricted. Note: It is recommended that you do not restrict Web Tailor pages. If you are accessing Banner Self -Service from Luminis®, th e VBS restrictions go into effect automatically when you access a restricted Web page. You do not need to enter your Oracle username and password at t hat time because the Single Sign-On (SSO) feature handles it automatically. Warning! For VBS to work properly with Ba nner Self-Service, any Oracle IDs that will be used with the Self-Service applications must be granted the role ban_default_webprivs . For more information about this role, see the Banner Security Administration Handbook. For more information about Value-Based Security, see the Banner Data Security Handbook. WEBUSER parameter The WEBUSER parameter on the Customize a Web Tailor Parameter page (twbkparm.P_DispAllParams ) contains the Oracle user that Banner Self-Service will connect as. VBS needs this valu e to function appropriately. Warning! The value delivered with this parameter is UPDATE ME . You must change this value to be the Orac le ID your users will use to connect to Banner Self-Service (e.g., OAS_PUBLIC ).The WEBUSER parameter is stored in the Web Tailor Web Parameters Table (TWGBPARM) in Web Tailor, and can be customized via the TWBKPARM package. /n 95Banner Web Tailor User Guide |Technical Reference Securing web pages The Admin Secured check box on the Customize a Web Menu or Procedure page (twbkwmnu.P_ModifyPgWebMain ) specifies if that Web page is secured under the VBS and PII rules set up in Banner. If you select this check box, a user who a ccesses the page must specify an Oracle username and password, and th e VBS and PII rules will apply to the user™s activities for the duration of that person™s session. Note: VBS and PII rules are defined for the user™s role, e.g., Faculty .Each user who you want to restrict via VBS must have a record in the Enterprise Oracle Access Table (GOBEACC). Database Access Descriptors (DADs) The architecture of Banner Self-Service us es Database Access Descriptors (DADs) for database connection information. The con nection information can contain a user ID/ password combination.Banner Self-Service recognize two different DADs: 1.The DAD with the user ID/password combinat ion is the standard DAD in use before 7.0, and it is used for normal user ID and PIN logins. 2.Another DAD introduced with Release 7.0 does not have a user ID/password combination. It is used when access to a specific Web page should be restricted under the VBS rules set up in Banner. When th e new DAD is being used, Banner Self- Service will prompt each user for his or her Oracle user ID and password to gain access to that page. The user will only need to supply the ID and password once each session, and VBS will be in effect for that user for the re mainder of th at person™s session.This DAD is used for all transactions when the Admin Secured checkbox is selected on the Customize a Web Menu or Procedure page (twbkwrul.P_ModifyPgWebRules ).Note: After you successfully access a Web page that has been secured via the Admin Secured checkbox, that level of access is what you will have throughout the session. Browsers and cachingBrowsers can store copies of recently accessed pages on local computers so the page does not have to transmitted across t he network the next time you access it. While this is helpful for perf ormance, it does create a security issue for educational institutions where computers are often shared in public settings like labs and libraries. /n 96Banner Web Tailor User Guide |Technical Reference If your browser has cached a recently-visited pa ge with sensitive in formation, it may be possible for the next us er to retrieve that page from the cache. The issues are: ŁHow to control which pages are cached by the browser ŁWhat controls are available when someone accesses a page via the Back buttonTo control which pages are cached by the browser, you should make sure the following are always set: ŁFor Netscape: ŁFind Edit>Preferences>Cache>Compare this page in the cache to the next page on the network ŁSelect Everytime ŁFor Internet Explorer: ŁFind Tools>Internet Options>Advanced>Security ŁSelect Do not save encrypted pages to disk To control what happens when someone uses the Back button is more difficult. We have found that different versions of the same browser from the same company can ignore or comply with HTML caching directives when re-displaying a cached page via the Back button. Note: The best way to make data secure is to train users to close the browser after they log off, as directed on the Logout page. Packages and proceduresProceduresA procedure (also referred to as package.proced ure) is code (PL/SQL or C) that executes to carry out a specific function on the Web. The procedures that are delivered in the TWGBWMNU table include those which create a nd display static Web pages, such as the college catalog, class schedule, and campus directory, as well as those which generate dynamic Web pages. You can group several functionally-related procedures together in one package. The overall package contains different sections of code for each procedure within the package. For example, the process of viewing address information on the Web belongs to the package that includes all address functionality, while the process that changes a PIN belongs to the package that contains other PIN functions such as logins and security checks. Packages are compiled in the database from two separated files: /n 97Banner Web Tailor User Guide |Technical Reference 1.The package specification defines the public interface for the procedures and functions in the package. It has the fu ll eight-character name, for example, twbkwbis.sql . 2.The package body defines the actual implementation of those procedures and functions. It has the same name as the pa ckage body, but the last character of the name is 1, for example, twbkwbi1.sql .Some functions, such as viewing an address, co nsist of multiple step s or procedures that the end user performs (selecting the address type to view, then actually viewing the address information). Default values for many of the fields are delivered with installation, and should not be modified unless customization is desired. Modifying existing proceduresIt is recommended that you keep a detailed record of any changes that you make to a Self-Service product. It will assist you when subsequent baseline re leases are delivered and you need to analyze baseline changes compared to your customizations. Use extreme care when changing any exis ting delivered procedures. You should be familiar with PL/SQL and database packages , procedures and functions. Many Self- Service pages pass parameters required for successful execution of the package.procedure. Your changes to an exis ting page should successfully pass and correctly use any parameters that may be required. Also, you should know that many procedures and functions are called from multiple packages and even different Self- Service products. Before undertaking any modification you should: 1.Determine the functional need for the modification Is the change appropriate for all of the Web roles that are enabled for the page? If not, you may need a new procedure for the specific Web role or roles. 2.Determine the appropriate package.proce dure where the modification needs to be made by the package.procedure name displayed in the URL. If the package.procedure name is, for example, twbkabcd , the package specification will be found in the appropriat e Self-Service produc t/module (see the section on Web naming conventions for more information) in the dbprocs subdirectory with the name twbkabcd.sql . The specific code, known as the package body, for the individu al procedure will be found in the same subdirectory with the name twbkabc1.sql . 3.Determine the technical modification r equired to meet the functional need. Complete the code change. Recompile the affected procedures and test. 4.Determine whether changes to links to or from other pages would be appropriate, as well as changes to Info Text. Make changes accordingly. Please note that small changes can probably be completed easily. These could include a modification to the Change PIN page which would prevent a change to any previously used PIN. Following the guidelines listed above, you would: 1.Determine the functional need for the modification. /n 98Banner Web Tailor User Guide |Technical Reference Do you want the modification to affect all users, or maybe just faculty and employees? Do you want to prevent the us e of any previously used PINs or do you want to restrict it to only those used within th e last year? This is the time to make a specification of your changes. For this example, let™s as sume the change will affect all users and prevent the reuse of any PIN in the PIN Audit Trail (GORPAUD) table. 2.Find the appropriate package.procedure. Select the Personal Information Menu in the pull-down menu on the Menu Items page in the Web Tailor. Look for Change PIN . The URL field tells you that the package.procedure is twbkwbis.P_ChangePIN . The package source code can be found in the dbprocs subdirectory for the appropriate product. Except for very small packages, it is a standard that the body of the package will be in a file with the same first seven le tters as the package, but it ends in the number 1 (one). So look for a file in wtlweb/dbprocs called twbkwbi1.sql . Once in that file, find the procedure P_ChangePin . As you look at the code for this pr ocedure, you will notice that another procedure, P_ValidateChangePin is called. This is the actual procedure which validates all the requirements for a PIN change. It is separated from P_ChangePin so that it can also be called from P_ValLogin , in case an expired PIN needs to be changed during the login process. 3.Determine the technical modification. In the package goklibs, ther e is an existing function, F_PinReused , that checks for PIN reuse. You could either insert a call to that function, or write one specifically for your institution. You will also need to create an error mess age and pass it back to the P_ChangePin procedure correctly. Remember, th is change will also be in effect for any PIN changes which occur during the login process due to PIN expirations. 4.Determine whether changes to links to or from other pages would be appropriate, as well as changes to Info Text. Since we did not create a new page or dras tically change the function of an existing one, no link changes are required. However, it would be wise to add some Info Text notifying your users that PINs may not be reused. Adding new menus and proceduresUse Web Tailor to define both the Web menu structure and the appearance of each page. All dynamically-generated menus and interface procedures that are called from the Oracle Apache PL/SQL Agent must be defined. You must make your pages available to a specific role or roles using Web Tailor, but there may be additional steps, depending on the role. For more information, please refer to the product-specific documentation. Menu pages can be easily generated by calling the existing procedure twbkwbis.P_GenMenu ; when you use the submenu indicator on the Customize the Selected Menu Item page, that procedure is automatically used. It is highly recommended that functional pages call twbkwbis.P_OpenDoc to generate the HTML document open, title, body, and header tags that begin a page. P_OpenDoc uses the information provided in twgbwmnu when it generates this code. The procedure /n 99Banner Web Tailor User Guide |Technical Reference twbkwbis.P_CloseDoc prints any bottom-of-page links associated with the page. P_OpenDoc also provides accessibility functionality. Parameter print_module_bottom_links was added to suppress module bottom links for printing. The default value for this parameter is true. All procedures which use P_OpenDoc to open the page must use P_CloseDoc to close the page, and vice versa, due to We b Tailor™s use of HTML tables for page formatting purposes. Note: P_CloseDoc cannot be used in a page unless P_OpenDoc is also called. Please refer to any of the General Web packages for a specific example of the P_OpenDoc and P_CloseDoc procedures (for example, twbkwbi1.sql ). Web roles User roles in Self-Service determine what me nus are displayed after logging on and what each person has access to. Users can see and access only those menu items that their roles authorize them to see. A user may have more than one role. Note: Do not confuse the concept of web user roles with the Oracle roles used in Banner security. For information about Banner security™s use of roles, see the Banner Security Administration Handbook. Roles are not the only factor that determine which pages a user can access. For example, a student will not be allowed to register for classes if the individual™s current general student record is not active. There are three types of roles that each user may be assigned at the time that they login. Each valid role that is found is loaded into an occurrence in twbkslib.role_table during login by the twbkslib.p_fetch_roles procedure. ŁStandard Banner roles . Each of these roles is defined by the existence of data in the Banner system via the GOVROLE view. It is poss ible for a user to have none, any, or all of the roles. ŁThe All Web Users role (WEBUSER). This role is assigned dynamically to every user that logs in. ŁManually assigned roles. These roles are assigned to a user by a Web Tailor Administrator on the Upda te User Roles page in Web Tailor. It is possible for a user to have none, any, or all of the roles. The assigned roles are stored in the TWGRROLE table. Refer to each Self-Service product™s documentation for more information on the roles required for its users and the application rules that control a user™s access and update privileges. /n 100 Banner Web Tailor User Guide |Technical Reference Standard Banner web roles Each of these roles is automatically assigned when a user has the required records in the Banner database. The GOVROLE view gathers the information from the Banner database to determine. It is possible for a user to have none, any, or all of these roles. WEBUSER roleThe All Web Users role (WEBUSER) is assigned dynamically to every user that logs in. This WEBUSER role has no connection to the TWGMPARM parameter of the same name. Web Role Banner records required to assign this role Main Menu selections available for this role Alumni a Constituent record (APBCONS)General Functions Menu Alumni Menu BSACGOVROLE_BSAC_IND = Y See Banner Student Aid for Canada documentation Employeean Employee record (PEAEMPL)General Functions MenuEmployee Menu Facultya Faculty Information record (SIAINST) General Functions Menu Faculty and Advisors Menu FinanceFinance Security Record from FOMPROF with the Web Access Indicator selected and an Enterprise Access Record from GOAEACC, relating the Oracle ID and Banner ID General Functions Menu Finance Menu Financial Aida Financial Aid application record (ROASTAT) General Functions Menu Financial Aid Menu Friendsee product documentation Studenta General Student record (SGASTDN)General Functions Menu Student Menu /n 101 Banner Web Tailor User Guide |Technical Reference Manually assigned web rolesThese roles are assigned to a user on the Update User Roles page in Web Tailor. It is possible for a user to have none, any, or all of the roles. The assigned roles are stored in the TWGRROLE table. Web Role TWGRROLE_ROLE Value Main Menu selections available for this role Advancement Data Tailor ADVANCEMENTDATATAILOR Web Tailor Menu (for Alumni Rules only) Advancement Moves Manager MOVESMANAGER General Functions Menu Development Officers Menu Development Officer DEVELOPMENTOFFICER General Functions Menu Development Officers Menu Effort Certification Administrator see product documentation EPAF Administrator see product documentation Executivesee product documentation Faculty Compensation Administrator see product documentation Finance Data Tailor FINANCEDATATAILOR Web Tailor Menu (for Finance Site Preferences only) HR Manager see product documentation Labor Redistribution Initiatorsee product documentation Master Salary Planner see product documentation Travel & Expense Administrator see product documentation Travel & Expense Approver see product documentation Travel & Expense Usersee product documentation Web for Executives Administrator see product documentation Web Tailor Administrator WTAILORADMIN General Functions Menu Web Tailor Menu /n 102 Banner Web Tailor User Guide |Technical Reference Assigning the Web Tailor Administrator role You can run the twadminu.sql script through SQLPlus to add the Web Tailor Administrator role to an existing Banner ID. This file can be found in the BAN_HOME/wtlweb/plus/ directory. Modifying web roles for existing proceduresWeb roles are delivered as appropriate for baseline product functionality. You may remove Web roles from pages or add them to pages as you deem appropriate. When you create roles, be sure to save them as local, so future releases do not overwrite them. Keep the following points in mind, particularly if you want to add Web user roles to pages that currently do not have that role. Does the page require certain parameters to be passed? Does the Web user role that you are adding have records in the database that can supply the values needed for those parameters? If not, then the page will not work for that Web role. For example, you should not add the EMPLOYEE role to the Student Self-Service Add/Drop Classes page. An EMPLOYEE who does not also have the STUDENT role would not be able to access the page because the correct record (active general student record) does not exist in the database. You will probably most often remove roles from selected Web pages, particularly in Web General's Personal Info rmation. For example, you may determine that you will permit the roles of EMPLOYEE and FACULT Y to update address information, but not STUDENT. As delivered, all three are allowed to update addresses. For example, to remove the STUDENT Web ro le from Update Addr ess capability, you would: 1.Determine the page where the address information is updated. 2.For the package.procedure name for the page, you would select that package.procedure in the Web Menus and Procedures page, then scroll down to the Associated Roles section. 3.Delete the STUDENT role record by clearing the check box next to Student 4.Select Save Changes .Adding web roles for new procedures If you add a new procedure, you must assign at least one Web role, or none of the users will be able to access it. You should assi gn the appropriate ro les depending on the purpose of your new procedure, and the Web pro duct it is associated with. Keep in mind the database record requirements as you determine which Web roles are appropriate to add. /n 103 Banner Web Tailor User Guide |Technical Reference Printing text fields and processing date inputTo print text fields and process date input in your own custom procedures, go to the Web Tailor Web Rules page. Adjust the settings for Date Display Format Mask and Date Input Format Mask during unit testing to verify that your procedures are correctly referencing the current display and input formats. ŁTo print text input fields, use the following PL/SQL code to prin t a text field called START_DATE : twbkfrmt.P_FormDateText (‚START_DATE™,™™,fl); This code produces both the text field and the description of the date input format. The HTML code for this outpu t looks like the following:   (MM/DD/YYYY) ŁTo process the date field created, specify the START_DATE as an fiinfl parameter to your procedure. Use the twbkwbis.F_IsDate function to determine if the date is valid using the current date input format. Afte r you determine that a date is valid, use the twbkwbis.F_FmtDate function to convert the VARC HAR2 input to Oracle data. ŁTo display a date on the Web, use twbklibs.date_display_fmt to format your date instead of twbklibs.date_input_fmt :htp.p(to_char(reg_date, twbklibs.date_display_fmt)); Breadcrumb validationThe breadcrumb trail in Banner Self-Service is created based on parent-child relationships between pages in the system. This parent-c hild relationship is defined in Web Tailor through use of the Back Link URL field and in the menu definition structure (twgrmenu table). However, since some pages are used in more than one area, occasionally the bread crumb trail may not accurately repres ent the path taken to get to the page. procedure P_SaveDate (start_date IN VARCHAR2 DEFAULT null) is beginIF (start_date IS NOT NULL) AND (twbkwbis.F_IsDate(start_date, twbklibs.date_input_fmt)) THENUPDATE date_table SET reg_start_date = twbkwbis.F_FmtDate (start_date); COMMIT; ELSE END IF; . . . end P_SaveDate; /n 104 Banner Web Tailor User Guide |Technical Reference If a back link URL has an invalid parent, or invalid or empty back link URL, the bread crumb trail is generated using the structure defined in the site map, as long as the following two conditions are met: 1.The page is defined as a child to another page in the twgrmenu table. 2.It is a child to only one parent; otherwise, there is no way to determine who the correct parent for the current view is. If these conditions are not met, the bread crumb trail will display the following: Home -> "Page Name" where fiPage Namefl is equal to the value in Header Details ( TWGBWMNU_HEADER ) if available. If Header Details is not available, Page Title ( TWGBWMNU_PAGE_TITLE ) will display, else Description ( TWGBWMNU_DESC ) will display. Note: This is applicable only for the Cascade theme. Empty back link URLBread crumb trails may no be generated correctly for pages that do not have back link URLs defined in Web Tailor. To determine if there is a back link URL that can be used to construct breadcrumbs based on the usage of the page, execute the following SQL statement: SELECT twgbwmnu_name, twgbwmnu_source_ind FROM twgbwmnu WHERE twgbwmnu_name = proc_name AND (twgbwmnu_back_url is NULL OR twgbwmnu_back_url = ''); When the query returns one or more rows it indicates that the back link URL is NULL for that page. Invalid back link URLAn invalid back link URL can either be a page that has not been defined in Web Tailor, a link to a page outside of Self-Service Banner, or a link to a page that doesn't match the hierarchy defined in the site map. Even if a back link URL has been defined, the bread crumb tr ail for the page may still not be able to be generated if the URL is not valid. To determine if there is an invalid back link URL, execute the following SQL statement: SELECT twgbwmnu_back_url FROM twgbwmnu WHERE twgbwmnu_name = proc_name AND twgbwmnu_back_menu_ind = 'Y' AND twgbwmnu_source_ind = (SELECT nvl( max(twgbwmnu_source_ind ),'B') FROM twgbwmnu WHERE twgbwmnu_name = proc_name AND twgbwmnu_source_ind='L') AND twgbwmnu_back_url IN (SELECT twgrmenu_name FROM twgrmenu WHERE twgrmenu_url = proc_name); /n 105 Banner Web Tailor User Guide |Technical Reference This query returns NULL for pages which have invalid back URLs defined. Resolving breadcrumb/page issues You can query to determine pages that do not generate breadcrumbs as follows: (SELECT t.twgbwmnu_name FROM twgbwmnu t WHERE t.twgbwmnu_back_menu_ind = 'Y' AND t.twgbwmnu_source_ind = 'B' AND (t.twgbwmnu_back_url NOT IN (SELECT tg.twgrmenu_name FROM twgrmenu tg WHERE tg.twgrmenu_url = t.twgbwmnu_name))) MINUS (SELECT t.twgbwmnu_name FROM twgbwmnu t WHERE t.twgbwmnu_back_menu_ind = 'Y' AND t.twgbwmnu_source_ind = 'B' AND t.twgbwmnu_back_url IN (SELECT t2.twgrmenu_name FROM twgrmenu t2 WHERE t2.twgrmenu_enabled = 'Y' AND t2.twgrmenu_source_ind = 'B' AND 1 = (SELECT COUNT() FROM twgrmenu t3 WHERE t3.twgrmenu_url = t2.twgrmenu_url AND t3.twgrmenu_enabled = 'Y' AND t3.twgrmenu_source_ind = 'B'))); For all pages in the result set, you will need to define a value back link URL in Web Tailor, or the page should be correctly defined as a child to only one parent in the twgrmenu table. Handling pages with improperly coded HTML (Cascade theme)In the Cascade theme, if a page does no t use proper HTML, the page may not render properly. The HTML issues may include the following: ŁHTML content/tags appeari ng above the <!DOCTYPE> or declarationŁIncorrect <!DOCTYPE> declarationŁImproper closure of tags Ł tags not being closed Ł

tags not being closed ŁImproper closure of

tags at certain places Ł
tags not being closed /n 106 Banner Web Tailor User Guide |Technical Reference Identify <!DOCTYPE> issuesWhen HTML content/tags app ear above the <!DOCTYPE> or declaration or an incorrect <!DOCTYPE> declaration is used, the user interface will not display correctly. The display issues include the header and footer being displaced. This error needs to be fixed in the HTML by adding the correc t <!DOCTYPE> and moving all HTML content inside the tag. The correct <!DOCTYPE> is as follows: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http:// www.w3.org/TR/html4/loose.dtd"> Identify

, , and

tag issues When the following issues occu r with an HTML page, this in dicates that a

, , and

tag may have an issue: ŁForm buttons are missing from the content pages ŁForm Submits are not triggering ŁForm Submits have a PL/SQL failure Resolve HTML issuesTo resolve HTML issues in pages, perform the following steps: 1.Identify the page with invalid HTML. The Page Name is incl uded in the URL. For example, bwskalog.P_DispChoicesStu is the page name in the following URL: http://://bwskalog.P_DispChoicesStu?name=xyz" 2.If the generated HTML page has a <!DOCT YPE> issue, modify the PL/SQL package to correct the issue and re compile the PL/SQL package. 3.If the generated HTML page has a

, , or

tag issue and renders properly in the Default theme, open the /js/serviceProperties.js file and add the package.procedure name to the exception list and save your changes. For example: var CascadeDowngrade = { exceptions: ['bwskalog.P_DispChoicesStu'] }4.Refresh the page to confirm that the issue was resolved. /n 107 Banner Web Tailor User Guide |Technical Reference Minified and Full JavaScript filesWeb Tailor uses JavaScript files in minified and full versions for the Cascade theme. A minified JavaScript file is a co mpressed version of a JavaScript file with audit trails, extra spaces, new lines, and comments removed. The full versions of the JavaScript files have audit trails, extra spaces, new lines, and comments. Uses for minified and full versions of JavaScript filesThe minified versions are used to improve performance by reducing the file size and allows for it to be downloaded to the page faster. The full versions can be used to troubleshoot problems. By default, twbkwbi1.sql uses the minified versions of the .js files. Identify minified and full versions of JavaScript filesMinified versions have -min appended to the full version name. For example, cascade- controls.js is the full version, and casca de-controls-min.js is the minified version. Switch between minified and full versions of JavaScript filesWeb Tailor uses the minified version of the JavaScript files by default. The UI_MINIFY parameter allows users to switch between the minified and full versions of JavaScript files. This parameter is added to the Web Tailor Administration tab and then set to one of the following values: ŁWhen the UI_MINIFY parameter is set to Y or if the parameter does not exist, the minified JavaScript files are used by Cascade. ŁIf the parameter is added and is set to N, full versions are used by Cascade. /n 108 Banner Web Tailor User Guide |Web Tailor Tables Web Tailor Tables Web Tailor uses a number of tables to: ŁControl many of the settings in BannerŽ Self-Service ŁDisplay menus ŁAssign access privileges This chapter includes the following tables: ŁfiWeb Tailor Image Information Table (TWGBIMAG)fl on page109 ŁfiLDAP Settings Table (TWGBLDAP)fl on page110 ŁfiWeb Tailor Overrides Table (TWGBOVRR)fl on page111 ŁfiWeb Tailor Global User Interface Settings Table (TWGBGLUI)fl on page112 ŁfiWeb Tailor Web Parameters Table (TWGBPARM)fl on page114 ŁfiWeb Tailor Login Return Code Base Table (TWGBRETC)fl on page114 ŁfiWeb Tailor Main Web Page Settin gs Table (TWGBWMNU)fl on page115 ŁfiWeb Tailor Web Rules Tabl e (TWGBWRUL)fl on page117 ŁfiWeb Tailor Web SessionID Table (TWGBWSES)fl on page119 ŁfiChannel SourceInfo Master Table (TWGRCHNL)fl on page120 ŁfiChannel Mapping Table (TWGRCMAP)fl on page121 ŁfiWeb Tailor Repeating Information Text Table (TWGRINFO)fl on page122 ŁfiWeb Tailor Repeating Menu Item Table (TWGRMENU)fl on page123 ŁfiWeb Tailor Login Return Code Repeating Table (TWGRRETC)fl on page124 ŁfiWeb Tailor User Roles Repeating Table (TWGRROLE)fl on page124 ŁfiChannel/Self-Service Preferences Table (TWGRUPRF)fl on page125 ŁfiWeb Tailor Menu Roles Table (TWGRWMRL)fl on page126 ŁfiWeb Tailor User Parameters Table (TWGRWPRM)fl on page126 ŁfiWeb Tailor Module Validation Table (TWTVMODU)fl on page127 ŁfiWeb Tailor User Role Validation Table (TWTVROLE)fl on page128 /n 109 Banner Web Tailor User Guide |Web Tailor Tables Web Tailor Image Information Table (TWGBIMAG) This table defines images that can be display ed with menu items, Info Text, etc., in Banner Self-Service.Column NameNull?Type Column Comment twgbimag_name Not nullVARCHAR2(120)Unique name for image twgbimag_image_url Not nullVARCHAR2(120)URL of image (will be the fiofffl image when part of a javascript-dynamic image) twgbimag_image_width NUMBER Width of image in pixels twgbimag_image_height NUMBER Height of image in pixels twgbimag_image_on_url VARCHAR2(120)URL of image displayed when user's cursor moves over the fiofffl image twgbimag_alt VARCHAR2(120)Alternate text to be associated with image twgbimag_status_bar VARCHAR2(120)Text to be displayed in window status bar when user's cursor moves over image area twgbimag_comment VARCHAR2(255)Free-form comments about the image twgbimag_align VARCHAR2(30)Alignment of image twgbimag_border VARCHAR2(10)If image is a link hotspot, width of border highlight twgbimag_vspace VARCHAR2(10)Amount of empty space (in pixels) to be displayed above and below the image twgbimag_hspace VARCHAR2(10)Amount of empty space (in pixels) to be displayed to right and left of image twgbimag_desc VARCHAR2(120)Description of image twgbimag_activity_date Not nullDATE Last date modified /n 110 Banner Web Tailor User Guide |Web Tailor Tables LDAP Settings Table (TWGBLDAP) This table contains the settings LDAP will use to map to Banner Self-Ser vice. This settings are institution-wide. Note: You must use the new LDAP Administration page in Web Tailor to make any changes to this table becaus e some of the values it contains are encrypted via the Oracle Obfuscation toolkit package. Column NameNull?Type Column Comment TWGBLDAP_PROTOCOL Not nullVARCHAR2(20)Indicates the current protocol being used for Self-Service authentication. Valid values are: LDAP - LDAP authentication without SSLLDAP_S - LDAP authentication with SSL None - Authentication is provided by the GOBTPAC table in Banner General TWGBLDAP_SEARCH_IND Not nullVARCHAR2(1)Specifies if the LDAP server will perform an anonymous search for the Distinguished Name (DN) for the user. If Y, the search will be performed, if N, the search will not be performed TWGBLDAP_ACTIVITY_DATE Not nullDATE The date that the information in the table was created or last modified TWGBLDAP_CERTIFICATE LOCATION VARCHAR2(255)The Secured Socket Layer (SSL) wallet location. Indicates where the SSL is stored TWGBLDAP_CERTIFICATE_ PASSWD VARCHAR2(255)Indicates the location of the SSL certificate password. This field is encrypted via the Oracle Obfuscation utility. /n 111 Banner Web Tailor User Guide |Web Tailor Tables Web Tailor Overrides Table (TWGBOVRR) This table contains defines the names of stored procedures that you can use instead of some of the delivered code. It provides, in a sense, an alternate API mechanism. For a specific set of standard functions, you can define an alternate set that are called automatically. TWGBLDAP_SSL_AUTH_MODE VARCHAR2(20)Specifies the SSL Authentication Mode. Valid values are: 1 - No authentication required 2 - One-way authentication required 3 - Two-way authentication required TWGBLDAP_SERVER_NAME VARCHAR2(255)Specifies the location of the LDAP serverTWGBLDAP_PORT VARCHAR2(20)Indicates the LDAP port number TWGBLDAP_SEARCH_BASE VARCHAR2(255)Specifies the directory on the LDAP server from which the search should begin TWGBLDAP_SEARCH_FLTR_S UFXVARCHAR2(255)Specifies the filter suffix that should be used in the search or bind TWGBLDAP_SEARCH_FLTR_P RFXVARCHAR2(255)Specifies t he filter prefix that should be used in the search or bind TWGBLDAP_SEARCH_ATTRIB UTEVARCHAR2(255)The name of the attribute that contains the Self-Service ID in LDAP Column NameNull?Type Column Comment /n 112 Banner Web Tailor User Guide |Web Tailor Tables This allows Web Tailor to be used with non- Banner applications, such as Executive Self- Service.Web Tailor Global User Interface Settings Table (TWGBGLUI)This table contains settings for the various user interface options across all the Self- Service products. Column NameNull?Type Column Commenttwgbovrr_condition Not nullVARCHAR2(120) The name of the package.procedure to be replaced. Valid values are: †twbkslib.f_centurypivot †twbkslib.f_dateinputfmt †twbkslib.f_fetchpidm †twbkslib.f_formatname †twbkslib.f_proceedafterlogin †twbkslib.f_userisdead †twbkslib.f_fetchroles twgbovrr_replace_value Not nullVARCHAR2(120) The name of the alternate package.procedure th at will be called via dynamic SQL twgbovrr_activity_date Not nullDATE Date last modified Column NameNull?TypeColumn Comment twgbglui_system_name VARCHAR2(120)Name of Web System, displayed in the header bar of each page when in standalone mode twgbglui_body_bg_color VARCHAR2(6)Obsolete, replaced by CSS twgbglui_body_bg_image VARCHAR2(120)Obsolete, replaced by CSS twgbglui_help_image VARCHAR2(120)Global help graphic name twgbglui_main_menu_name VARCHAR2(120)Name of central menu page twgbglui_header_image VARCHAR2(120)Obsolete, replaced by CSS twgbglui_header_color VARCHAR2(6)Obsolete, replaced by CSS twgbglui__table_header_color VARCHAR2(6)Obsolete, replaced by CSS /n 113 Banner Web Tailor User Guide |Web Tailor Tables twgbglui__table_default_color VARCHAR2(6)Obsolete, replaced by CSS twgbglui_table_label_color VARCHAR2(6)Obsolete, replaced by CSS twgbglui_table_hilite_color VARCHAR2(6)Obsolete, replaced by CSS twgbglui_header_sep_color VARCHAR2(6)Obsolete, replaced by CSS twgbglui_table_dead_color VARCHAR2(6)Obsolete, replaced by CSS twgbglui_font_face VARCHAR2(255)Obsolete, replaced by CSS twgbglui_activity_date DATE Date that the record was last modified twgbglui_submenu_image VARCHAR2(120)Graphic to be displayed to the left of full-page menu items that point to a submenutwgbglui_app_page_image VARCHAR2(120)Graphic to be displayed to the left of full-page menu items that point to an application page twgbglui_css_url VARCHAR2(255)URL where the cascading style sheet is stored for that page twgbglui_help_url VARCHAR2(255)URL where the system-level static HTML page is stored twgbglui_sct_homepage VARCHAR2(255) URL where the Powered By logo is stored twgbglui_error_image VARCHAR2(120)Name of the image that identifies system-level error messages twgbglui_warning_image VARCHAR2(120)Name of the image that identifies system-level warning messages twgbglui_exit_image VARCHAR2(120)Obsolete twgbglui_menu_image VARCHAR2(120)Obsolete twgbglui_back_image VARCHAR2(120)Obsolete twgbglui_required_image VARCHAR2(120)Name of the image that identifies the required fields on each page at a system level Column NameNull?TypeColumn Comment /n 114 Banner Web Tailor User Guide |Web Tailor Tables Web Tailor Web Parameters Table (TWGBPARM) This table contains a flexible list of para meter/value pairs that control a variety of functions, including: ŁLuminis Platform® integration settings ŁPIN length for the Self-Service applications ŁCredit card payment gateways ŁURL for the system-wide CSS Note: Comments may be added for Web Tailor parameters. Comments are set up as infotext as part of twbkparm.P_DispAllParams . Please note that the infotext label is limited to 20 characters. Since Web Tailor parameters can be 30 characters in length , the infotext label will only display the first 20 characters of the parameter name. Web Tailor Login Return Code Base Table (TWGBRETC)This table contains the name of us er-defined login return locations. twgbglui_help_css VARCHAR2(255)Provides the location of the system-level Help CSS Column NameNull?Type Column Comment twgbparm_param_name Not nullVARCHAR2(30) Name of global parameter used in Web Tailor twgbparm_param_value Not nullVARCHAR2(255) Value of parameter twgbparm_activity_date Not nullDATE Date last modified Column NameNull?Type Column Commenttwbbretc_return_cde Not nullVARCHAR2(30)Login return code Column NameNull?TypeColumn Comment /n 115 Banner Web Tailor User Guide |Web Tailor Tables Web Tailor Main Web Page Settings Table (TWGBWMNU)This table contains the main definitions for all menus and menu item s in the Self-Service applications. twbbretc_return_location Not nullVARCHAR2(120)Locat ion to return to after successful login, either a Web menu or procedure twbbretc_frameset_ind Not nullVARCHAR2(1)Obsolete twbbretc_menu_ind Not nullVARCHAR2(1)Indicates if the return location is a Web menu. Valid values: Y - it is a Web menu N - it is a normal Web procedure. twbbretc_ovr_startpage VARCHAR2(120)Obsolete twbbretc_desc Not nullVARCHAR2(120)Short description of return locationtwbbretc_login_forward_ind Not nullVARCHAR2(1)Obsolete twbbretc_activity_date Not nullDATE Date last modified Column NameNull?Type Column Commenttwgbwmnu_name Not nullVARCHAR2(120)Name of the Web page - should match the name of the package.procedure that generates the HTML twgbwmnu_desc Not nullVARCHAR2(120)Description of the Web page twgbwmnu_page_title VARCHAR2(120)HTML title of the page - appears in browser window title area twgbwmnu_header VARCHAR2(120)Page header, if no title graphic exists twgbwmnu_header_image VARCHAR2(120)Name of main header graphic (e.g. stylized text) for the page twgbwmnu_l_margin_width VARCHAR2(10)Obsolete Column NameNull?Type Column Comment/n 116 Banner Web Tailor User Guide |Web Tailor Tables twgbwmnu_main_text_width VARCHAR2(10)Obsolete twgbwmnu_r_margin_width VARCHAR2(10)Obsolete twgbwmnu_help_url VARCHAR2(120)URL of help page associated with this page twgbwmnu_bgcolor VARCHAR2(6)Obsolete twgbwmnu_bg_image VARCHAR2(120)Obsolete twgbwmnu_comment VARCHAR2(255)Description of page - used to identify page in select boxes twgbwmnu_back_url VARCHAR2(120)URL of Back link for the page twgbwmnu_back_link VARCHAR2(120)Text for the Back link twgbwmnu_back_image VARCHAR2(120)Obsolete twgbwmnu_back_menu_ind Not nullVARCHAR2(1)Indicates if the Back link URL is a database procedure. A value of Y indicates that it is a database procedure, a value of N indicates that it is not twgbwmnu_module VARCHAR2(3)Web system that this page belongs to. twgbwmnu_enabled_ind Not nullVARCHAR2(1) A value of Y indicates that Web access is currently allowed to this procedure or menu. A value of N indicates that it is not. twgbwmnu_insecure_allowed_ indNot nullVARCHAR2(1) A value of Y indicates that users may access this menu or procedure without authentication. A value of N indicates that they cannot. twgbwmnu_activity_date Not nullDATE Date last modified twgbwmnu_css_url VARCHAR2(255)URL where the page-level CSS is stored twgbwmnu_map_title VARCHAR2(120)Title of th e map that is created when a menu is generated as a series of links on a page twgbwmnu_cache_override VARCHAR2(1)Page-level se tting that controls Web caching twgbwmnu_exit_image VARCHAR2(120)Obsolete twgbwmnu_menu_image VARCHAR2(120)Obsolete Column NameNull?Type Column Comment/n 117 Banner Web Tailor User Guide |Web Tailor Tables Web Tailor Web Rules Table (TWGBWRUL) This table contains the settings for rules that will affect the lo ok and feel of all your Self- Service pages and specify how the pages function. twgbwmnu_source_ind Not nullVARCHAR2(1)Indicates if the row is Baseline (B) or Local ( L). The default value is B.twgbwmnu_help_css VARCHAR2(255)Indicates where the package.procedure-level Help CSS is stored twgbwmnu_adm_access_ind Not nullVARCHAR2(1)Indicates if the page is secured under VBS or not. Valid values are: Y - Users must enter an Oracle username and password to access the page. When they do, the FGAC an d PII rules set up in Banner for each user™s role will determine the actions that person can perform. These rules will be in effect for the duration of their sessions. N - Users can access the page without entering an additional ID and password. twgbwmnu_print_css VARCHAR2(255)PRINT STYLE SHEET: The location of page level CSS that controls presentation for printing. Column NameNull?Type Column Commenttwgbwrul_time_out Not nullNUMBER Period of inactivity on the Web which will cause a timeout (in minutes) twgbwrul_cgibin_dir Not nullVARCHAR2(60)Relative URL of the CGI-BIN directory on the Web server twgbwrul_date_fmt Not nullVARCHAR2(30)Default date format for the Web Column NameNull?Type Column Comment/n 118 Banner Web Tailor User Guide |Web Tailor Tables twgbwrul_time_fmt Not nullVARCHAR2(30)Default time format for the Web twgbwrul_login_attempts Not nullNUMBER(2,0)Number of unsuccessful login attempts for the same userid before the account is disabled twgbwrul_activity_date Not nullDATE Date last modifiedtwgbwrul_error_gif VARCHAR2(60)Obsolete twgbwrul_warning_gif VARCHAR2(60)Obsolete twgbwrul_start_frameset VARCHAR2(120 )Obsolete twgbwrul_disp_usage_ind Not nullVARCHAR2(1)Indicates if a usage agreement statement is displayed after first login twgbwrul_exit_gif VARCHAR2(60)Obsolete twgbwrul_pin_exp_days NUMBER(4,0)Number of days a user™s PIN remains valid twgbwrul_java_classpath VARCHAR2(255 )Obsolete twgbwrul_disp_admin_desc_ indNot nullVARCHAR2(1)Indicat es if the descriptive name of Web Tailor objects are displayed on the Web Tailor administrative Web pages twgbwrul_asrc_code VARCHAR2(4)Address source code informationtwgbwrul_disp_dead_ind Not nullVARCHAR2(1)Indicat e if information for a deceased person should appear on the Web twgbwrul_cache_ind Not nullVARCHAR2(1)Indicates whether Web page caching is enabled for the entire system twgbwrul_http_redirect_ind Not nullVARCHAR2(1) A value of Y redirects the user to owa_util.redirect_u rl. N uses an HTML META refresh tag instead twgbwrul_start_page VARCHAR2(120 )Indicates which page users will see directly after login Column NameNull?Type Column Comment/n 119 Banner Web Tailor User Guide |Web Tailor Tables Web Tailor Web SessionID Table (TWGBWSES) This table contains session-specific information, including: ŁNumber of logon attempts ŁTime and date of last access twgbwrul_start_page_menu_ indVARCHAR2(1)Indicates whether the start page is a Web Tailor- generated menu twgbwrul_date_input_fmt VARCHAR2(30)Stores th e date input format mask to be used when entering free-form dates on the Web twgbwrul_dtd_type VARCHAR2(255 )High-level information about the Document Type Definition (DTD) that the Web page was coded to twgbwrul_dtd_fpi VARCHAR2(255 )The Formal Public Identifier (FPI) portion of the DTD twgbwrul_dtd_url VARCHAR2(255 )The URL portion of the DTD. Together, the previous two columns and this one make up the !DOCTYPE tag used by the Self-Service applications twgbwrul_language VARCHAR2(5)The language used on the Web pages. Values should conform to ISO 639 standards TWGBWRUL_CGIBIN_DIR_ADM Not NullVARCHAR2(255 )Administrative path suffix of the Database Access Descriptor (DAD) for Oracle FGAC. The suffix determines which DAD is used for VBS. For example, if the normal DAD you use is dadb70, and the VBS DAD is dadb70o , this field will contain o.Column NameNull?Type Column Comment/n 120 Banner Web Tailor User Guide |Web Tailor Tables ŁGenerated session ID Channel SourceInfo Master Table (TWGRCHNL) This is the main channel source table. It stores all the attributes related to the channel source. SourceInfo is a generic keyword that tells Banner what XML content is being requested by the channel. The SourceInfo name is a parameter defined in the channels. It identifies channels in channel database tables. Note: This table was delivered without any data. A script to load the table was delivered with Luminis Channels for Banner.. Column NameNull?Type Column Commenttwgbwses_pidm Not null NUMBER(8)PIDM of user twgbwses_webid VARCHAR2(6)Randoml y generated Web session idtwgbwses_last_access DATE Last date the user logged into the system twgbwses_login_ attempts NUMBER(2)Counter for number of times an unsuccessful login has been attempted for same ID twgbwses_login_req_ indVARCHAR2(1)For systems which include insecure pages - Y if user should be required to login at next secure page twgbwses_sessionid NUMBERCurrent Oracle se ssion ID for this database transaction twgbwses_prev_webid VARCHAR2(6)Previous Web session ID Column NameNull?Type Column Comment TWGRCHNL_NAME Not nullVARCHAR2(50)The name of the SourceInfo as defined during the channel publishing process. For example, gi_mybanner is the SourceInfo for the My Banner channel. /n 121 Banner Web Tailor User Guide |Web Tailor Tables Channel Mapping Table (TWGRCMAP) This table stores the mapping between the channel SourceInfo, mode and database packages. This allows channels to retrieve data from Banner. Mode is another concept in the Banner channel framework. The mode is passed to Banner to provide further information on what is to be retrieved. It is also used by the XML style sheet to transform the Banner inform ation into the channel. The view can be changed by certain events while you remain in the same mode. For example, if you perform a search (one view), you will see the results (another view) while still in the same mode. Note: This table is being delivered with out any data. The script that will load the table is being delivered with Luminis Channels for Banner. TWGRCHNL_MODULE_CODE Not nullVARCHAR2(3)The func tional module to which the channel belongs. TWGRCHNL_ACTIVITY_ DATE Not nullDATE The date the record was created or last updated. TWGRCHNL_USER_ID Not nullVARCHAR2(30)The ID of the person who created or last updated the record. TWGRCHNL_SECURE_IND Not nullVARCHAR2(1)Specifies if the channel must be secured. Valid values are: Selected - the Banner Main package, TWBCMAIN, will validated the external system ID Cleared - no authentications will be performed for the external system ID via TWBCMAIN TWGRCHNL_TYPE VARCHAR2(10)Specifies if the channel is informational or nav igational. Valid values are: I - InformationalN - Navigational Column NameNull?Type Column Comment TWGRCMAP_NAME Not nullVARCHAR2(50)The data source name used when the channel was published. Column NameNull?Type Column Comment /n 122 Banner Web Tailor User Guide |Web Tailor Tables Web Tailor Repeating Information Text Table (TWGRINFO)This table contains user-defined text items that appear at various places in the Self- Service pages. You can provide instructions, ba ckground information, et c. with Info Text. TWGRCMAP_MODE Not nullVARCHAR2(1)This represents the different modes the channe l will support, such as default or edit. TWGRCMAP_VIEW Not nullVARCHAR2(1) This will show a different view from within the mode of the channel. TWGRCMAP_PROCEDURE Not nullVARCHAR2(255)The name of the database package that will be called from the channel for the given mode and view. It will return XML. TWGRCMAP_ACTIVITY_ DATE Not nullDATE The date the record was created or last updated. TWGRCMAP_USER_ID Not nullVARCHAR2(30)The dat abase user who created or last updated the record. Column Name Null?Type Column Comment twgrinfo_name Not nullVARCHAR2(120)Name of associated page twgrinfo_label Not nullVARCHAR2(20)Short labe l, used to select which set of text items to print for a page. Default is DEFAULTtwgrinfo_sequence Not nullNUMBER Sequence number for this text itemtwgrinfo_image VARCHAR2(120)Image associated with this text - overrides programmatic choice of image twgrinfo_text VARCHAR2(2000)Text to be displayed on Web page when this item is selected twgrinfo_comment VARCHAR2(120)Comment about this text item twgrinfo_activity_ date Not nullDATE Last date modified Column NameNull?Type Column Comment /n 123 Banner Web Tailor User Guide |Web Tailor Tables Web Tailor Repeating Menu Item Table (TWGRMENU)This table contains detail information about menu items. TWGBWMNU is its parent table. twgrinfo_source_ind VARCHAR2(1) Indicates if the row is Baseline ( B) or Local (L). The default value is BColumn NameNull?TypeColumn Comment twgrmenu_name Not nullVARCHAR2(120)Unique name of the menu or menu item. It is associated with one of the functional areas of the system twgrmenu_sequence Not nullNUMBER Sequence number for appearance on toolbar from top to bottom twgrmenu_url_text VARCHAR2(120)The text string to be used as the hyperlink twgrmenu_url Not nullVARCHAR2(120)Text or expression that represents URL to link to when menu item is selectedtwgrmenu_url_image VARCHAR2(120)Name of image that can be printed with or in place of the text hyperlink, as found in TWGBIMAG twgrmenu_url_desc VARCHAR2(2000)Optional info rmational text that will be displayed below the link in the menu twgrmenu_image VARCHAR2(120)Name of image, as found in TWGBIMAGtwgrmenu_enabled VARCHAR2(1)Menu item enabled switch twgrmenu_db_link_ind Not nullVARCHAR2(1) A value of Y indicates that this link is to a PL/SQL stored procedure; N indicates a static HTML link twgrmenu_submenu_ind Not nullVARCHAR2(1)Sub Menu item indicator. A value of Y indicates that it is a Sub menu; N indicates that it is not twgrmenu_target_frame VARCHAR2(120)Obsolete Column Name Null?Type Column Comment /n 124 Banner Web Tailor User Guide |Web Tailor Tables Web Tailor Login Return Code Repeating Table (TWGRRETC)This table contains the names of the packages associated with the login return locations specified in the TWGBRETC table. Web Tailor User Roles Repeating Table (TWGRROLE)This table defines roles that have been exp licitly assigned to a user. Other roles are assigned dynamically when they logon based on a variety of different records throughout Banner. twgrmenu_status_text VARCHAR2(120)Text to display in the status bar when cursor is over this link twgrmenu_activity_date Not nullDATE Last date modified twgrmenu_source_ind VARCHAR2(1) Indicates if the row is Baseline ( B) or Local ( L). The default value is BColumn NameNull?TypeColumn Comment twgrretc_return_code Not nullVARCHAR2(30)Login return code twgrretc_assoc_package VARCHAR2(12)PL/SQL Package name associated with this return code twgrretc_assoc_module VARCHAR2(3)Module associated with this return code twgrretc_activity_date Not nullDATE Date last modifiedColumn NameNull?Type Column Commenttwgrrole_pidm Not nullNUMBER(8,0)User PIDM twgrrole_role Not nullVARCHAR2(30)Role as sociated with this user (from twtvrole) twgrrole_activity_ date Not nullDATE Date last modifiedColumn NameNull?Type Column Comment /n 125 Banner Web Tailor User Guide |Web Tailor Tables Channel/Self-Service Preferences Table (TWGRUPRF)This table stores institution-wide and user preferences for channels. Note: This table was delivered without any data. The script to load the table was delivered with Luminis Channels for Banner. Column NameNull?Type Column Comment TWGRUPRF_NAME Not nullVARCHAR2(50)The channel SourceInfo name. TWGRUPRF_GROUP Not nullVARCHAR2(30)The group to which this preference belongs. TWGRUPRF_KEY Not nullVARCHAR2(30)The ke y that will be used to identify the preference within the group. TWGRUPRF_PREF_USER Not nullVARCHAR2(30)For deliver ed preferences, this is BASELINE . If a user customizes the preference, their ID will be stored here instead. TWGRUPRF_SUB_ID Not nullVARCHAR2(30)Subscriber ID for the channel. TWGRUPRF_DESC Not nullVARCHAR2(255)Description of the preference. TWGRUPRF_VALUE Not nullVARCHAR2(255)Value for the preference. For BASELINE users this will be the default preference and for other users this will be a user-edited procedure. TWGRUPRF_ACTIVITY_ DATE Not nullDATE The date the record was created or last updated. TWGRUPRF_USER_ID Not nullVARCHAR2(30)Banner ID of the person who created or last updated the record. TWGRUPRF_EDIT_IND Not nullVARCHAR2(1)Indicates if the preference can be edited by the end users. Valid values are: Y - the preference can be edited by end users N - the preference cannot be edited; it will not be displayed to users in the channel /n 126 Banner Web Tailor User Guide |Web Tailor Tables Web Tailor Menu Roles Table (TWGRWMRL) This table contains records that define the ro les a user must have to access a particular menu or page. Web Tailor User Parameters Table (TWGRWPRM) This table contains temporary attribute/val ue combinations for a specific user. These combinations provide session state c ontext between database procedure calls. TWGRUPRF_DISPLAY_ TYPE VARCHAR2(10)HTML control used to display this preference, e.g., checkbox, radio button, etc. TWGRUPRF_SORT_ORDER NUMBEROrder in which the preference should be displayed to the end users. Column NameNull?Type Column Comment twgrwmrl_name Not nullVARCHAR2(120)Name of procedure or menu from TWGBWMNUtwgrwmrl_role Not nullVARCHAR2(30)User role associated with this menu or procedure twgrwmrl_activity_ date Not nullDATE Last date modified twgrwmrl_source_ indVARCHAR2(1) Indicates if the row is Baseline ( B) or Local ( L). The default value is BColumn NameNull?TypeColumn Comment twgrwprm_pidm Not nullNUMBER(8,0)User PIDM twgrwprm_param_name Not nullVARCHAR2(10)Parameter name twgrwprm_param_value VARCHAR2(30)Parameter value twgrwprm_activity_date Not nullDATE Last date modified Column NameNull?Type Column Comment /n 127 Banner Web Tailor User Guide |Web Tailor Tables Web Tailor Module Validation Table (TWTVMODU) This table contains definitions of all the Self-Service modules. You should only update the information in the table, not insert records into it or delete records from it. Column NameNull?Type Column Commenttwtvmodu_code Not nullVARCHAR2(3)Module code - one exists for each Web product twtvmodu_desc Not nullVARCHAR2(120)Description of the module twtvmodu_global_menu VARCHAR2(120)Menu (twgbwmnu) to be displayed at the bottom of every page associated with this module twtvmodu_header_caps_on VARCHAR2(1) A value of Y indicates that the Header Text in this module is printed with twbkfrmt.P_HeaderCaps. In Release 5.2, this was replaced by values on the page-level CSS twtvmodu_display_exit_ indNot nullVARCHAR2(1)A value of Y indicates that the Exit/Logout button is to be printed on pages within this module twtvmodu_curr_release_ noVARCHAR2(30)Current release number for this module. Will override setting in twbkwbis, but not value passed to P_CloseDoc .twtvmodu_activity_date Not nullDATE Date last modified twtvmodu_css_url VARCHAR2(255)URL where the module-level cascading style sheet is stored twtvmodu_help_image VARCHAR2(120)Obsolete twtvmodu_exit_image VARCHAR2(120)Obsolete twtvmodu_menu_image VARCHAR2(120)Obsolete twtvmodu_back_image VARCHAR2(120)Obsolete twtvmodu_help_css VARCHAR2(255)Indicates where the module-level Help CSS is stored twtvmodu_help_url VARCHAR2(255)Holds the URL of the module- level static HTML page /n 128 Banner Web Tailor User Guide |Web Tailor Tables Web Tailor User Role Validation Table (TWTVROLE)This validation table lists the valid roles that can be granted to a user or assigned to a menu item. Column NameNull?Type Column Commenttwtvrole_code Not nullVARCHAR2 (30)Role code twtvrole_desc Not nullVARCHAR2 (60)Desc ription of the user role twtvrole_activity_date Not nullDATE Date last modifiedtwtvrole_user_defined_ indNot nullVARCHAR2(1) A value of Y indicates that the role is defined on twgrrole; N indicates that it is data-driven from GOVROLE twtvrole_time_out Not nullNUMBERTIME OUT: Period of inactivity on the web which will cause a timeout (in minutes). This value overrides TWGBWRUL_TIME_OUT if it is a longer period of time. /n 129 Banner Web Tailor User Guide |Web Tailor Packages Web Tailor Packages This chapter provides reference information on the packages that support Web Tailor processing. OverviewThis section provides a technical summary of the Web Tailor packages that are used in Web processing. Where appropriate, cursors, variables, constants, functions and procedures are documented, and a brief description is supplied. This information is provided to assist technical staff in understanding the technical processing in Web Tailor. In addition, any site-specific Web development may be able to use delivered BannerŽ Self-Service packages, eliminating the need to write new code in some cases. fiTWBKAUSRfl on page130 fiTWBKTABSfl on page130 fiTWBKSELSfl on page130 fiTWBKMODSfl on page131 fiTWBKFUNCfl on page132 fiTWBKBSSFfl on page132 fiTWBKAUTHfl on page134 fiTWBKLDAPfl on page135 fiTWBKLOGNfl on page135 fiTWBKINTEfl on page136 fiTWBKLISTfl on page137 fiTWBKFRMTfl on page137 fiTWBKGLIBfl on page145 fiTWBKIMAGfl on page146 fiTWBKJSCRfl on page147 fiTWBKLIBSfl on page148 fiTWBKMENUfl on page150 fiTWBKMODUfl on page151 fiTWBKRETCfl on page152 fiTWBKSERRfl on page153 fiTWBKSLIBfl on page154 fiTWBKUROLfl on page154 fiTWBKVALDfl on page154 fiTWBKWBISfl on page156 fiTWBKWRULfl on page165 fiTWBKWMNUfl on page165 fiTWBKWINFfl on page166 fiPackage Specs for Luminis Channels for Bannerfl on page168 /n 130 Banner Web Tailor User Guide |Web Tailor Packages TWBKAUSRThis package, designed to handle alternate us er IDs, maps the user ID on the SPRIDEN table to an external user. Proceduresp_main_wrapper - Contains the URL as \twbklogn.P_Login p_web_login - Contains SSO_USER , SSO_PSWD, SSO_LUM_USER and the URL as \twbklogn.P_Login TWBKTABS This package contains definitions of table ty pes to be used when processing Web Tailor data. TWBKSELS This package contains cursors, simple proc edures, and functions that retrieve data contained in Web Tailor tables. Note: In most cases Web Tailor calls are made to a given procedure, for example, p_printanchor . Many of those procedures call a corresponding function which actually does the work, for example, f_printanchor . Procedures begin with p_ and functions begin with f_.These procedure/function pairs were cr eated so that applications that require the HTML to be constructed in a buffer and printed later can call the function directly, while applications that need the output to be generated immediately can call the procedure. Cursorstwgbwses_row_by_pidm_c - Retrieves rows from TWGRWPRM for a specified TWBRWPRM_PIDM .twgrwprm_row_by_pidm_name_c - Retrieves rows from TWGRWPRM for a specified TWBRWPRM_PIDM and TWBRWPRM_PARAM_NAME ./n 131 Banner Web Tailor User Guide |Web Tailor Packages twgrwprm_row_pidm_like_name_c - Retrieves a row from table TWGRWPRM based on PIDM and value. twbrwprm_row_by_name_value_c - Retrieves rows fr om TWGRWPRM for a specified TWBRWPRM_PARAM_NAME and TWBRWPRM_PARAM_VALUE .Functionsf_generate_random_id - Generates a six-character random ID from the value submitted. f_get_param_value - Retrieves the TWBRWPRM_PARAM_VALUE for a specified TWBRWPRM_PARAM_NAME and TWBRWPRM_PIDM .f_get_pidm_from_twbrwprm - Retrieves the TWBRWPRM_PIDM from TWGRWPRM for a specified TWBRWPRM_PARAM_VALUE .TWBKMODSThis package contains procedures and functi ons that insert new records into Web Tailor tables, update existing records in Web Tailor tables, and delete existing records from Web Tailor tables. p_del_twgrwprm_pidm_like_name - Deletes existing records from TWGRWPRM, where TWGRWPRM_PIDM equals the specified pidm and TWGRWPRM_PARAM_NAME is the specified parameter name. p_delete_twgrwprm - Deletes existing records fr om TWGRWPRM for a specified TWGRWPRM_PIDM and, optionally, up to two (2) TWGRWPRM_PARAM_NAME values.p_delete_twgrwprm_pidm_name - Deletes existing records from TWGRWPRM for a specified TWGRWPRM_PIDM and TWGRWPRM_PARAM_NAME .p_insert_twgbwses - Inserts new records into TWGBWSES for a specified TWGBWSES_PIDM with the values provided. p_insert_twgrwprm - Inserts new records into TWGRWPRM for a specified TWGRWPRM_PIDM with the values provided. p_update_twgbwses - Updates existing records in TWGBWSES for a specified TWGBWSES_PIDM with the values provided. p_update_twgrwprm - Updates existing records in TWGRWPRM for a specified TWGRWPRM_PIDM with the values provided. /n 132 Banner Web Tailor User Guide |Web Tailor Packages TWBKFUNC This package contains procedures and functions that process data in Web Tailor tables. Proceduresp_del_twgrwprm_by_pidm_name - Deletes TWGRWPRM rows for a specified TWGRWPRM_PIDM , where at least part of TWGRWPRM_PARAM_NAME matches the specified parameter name. Us es the Oracle LIKE operat or and appends the wildcard matching character ( %) to the end of the string to match. p_del_twgrwprm_by_value - Deletes TWGRWPRM rows for a specified TWGRWPRM_PARAM_VALUE .p_get_twgrwprm_rows - Retrieves TWGRWPRM rows for a specified TWGRWPRM_PIDM and TWGRWPRM_PARAM_NAME .p_store_twgrwprm_row - Builds a parameter name from values submitted and updates an existing row in TWGRWPRM, or inserts a new row if one does not already exist. p_validate_session_id - Validates the current webid ( value_in ) against the previously generated webi d for the specified PIDM ( pidm_in ), and generates a new webid ( temp_id_in_out ) from the value submitted. Functionsf_build_param_name - Builds a parameter name from values submitted to be used when retrieving, updating, inserting, or deleting TWGRWPRM rows. f_load_and_store_param_value - Builds a parameter name, deletes existing rows with that name, builds a new pa rameter name, and updates an existing TWGRWPRM row or inserts a new row if one does not exist for the new parameter name. TWBKBSSFThis package contains the encryption procedures used in the Luminis Platform security routines. f_binary_to_integer f_decode_base64 (base64str IN VARCHAR2, pad IN CHAR DEFAULT '=') RETURN VARCHAR2; Encodes the str value using the base64 encoding method as described above. /n 133 Banner Web Tailor User Guide |Web Tailor Packages f_decode_bits - Decodes the value passed to the base64str parameter using the Base64 method described above. f_encode - Encodes the following special characters so they can be passed through the Web server without being misinterpreted: f_encode_bits (binval IN VARCHAR2) RETURN VARCHAR2; f_hex_to_integer f_integer_to_binary f_integer_to_hex The following procedures are used within the encoding and decoding process to process sections of the source string. p_encode_pos1 p_encode_pos2 The following two procedures use calls to the UTL_RAW package to emulate binary shifting of the string pass ed into the rawin parameter. p_rightshift p_leftshift ValueEncoded Value %%25+%2Bsp+/%2F:%3A;%3B@%40&%26=%3D?%3F‚%27/n 134 Banner Web Tailor User Guide |Web Tailor Packages TWBKAUTHThis package contains the procedures whic h pass secured information in the Luminis Platform application. Global variablesGlobal variables used to parse the security info in the CP global cookie: FunctionsF_CPAuthenticate - Takes in the user's ID and PI N, and returns a combination of the Web session id and pidm if the user is valid. If the us er is not valid, the function will return a NULL.F_FetchCPCookieval F_FetchCPLastAccess F_GetLastActivityTime - Takes the user's ID and returns the last activity time found in the Web session tabl e (TWGBWSES). The format of the return string is as specified in the CP cookie-encoding spec. Returns NULL if the user is not found, or the user does not have a last activity time stored in the Web session table. F_ReconstructCPCookie - Puts the CP cookie back together, using the PL/SQL tables above with the updated Web ID and user PIDM. This returns the plain text version of the cookie. It will be encoded later. F_RetrieveRoles - Takes the user's ID, and passes back a comma-delimited string of CP-recognized role names that are valid for the specified user. If no roles are found, the function returns a NULL.ProcedureP_ParseCPCookie - Takes the CP cookie value (after it has been decoded), splits it into sections based on th e CP cookie specifications. The pieces are loaded into the PL/SQL tables (defined above) for later use. type longvarchar2_tabtype is table of VARCHAR2(32767) index by binary_integer; cp_endpos_tab twbklibs.VARCHAR2_tabtype; cp_startpos_tab twbklibs.VARCHAR2_tabtype; cp_value_tab longVARCHAR2_tabtype; cp_ent_value_tab longVARCHAR2_tabtype; cp_type_tab twbklibs.VARCHAR2_tabtype; cp_num_cookie_vals number := 0; cp_num_cookie_vals number := 0; /n 135 Banner Web Tailor User Guide |Web Tailor Packages TWBKLDAPThis package creates the LDAP Administration page. You will use this page to maintain the LDAP Settings Table (TWGBLDAP) becaus e some of the columns in TWGBLDAP are encrypted so the information they c ontain cannot be viewed in SQLPlus. ProceduresP_ModifyPgLDAP - Displays a page showing information from the TWGBLDAP table. P_SaveLDAP - Allows you to save changed information to the TWBKLDAP table. Warning! The values of the passwords will be encrypted when you save. TWBKLOGNThis package contains the procedures and fu nctions that authenticate user credentials. Note: If you want to create a custom func tion, it is recommended that you copy one of the existing functions, modify it, and change the Web Tailor parameter LDAPFUNCTION to point to it. This package calls the GB_THIRD_PARTY_ACCESS API for all inserts and updates to the GOBTPAC table. return_code Indicates that the procedure has been called from another procedure, and that some message should be displayed to explain the outcome of the calling procedure. return_msg A message to be displayed on screen trans_type Transaction type indicator; U - update, C - create _in Input parameters - will be null if successful. If not null, the update or insert failed, and the user must resubmit the data. The values the user entered in to the form will be passed back into this procedure and displayed. trans_type Transaction type indicator. Valid values: U - update, C - create _in Fields from the data entry form that correspond to the database tables. /n 136 Banner Web Tailor User Guide |Web Tailor Packages FunctionsF_ENC_DATA - Performs encryption using the Oracle DBMS_OBFUSCATION package, and returns the encrypted string. F_LDAP_BANNERSEARCH - Returns the mapping from the GOBTPAC table. Use this function if the LDAP user is mapped to Banner Self-Service by storing the LDAP user ID in the GOBTPAC_LDAP_USER column in the GOBTPAC table. Warning! When mapping an LDAP user ID on the GOATPAD form, be sure to assign a different LDAP ID for each Banner ID. They must be unique. F_LDAP_CPSEARCH - This function is used if your institution stores user credentials on an LDAP server instead of maintaining them on the GOBTPAC table. It performs an LDAP search to retrieve the Banner ID. In addition to mapping LDAP to Banner Self-Service, it also manipulates the returnin g string to remove extraneous text from the end of it. F_LDAP_CUSTOMSEARCH - Performs an LDAP search to retrieve the Banner ID. It returns a string exactly as it is. Use this function if the LDAP user is mapped to Banner Self-Service by storing Self-Service IDs as an attribute in LDAP. If a GOBTPAC record is not found (and LDAP is being used as the authentication source), one will be inserted automatically for the first login. The Terms of Usage indicator information (selected or cleared) will be included in this record. However, this will not store PIN information. ProceduresP_ValLogin - Procedure to validate the login. TWBKINTEThis package contain the procedures which perform the necessary steps to allow end users of the Banner Web systems to jump to another Web Tailor-based system without having to authenticate them selves again, and back again when backing out. sid Student ID pinPersonal Identification string newpin New PIN number verpin Verification of new PIN number /n 137 Banner Web Tailor User Guide |Web Tailor Packages Procedures (used on remote side) P_ForwardFromBanner - Used to check jumpid to make sure is valid, update sessid and re-route user to the correct initial screen. P_ReturnToBanner - Used to send the end user back to Banner WT system. Procedures (used on Banner side)P_ReturnFromOther - Used to re-establish security on the Banner system when user returns back to Banner from other system from executing P_ReturnToBanner P_ForwardToOther (systemname VARCHAR2) - Used to create a jumpid cookie and redirect to another We b Tailor-based system and execute P_ForwardFromBanner on that system TWBKLISTThe TWBKLIST package was introduced in Release 7.1 to close a potential security hole. Some Self-Service procedures exist in executab le packages that a user previously could call directly in a URL without be ing logged in. This caused a security vulnerability through which users could potentially access/update data that they would normally not be able to access. This package solves the security issue by preventing users from calling a procedure directly without being logged in. ProceduresP_main - Throws an exception if a procedure is executed directly and is not defined in the TWGBWMNU table. The process looks at an environment variable to determine which procedure is bein g called. This process will need to be called from Before procedure in the DAD configuration. TWBKFRMTThis package provides general HTML formatti ng functions, which are used by other Web Tailor packages. /n 138 Banner Web Tailor User Guide |Web Tailor Packages FunctionsF_ConvertTextareaTags - Converts any greater than or less than signs ( < > ) in the specified string to < and > respectively. This is used in textarea value strings, to ensure that the HTML tags stor ed in a database field are displayed on the page. F_ConvertURLSpaces - Converts any spaces in the specified string to %20, which is interpreted by a Web server as a space. Used to make sure that URLs with query strings do not contain any spaces. f_display_ssb_field - Conditionally displays fi elds based on GORDMSK rules established for the SSBMASKING object and the specific package and item. For instructions on using this masking feature, see fiMasking International Person Information Fieldsfl in Chapter 4 of the Banner General Data Security Handbook .F_EncodeURL - Encodes the following char acters in the input string: ? / ; : @ = & f_err_msg_remove_delim_tbl - Formats and displays any exceptions from a procedure™s API call. f_Escape - converts suspicious strings to or dinary text before passing them to the browser to be displayed F_FormDate_txt F_FormDateText - Prints a form text field with th e length set to the current length of the date input format. Prints the date input format to the right of the field to instruct users. F_FormHidden - replacement for htf.formhidden F_FormText - Generates the tag by calling the Oracle Web Toolkit function htp.FormText . It may also make some adjus tments to the input field width. F_FormLabel - Prints cvalue as a label, applying idname as the ID attribute. ŁVisible takes two values, Visible and Invisible, to allow a label to be output but not displayed by the browser. Th is is occasionally required when a label is necessary for screen readers but not for display. The invisible attribute is controlled by the style sheet classes fieldlabeltextinvisible . Visible text is controlled by the style sheet class fieldlabeltext . ŁPrintrequired optionally outputs required image as defined on the Web Tailor Customize Global User Interface Options page. F_FormText - Produces the tag to provide text fields for data entry. F_HeaderCaps - Prints a large bold heading, where string_in is converted to all capital letters, with in itial capital letters two si zes larger than the rest. F_ImageLink - Returns the HTML text that displays the link specified, using the image as the hotspot for the link. url The URL of the new hyperlink /n 139 Banner Web Tailor User Guide |Web Tailor Packages F_PrintAnchor - Produces tags to create a hyperlink. F_PrintBold - Prints text with the bold attribute. This is a deprecated function and should not be used for generating accessible HTML. F_PrintBullet - Returns the te xt of the HTML IMG tag for printing the bullet for the specified page. Checks th e TWBKWMNU record to find the specified bullet name. F_PrintDivider - Returns the text of the HTML IMG tag for printing the divider for the specified page. Checks the TWBKWMNU record to find the specified divider name. F_PrintHeader - Produces the tag. Parameters are the same as the Oracle Web toolkit HTF.header , but if cheader, the header text, is null, it returns NULL and no tag is produced at all. F_PrintImage - Returns the text of the HTML IMG tag for printing the specified image. F_PrintText - Prints text inside tags using the CSS class defined by class_in .F_Object - Formats an object tag F_ObjectOpen - Formats an object open tag. F_ObjectClose - Formats an object close tag. F_PrintRequired - Prints a marker (the image in TWBKIMAG called web_required ) that specifies a required field on a form using CSS class fieldrequiredtext . If web_required is not defined, it defaults to *.F_PrintSpacer - Returns the text of an HTML IMG tag that uses a single-pixel transparent gif file ( TWBKIMAG_NAME='GeneralSpacer' ) to create a spacer. F_TableClose - Produces the
tag and restores previous table type if defined. imagename The high-level image name, from TWBKIMAG_NAME anchorname Placeholder name to be associated with the anchor tag (prints or tags with the appropriate style sheet classes based on the input parameters. It is sensitive to the type of table, im plemented in the package global variable current_table_type . current_table_type is initialized when twbkfrmt.f_tableopen is called, and reset when twbkfrmt.f_tableclose is called. The style sheet class is defined by the ty pe of table and the datatype parameter, as follows: If the current table type is DATAENTRY and the datatype is HEADER , the TH tag is returned with the class defined as CLASS=™deheader™ .In addition, a SCOPE= attribute is defined when current_table_type is DATAENTRY , DATADISPLAY , NONTABULAR , or DATAWITHBORDER :ŁIf datatype is TITLE then scope is set to colgroup .ŁIf datatype is HEADER then scope is set to col.ŁIf datatype is LABEL then scope is set to row .Current Table TypeClass Attribute DATAENTRYclass=™de™ NONTABULAR class=™nt™ DATADISPLAY class=™dd™ PLAIN class=™pl™ MENUPLAIN class=™mp™ INFO class=™in™ DATAWITHBORDER class=™db™ cvalue The value for the VALUE attribute cdpThe value for the DP (decimal point) attribute. Passed as is. crowspan Value of the ROWSPAN attribute ccolspan Value of the COLSPAN attribute cattributes Other attributes, passed as is. datatypeTITLE , HEADER , LABEL generate TH tag if current_table_type is DATADISPLAY . Otherwise, a TD tag is generated /n 141 Banner Web Tailor User Guide |Web Tailor Packages F_tableDataOpen - Generates the tag, with class and alignment controlled by style sheet classes in the same way as f_tableopen . It keeps track of table nesting levels. F_TableDataClose - Generates the tag and keeps track of table nesting levels.F_TableDataDead F_TableDataDeadClose F_TableDataHeader F_TableDataHeaderOpen F_TableDataHeaderClose F_TableDataHighlight F_TableDataHighlightOpen F_TableDataHighlightClose F_TableDataLabel F_TableDataLabelOpen F_TableDataLabelClose F_TableDataSeparator F_TableDataSeparatorOpen F_TableDataSeparatorClose F_TableDataWhite F_TableDataWhiteOpen F_TableDataWhiteClose F_TableHeader F_TableOpen F_TableRowClose F_TableRowOpen ProceduresP_FormDateText P_FormHidden - replacement for htp.formhidden. P_FormLabel - Uses F_formlabel to print an item inside a list for this select box). field_desc Description of field, to be included in error message if the field is found to be null. curlURL of the CGI script. ctarget The frame to load the results of the form submit into. cenctype The type of encoding used. cattributes Any additional attributes to be added to the form tag. validate_tab PL/SQL table of form fields th at need to be checked for not null values. num_validate Number of fields to be validated. button_text Will override the default text sh own on the button (default is currently Save Changes).cname Name associated with this button. /n 157 Banner Web Tailor User Guide |Web Tailor Packages Note: All the PIN-related changes to GOBTPAC records are performed via the GB_THIRD_PARTY_ACCESS API as of Release 7.0. Variables minutesPerDay constant number := 1440; Colors used in Web Tailor - borders around update and create boxes Łcreate_dk VARCHAR2(9) -- Darker colo r in Create box borders Łcreate_lt VARCHAR2(9) -- Lighter colo r in Create box borders Łupdate_dk VARCHAR2(9) -- Darker colo r in Update box borders Łupdate_lt VARCHAR2(9) -- Lighter color in Update box borders Łbottom_right_on VARCHAR2(1), Y -- Indicates whether or not to print right and bottom borders of Create and Update box es in Web Tailor administrative pages Colors used in data-entry forms: Łheader_col VARCHAR2(9), #cccccc -- Color of headers in some data entry forms Łlineitem_col VARCHAR2(9), #ffffff -- Color of line items in some data entry forms.Variables which keep track of whether or not the HTTP header has been opened and closed, updated by F_ValidUser :Łhttp_header_closed BOOLEAN DEFAULT FALSE Łhttp_header_opened BOOLEAN DEFAULT FALSE FunctionsDISPLAY_FGAC_USAGE - Contains the values Y or N to indicate whether or not to display the FGAC Policy exists for message. DISPLAY_VPDI_CODE - Displays the VPDI code. F_CgiBin - Returns the directory path of the CGI-BIN directory NONE Do not display anything. CODE Display only the code. DESC Display only the description. BOTH Display both the code and description. /n 158 Banner Web Tailor User Guide |Web Tailor Packages F_CheckPositiveInd - To be used in check box creation in the Web Tailor Administration procedures. If cursorvalue in ('A', 'Y'), the function returns CHECKED .f_css_link - Gets the CSS URL defined for the Web page. If it does not exist, the function gets the CSS URL defined for the module. If that does not exist either, the function get the CSS URL defined for the system. F_DispInfo - Prints HTML tags that print an In fo Text message and image in table format.F_FetchWTParam - Fetches the parameter valu e associated with the specified parameter name in the TWGBPARM table. F_FmtDate - Function to convert a string to a date based on gubinst_date_default_format .F_formSelectOption - Function that replaces htf.formSelectOption .F_GenRandId - Function to generate a random ID. name The high-level page name, from TWBKWMNU_NAME label Message label, from TWBRINFO_LABEL (specifies which piece of text to display, if more than one exists for this page). msg_text The message text to be printed. Should be NULL if the text is being fetched from the TWGRINFO table. msg_type Indicates which image to print with the message. The default is the standard NOTE type. (Note image printed before text). value1 AND value2 These are parameters to be inserted into the retrieved text. To be inserted, the te xt in the database must contain parameter PLACEHOLDERS, <VALUE1> or <VALUE2> , respectively. These are to be used if user-specific data needs to be displayed as part of a standard error or return message. strCharacter string date variable cdispvalue Select list displayed value cpassvalue Select list passed value cselected SELECTED argument cattributes Generic attribute argument VALUE1> and <VALUE2> , respectively. Use them when user- specific data must be displayed as part of a standard error or return message. pidm Banner PIDM webid Dynamically generated Web session ID /n 162 Banner Web Tailor User Guide |Web Tailor Packages P_formSelectOption - Procedure that replaces htp.formSelectOption .P_Logout - Procedure to logout of the Web session. P_MetaForward - Prints an HTML page with META tag headers that forward the browser immediately to ret_location .P_OpenDoc - Generates the beginning HTML page . It will refer to the Luminis CSS if it is present. usage_btn String containing text on the button pressed from usage page cdispvalue Select list displayed value cpassvalue Select list passed value cselected SELECTED argument cattributes Generic attribute argument _in Input parameters - if null, the update or insert was successful. Otherwise, the user is asked to resubmit the data. The values the user en tered into the form will be passed back into this procedure and displayed. trans_type Transaction type indicator. Valid values: U for update, C for create _in Fields from the data entry form that correspond to the database tables /n 166 Banner Web Tailor User Guide |Web Tailor Packages P_ModifyPgWebMain - Page that allows the user to enter or change information in the TWGBWMNU table. Uses a call to a javascript procedure to validate the data before the form is submitted. P_OptionPgWebMain - Page that gives user option of creating or updating an existing Main Text page. P_SaveWebMain - Updates or inserts a row into the TWGBWMNU table, depending on user inputs and the transaction type. TWBKWINFThis package contains procedures that a llow users to update Info Text and error messages. P_CopyToLocal - This procedure will copy all base line Info Text rows to local Info Text rows. If there are any local rows, it w on't overwrite them. If a parent menu record is needed (due to the new source_ind column) then create a parent row first. return_code Indicates that the procedure has been called from another procedure, and that some message should be displayed to explain the outcome of the calling procedure. return_msg A message to be displayed on screen. trans_type Transaction type indicator. Valid values: U for update, C for create. _in Input parameters. Will be null if the insert was successful, otherwise, the user must resubmit the data. The values the user entered into the form will be passed back into this procedure and displayed. return_code Indicates that the procedure has been called from another procedure, and that some message should be displayed to explain the outcome of the calling procedure. trans_type Transaction type indicator. Valid values: U for update, C for create. _in Fields from the data entry form that correspond to the database tables. /n 167 Banner Web Tailor User Guide |Web Tailor Packages P_ModifyPgInfoText - Page that allows the user to enter or change information in the TWGRINFO table. Uses a call to a javascript procedure to do data validation before the form is submitted. P_OptionPgInfoText - Page that gives user option of creating or updating an existing set of Info Text en tries (repeating records). P_ReorderInfoText - Back-end process which reorders the Info Text for the specified menu, then returns to the Reorder Info Text page. P_ReorderPgInfoText - Page that displays all curr ent Info Text, gives links to update each item, and an interface for reordering elements. P_SaveInfoText - Updates or inserts a row into the TWGRINFO table, depending on user inputs and the transaction type. return_code Indicates that the procedure has been called from another procedure, and that some message should be displayed to explain the outcome of the calling procedure return_msg A message to be displayed on screen trans_type Transaction type indicator. Valid values: U for update, C for create _in Input parameters. Will be null if the update or insert failed, otherwise, they will not be null, and the user will be asked to resubmit the data. The values the user entered into the form will be passed back into th is procedure and displayed name_in Name of the menu, from TWBRINFO_NAME orig_seq_tab Table of original sequence numbers as printed on the Reorder Info Text page new_seq_tab Table containing the values of Info Text sequence number pull-down lists on the page label_tab Table containing the labels as printed on the Reorder Info Text page name_in Menu name from TWBRINFO_NAME return_msg Return message to be printed return_code Error return code trans_type Transaction type indicator. Valid values: U for update, C for create *_in Fields from the data entry form that correspond to the database tables. /n 168 Banner Web Tailor User Guide |Web Tailor Packages Package Specs for Luminis Channels for Banner The package specs for Luminis Channels for Banner are delivered with Web Tailor (the package bodies are delivered with Luminis Channels for Banner). They are described in this section. twbccomn.sqlThis is the package spec for channel functions and procedures. It also stores the common methods which are used in channel processi ng. The package body is delivered with Luminis Channels with Banner. twbcmain.sqlThis is the package spec for the main channel package. Luminis classes call it to retrieve the XML used to render the channels in Lumi nis. The package body is delivered with Luminis Channels with Banner. twbcmxml.sqlIndividual channel packages will use methods from this helper package to generate XML using the Oracle XDK. XML is used in Luminis to render channels. /n 169 Banner Web Tailor User Guide |Graphic Elements Graphic Elements This chapter presents instructions on replaci ng or modifying the images delivered as part of Web Tailor and the BannerŽ Self-Service products. Review and customize graphic elements Graphic elements are images that can be customized to display at various places in Self- Service Banner. They can be placed next to menu items, error and warning messages, links, Info Text, and the like. You will want to review the delivered graphic elements to make sure they are appropriate for your institution. You can use Web Tailor to customize the gr aphics and icons that appear on your Web pages, or to define new ones. To customize the images that display, perform the following steps: 1.Select Graphic Elements from the Web Tailor Administration Menu. 2.Select the Create button to create a new element, or select an element from the pull- down menu. 3.Enter the name of the element. If you ar e customizing a delivered element, you may want to rename the element to something unique to your institution. 4.Enter the URL that points to the element on the web server. 5.Enter the image™s width and height. 6.Enter any alternate text to be processed by a user agent such as a screen reader. This will help a visually-impaired user unde rstand how the graphic element is used. Delivered imagesDelivered images can be foun d in the following locations: ŁFaculty Self-Service - im ages are delivered in /facweb/gifs and deployed in /facgifs on the web server to support the Faculty Self-Service product. ŁStudent Self-Service - images are delivered in /stuweb/gifs and deployed in /stugifs on the web server to support the Student Self-Service product. ŁWeb Tailor - images are delivered in /wtlweb/gifs and deployed in /wtlgifs on the web server to support the Web Tailor application. /n 170 Banner Web Tailor User Guide |Tag Mapping Tag Mapping This appendix has been provided to help you customize the delivered Web pages. It identifies which items on the pages are created and influenced by which tags. There are more style classes related to tables than are shown here. For example, there are style classes for DATAENTRY, DATADISPLAY, and PLAIN type tables and their components (table headers and table cells). Style rules for form controls are defined for ea ch HTML form control element. There is a single style rule for each of INPUT, TEXTAREA, and SELECT. Error and warning messages use the errort ext and warningtext cl asses respectively. Note: The text SPANS and other tag classes describe the objects; the DIV classes specify where they appear on the web page. This appendix covers three different web pages: ŁfiLogin pagefl on page171 ŁfiWeb Tailor Menufl on page172 (an example of a menu page) ŁfiCustomize the selected modulefl on page173 (an example of an application page) /n 171 Banner Web Tailor User Guide |Tag Mapping Login page NameDescriptionBODY The entire screen. H1The level 1 header. pageheaderlinks The region directly under the level 1 header. Usually there would be links to other pages, but on this page there aren™t any. TABLE.infotexttable This class defines styles for the table that will be populated with Info Text. TD.indefault1 This class defines styles for the table™s data cells. infotext This class defines text styles for Info Text. TABLE.dataentrytable This class defines styles fo r the table that contains a form with data entry fields. TD.delabel This class defines styles fo r table data cells containing labels.fieldlabeltext This class defines text styles for labels. TD.dedefault This class defines default styles for table data cells. releasetext This class defines styl es for release text. headerwrapperdiv The DIVs identified by the pageheaderdiv1 and pageheaderdiv2 classes. pageheaderdiv1 The DIV class that contains H1, which contains the page header. pagetitlediv The DIV class that contains H2, which contains the page title (not applicable in this case). pagebodydiv The DIV class that contains all the page-specific content. In this case, the Info Text, data entry fields, and buttons. infotextdiv The DIV class that contains the Info Text. pagefooterdiv The DIV class that contains footer information for this screen. poweredbydiv The place where the Powered by Ellucian graphic is displayed. The Powered by Ellucian graphic is no longer used. /n 172 Banner Web Tailor User Guide |Tag Mapping Web Tailor Menu NameDescription BODY The entire screen. H1The level 1 header. pageheaderlinks Links to other pages, e.g., Personal Information , Student Services & Financial Aid , etc. H2The level 2 header, which contains the page title. In this case it says Web Tailor Menu .TABLE.menuplaintable This class defines styles for a table that has menu links. TD.mpdefault This class defines styles for table data. releasetext This class defines styles for release text. headerwrapperdiv The DIVs identified by the pageheaderdiv1 and pageheaderdiv2 classes. pageheaderdiv1 The DIV class that contains H1, which contains the page header. headerlinksdiv The DIV class that contains the links to other web pages. It this case the links are Personal Information , Student Services & Financial Aid , etc. pagetitlediv The DIV class that contains H2, which contains the page title (in this case, Customize the selected Module ).pagebodydiv The DIV class that contains all the page-specific content. pagefooterdiv The DIV class that contains footer information for this screen. In this case, it contains Release 5.2 .poweredbydiv The place where the Powered by graphic is displayed.The Powered by Ellucian graphic is no longer used. headevlinksdiv2 The DIV class that contains search box 2. submenulinktext2 This defines menu links. staticheaders The DIV class that contains static headers. /n 173 Banner Web Tailor User Guide |Tag Mapping Customize the selected moduleNameDescription BODY The entire screen. H1The level 1 header. pageheaderlinks Links to other pages, e.g., Personal Information , Student Services & Financial Aid , etc. H2The level 2 header, which contains the page title. In this case it says Customize the selected Module.infotext This class defines styles for Info Text. fieldrequiredtext This class defines st yles for the graphic that indicates that a field is required. requiredmsgtext This tag defines styl es for the required field message text. In this case, indicates a required field.TABLE.dataentrytableThis class defines st yles for the table that contains a form with data entry fields. TD.delabelThis class defines styles for table data cells containing labels. TD.dedefaultThis class defines default styles for table data cells. fieldlabeltextThis class define s text styles for labels. backlinktextThis class defines styles for a back link, in this case it says Select another Module to customize .headwrapperdivThe DIV class that contains BODY, H1, and pageheaderlinks. pageheaderdiv1The DIV class that contains H1, which contains the page header. headerlinksdivThe DIV class that contains the links to other web pages. In this case, Personal Information , Student Services & Financial Aid , etc. pagetitledivThe DIV class that contains H2, which contains the page title (in this case, Customize the selected Module )./n 174 Banner Web Tailor User Guide |Tag Mapping pagebodydiv The DIV class that contains all the page-specific content. In this case, the In fo Text, data entry fields, pull-down lists and buttons. infotextdiv The DIV class that contains the Info Text. backlinkdiv The DIV class that contains the Back link and text. headlinksdiv2 The DIV class that contains the search box. staticheaders The DIV class that contains static headers. NameDescription /n

Banner_Web_Tailor_User_Guide_8.6.1.pdf (641.4 KB)
Helpful?

Related Articles: