Oracle® HTML DB User’s Guide Release 1.5 Part No. B10992-01 December 2003 Oracle HTML DB User’s Guide, Release 1.5 Part No. B10992-01 Copyright © 2003 Oracle Corporation. All rights reserved. Primary Author: Terri Winters Contributor: Christina Cho, Michael Hichwa, Joel Kallman, Sergio Leunissen, Raj Mattamal, Tyler Muth, Marc Sewtz, Scott Spadafore, and Jason Straub The Programs (which include both the software and documentation) contain proprietary information of Oracle Corporation; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent and other intellectual and industrial property laws. Reverse engineering, disassembly or decompilation of the Programs, except to the extent required to obtain interoperability with other independently created software or as specified by law, is prohibited. The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. Oracle Corporation does not warrant that this document is error-free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Oracle Corporation. If the Programs are delivered to the U.S. Government or anyone licensing or using the programs on behalf of the U.S. Government, the following notice is applicable: Restricted Rights Notice Programs delivered subject to the DOD FAR Supplement are "commercial computer software" and use, duplication, and disclosure of the Programs, including documentation, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement. Otherwise, Programs delivered subject to the Federal Acquisition Regulations are "restricted computer software" and use, duplication, and disclosure of the Programs shall be subject to the restrictions in FAR 52.227-19, Commercial Computer Software - Restricted Rights (June, 1987). Oracle Corporation, 500 Oracle Parkway, Redwood City, CA 94065. The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of such applications if the Programs are used for such purposes, and Oracle Corporation disclaims liability for any damages caused by such use of the Programs. Oracle is a registered trademark, and Oracle Store, PL/SQL, and SQL*Plus are trademarks or registered trademarks of Oracle Corporation. Other names may be trademarks of their respective owners. iii Contents Send Us Your Comments xix Preface xxi Intended Audience xxi Organization . xxi Related Documentation xxiv Conventions xxiv Documentation Accessibility xxvii Part I Getting Started with Oracle HTML DB 1 What is Oracle HTML DB? About Oracle HTML DB . 1-1 About Application Builder . 1-2 About SQL Workshop 1-2 About Data Workshop . 1-3 2 Quick Start Understanding Oracle HTML DB User Roles . 2-1 Logging in to Oracle HTML DB 2-2 Requesting a Workspace . 2-2 Logging in to a Workspace 2-3 Resetting Your Password 2-3 Logging Out of Your Workspace . 2-4 iv About Oracle HTML DB User Interface . 2-4 About Using the Tasks List . 2-5 Other Sources of Information 2-5 Creating an Application Using the Create Application Wizard 2-6 Running Your Application 2-8 3 Running a Demonstration Application Viewing and Installing a Demonstration Application 3-1 Running a Demonstration Application 3-2 Running an Application from Demonstration Applications 3-2 Running an Application from Application Builder . 3-3 Understanding Sample Application . 3-4 About the Home Page 3-5 About the Orders Page . 3-5 About the Products Page . 3-6 About the Customers Page 3-6 Viewing Pages in Printer Friendly Mode 3-6 Modifying a Demonstration Application 3-6 About the Developer Toolbar . 3-7 Editing a Demonstration Application 3-7 Viewing Underlying Database Objects 3-9 Part II Using Oracle HTML DB 4 Managing Data with Data Workshop About Data Workshop . 4-1 Importing Data 4-2 Importing a Text File 4-2 Importing an XML Document 4-3 Importing Spreadsheet Data . 4-3 Exporting Data . 4-3 Exporting to a Text File 4-4 Exporting to an XML Document 4-4 v 5 Using SQL Workshop to Manage Database Objects About SQL Workshop 5-1 About Transaction Support . 5-2 About Support for SQL*Plus Commands 5-2 Viewing Database Objects 5-3 Using the SQL Command Processor . 5-3 About Command Termination 5-4 Using Explain Plan 5-4 Browsing Database Objects . 5-4 Querying by Example . 5-5 Viewing Database Objects by Object Type . 5-5 Managing Database Objects . 5-5 Browsing Database Objects . 5-6 Creating Database Objects . 5-6 Dropping Database Objects 5-7 Restoring Dropped Database Objects 5-7 Using the SQL Script Repository 5-8 Managing Script Files in the SQL Script Repository 5-8 Uploading and Creating Script Files 5-10 Using Parameters in a Script 5-10 Including SQL Queries in a Script 5-11 Exporting a Script File 5-11 Accessing Saved Commands in the SQL Archive . 5-11 Accessing the SQL Command History 5-12 Generating DDL 5-12 Managing Control Files . 5-13 Viewing the Control File Run History . 5-14 Viewing Control File Job Status 5-14 Managing Tables . 5-15 Managing User Interface Defaults 5-15 Managing Tables Using UI Defaults 5-16 Applying UI Defaults to a Table or View . 5-17 Exporting UI Defaults 5-18 Browsing the Data Dictionary 5-18 vi 6 Application Builder Concepts About Page Rendering and Page Processing . 6-1 What is a Page? . 6-2 How Application Builder Uses Templates 6-5 Page Templates 6-5 Region Templates 6-6 List Templates 6-6 Report Templates . 6-6 Label Templates . 6-6 Menu Templates 6-6 Popup List of Values Templates 6-6 How Page Processing and Page Rendering Work . 6-6 Understanding Shared Components . 6-7 About Standard Tabs and Parent Tabs . 6-7 About Navigation Bars . 6-8 About List of Values 6-8 About Menus 6-8 About Lists 6-8 About Templates . 6-9 Understanding Conditional Rendering and Processing 6-9 Current Page In Expression 1 6-10 Exists 6-10 PLSQL Expression . 6-10 Using Build Options to Control Configuration 6-11 Creating Build Options . 6-11 Viewing Build Option Reports 6-11 Verifying User Identity 6-12 Controlling Access to Components 6-12 Understanding Session State Management . 6-12 Understanding Session IDs . 6-13 Viewing Session State . 6-13 Managing Session State Values . 6-14 Referencing Session State 6-15 Setting Session State . 6-15 Clearing Session State 6-16 vii Clearing Cache by Item 6-16 Clearing Cache by Page 6-16 Clearing Cache for an Entire Application 6-18 Clearing Cache for the Current User Session 6-18 About Bind Variables . 6-18 Using Bind Variables in Regions Based on a SQL Query or LOV 6-19 Using Bind Variables in PL/SQL Procedures . 6-19 Understanding URL Syntax 6-19 Using f?p Syntax to Link Pages 6-20 Calling a Page Using an Application and Page Alias . 6-22 Calling a Page from a Button URL . 6-22 Using Substitution Strings . 6-22 Built-in Substitution Strings 6-23 APP_SESSION . 6-24 APP_USER 6-25 IMAGE_PREFIX 6-25 WORKSPACE_IMAGES 6-26 APP_IMAGES 6-26 BROWSER_LANGUAGE . 6-27 PRINTER_FRIENDLY 6-27 HOME_LINK . 6-28 PROXY SERVER 6-28 REQUEST . 6-28 SYSDATE_YYYYMMDD . 6-30 DEBUG 6-30 APP_ID . 6-31 APP_PAGE_ID 6-31 APP SCHEMA OWNER 6-32 SQLERRM . 6-32 AUTHENTICATED_URL_PREFIX 6-32 LOGOUT_URL 6-33 PUBLIC_URL_PREFIX . 6-33 CURRENT_PARENT_TAB_TEXT 6-34 APP_ALIAS 6-34 APP_UNIQUE_PAGE_ID 6-35 viii 7 Using Application Builder Understanding the Definition of a Page 7-2 Accessing Application Builder . 7-2 About the Available Applications List . 7-2 About the Edit Page List . 7-3 About the Application Navigation Pane 7-4 Viewing a Page Definition . 7-5 Using the Page Navigation Pane . 7-7 Viewing Page Reports 7-7 About All Conditions 7-8 About Event View . 7-8 About History 7-9 About Page Detail 7-9 About Related Pages . 7-9 About Summary of All Pages 7-9 About Tree View 7-10 Using the Developer Toolbar 7-10 Creating an Application 7-11 Creating a New Application . 7-11 Deleting an Application . 7-12 Creating a New Page Using a Wizard . 7-13 About SVG Charting Support 7-13 Creating a Page While Viewing the Page Definition . 7-14 Creating a Page from the Developer Toolbar . 7-14 Creating a Page Using a Wizard . 7-14 Deleting a Page 7-15 Working with Templates . 7-16 Viewing Existing Templates . 7-16 About Cascading Style Sheets . 7-16 Creating Custom Templates 7-17 Editing Templates . 7-17 Editing Page Templates 7-18 Editing Region Templates 7-23 Editing Report Templates . 7-24 Editing List Templates 7-26 ix Editing Label Templates . 7-27 Editing Menu Templates 7-27 Editing Button Templates 7-28 Editing Popup LOV Templates . 7-28 Viewing Application Attributes 7-28 Editing Application Attributes 7-29 About Application Definition . 7-30 About Authorization 7-32 About Session Management . 7-33 About User Interface Templates . 7-34 About Template Defaults 7-35 About Globalization . 7-35 About Application Availability 7-36 About Global Notifications . 7-36 About Virtual Private Database (VPD) . 7-36 About Static Substitution Strings . 7-36 About Build Options 7-37 About Application Comments 7-37 Viewing Page Attributes . 7-37 Editing a Page Definition 7-38 Managing Page Rendering Components 7-39 About Page . 7-39 About Regions . 7-39 About Buttons 7-42 About Items 7-43 About Page Computations . 7-49 About Page Processes . 7-50 About Page Processing Components . 7-50 About Validations . 7-51 About Branching . 7-51 Editing Page Attributes . 7-52 About Primary Page Attributes . 7-53 About HTML Header . 7-54 About Page Header, Footer and Text Attributes 7-54 About On Load JavaScript . 7-55 x About Security . 7-55 About Duplicate Page Submission Checks 7-56 About Configuration Management 7-56 About On Error Text . 7-56 About Page Help Text . 7-56 About Comments . 7-57 Running a Page 7-57 8 Building Application Components Displaying Components on Every Page . 8-1 Adding Navigation . 8-2 Creating Tab Sets 8-2 About Template Support 8-3 Using Tab Manager to Manage Tab Information . 8-3 About the Standard Tab Tasks List . 8-4 Creating a Navigation Bar . 8-4 Creating a Navigation Bar Entry . 8-5 Creating Menus . 8-7 Creating a Menu 8-7 Creating a Menu Template . 8-8 Adding a Menu to a Page . 8-9 About Creating a Dynamic Menu . 8-9 Creating Trees . 8-10 Creating Lists . 8-11 Creating a List 8-11 Adding a List on a Page 8-12 About Creating a List Template 8-13 Creating a Branch . 8-13 Creating Regions . 8-14 Creating New Regions . 8-15 Building a Form Using a Region 8-16 Building a Report Using a Region 8-17 About Regions Based on an URL . 8-17 About Regions Based on PL/SQL Dynamic Content 8-18 Creating Buttons . 8-19 [...]... ■ Related Documentation ■ Conventions ■ Documentation Accessibility Intended Audience Oracle HTML DB User's Guide is intended for application developers who are building database-centric Web applications using Oracle HTML DB The guide describes how to use the Oracle HTML DB development environment to build, debug, manage, and deploy applications To use this guide, you need to have a general understanding... mixture of UPPERCASE and lowercase Enter these elements as shown Documentation Accessibility Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community To that end, our documentation includes features that make information available to users of assistive technology This documentation is available in HTML format, and contains markup... DB User’s Guide About Data Workshop See Also: "Using SQL Workshop to Manage Database Objects" on page 5-1 About Data Workshop You use Data Workshop to import data into and export data from the hosted database Supported import formats include text (such as comma or tab delimited data), XML documents, and spreadsheets Supported export formats include text (such as comma or tab delimited data) and XML documents... http://otn.oracle.com/membership/ If you already have a username and password for OTN, then you can go directly to the documentation section of the OTN Web site at http://otn.oracle.com/documentation/ Conventions This section describes the conventions used in the text and code examples of this documentation set It describes: ■ xxiv Conventions in Text ■ Conventions in Code Examples Conventions in Text We... improvement, please indicate the title and part number of the documentation and the chapter, section, and page number (if available) You can send comments to us in the following ways: ■ ■ ■ Electronic mail: infodev_us@oracle.com FAX: (650) 506-7227 Attn: Server Technologies Documentation Manager Postal service: Oracle Corporation Oracle Server Technologies Documentation 500 Oracle Parkway, Mailstop 4op11 Redwood... vendors to address technical obstacles so that our documentation can be accessible to all of our customers For additional information, visit the Oracle Accessibility Program Web site at http://www.oracle.com/accessibility/ Accessibility of Code Examples in Documentation JAWS, a Windows screen reader, may not always correctly read the code examples in this document The conventions for writing code require... DB Appendix A, "Available Conditions" Provides a listing of conditions available in Oracle HTML DB Related Documentation For more information, see these Oracle resources: ■ Oracle Database Concepts ■ Oracle Database Application Developer's Guide - Fundamentals ■ Oracle Database Administrator's Guide ■ Oracle Database SQL Reference Many of the examples in this book use the sample schemas of the seed... DB User's Guide describes how to use the Oracle HTML DB development environment to build and deploy database-centric Web applications Oracle HTML DB turns a single Oracle database into a shared service by enabling multiple workgroups to build and access applications as if they were running in separate databases This preface contains these topics: ■ Intended Audience ■ Organization ■ Related Documentation... braces should appear on an otherwise empty line; however, JAWS may not always read a line of text that consists solely of a bracket or brace xxvii Accessibility of Links to External Web Sites in Documentation This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control Oracle neither evaluates nor makes any representations regarding the accessibility... Oracle Refer to Oracle Database Sample Schemas for information on how these schemas were created and how you can use them yourself Printed documentation is available for sale in the Oracle Store at http://oraclestore.oracle.com/ To download free release notes, installation documentation, white papers, or other collateral, please visit the Oracle Technology Network (OTN) You must register online before using . Oracle® HTML DB User’s Guide Release 1.5 Part No. B10992-01 December 2003 Oracle HTML DB User’s Guide, Release 1.5 Part No. B10992-01. prohibited. The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to