4749-6 Cover 5/15/01 12:25 PM Page If Oracle9iAS Portal can it, you can it too Inside, you’ll find complete coverage of Oracle9iAS Portal Build complete information portals • Understand Portal basics — components, content areas, portlets, and portal pages • Create sophisticated Portal applications • Build in menus, links, consistency, and data validation • Design reporting components, including forms, charts, and calendars • Deploy, administer, and secure a Portal site Reports — direct to the Web from your Oracle database • Program your own custom portlets and portlet provider Bonus CD-ROM! • All source code from the book • A complete sample database • PS/SQL Developer trial version, SWiSH demo, and • GREENWALD AND MILBERY Cookie Pal freeware A searchable e-version of the book www.hungryminds.com System Requirements: Windows NT SP3 or higher, 64MB RAM, 600MB hard disk space, CD-ROM drive, Oracle9iAS $49.99 USA $74.99 Canada £39.99 UK incl VAT Reader Level: Shelving Category: Beginning to Advanced Database ISBN 0-7645-4749-6 *85 -AE CDe C O M P R E H E N S I V E ™ • Integrate existing PL/SQL logic into a Portal application 100% Oracle9iAS Portal Oracle’s revamped, browser-based technology for information portals delivers everything you need to create a complete information portal, which can include forms, charts, reports, content collections, and a variety of information from the Web And this authoritative reference provides all the information you need to master portlet creation, database browsing, application development, component management, performance monitoring, and the other capabilities of Portal Written by two veteran database developers, this encyclopedic guide will help you extend the rich functionality of Portal — and create powerful, easy-to-use information retrieval and reporting systems for companies and their customers ,!7IA7G4-fehejc!:p;o;t;T;T Bible Source code and sample database on CD-ROM 100% ONE HUNDRED PERCENT COMPREHENSIVE AUTHORITATIVE WHAT YOU NEED ONE HUNDRED PERCENT Create and administer information portals Integrate internal and Internet information Build and deploy robust, Web-based database applications Oracle9iAS Portal ™ BONUS CD-ROM Source code, complete sample database, development tools, and more! Rick Greenwald and James Milbery Oracle9iAS Portal Bible ™ Oracle9i AS Portal Bible ™ Rick Greenwald and Jim Milbery Best-Selling Books • Digital Downloads • e-Books • Answer Networks • e-Newsletters • Branded Web Sites • e-Learning New York, NY ♦ Cleveland, OH ♦ Indianapolis, IN Oracle9i AS™ Portal Bible Published by Hungry Minds, Inc 909 Third Avenue New York, NY 10022 www.hungryminds.com Copyright © 2001 Hungry Minds, Inc All rights reserved No part of this book, including interior design, cover design, and icons, may be reproduced or transmitted in any form, by any means (electronic, photocopying, recording, or otherwise) without the prior written permission of the publisher Library of Congress Control Number: 2001090705 ISBN: 0-7645-4749-6 Printed in the United States of America 10 1B/RT/QW/QR/IN Distributed in the United States by Hungry Minds, Inc Distributed by CDG Books Canada Inc for Canada; by Transworld Publishers Limited in the United Kingdom; by IDG Norge Books for Norway; by IDG Sweden Books for Sweden; by IDG Books Australia Publishing Corporation Pty Ltd for Australia and New Zealand; by TransQuest Publishers Pte Ltd for Singapore, Malaysia, Thailand, Indonesia, and Hong Kong; by Gotop Information Inc for Taiwan; by ICG Muse, Inc for Japan; by Intersoft for South Africa; by Eyrolles for France; by International Thomson Publishing for Germany, Austria, and Switzerland; by Distribuidora Cuspide for Argentina; by LR International for Brazil; by Galileo Libros for Chile; by Ediciones ZETA S.C.R Ltda for Peru; by WS Computer Publishing Corporation, Inc., for the Philippines; by Contemporanea de Ediciones for Venezuela; by Express Computer Distributors for the Caribbean and West Indies; by Micronesia Media Distributor, Inc for Micronesia; by Chips Computadoras S.A de C.V for Mexico; by Editorial Norma de Panama S.A for Panama; by American Bookshops for Finland For general information on Hungry Minds’ products and services please contact our Customer Care department within the U.S at 800-762-2974, outside the U.S at 317-572-3993 or fax 317-572-4002 For sales inquiries and reseller information, including discounts, premium and bulk quantity sales, and foreign-language translations, please contact our Customer Care department at 800-434-3422, fax 317572-4002 or write to Hungry Minds, Inc., Attn: Customer Care Department, 10475 Crosspoint Boulevard, Indianapolis, IN 46256 For information on licensing foreign or domestic rights, please contact our Sub-Rights Customer Care department at 212-884-5000 For information on using Hungry Minds’ products and services in the classroom or for ordering examination copies, please contact our Educational Sales department at 800-434-2086 or fax 317-572-4005 For press review copies, author interviews, or other publicity information, please contact our Public Relations department at 317-572-3168 or fax 317-5724168 For authorization to photocopy items for corporate, personal, or educational use, please contact Copyright Clearance Center, 222 Rosewood Drive, Danvers, MA 01923, or fax 978-750-4470 LIMIT OF LIABILITY/DISCLAIMER OF WARRANTY: THE PUBLISHER AND AUTHOR HAVE USED THEIR BEST EFFORTS IN PREPARING THIS BOOK THE PUBLISHER AND AUTHOR MAKE NO REPRESENTATIONS OR WARRANTIES WITH RESPECT TO THE ACCURACY OR COMPLETENESS OF THE CONTENTS OF THIS BOOK AND SPECIFICALLY DISCLAIM ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE THERE ARE NO WARRANTIES WHICH EXTEND BEYOND THE DESCRIPTIONS CONTAINED IN THIS PARAGRAPH NO WARRANTY MAY BE CREATED OR EXTENDED BY SALES REPRESENTATIVES OR WRITTEN SALES MATERIALS THE ACCURACY AND COMPLETENESS OF THE INFORMATION PROVIDED HEREIN AND THE OPINIONS STATED HEREIN ARE NOT GUARANTEED OR WARRANTED TO PRODUCE ANY PARTICULAR RESULTS, AND THE ADVICE AND STRATEGIES CONTAINED HEREIN MAY NOT BE SUITABLE FOR EVERY INDIVIDUAL NEITHER THE PUBLISHER NOR AUTHOR SHALL BE LIABLE FOR ANY LOSS OF PROFIT OR ANY OTHER COMMERCIAL DAMAGES, INCLUDING BUT NOT LIMITED TO SPECIAL, INCIDENTAL, CONSEQUENTIAL, OR OTHER DAMAGES Trademarks: Oracle and Oracle9i are trademarks or registered trademarks of Oracle Corporation All other trademarks are property of their respective owners Hungry Minds, Inc is not associated with any product or vendor mentioned in this book is a trademark of Hungry Minds, Inc Credits Acquisitions Editor Grace Buechlein Media Development Specialist Travis Silvers Project Editor Sharon Nash Media Development Coordinator Marisa Pearman Development Editor Kezia Endsley Book Designer Michelle Logan Technical Editor Todd E Vender Illustrators Karl Brandt John Greenough Kelly Hardesty Joyce Haughey Clint Lahnen Gabriele McCann Ron Terry Copy Editor Maarten Reilingh Project Coordinator Regina Snyder Graphics and Production Specialists Sean Decker Laurie Stevens Brian Torwelle Quality Control Technician Laura Albert John Greenough Proofreading and Indexing Laura Albert John Greenough Susan Moritz TECHBOOKS Production Services Cover Image Kate Shaw Senior Permissions Editor Carmen Krikorian About the Authors Rick Greenwald is a marketing manager in the server technologies group at Oracle Corporation He has been active in the field of data processing for over 15 years, including stints with Data General, Cognos, and Gupta He is the author of six other books on technology and dozens of articles and analyst pieces Jim Milbery has been involved in the software business for over 16 years and has worked for a variety of high-tech companies, including Digital Equipment Corporation, Ingres, Uniface, and Revere He is currently a partner with the technology consulting firm Kuromaku Partners LLC, where he provides strategic consulting to a diverse group of clients Jim lives in Easton, Pennsylvania, with his lovely wife, Renate, and two spoiled cats Jim Milbery — This book is dedicated to my father, Ken Milbery Here’s to you, Dad; no son loves his father more than I love you Rick Greenwald — For the three women in my life: LuAnn, Elinor, and Josephine Greenwald You are the breath of love in my life Preface This book is essentially the second edition of Oracle WebDB Bible The product formerly known as WebDB is called Oracle9iAS Portal in its current incarnation, which indicates that it is both bundled with the Oracle9i Application Server product and that the focus of the product has been modified to encompass the fast-growing world of information portals Consequently, the organization of this book has been enhanced and modified to fit in with the new product direction How This Book Is Organized As with the previous version, the first section of this book is an introduction to Oracle9iAS Portal — what it is, how to install it, and the basics of the development environment you will be using The second section of the book jumps right into the topic of portals Chapter introduces the concept of portals, portlets, and how Oracle9iAS Portal handles these entities Chapter walks you through the creation of a portal page Part III of the book covers the creation of a variety of components These are the same components that were supported in WebDB — reports, forms, charts, calendars, hierarchies, and dynamic HTML pages Each of these components retains the functionality it had in WebDB, but each of them also has been enhanced in the new version of the product Part IV of the book covers some of the topics you will need to understand to create complete applications with Oracle9iAS Portal For instance, you will almost inevitably be using lists-of-values to help your users properly utilize components, and Oracle9iAS Portal menus are essential for navigating through an application Validation, the use of templates, and linking are also integral to creating complete applications, and these areas have also been changed and enhanced from their counterparts in WebDB Finally, there will be times when you will need to use PL/SQL procedures to extend the functionality of your Oracle9iAS Portal components, which is also covered in this section In Oracle9iAS Portal, as in WebDB, you have the ability to create Content Areas, which were referred to as sites in WebDB Part V of the book explores this area of the product, including how to deploy your content collections 946 Index ✦ P–Q proportional (variable width) fonts, 488, 489, 493 protocol values for Uniform Resource Locators (URLs), 446 Provider portlet, 754–755 providers privileges, 772 provsyns.sql script (on CD-ROM), 837 proxy calls, portals and portlets, 136 proxy log on failure, post-installation check, 39–40 Proxy Server, 678–679, 752 public access, Navigation Bar, 641 components, Database Access Descriptors (DADs), 671 folders, Folder Wizard, 626, 627 template art images, 497 users, 764 Publish as Portal, Folder Wizard, 625 Publish As Portlet, Page Wizard, 156 punctuation in dates, 333 Purge Key, Content Areas, 723 Q QBE See Query-By-Example Report Wizard QBE Report and Customization Form Text, 193–195 QBE Report Name and Application, 175–176 Query button data, 117–118, 119 Form Wizard, 257, 272–275, 277–278 master-detail forms, 295, 297, 298 Query-By-Example (QBE) Report Wizard, 192 Query-By-Example (QBE) Report Wizard, 175–195 See also PL/SQL logic integration; Report Wizard; running reports; Shared Components Align of Column Formatting, 180 Application combo box, 175 ASCII formatting, 185 Background Color, 183 Batch button, 192 Border Size, 186 Break Options, 189, 190 button options, 192 cell highlighting feature, 182 Color of Formatting Conditions, 183 Column Formatting, 179–180 Column Heading, 179 Common Options, 184–186 Customization Form Display Options, 191–192 Default Format, 185 defining a report, 174–178 Display As, 180 Display Name, 194 Display Options, 183–190 Draw Lines Between Rows, 188 Embed interMedia rich content, 185 Enable delete/update link, 185 Excel formatting, 185 Expire After, 186 Finish button, 195 Font Color, 187 Font Size, 186 Footer Text, 194 Format Mask of, 180 Formatting Conditions, 181–183 Full Page Options, 186–188 Header Text, 194 Help Text, 194 HTML formatting, 185 Insert button, 192 Link, 181 Lists-of-Values (LOVs), 181 Log Activity check box, 188 Maximum Rows Per Page, 188 naming conventions, 175 PL/SQL procedure creation, 195 Portlet Options, 188–189 Preview Template button, 193–194 QBE Report and Customization Form Text, 193–195 QBE Report Name and Application, 175–176 Query button, 192 Reset button, 192 Row Order Options, 189–190, 204 Search dialog box, 176–177 Selected Columns list box, 178 Sequence, 183 shaping your report, 179–190 Show NULL Values as, 185 Show Timing, 188 Show Total Row Count, 184 Size, 181 Sum, 180 Table or View, 176 Table or View Columns, 177–178 Table Row Color(s), 187 templates, 192–195 text addition, 192–195, 194–195 Type, 180 Type Face, 183, 186 user shaping of report, 190–192 Width Type, 181 Index ✦ Q–R query code (on CD-ROM), SQL Query Link for charts, 323 query Lists-of-Values (LOV) object, 415–416 Query Options line, SQL Query Link for reports, 232–234 query parameters, Link Wizard, 581–582 Query Rows action, 97, 110–115 Query Wizard versus SQL Query Link for reports, 221–222 See also Chart Wizard; Report Wizard querying data See browsing (querying) data Questions Answered, monitoring performance, 797–798, 813–818 Quick Picks, Style Manager, 634 QuickPick items, Content Areas, 700 quota setting, Content Area Create Wizard, 652 R radio group format, LOV Wizard, 418, 421, 433 RadioGroup item type, Form Wizard, 266, 270, 521 range check code example (on CD-ROM), JavaScript, 542–543 range validation, 515 ranking groups of data, Hierarchy Wizard, 361 “real-time” page caching, portals and portlets, 141 rebooting system portal installation, 38 setup.exe, 22 recompiling procedures, Database Objects tab of Navigator, 106–107 recursive relationship, Hierarchy Wizard, 361 red X icon (delete), 152, 257, 644 redirect feature of Form and cookies, 873–877 redo logs, database object monitoring, 822–823 referential integrity, 292, 515 referential relationship, multiple tables in a report, 234, 235–240, 241 Refresh Page link, portals and portlets, 141, 150 refreshing home page, 61, 138–141 region properties, Style Manager, 636–639 regions, Add Portlets page, 153–155, 159–160 registering your provider, 845–846 Regular Items Content Areas, 700 Style Manager, 635 relative links Menu Builder Wizard, 450, 458, 464 Uniform Resource Locators (URLs), 450, 458, 464 remote database, portal installation, 33, 38 Rename process Database Objects tab of Navigator, 97, 98, 99 Manage Components, 740 rendering of colors, 482 Replace ASCII new lines option, 114 Report and Customization Form Text, Report Wizard, 212 Report Browser, running reports, 197–198 Report Layout Page, Report Wizard, 210 report versus forms, 252 Report Wizard, 207–216 See also Chart Wizard; Link Wizard; multiple tables in a report; PL/SQL logic integration; Query-By-Example (QBE) Report Wizard; reports as portlets; running reports; SQL Query Link for reports Break columns, 215 Break conditions, 213 Column Conditions, 209–210 Columns Formatting, 211 Custom Layout, 210 Customization Form Display Options, 212 Customize link, 212–213 defining reports, 174 Display Options, 212 editing, 214–216 Finish button, 212 Form Layout, 210 Formatting Conditions, 211–212 ORDER BY clause, 213, 215 overview, 7–8 Report and Customization Form Text, 212 report browser, 212–213 Report Layout Page, 210 Run Report button, 213 sorting, 213, 215 SQL statements for reports versus, 221–222 Table or View Columns, 209 Tables and Views, 208 Tabular Layout, 210 reports, object-based monitoring, 807–808 reports as portlets, 243–247 See also Add Portlets page default values, 246 design considerations, 244–245 editing, 246–247 Publish to Portal, 243 947 948 Index ✦ R–S Required Settings and Values, Content Areas, 702–703 Reset button Calendar Wizard, 343 Form Wizard, 257, 273, 275 Query-By-Example (QBE) Report Wizard, 192 Reset to Defaults button, home page, 66 restoring previous versions, 730–731 RESTRICT_CODES table, NetU Database, 45 result (target) frame, Frame Driver Wizard, 399, 400, 401, 402–403 Retain Deleted Items check box, Content Areas, 723 Retrieve Keys button, database, 126 return value, LOV Wizard, 419, 420 reusing SQL statements, SQL Query Link for reports, 221 REVISION_HISTORY table, NetU Database, 45 roles (abstract users) for database security, 758, 759–760, 789 rollback segments, database object monitoring, 823 round() function, 332 row in HTML table, Form Wizard, 258 Row Order Options browsing data, 112 Query-By-Example (QBE) Report Wizard, 189–190, 204 row-oriented frame, 402 rows See Database Objects tab of Navigator RRYY format mask element, 333 Run privilege, 773 running reports, 196–207 See also Query-By-Example (QBE) Report Wizard; Report Wizard; SQL Query Link for reports Align Column Parameter, 201 ARCHIVE status, 197 batch reporting, 192, 249, 343 Break Options, 205–206 Call Interface label, 196 calling reports directly, 247–248 Case Sensitive Column Parameter, 201, 203 character criteria, 202–204 Close button, 202, 205 column criteria, 200–202 Column Parameter, 200 component information, 196 Customize Page, 199–207 Datatype Column Parameter, 201 defaults, saving, 206–207 EDIT status, 196 Format Mask Column Parameter, 201 Help icon, 198 Manage Component, 196–207 ORDER BY clause, 204–205 parameter setting, 199–207 PL/SQL package, 196 PRODUCTION status, 196 Report Browser, 197–198 Run link, 197 saving defaults, 206–207 Show Column Parameter, 200 show procedure, 247–248 show_params procedure, 247–248 sorting reports, 199–205 Value Column Parameter, 201 version control, 197 runtime implementation of portals and portlets, 137–138 S sample scripts and files for each chapter (on CD-ROM), 898–904 schema(s) deployment, 660, 672–675 granting access with Database Objects tab of Navigator, 101–103 NetU Database, 47 portal installation, schemas created, 33–34 privileges, 785–790 selection, 122 users, privileged accounts, 765, 774 screen resolutions and Color Wizard, 480–481, 482 script code field, JavaScript, 534–535 script samples for each chapter (on CD-ROM), 898–904 ScriptBuilder (NetObject), 537 scripts, JavaScript, 519, 521–530 search engines meta tags (HTML packages) and, 588–589 Uniform Resource Locators (URLs) and, 453–454 Search folders, Folder Wizard, 622, 623 Search Settings, 753 searches monitoring, 805 searching Content Areas, 723–724 Menu Builder Wizard, 459, 463 Navigation Bar, 643, 644 Query-By-Example (QBE) Report Wizard, 176–177 secexp script, 746 secimp script, 746 Secondary Items, Content Areas, 704 Index ✦ S–S Secondary Links, Page Wizard, 150 security, 757–794 See also administration; privileged accounts Account Lockout Policies, 792 administrators, 759 applications privileges, 783–785 CONNECT privilege, 758 Content Areas, 691–696, 718–721 cookies, 874 data for users and groups, exporting and importing, 746 Database Access Descriptors (DADs), 671 database administrators (DBAs), 759, 764 database security, 757–760 Edit Login Server, 791–792 Edit User, 793 environment, 73–74 Folder Wizard, 626–629, 695–696 GRANT command, 758 Grants (Schema), 788–789 groups and group privileges, 764, 774, 775–781 Inherit Privileges, 783–784 instances of databases, 758 lightweight users, 765, 787 Login Server, 762, 765, 790–793 Members tab, 776 object privileges, 693–694, 771–774, 781–785, 788 Password Policy, 792 passwords for database security, 757 portal developers, 759, 760 portal users, 759 portals and portlets for implementing, 137 portlet publishers, 759, 764 roles (abstract users) for database security, 758, 759–760, 789 schema privileges, 785–790 user names for database security, 757, 758 WWSEC% tables, 785 security privileges Database Objects tab of Navigator, 96, 101–102 Navigator appearance and, 82 SELECT keyword, Calendar Wizard, 336 select() method, 530 SELECT statement, SQL Query Link for charts, 318 Selected Columns list box, Query-By-Example (QBE) Report Wizard, 178 Sequence, Query-By-Example (QBE) Report Wizard, 183 sequences, Database Objects tab of Navigator, 95, 99, 109 server-based capabilities for Web clients from portals and portlets, 132 server configuration, deployment, 678–679 server field, portal installation, 33 server-side validation, 513, 515, 516, 557–558 servername environment, 55 Uniform Resource Locators (URLs), 446–447, 448 Services portlet, 751–754 Session Cookie Name, Database Access Descriptors (DADs), 666 Session State, Database Access Descriptors (DADs), 666 sessions, database object monitoring, 823–825 set() methods, 531 SetCookie() function, 879–883 setup.exe program, 20–26 See also installation and configuration Apache Listener configuration, 23 archive kits extraction, 20 Database Access Descriptor Panel, 24 extracting archive kits, 20 file installation, 23 file locations, 21 Install button, 25–26 installation types, 21–22 iSuites, 21 mistakes, correcting, 25 Oracle HTTP Server Only option, 22 “portal30” default value, 23 Portal-to-Go product, 24–25 Previous button, 25 rebooting system, 22 system reboot, 22 TNS Connect String field, 24 TNSNAMES, 23 SGA See System Global Area shaping your report, Query-By-Example (QBE) Report Wizard, 179–190 Shared Components, 477–512 See also Color Wizard; fonts; images; JavaScript for client-side validation; User Interface Templates brand recognition from, 477 content creation versus standards enforcement, 478–479 exporting and importing, 748–749 navigation ease from, 477 privileges, 773 standards enforcement versus content creation, 478–479 949 950 Index ✦ S–S Shared Objects Content Area, Navigator, 85 Show Column Parameter, running reports, 200 Show Errors command, PL/SQL, 612 Show Frame check box, Menu Builder Wizard, 468 Show Horizontal Rule (HR) Between Rows option, 114 Show Lock on This Component link, Manage Components, 738–739 Show Monday-Friday Only option, Calendar Wizard, 338, 343 Show Null As, browsing data, 113 Show NULL Values as, Query-By-Example (QBE) Report Wizard, 185 Show Paging Buttons option, 114, 115 Show Parent Level check box, Hierarchy Wizard, 369 SHOW procedure creating own portlet and provider, 839, 840, 853, 854 Link Wizard, 564, 570 running reports, 247–248 Show Properties action, Database Objects tab of Navigator, 96, 98, 99 Show Query Conditions check box, Calendar Wizard, 340 Show SQL option, browsing data, 113 Show SQL Query Info link, Manage Components, 737–738 Show Timing Calendar Wizard, 340 Menu Builder Wizard, 468 Query-By-Example (QBE) Report Wizard, 188 Show Total Row Count browsing data, 113 Query-By-Example (QBE) Report Wizard, 184 _show_header parameter, Link Wizard, 566 SHOW_PARAMETER procedure, Link Wizard, 564 show_params procedure, running reports, 247–248 sign-on access to applications, home page, 69–73 Single Sign-On Server, portal installation, 33, 34 single sing-on accounts, 745–746 Size, Query-By-Example (QBE) Report Wizard, 181 SIZE keyword, NetU Database, 46 sorting Calendar Wizard, 349–350 Database Objects tab of Navigator, 96 Form Wizard, 260 multiple tables in a report, 237, 241–242 Navigator, 82 region setting, Style Manager, 639 Report Wizard, 213, 215 reports, 199–205 source link, Link Wizard, 563 source table, Lists-of-Values (LOVs), 412 SQL code See also PL/SQL Dynamic Pages Wizard, 379, 380, 383, 388, 390–395 linked into HTML framed page, 379 mixed with HTML, Dynamic Pages Wizard, 379, 380 script loading (on CD-ROM), Hierarchy Wizard, 376 SELECT statement, LOV Wizard, 428–430 statements for reports versus Report Wizard, 221–222 stored procedure forms, 281–282 SQL*Plus, 44, 45, 745, 908–914 SQL Query Calendar Wizard, 336–338 Frame Driver Wizard, 398–402, 403 SQL Query Link for charts, 316–325 See also Chart Wizard; Link Wizard Chart Name and Application, 316 charts as portlets, 325–328 Customization Entry Form Display Options, 319, 321–322 Display Options, 318–319 editing charts, 320–322 Finish button, 319 formatting values and limiting rows, 323–325 GROUP BY clause, 323 importing objects (on CD-ROM), 322 limiting rows, 323–325 Lists-of-Values (LOVs), importing (on CD-ROM), 322 multiple table charts, 316–325 query code (on CD-ROM), 323 running charts, 319 SELECT statement, 318 SQL Query page, 317–318 SQL statement sample (on CD-ROM), 318 Template combo box, 319 the_data column, 318 the_link column, 318 the_name column, 318 SQL Query Link for reports, 217–234 See also Link Wizard; multiple tables in a report; Report Wizard aggregate functions, 222–226 AVG aggregate function (on CD-ROM), 224–226 COUNT aggregate function (on CD-ROM), 222–224 Custom Layout option (on CD-ROM), 227–230 Index ✦ S–S Customization Entry Form Display Options, 220, 230–234 Display Options, 220 error statements, 219 extending functionality of reports, 222–226 Finish button, 220 Form Layout option, 220, 221 Formatting Conditions, 220 GROUP BY clause, 225 HTML table (on CD-ROM), 227–230 like condition use, 233 ORDER BY clause, 220 parameter setting, 230–234 Prompt field, 231 Query Options line, 232–234 Query Wizard for reports versus, 221–222 reusing SQL statements, 221 SQL familiarity for, 221 validating entries, 234 Value Required field, 231–232 SS format mask element, 333 ssoexp script, 745 ssoimp script, 745 Stackowiak, Robert, 127 staging areas, deployment, 677–678 standard fonts preinstalled, 493 standards enforcement versus content creation, 478–479 start page, 56 Start with Column combo box, Hierarchy Wizard, 364 Start with Value, Hierarchy Wizard, 369, 374, 375–377 STATES table, NetU Database, 44 static HTML page, Uniform Resource Locators (URLs), 448–452 static Lists-of-Values (LOVs) objects, 416–426 static page caching, portals and portlets, 141 STDDEV function, 305 Stern, Jonathan, 127 storage See also disk space database object monitoring, 825–827 images, 494–495 parameters specification, database, 126–127 stored procedure forms, 281–288 See also Form Wizard data values, format limitation, 286 defined, 253 existing stored procedures, 284 Finish button, 287 Form Name and Application, 284 Form Text, 287 Formatting and Validation, 285–287 importing objects (on CD-ROM), 286 Insert button, 288 layout of form, 285 Lists-of-Values (LOVs), importing (on CD-ROM), 286 parameter setting, 285–286 PL/SQL procedures, 282, 284 running form, 287–288 Structured Query Language (SQL), 281–282 Template combo box, 287 string concatenation Calendar Wizard, 350–352 Frame Driver Wizard, 400 string datatype, JavaScript, 524 string() method, 530 strong command, 586 structured User Interface Templates, 502–506 Style combo box, Page Wizard, 147 Style Manager, 629–647 See also Content Area Create Wizard; Folder Wizard; Navigation Bar attributes of items, 637–638 Available Attributes list box, 638 backgrounds, 633 banner setting, 630–632 Display Attributes list box, 638 editing styles, 630 Folder Layout Tab, 634–639 Folder Layouts, 635–636 Group By region setting, 639 Icon Height region setting, 639 Icon Width region setting, 639 items style, 630, 632–633 Main Banner, 631 Navigation Bar style, 630 news and announcement items, 634–635 Number of Columns/Rows region setting, 639 overview, Quick Picks, 634 region properties, 636–639 Regular Items, 635 Sort By region setting, 639 Style Properties, 631 Sub Banner, 631 subfolders, 635 Style Properties, Navigation Bar, 642–644 Styles privileges, 772 Sub Banner, Style Manager, 631 Sub Levels, Menu Builder Wizard, 467–468 subfolders, 624–625, 635 submenus, Menu Builder Wizard, 461–462 951 952 Index ✦ S–T substr() function, 414 Sum, Query-By-Example (QBE) Report Wizard, 180 SUM function, 305 Summary Options list box, Chart Wizard, 309, 311–312 Sun/AOL/Netscape Alliance, 528 super-user privileges, 771 Super Video Graphics Adapter (SVGA), 479 suppressing redundant values, multiple tables in a report, 238 SVGA See Super Video Graphics Adapter SWiSH (DJJ Holdings Pty Ltd) (on CD-ROM), 905 SWiSH (SWiSHzone), 510 switch statement, 526–527 synonym object, Database Objects tab of Navigator, 95, 99 SYNONYMS, Lists-of-Values (LOVs), 413 SYS password, 19, 33 system colors, 484 fonts, 490 images, 496 parameters, Link Wizard, 565, 566–567 reboot, setup.exe, 22 tablespace, portal installation, 35 templates, 502 System Global Area (SGA), database object monitoring, 823 T Table Background Color option, Calendar Wizard, 342 table-based forms See Form Wizard table creation, database, 122–127 Table or View Form Wizard, 254 master-detail forms, 289–290 multiple tables in a report, 235–236 Query-By-Example (QBE) Report Wizard, 176 Report Wizard, 208 Table or View Columns Chart Wizard, 303–306, 313–314 Hierarchy Wizard, 363–365 Query-By-Example (QBE) Report Wizard, 177–178 Report Wizard, 209 Table Row Color(s), Query-By-Example (QBE) Report Wizard, 187 table_name, LOV Wizard, 429 tables, Database Objects tab of Navigator, 94, 97, 108–109 tables and data, deployment, 660 tablespace for NetU Database, 46 Tablespace Options, portal installation, 34–35 tablespaces, database object monitoring, 825–827 tabs and their meanings of Navigator, 80–82 Tabular Layout, Report Wizard, 210 target frame, Calendar Wizard, 337 target link, Link Wizard, 563 target (result) frame, Frame Driver Wizard, 399, 400, 401, 402–403 Target Type and Name, Link Wizard, 562–565 TCP See Transmission Control Protocol TELNET protocol, Uniform Resource Locators (URLs), 446 Template Header Properties, User Interface Templates, 504 template images, 497 templates See also User Interface Templates adding JavaScript to, 549–551 Calendar Wizard, 345, 346 Chart Wizard, 310 Dynamic Pages Wizard, 385, 388, 389, 397 Form Wizard, 271 Frame Driver Wizard, 403 Menu Builder Wizard, 457, 459 overview, Query-By-Example (QBE) Report Wizard, 192–195 SQL Query Link for charts, 319 stored procedure forms, 287 Temporary Directory, 752 temporary tablespace specification, NetU Database, 46 terminating user sessions, database object monitoring, 824–825 testing default account (privileged) settings, 766–770 JavaScript in Oracle9iAS, 537–540 JavaScript with browsers, 536–537 Link Wizard, 567–570 LOV Wizard, 419 text addition, Query-By-Example (QBE) Report Wizard, 192–195, 194–195 Dynamic Page Content, 381–383 Navigation Bar, 643 with HTML tags, Dynamic Pages Wizard, 382 Text item type, Content Areas, 698, 703 Text Options Calendar Wizard, 344–347 Frame Driver Wizard, 403 Index ✦ T–U TextArea item type, Form Wizard, 266, 271, 521 TextBox item type, Form Wizard, 266, 271, 521 the_data column, SQL Query Link for charts, 318 theElement, 535, 540 the_link column, SQL Query Link for charts, 318 the_name column, SQL Query Link for charts, 318 theme for site, Content Areas, 697 this keyword, 540 three-level hierarchy, 372–373 TICKETS table, NetU Database, 45 time-based (expiry-based) caching, portals and portlets, 139–140, 141 title font color/face/size, User Interface Templates, 504 #TITLE# keyword, User Interface Templates, 508 _title parameter, Link Wizard, 566 Title setting, Content Areas, 702 Title text, Calendar Wizard, 345 TNS Connect String field, setup.exe, 24 TNSNAMES entry check, post-installation, 40 network installation, 29, 30 setup.exe, 23 TNSNAMES.ORA file, 33, 41–42 to_char() function, 332, 333, 334 to_date function, 332, 333, 334 ToHex button, Color Wizard, 487 ToNum button, Color Wizard, 487 tools, Oracle9iAS Portal, top-level pages, 80–81, 83, 168–169 transactions, database object monitoring, 821 TRANSCRIPT table, NetU Database, 45 Transmission Control Protocol (TCP), 28 trigger object, Database Objects tab of Navigator, 95, 99 triggers, data validation, 558 TrueType font, 490 trunc() function, 332 two-level hierarchy, 371–372 Type, Query-By-Example (QBE) Report Wizard, 180 Type column Database Objects tab of Navigator, 96 Navigator, 81 Type Face, Query-By-Example (QBE) Report Wizard, 183, 186 U UGRADS table, NetU Database, 44, 45 unauthenticated (public) components, Database Access Descriptors (DADs), 671 underlining text (links), 355 underscore (_) wildcard for Find, 89 Uniform Resource Locators (URLs), 445–455 See also Direct Access URLs; Link Wizard; Menu Builder Wizard Apache Listener, 23, 37, 38–39, 453, 454 Data Access Descriptor in, 454 dynamic strings in, 454–455 FILE protocol, 446 File Transfer Protocol (FTP), 446 folders, Folder Wizard, 622, 623 GOPHER protocol, 446 Home Link, User Interface Templates, 505 HTML, 445 HTTPS protocol, 446 Hypertext Transport Protocol (HTTP), 445, 446 interMedia searching and indexing technology, 453 item type, Content Areas, 703, 710–712 linking capabilities, 448–452, 463–466 MAILTO protocol, 446 NNTP protocol, 446 object name in, 454–455 Oracle9iAS Portal environment, 55 owner name in, 454 path of, 448, 452 physical directory, 452, 453 port of, 447 portlet, using (on CD-ROM), 861–864 protocol values for, 446 relative links, 450, 458, 464 result frame, 400 search engines and, 453–454 servername of, 446–447, 448 static HTML page, 448–452 TELNET protocol, 446 virtual directory, 452–455 UNIQUE constraints, database, 123–124 unstructured templates for embedding JavaScript code, 549–551 unstructured User Interface Templates, 502, 506–510 Up button, Hierarchy Wizard, 372 Updatable check box, Form Wizard, 269 UPDATE_TOP button, master-detail forms, 291 updating data, 118–119 data with links, Link Wizard, 576–579 forms, 273–274 Lists-of-Values (LOV) object, 415–416 records with dynamic LOV objects, 431–433 953 954 Index ✦ U–W upper() function, 115 upward-pointing arrow icon (move in display region), add Portlets page, 153 URLs See Uniform Resource Locators usage statistics, Dynamic Pages Wizard, 384 Use Page Style check box, Folder Wizard, 625 user, making changes as, 161–169 user accounts See privileged accounts user accounts for Content Areas, 691–695, 718–721 User colors, 484 user customization stores, 850–851 user error prevention Form Wizard, 274–278 Hierarchy Wizard, 374–375 User fonts, 490 user identification by portals and portlets, 137 User images, 496 User Interface Templates, 501–512 See also Color Wizard; fonts; images; Shared Components; templates adding templates, 502–506 Application Image, 505 Application Image Alt Text entry field, 505 background color, 503 deploying templates into components, 511–512 heading background color, 504 Help Image, 505 Home Link, 505 images, 503, 504–505 keywords for unstructured templates, 507–508 previewing, 505–506, 510 structured templates, 502–506 System templates, 502 Template Header Properties, 504 Template Name, 503 Template Title, 504 title font color, 504 title font face, 504 title font size, 504 unstructured templates, 502, 506–510 URL of Home Link, 505 User templates, 502 User Name field, privileged accounts, 761 user names for database security, 757, 758 User Pages, Navigator, 83 user parameters, Link Wizard, 565, 581 user shaping of report, Query-By-Example (QBE) Report Wizard, 190–192 USERID, deployment, 672–674 USERS tablespace, portal installation, 35 V validating entries, SQL Query Link for reports, 234 validation of HTML code, Dynamic Pages Wizard, 382, 389 validation-based caching, portals and portlets, 139, 140 Value Column Parameter, running reports, 201 Value field, Chart Wizard, 304 Value Format Mask, Chart Wizard, 309 Value Required field, SQL Query Link for reports, 231–232 Value Type combo box, Hierarchy Wizard, 367 value_column, LOV Wizard, 429 values list, linking from frame drivers, 405 variable width (proportional) fonts, 488, 489, 493 variables in JavaScript functions, 523–525 VARIANCE function, 305 VBScript versus JavaScript, 517, 533 version control, 197, 729–731, 735–736 Version Information, 752 versioning of items, Content Areas, 722 VGA See Video Graphics Adapter video color settings, 481–483 video display and colors, 479–481 Video Graphics Adapter (VGA), 479 view object, Database Objects tab of Navigator, 94, 97 View privilege, 628, 694, 772, 773, 774 view-based forms, 253 View-Only privilege, Page Wizard, 157 viewers (users), Content Areas, 718 viewing fonts, 491–492 images, 500 virtual directory Uniform Resource Locators (URLs), 452–455 URL path, Direct Access URLs, 681 Visible Item Type, Content Areas, 722 visual image of big picture, linking from calendar cells, 354 W Web portlet and provider with Java Server Pages (JSPs), 855–861 Web portlets, 834, 835 Web server (existing) replacing listener, 662–663 Web site for Oracle9iAS Portal, 45, 905 WebDB, 3–4 See also Oracle9iAS Portal Weinman, Lynda, 483 Index ✦ W–Z WHERE clause browsing data, 112 Calendar Wizard, 337, 357 dates and, 334 while loop, 528 width of Navigation Bar, 643, 644 Width Type, Query-By-Example (QBE) Report Wizard, 181 wildcards for Find, 89 Window object, JavaScript, 518 Windows (Microsoft) and environment, 56, 482 wizard images, 497 wizards, 6, 16, 74–76 writing data caution, 120–121 WWLOG_ALL_CATEGORY_LOGS, 798 WWLOG_ALL_COMPONENT_LOGS, 798 WWLOG_ALL_DELETE_LOGS, 798 WWLOG_ALL_DOCUMENT_LOGS, 799 WWLOG_ALL_FOLDER_LOGS, 799 WWLOG_ALL_GROUP_LOGS, 799 WWLOG_ALL_ITEM_LOGS, 799 WWLOG_ALL_OBJECT_LOGS, 799 WWLOG_ALL_PAGE_LOGS, 799 WWLOG_ALL_PERSPECTIVE_LOGS, 799 WWLOG_ALL_PORTLET_LOGS, 799 WWLOG_ALL_SEARCH_LOGS, 799 WWLOG_ALL_USER_LOGS, 799 WWLOG_EVENT, 799 WWLOG_PORTAL_ADMIN_LOGS, 799 WWLOG_USER_LOGS, 799 WWSEC% tables, 785 wwwpre_api_name package, 850–851, 852 WWW_USER_UTILITIES, 354, 405 Y YEA format mask element, 333 YY format mask element, 333 YYYY format mask element, 333 Z Zip file type, Content Areas, 699, 703 955 Hungry Minds, Inc End-User License Agreement READ THIS You should carefully read these terms and conditions before opening the software packet(s) included with this book (“Book”) This is a license agreement (“Agreement”) between you and Hungry Minds, Inc (“HMI”) By opening the accompanying software packet(s), you acknowledge that you have read and accept the following terms and conditions If you not agree and not want to be bound by such terms and conditions, promptly return the Book and the unopened software packet(s) to the place you obtained them for a full refund License Grant HMI grants to you (either an individual or entity) a nonexclusive license to use one copy of the enclosed software program(s) (collectively, the “Software”) solely for your own personal or business purposes on a single computer (whether a standard computer or a workstation component of a multi-user network) The Software is in use on a computer when it is loaded into temporary memory (RAM) or installed into permanent memory (hard disk, CD-ROM, or other storage device) HMI reserves all rights not expressly granted herein Ownership HMI is the owner of all right, title, and interest, including copyright, in and to the compilation of the Software recorded on the disk(s) or CD-ROM (“Software Media”) Copyright to the individual programs recorded on the Software Media is owned by the author or other authorized copyright owner of each program Ownership of the Software and all proprietary rights relating thereto remain with HMI and its licensers Restrictions On Use and Transfer (a) You may only (i) make one copy of the Software for backup or archival purposes, or (ii) transfer the Software to a single hard disk, provided that you keep the original for backup or archival purposes You may not (i) rent or lease the Software, (ii) copy or reproduce the Software through a LAN or other network system or through any computer subscriber system or bulletin-board system, or (iii) modify, adapt, or create derivative works based on the Software (b) You may not reverse engineer, decompile, or disassemble the Software You may transfer the Software and user documentation on a permanent basis, provided that the transferee agrees to accept the terms and conditions of this Agreement and you retain no copies If the Software is an update or has been updated, any transfer must include the most recent update and all prior versions Restrictions on Use of Individual Programs You must follow the individual requirements and restrictions detailed for each individual program in Appendix A of this Book These limitations are also contained in the individual license agreements recorded on the Software Media These limitations may include a requirement that after using the program for a specified period of time, the user must pay a registration fee or discontinue use By opening the Software packet(s), you will be agreeing to abide by the licenses and restrictions for these individual programs that are detailed in Appendix A and on the Software Media None of the material on this Software Media or listed in this Book may ever be redistributed, in original or modified form, for commercial purposes Limited Warranty (a) HMI warrants that the Software and Software Media are free from defects in materials and workmanship under normal use for a period of sixty (60) days from the date of purchase of this Book If HMI receives notification within the warranty period of defects in materials or workmanship, HMI will replace the defective Software Media (b) HMI AND THE AUTHOR OF THE BOOK DISCLAIM ALL OTHER WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, WITH RESPECT TO THE SOFTWARE, THE PROGRAMS, THE SOURCE CODE CONTAINED THEREIN, AND/OR THE TECHNIQUES DESCRIBED IN THIS BOOK HMI DOES NOT WARRANT THAT THE FUNCTIONS CONTAINED IN THE SOFTWARE WILL MEET YOUR REQUIREMENTS OR THAT THE OPERATION OF THE SOFTWARE WILL BE ERROR FREE (c) This limited warranty gives you specific legal rights, and you may have other rights that vary from jurisdiction to jurisdiction Remedies (a) HMI’s entire liability and your exclusive remedy for defects in materials and workmanship shall be limited to replacement of the Software Media, which may be returned to HMI with a copy of your receipt at the following address: Software Media Fulfillment Department, Attn.: Oracle9iAS™ Portal Bible, Hungry Minds, Inc., 10475 Crosspoint Blvd., Indianapolis, IN 46256, or call 1-800-762-2974 Please allow four to six weeks for delivery This Limited Warranty is void if failure of the Software Media has resulted from accident, abuse, or misapplication Any replacement Software Media will be warranted for the remainder of the original warranty period or thirty (30) days, whichever is longer (b) In no event shall HMI or the author be liable for any damages whatsoever (including without limitation damages for loss of business profits, business interruption, loss of business information, or any other pecuniary loss) arising from the use of or inability to use the Book or the Software, even if HMI has been advised of the possibility of such damages (c) Because some jurisdictions not allow the exclusion or limitation of liability for consequential or incidental damages, the above limitation or exclusion may not apply to you U.S Government Restricted Rights Use, duplication, or disclosure of the Software for or on behalf of the United States of America, its agencies and/or instrumentalities (the “U.S Government”) is subject to restrictions as stated in paragraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause of DFARS 252.227-7013, or subparagraphs (c) (1) and (2) of the Commercial Computer Software - Restricted Rights clause at FAR 52.227-19, and in similar clauses in the NASA FAR supplement, as applicable General This Agreement constitutes the entire understanding of the parties and revokes and supersedes all prior agreements, oral or written, between them and may not be modified or amended except in a writing signed by both parties hereto that specifically refers to this Agreement This Agreement shall take precedence over any other documents that may be in conflict herewith If any one or more provisions contained in this Agreement are held by any court or tribunal to be invalid, illegal, or otherwise unenforceable, each and every other provision shall remain in full force and effect CD-ROM Installation Instructions To install the CD-ROM, insert the disk into the CD-ROM drive on your computer You can access the contents of the CD-ROM through Windows Explorer, or by opening My Computer on the desktop All the files on the CD can be accessed as local file system files; there is no SETUP.EXE program Installation of third-party utility programs is detailed in README.TXT files in each relevant subdirectory Installation of code and program examples is detailed in Appendix B The CD-ROM provides a trial copy of several utility programs (PL/SQL Developer and Cookie Pal) along with the various sample component objects and images that are referenced in the examples Appendix A provides a complete list of the contents of the CD-ROM, and you will find a README.TXT file on the CD that explains any late-breaking changes to the content on the CD-ROM ... Use Oracle9 iAS Portal Understanding How Oracle9 iAS Portal Is Packaged Taking a Look at Oracle9 iAS Portal Functionality Understanding Oracle9 iAS Portal Components Understanding Oracle9 iAS Portal. .. Creating Oracle9 iAS Portal Components 15 Chapter 2: Installing and Configuring Oracle9 iAS Portal 17 Obtaining a Copy of Oracle9 iAS Portal Installing Oracle9 iAS Portal. .. Introducing Oracle9 iAS Portal Choosing Oracle9 iAS Portal Understanding How Oracle9 iAS Portal Is Packaged Taking a Look at Oracle9 iAS Portal