Tài liệu User’s Guide doc

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
xi
Using the Create Button Wizard .............................................................................................. 8-19
Creating an HTML Button ................................................................................................. 8-20
Creating Lists of Values................................................................................................................... 8-20
Creating LOVs............................................................................................................................. 8-21
Referencing Session State within a LOV.......................................................................... 8-21
Inline Static LOV.................................................................................................................. 8-21
Popup LOV........................................................................................................................... 8-22
Creating Forms .................................................................................................................................. 8-22
Using a Wizard to Build a Form............................................................................................... 8-23
Creating a Form Manually ........................................................................................................ 8-23
Processing a Form....................................................................................................................... 8-24
Creating an Automatic Row Processing Process............................................................ 8-24
Creating a Process Containing One or More Insert Statements ................................... 8-25
Using a PL/SQL API to Process Form Values ................................................................ 8-26
Populating Forms ................................................................................................................ 8-26
Validating User Input in Forms................................................................................................ 8-27
Creating Reports ............................................................................................................................... 8-28
Using a Wizard to Create a Report .......................................................................................... 8-28
Managing Report Attributes..................................................................................................... 8-29
Accessing Report Attributes .............................................................................................. 8-30
Enabling Column Sorting................................................................................................... 8-31
Exporting a Report .............................................................................................................. 8-31
Creating a Column link ...................................................................................................... 8-32
Defining Updatable Columns............................................................................................ 8-33

Defining a Column as a List of Values............................................................................. 8-33
Controlling When Columns Display................................................................................ 8-34
Controlling Column Breaks ............................................................................................... 8-34
Creating a Report with Pagination .......................................................................................... 8-35
Creating Charts.................................................................................................................................. 8-35
Creating Calendars ........................................................................................................................... 8-36
Specifying Layout and User Interface .......................................................................................... 8-36
Creating a Multiple Column Layout ....................................................................................... 8-37
Creating Regions in Multiple Columns ........................................................................... 8-37
Creating a Multiple Column Page Template................................................................... 8-38
Using a LOV to Drive Another LOV ....................................................................................... 8-38
xii
Specifying Print Preview Mode................................................................................................ 8-39
Setting a Print Mode Template for an Application......................................................... 8-39
Using f?p Syntax to Toggle to Print Mode....................................................................... 8-40
Utilizing Shortcuts ...................................................................................................................... 8-40
Defining Shortcuts............................................................................................................... 8-40
Creating a Help Page........................................................................................................................ 8-41
Creating a Help Page and Region ............................................................................................ 8-41
Defining Help Text ..................................................................................................................... 8-42
Creating a Help Navigation Bar Icon....................................................................................... 8-43
Sending E-mail from an Application ............................................................................................ 8-43
9 Debugging an Application
About Tuning Performance............................................................................................................... 9-1
Remembering to Review Session State .......................................................................................... 9-2
Accessing Debug Mode ..................................................................................................................... 9-2
Enabling SQL Tracing and Using TKPROF................................................................................... 9-3
Monitoring Application and Page Resource Use ......................................................................... 9-3
Viewing Page Reports ........................................................................................................................ 9-3
Debugging Problematic SQL Queries ............................................................................................ 9-4

Removing Components to Isolate a Problem................................................................................ 9-5
10 Managing an Application
Accessing Application Builder Utilities....................................................................................... 10-1
Viewing Application Summary and Utilization Reports ..................................................... 10-2
Exporting and Importing Applications ........................................................................................ 10-2
How Exporting an Application Works.................................................................................... 10-3
About Managing Database Objects.......................................................................................... 10-3
Exporting an Application and Related Files........................................................................... 10-4
Exporting Related Application Files................................................................................. 10-5
Importing Exported Application Files..................................................................................... 10-6
Installing Files from the View Export Repository.................................................................. 10-6
Uploading CSS, Images, and Static Files ..................................................................................... 10-8
Understanding Security................................................................................................................... 10-8
Using the Security Navigation Pane ........................................................................................ 10-9
Establishing User Identity Through Authentication................................................................. 10-9
xiii
Understanding How Authentication Works .......................................................................... 10-9
Creating an Authentication Scheme ...................................................................................... 10-10
Using the Authentication Scheme Repository ..................................................................... 10-11
Viewing the Current Authentication Scheme for an Application..................................... 10-12
About Preconfigured Authentication Schemes.................................................................... 10-12
About DAD Credentials Verification ............................................................................. 10-13
About HTML DB Account Credentials.......................................................................... 10-14
About LDAP Credentials Verification ........................................................................... 10-14
About Single Sign-On Server Verification..................................................................... 10-14
About Creating an Authentication Scheme from Scratch .................................................. 10-15
About Session Management Security............................................................................. 10-15
Building a Login Page....................................................................................................... 10-16
About Deep Linking ......................................................................................................... 10-16
Providing Security Through Authorization .............................................................................. 10-17

How Authorization Schemes Work....................................................................................... 10-17
Creating an Authorization Scheme........................................................................................ 10-17
About the Evaluation Point Attribute ............................................................................ 10-18
About Resetting Authorization Scheme State............................................................... 10-18
Attaching an Authorization Scheme to an Application, Page, or Component ............... 10-19
Viewing the Authorization Scheme Utilization Report...................................................... 10-20
11 Managing Your Development Workspace
Understanding Administrator Roles............................................................................................. 11-1
Managing Users ................................................................................................................................ 11-2
Creating New User Accounts ................................................................................................... 11-2
Editing Existing User Accounts................................................................................................ 11-3
Changing Your Password ......................................................................................................... 11-3
Monitoring Users.............................................................................................................................. 11-4
Administering Session State and User Preferences................................................................... 11-4
Managing Session State and User Preferences for the Current Session ............................. 11-5
Managing Recent Sessions ........................................................................................................ 11-5
Viewing Workspace Reports........................................................................................................... 11-6
Monitoring Developer Activity ..................................................................................................... 11-6
Managing Log Files .......................................................................................................................... 11-7
Managing Development Services.................................................................................................. 11-8
xiv
Viewing Current Workspace Status......................................................................................... 11-8
Requesting a Database Schema................................................................................................. 11-8
Requesting Additional Storage................................................................................................. 11-9
Requesting Service Termination............................................................................................... 11-9
12 Advanced Programming Techniques
Accessing Data with Database Links............................................................................................ 12-1
Using Collections.............................................................................................................................. 12-2
Using the HTMLDB_COLLECTION API ............................................................................... 12-2
About Collection Naming .................................................................................................. 12-3

Creating a Collection........................................................................................................... 12-3
Truncating a Collection ...................................................................................................... 12-4
Deleting a Collection........................................................................................................... 12-4
Adding Members to a Collection ...................................................................................... 12-4
Updating Collection Members .......................................................................................... 12-6
Deleting a Collection Member ........................................................................................... 12-6
Determining Collection Status........................................................................................... 12-7
Merging Collections ............................................................................................................ 12-8
Managing Collections ......................................................................................................... 12-9
Clearing Collection Session State .................................................................................... 12-10
Running Background PL/SQL...................................................................................................... 12-10
Understanding the HTMLDB_PLSQL_JOB Package .......................................................... 12-11
About System Status Updates................................................................................................. 12-13
Using a Process to Implement Background PL/SQL.......................................................... 12-13
Implementing Web Services......................................................................................................... 12-15
Creating a Web Service............................................................................................................ 12-15
Invoking a Web Service as a Process ..................................................................................... 12-17
Managing User Preferences .......................................................................................................... 12-18
Viewing User Preferences........................................................................................................ 12-18
Setting User Preferences .......................................................................................................... 12-18
Setting User Preferences Using a Page Process............................................................. 12-19
Setting the Source of an Item Based on a User Preference .......................................... 12-19
Setting User Preferences Programatically...................................................................... 12-20
Resetting User Preferences Manually.................................................................................... 12-20
Resetting Preferences Using a Page Process ......................................................................... 12-21
xv
13 Oracle HTML DB APIs
HTMLDB_UTIL ................................................................................................................................ 13-1
CLEAR_APP_CACHE Procedure............................................................................................ 13-2
CLEAR_USER_CACHE Procedure ......................................................................................... 13-3

COUNT_CLICK Procedure....................................................................................................... 13-3
GET_FILE Procedure ................................................................................................................. 13-4
GET_NUMERIC_SESSION_STATE Function........................................................................ 13-5
GET_PREFERENCE Function .................................................................................................. 13-6
GET_SESSION_STATE Function ............................................................................................. 13-6
PUBLIC_CHECK_AUTHORIZATION Function .................................................................. 13-7
REMOVE_PREFERENCE Procedure....................................................................................... 13-8
REMOVE_SORT_PREFERENCES Procedure ........................................................................ 13-8
RESET_AUTHORIZATIONS Procedure ................................................................................ 13-9
SET_PREFERENCE Procedure................................................................................................. 13-9
SET_SESSION_STATE Procedure.......................................................................................... 13-10
STRING_TO_TABLE Function............................................................................................... 13-11
TABLE_TO_STRING Function............................................................................................... 13-12
URL_ENCODE Function......................................................................................................... 13-13
HTMLDB_ITEM ............................................................................................................................. 13-13
CHECKBOX Function.............................................................................................................. 13-14
DATE_POPUP Function.......................................................................................................... 13-16
HIDDEN Function.................................................................................................................... 13-18
MD5_CHECKSUM Function .................................................................................................. 13-19
MD5_HIDDEN Function......................................................................................................... 13-20
MULTI_ROW_UPDATE Procedure ...................................................................................... 13-21
SELECT_LIST Function ........................................................................................................... 13-22
SELECT_LIST_FROM_LOV Function................................................................................... 13-23
SELECT_LIST_FROM_LOV_XL Function............................................................................ 13-24
SELECT_LIST_FROM_QUERY Function ............................................................................. 13-26
SELECT_LIST_FROM_QUERY_XL Function ...................................................................... 13-27
TEXT Function .......................................................................................................................... 13-28
TEXT_FROM_LOV Function.................................................................................................. 13-30
RADIOGROUP Function......................................................................................................... 13-30
POPUP_FROM_LOV Function............................................................................................... 13-32

POPUP_FROM_QUERY Function......................................................................................... 13-34
xvi
POPUPKEY_FROM_LOV Function....................................................................................... 13-36
POPUPKEY_FROM_QUERY Function ................................................................................. 13-37
HTMLDB_APPLICATION............................................................................................................ 13-40
Referencing Arrays................................................................................................................... 13-40
Referencing Values Within an On Submit Process.............................................................. 13-41
Converting an Array to a Single Value.................................................................................. 13-41
HTMLDB_CUSTOM_AUTH ....................................................................................................... 13-42
APPLICATION_PAGE_ITEM_EXISTS Function ................................................................ 13-42
CURRENT_PAGE_IS_PUBLIC Function.............................................................................. 13-43
DEFINE_USER_SESSION Procedure .................................................................................... 13-43
GET_NEXT_SESSION_ID Function....................................................................................... 13-43
GET_SECURITY_GROUP_ID Function ................................................................................ 13-43
GET_SESSION_ID Function.................................................................................................... 13-44
GET_USER Function ................................................................................................................ 13-44
SESSION_ID_EXISTS Function .............................................................................................. 13-44
SET_USER Procedure............................................................................................................... 13-44
SET_SESSION_ID Procedure .................................................................................................. 13-45
SET_SESSION_ID_TO_NEXT_VALUE Procedure.............................................................. 13-45
Part III Administration
14 Administering Workspaces
About the Oracle HTML DB Administrator................................................................................ 14-1
Viewing Workspace Reports .......................................................................................................... 14-2
Creating a Workspace....................................................................................................................... 14-3
Specifying a Provisioning Mode............................................................................................... 14-3
Managing a Service and Change Request............................................................................... 14-4
Viewing a Pending Service or Change Request.............................................................. 14-4
Approving a Service or Change Request ......................................................................... 14-5
Creating a Workspace Without a Request .............................................................................. 14-6

Managing Users in a Workspace.................................................................................................... 14-6
Managing the Schemas Associated with a Workspace.............................................................. 14-8
Removing a Workspace.................................................................................................................... 14-8
Exporting and Importing a Workspace ......................................................................................... 14-9
xvii
15 Managing Services
Managing Logs.................................................................................................................................. 15-1
Deleting Developer Activity Log Entries................................................................................ 15-2
Deleting Click Counting Log Entries....................................................................................... 15-2
Deleting SQL Workshop Logs .................................................................................................. 15-2
Deleting User Activity Log Entries .......................................................................................... 15-3
Managing Session State................................................................................................................... 15-3
Purging Sessions by Age ........................................................................................................... 15-4
Viewing Session Details Before Purging................................................................................. 15-4
Viewing Session Statistics Before Purging.............................................................................. 15-5
Monitoring Activities....................................................................................................................... 15-5
Managing Engine Settings.............................................................................................................. 15-5
16 Managing Globalization
About Translating an Application and Globalization Support............................................... 16-1
About Language Identification................................................................................................. 16-2
How Translated Applications Are Rendered ........................................................................ 16-2
About Translatable Components ............................................................................................. 16-2
About Messages................................................................................................................... 16-2
About Dynamic Translation Text Strings ........................................................................ 16-3
About Translating Templates ............................................................................................ 16-3
Specifying the Primary Language for an Application .............................................................. 16-4
Using Format Masks for Items ................................................................................................. 16-5
Translating Applications for Multibyte Languages ............................................................. 16-5
Understanding the Translation Process........................................................................................ 16-6
Navigating to the Translate Application Page ....................................................................... 16-6

Mapping Primary and Target Application IDs...................................................................... 16-6
Seeding and Exporting Text to a Translation File.................................................................. 16-7
Seeding Translatable Text .................................................................................................. 16-7
Exporting Text to a Translation File ................................................................................. 16-8
Translating the XLIFF File......................................................................................................... 16-9
Uploading and Publishing a Translated XLIFF Document................................................ 16-10
Translating Messages Used in PL/SQL Procedures ................................................................. 16-12
Defining Translatable Messages............................................................................................. 16-12
HTMLDB_LANG.MESSAGE API.......................................................................................... 16-12
xviii
Translating Data that Supports List of Values........................................................................... 16-14
Defining a Dynamic Translation ............................................................................................ 16-14
HTMLDB_LANG.LANG API................................................................................................. 16-15
About Oracle HTML DB Globalization Codes......................................................................... 16-16
A Available Conditions
Conditions Available in Oracle HTML DB ................................................................................... A-1
Index
xix
Send Us Your Comments
Oracle HTML DB User's Guide, Release 1.5
Part No. B10992-01
Oracle Corporation welcomes your comments and suggestions on the quality and usefulness of this
publication. Your input is an important part of the information used for revision.
■
Did you find any errors?
■
Is the information clearly presented?
■
Do you need more information? If so, where?
■

Are the examples correct? Do you need more examples?
■
What features did you like most about this manual?
If you find any errors or have any other suggestions for 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:
■
FAX: (650) 506-7227 Attn: Server Technologies Documentation Manager
■
Postal service:
Oracle Corporation
Oracle Server Technologies Documentation
500 Oracle Parkway, Mailstop 4op11
Redwood Shores, CA 94065
U.S.A.
If you would like a reply, please give your name, address, telephone number, and (optionally) your
electronic mail address.
If you have problems with the software, please contact your local Oracle Support Services.
xx
xxi
Preface
Oracle HTML 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
■
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 of relational database concepts as well as an understanding
of the operating system environment under which you are running Oracle HTML
DB.
Organization
This document contains:
xxii
Part I, "Getting Started with Oracle HTML DB"
Part I provides an introduction to Oracle HTML DB by introducing you to basic
Oracle HTML DB concepts.
Chapter 1, "What is Oracle HTML DB?"
This chapter offers a general description of Oracle HTML DB and the components
you can use it to develop database-centric Web applications.
Chapter 2, "Quick Start"
This chapter offers a quick introduction to using Oracle HTML DB.
Chapter 3, "Running a Demonstration Application"
This chapter describes how to run a demonstration application and defines

fundamental concepts that are unique to Oracle HTML DB.
Part II, "Using Oracle HTML DB"
Part II describes how to use Data Workshop, SQL Workshop, and Application
Builder to develop database-driven applications.
Chapter 4, "Managing Data with Data Workshop"
This chapter describes how to use Data Workshop to import data into and export
data from a hosted database.
Chapter 5, "Using SQL Workshop to Manage Database Objects"
This chapter provides information on how to use SQL Workshop to view and
manage database objects as well as browse the data dictionary.
Chapter 6, "Application Builder Concepts"
This chapter provides basic conceptual information about Application Builder.
Chapter 7, "Using Application Builder"
This chapter describes how to use Application Builder to build the pages that
comprise an application.
xxiii
Chapter 8, "Building Application Components"
This chapter describes how to build application components in Oracle HTML DB,
including navigation, regions, buttons, Lists of Values, forms, reports, charts, and
help pages.
Chapter 9, "Debugging an Application"
This chapter describes a number of approaches to debugging your application
including viewing Debug Mode, enabling SQL tracing, viewing page reports, and
how to manually remove a component to isolate a problem.
Chapter 10, "Managing an Application"
This chapter provides information about Application Builder utilities, how to
export and import an application, and how to manage application security.
Chapter 11, "Managing Your Development Workspace"
This chapter describes the tools and reports available to Workspace administrators.
Chapter 12, "Advanced Programming Techniques"

This chapter provides information about advanced programming techniques
including establishing database links, using collections, running background SQL,
utilizing Web Services and managing user preferences.
Chapter 13, "Oracle HTML DB APIs"
This chapter describes available Oracle HTML DB APIs.
Part III, "Administration"
Part III describes the tasks associated with administering Oracle HTML DB,
including creating and managing workspaces, translating an application, and
managing activities, log files, and sessions.
Chapter 14, "Administering Workspaces"
This chapter describes tasks an Oracle HTML DB administrator performs when
administering workspaces.
Chapter 15, "Managing Services"
This chapter provides information about additional administrator activities
available in Oracle HTML DB, including sending e-mail, monitoring user activity,
managing log files, and managing sessions.
xxiv
Chapter 16, "Managing Globalization"
This chapter describes how to translate an application created in Oracle HTML 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 database,
which is installed by default when you install 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
/>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 OTN; registration is free and can be done at
/>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
/>Conventions
This section describes the conventions used in the text and code examples of this
documentation set. It describes:
■
Conventions in Text
xxv
■
Conventions in Code Examples
Conventions in Text
We use various conventions in text to help you more quickly identify special terms.
The following table describes those conventions and provides examples of their use.
Convention Meaning Example
Bold Bold typeface indicates terms that are
defined in the text or terms that appear in
a glossary, or both.
When you specify this clause, you create an
index-organized table.
Italics Italic typeface indicates book titles or
emphasis.

Oracle Database Concepts
Ensure that the recovery catalog and target
database do not reside on the same disk.
UPPERCASE
monospace
(fixed-width)
font
Uppercase monospace typeface indicates
elements supplied by the system. Such
elements include parameters, privileges,
datatypes, RMAN keywords, SQL
keywords, SQL*Plus or utility commands,
packages and methods, as well as
system-supplied column names, database
objects and structures, usernames, and
roles.
You can specify this clause only for a NUMBER
column.
You can back up the database by using the
BACKUP command.
Query the TABLE_NAME column in the USER_
TABLES data dictionary view.
Use the DBMS_STATS.GENERATE_STATS
procedure.
lowercase
monospace
(fixed-width)
font
Lowercase monospace typeface indicates
executables, filenames, directory names,

and sample user-supplied elements. Such
elements include computer and database
names, net service names, and connect
identifiers, as well as user-supplied
database objects and structures, column
names, packages and classes, usernames
and roles, program units, and parameter
values.
Note: Some programmatic elements use a
mixture of UPPERCASE and lowercase.
Enter these elements as shown.
Enter sqlplus to open SQL*Plus.
The password is specified in the orapwd file.
Back up the datafiles and control files in the
/disk1/oracle/dbs directory.
The department_id, department_name,
and location_id columns are in the
hr.departments table.
Set the QUERY_REWRITE_ENABLED
initialization parameter to true.
Connect as oe user.
The JRepUtil class implements these
methods.
lowercase
italic
monospace
(fixed-width)
font
Lowercase italic monospace font
represents placeholders or variables.

You can specify the
parallel_clause
.
Run U
old_release
.SQL where
old_
release
refers to the release you installed
prior to upgrading.