Oracle® Database

2 Day + Application Express Developer's Guide

Release 4.2 for Oracle Database 12c

E17960-05

March 2013

Oracle Database 2 Day + Application Express Developer's Guide, Release 4.2 for Oracle Database 12c

E17960-05

Copyright © 2003, 2013, Oracle and/or its affiliates. All rights reserved.

Primary Author: Terri Jennings

Contributors: Drue Swadener, Sharon Kennedy, David Peake, Sheila Moore

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

Contents

Preface

- Topic Overview

- Audience

- Documentation Accessibility

- Related Documents

- Conventions

Changes in This Release

- Changes in Oracle Application Express Release 4.2

1 Introducing Oracle Application Express

- 1.1 About Oracle Application Express

- 1.2 Understanding Oracle Application Express Architecture

- 1.3 About the Oracle Application Express Environment

- 1.3.1 About Workspaces

- 1.4 About Oracle Application Express User Roles

- 1.5 Overview of the Application You Build

2 Accessing Your Development Environment

- 2.1 Before You Begin

- 2.2 Accessing the Hosted Demo Environment

- 2.2.1 Logging In To the Hosted Demo Environment

- 2.3 Setting Up Your Own Local Environment

- 2.3.1 Logging In To Administration Services

- 2.3.2 Creating a Workspace

- 2.3.3 Logging In To Your Local Instance

- 2.4 Creating Additional User Accounts

3 Getting Started with Oracle Application Express

- 3.1 About the Workspace Home Page

- 3.2 What Is Application Builder?

- 3.3 Installing the Sample Objects

- 3.3.1 Downloading OEHR Sample Objects

- 3.3.2 Importing the OEHR Sample Objects

- 3.3.3 Viewing Your Database Objects

4 Building Your Application

- 4.1 About the Application You Build in This Tutorial

- 4.2 Creating the Initial Application

- 4.2.1 Previewing Your Application

- 4.3 Modifying the Departments Report

- 4.3.1 Run the Report to View Added Columns

- 4.4 Using an Interactive Report

- 4.4.1 Save Report Settings as the Default

- 4.4.2 Create a Filter

- 4.4.3 Change the Sort Order

- 4.4.4 Add a Controlled Break

- 4.4.5 Display the Single Row View

- 4.4.6 Reset Report Settings

- 4.5 Adding an Employees Report and Form

- 4.5.1 Previewing the Pages

- 4.6 Editing the Employees Report

- 4.6.1 Create a Function

- 4.6.2 Add a Column

- 4.6.3 Previewing the Page

- 4.6.4 Changing the Column Format

- 4.7 Adding a Link on the Home Page to the Employees Report

- 4.8 Adding a Department Column to the Employees Report

- 4.8.1 Add a Column

- 4.8.2 Display the Department Name Column in the Report

- 4.8.3 Save Report Settings as the Default

- 4.9 Linking a Column Value to Another Page

- 4.9.1 Change Column Value to a Link

- 4.9.2 Run the Departments Report

- 4.9.3 Create a Highlight to Test Clear Interactive Report Command

- 4.10 Adding a List of Values to the Employees Report

- 4.10.1 Add a List of Values

- 4.10.2 Add an Item to Display List of Values

- 4.10.3 Change Employees Report Query

- 4.10.4 Change Column Link on Department Report

- 4.10.5 Turning Off Pagination

- 4.11 Adding Your Company Name

- 4.12 Switching Themes to Change the User Interface

5 About Deploying Your Application

- 5.1 Overview of Deploying Your Application

- 5.2 Creating Users

- 5.3 About Publishing the Application URL

6 About Globalization

- 6.1 About Language Identification and Rendering

- 6.2 Specifying the Method for Global Identification

7 Next Steps

- 7.1 Additional Resources

Index

Preface

Oracle Database 2 Day + Application Express Developer's Guide introduces you to application development using Oracle Application Express. This guide shows you how to set up a development environment, or access a hosted demonstration environment. It then walks you through building an initial application, modifying it, and previewing it.

Through a series of exercises, you become familiar with the Oracle Application Express user interface, basic product functionality, and some underlying concepts that enable you to develop professional, fast, and secure applications.

Topics:

- Topic Overview

- Audience

- Documentation Accessibility

- Related Documents

- Conventions

Topic Overview

This document contains the following sections:

Title

Description

Changes in This Release

Describes changes in this document for Oracle Application Express, release 4.2.

Introducing Oracle Application Express

Describes Oracle Application Express, its architecture and the environment for using the product. It also introduces you to some concepts and terms used in this guide.

Accessing Your Development Environment

Leads you through the steps to access a development environment for your use.

Getting Started with Oracle Application Express

Introduces you to areas of the user interface. It also leads you through installing the sample objects to use with this guide.

Building Your Application

Leads you through the steps for building an application, modifying it, and previewing it at different points during the development process.

About Deploying Your Application

Describes some basic information about deploying your application. It also leads you through the steps to create end users and to determine the URL of your application.

About Globalization

Describes some basic information about globalization. It also leads you through the steps to specify how the application determines global identification.

Next Steps

Describes additional resources to expand your knowledge of Oracle Application Express and boost your productivity.

Audience

Oracle Database 2 Day + Application Express Developer's Guide is intended for:

- Workspace administrators who want to set up the Oracle Application Express development environment

- Application developers who want to learn how to build database-centric web applications using Oracle Application Express

To use this guide, you must have a general understanding of relational database concepts and the operating system environment under which Oracle Application Express is running.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.

Related Documents

For more information, see these Oracle resources:

- Oracle Application Express Installation Guide

- Oracle Application Express Release Notes

- Oracle Application Express End User's Guide

- Oracle Application Express Application Builder User's Guide

- Oracle Application Express SQL Workshop Guide

- Oracle Application Express API Reference

- Oracle Application Express Migration Guide

- Oracle Application Express Administration Guide

- Oracle Database Concepts

- Oracle Database Advanced Application Developer's Guide

- Oracle Database Administrator's Guide

- Oracle Database SQL Language Reference

- SQL*Plus User's Guide and Reference

- Oracle Database PL/SQL Language Reference

For additional documentation available on Oracle Technology Network (OTN), visit the Oracle Application Express website located at:

http://www.oracle.com/technetwork/developer-tools/apex/overview/index.html

For additional application examples, go to the Learning Library. Search for free online training content, including Oracle by Example (OBE), demos, and tutorials. To access the Oracle Learning Library, go to:

http://www.oracle.com/technetwork/tutorials/index.html

Printed documentation is available for sale in the Oracle Store at:

http://shop.oracle.com/

If you have a user name and password for OTN, then you can go directly to the documentation section of the OTN website at:

http://www.oracle.com/technetwork/indexes/documentation/index.html

Conventions

The following text conventions are used in this document:

Convention

Meaning

boldface

Boldface type indicates graphical user interface elements associated with an action, or terms defined in text or the glossary.

italic

Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values.

monospace

Monospace type indicates commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.

Changes in This Release

This preface contains:

- Changes in Oracle Application Express Release 4.2

Changes in Oracle Application Express Release 4.2

The following are changes in Oracle Database 2 Day + Application Express Developer's Guide for Oracle Application Express release 4.2.

- All content has been updated to reflect new functionality

- Screen captures and graphics have been added and updated to reflect Oracle Application Express release 4.2 user interface enhancements

1 Introducing Oracle Application Express

This section describes Oracle Application Express, its architecture, and the environment for using the product. It also introduces you to concepts and terms used in this guide when discussing Oracle Application Express.

Topics:

- About Oracle Application Express

- Understanding Oracle Application Express Architecture

- About the Oracle Application Express Environment

- About Oracle Application Express User Roles

- Overview of the Application You Build

1.1 About Oracle Application Express

Oracle Application Express is a rapid web application development tool for the Oracle database. Using only a web browser and limited programming experience, you can develop professional applications that are both fast and secure. Thanks to built-in features such as user interface themes, navigational controls, form handlers, and flexible reports, Oracle Application Express accelerates the application development process.

From the end user's perspective, the deployed applications require only a browser and access to an Oracle database running Application Express.

Tip:
To learn more about Oracle Application Express features, click Learn more... on the Workspace home page.

1.2 Understanding Oracle Application Express Architecture

Oracle Application Express installs with your Oracle database and is composed of data in tables and PL/SQL code.

Whether you run the Oracle Application Express development environment or an application you built using Oracle Application Express, the process is the same. Your browser sends a URL request that is translated into the appropriate Oracle Application Express PL/SQL call. After the database processes the PL/SQL, the results are relayed back to your browser as HTML. This cycle happens each time you request or submit a page.

The application session state is managed in the database tables within Oracle Application Express. It does not use a dedicated database connection. Instead, each request is made through a separate database session, consuming minimal CPU resources.

Understanding Web Listener Options

In order to run, Oracle Application Express must have access to Oracle Application Express Listener, Oracle HTTP Server and mod_plsql, or the embedded PL/SQL gateway.

About Oracle HTTP Server (Apache) and Oracle Application Express Listener

Oracle HTTP Server uses the mod_plsql plug-in to communicate with the Oracle Application Express engine within the Oracle database. Oracle Application Express Listener communicates directly with the Oracle Application Express engine, thus eliminating the need for the mod_plsql plug-in.

Both Oracle HTTP Server and the Oracle Application Express Listener function as communication brokers between the web server and the Oracle Application Express objects in the Oracle database. More specifically, they map browser requests into database stored procedure calls over an Oracle Net Services connection. The following graphic illustrates the Oracle Application Express architecture using Oracle HTTP Server and mod_plsql.

This three-tier architecture has the following components:

- A web browser

- Oracle HTTP Server (Apache) with mod_plsql or Oracle Application Express Listener

- An Oracle database containing Oracle Application Express

Advantages of either Oracle HTTP Server (Apache) with mod_plsql or Oracle Application Express Listener include:

- Separation of database tier from mid-tier

- Appropriate for Oracle Real Application Clusters (Oracle RAC) environments

- Versions before Oracle Database 11g Release 1 require Oracle Application Express Listener or Oracle HTTP Server (Apache) with mod_plsql

About the Embedded PL/SQL Gateway

The embedded PL/SQL gateway installs with the Oracle database. It provides the Oracle database with both a web server and the necessary infrastructure to create dynamic applications. The embedded PL/SQL gateway runs in the Oracle XML DB Protocol Server in the Oracle database and includes the core features of mod_plsql. The following graphic illustrates the Oracle Application Express architecture using the embedded PL/SQL gateway.

This two-tier architecture has the following components:

- A web browser

- An Oracle database containing the embedded PL/SQL gateway and Oracle Application Express

Advantages of the embedded PL/SQL gateway:

- Ease of configuration

- Included in the database

- No separate server installation

See Also:
"Security Considerations When Using the Embedded PL/SQL Gateway" in Oracle Application Express Application Builder User's Guide

About the Application Express Engine

The Application Express engine renders and processes pages. It also performs these tasks:

- Session state management

- Authentication services

- Authorization services

- Page flow control

- Validations processing

1.3 About the Oracle Application Express Environment

Oracle Application Express enables a single Oracle database to become a shared workgroup database service. Multiple users can access it using a web browser without installing additional software.

1.3.1 About Workspaces

The area where you develop applications is called a workspace. A workspace is a virtual private database that enables multiple users to work within the same Oracle Application Express installation while keeping their objects, data, and applications private.

In a typical development environment, you might create a single workspace for all your developers to share. However, you can also create dedicated workspaces for specific developers or projects. Creating a dedicated workspace limits access to the workspace objects to only those users associated with the workspace.

The following graphic shows the relationships between users and developers, workspaces, and database schemas.

When you create a workspace, you associate it with a new or existing schema. A schema is a logical container for database objects such as tables, views, and stored procedures. A single schema can be associated with one or more workspaces.

1.4 About Oracle Application Express User Roles

When setting up Application Express users at a large organization, you assign roles and privileges to specific users. The roles within Oracle Application Express include the following:

- End users are application users without any access to development or administrative capabilities.

- Developers are users who create and edit applications and modify database objects. Developers can have their own workspaces or share a workspace.

- Workspace administrators are developers who perform administrator tasks specific to a workspace such as managing user accounts, monitoring workspace activity, and viewing log files.

- Instance administrators are superusers who manage an entire hosted instance using the Application Express Administration Services application.

The following graphic shows multiple users with various roles accessing the Oracle Application Express development environment, Application Express Administration Services, and the published applications.

For this guide, you must have the privileges usually associated with three roles: Instance Administrator, Workspace Administrator, and Developer. The following graphic shows an Oracle Application Express instance with a single user.

1.5 Overview of the Application You Build

In "Building Your Application", you create a simple Human Resources (HR) application for a fictitious company called AnyCo Corp. The application manages departmental and employee information stored in the departments and employees tables that you create. The tutorial shows you how to build the application, modify it, and then preview it.

2 Accessing Your Development Environment

This section guides you through the steps to access an Oracle Application Express development environment for your use. Then, you and other developers can begin building applications within Oracle Application Express.

Topics:

- Before You Begin

- Accessing the Hosted Demo Environment

- Setting Up Your Own Local Environment

- Creating Additional User Accounts

2.1 Before You Begin

Before you begin this section, do the following:

- Install Oracle Application Express as described in Oracle Application Express Installation Guide.

- Read "Introducing Oracle Application Express".

- Confirm that your web browser supports JavaScript and the HTML 4.0 and Cascading Style Sheet (CSS) 1.0 standards. The following browsers meet this requirement:

- Microsoft Internet Explorer 7.0 or later version

- Mozilla Firefox 14 or later version

- Google Chrome 21 or later version

- Apple Safari 5.0 or later version

- Enable cookies for your web browser.

- Determine which environment you want to use:

- Oracle provides a hosted demonstration (demo) environment where you can try out Oracle Application Express.
Using the demo environment is the fastest way to access a development environment. You request a workspace from an Oracle Application Express website and provide some basic user information. Shortly after you submit your request, you receive your login credentials in an email. This option does not require installing any software.

For instructions on using the demo environment, see "Accessing the Hosted Demo Environment".

Note:
Do not use the hosted demonstration environment for your production work.

- Set up your own local instance of Oracle Application Express. Install Oracle Application Express and then follow the steps in "Setting Up Your Own Local Environment".

2.2 Accessing the Hosted Demo Environment

To use Oracle Application Express without installing the product locally, go to the hosted demo environment and sign up for a workspace.

To access the hosted demo environment:

1. In a web browser, go to:
http://apex.oracle.com

2. Click Sign Up.

3. Click Get Started.

4. On Welcome, review the information and click Next.

5. Identify the administrator for the service. Enter a first name, last name, and valid email address and click Next.
The system generates an email with your login credentials and sends it to the email address you enter.

6. For Workspace, enter a workspace name.
Workspace names must be unique. Requesting a duplicate name might delay your request. In general, enter a name that is significant to you. For example, enter your own name, your company name, or the name of the project or department to which your applications pertain.

To use the same name for your workspace and your schema (defined in the next step) use alphabetic characters when naming your workspace. Schema names are restricted to alphabetic characters.

7. Specify a schema. Options include:

1. New Schema to Create - Enter a name containing only alphabetic characters.

2. Initial Space Allocation - Select at least 10 MB to accommodate the space needed for creating the objects required for this guide.

Click Next.

A survey appears.

8. Answer the survey questions and click Next.

9. Indicate why you are requesting this service and click Next.
A license agreement appears.

10. Review the agreement, select I accept the terms, and click Next.

11. Click Submit Request.

An initial email containing a link is sent to you. Click the link within the email to complete the workspace provisioning process. This step verifies that your email address is valid before approving a workspace. After that, an email with your login credentials is sent to you. Use those credentials to log in to the hosted demo environment and begin using Oracle Application Express.

2.2.1 Logging In To the Hosted Demo Environment

Using the login credentials you received in an email, log in to your dedicated workspace on the hosted demo environment.

To log in to the hosted demo environment:

1. In a web browser, go to:
http://apex.oracle.com

2. On the Login page, enter your login credentials.

3. Click Login.
The Workspace home page appears. You may be prompted to change your password. If not, you can change it manually by clicking the Change Password link on the right side of the Workspace home page. Then, enter the information requested on the page that appears.

To continue with the tutorials, skip the rest of this section and go to "Getting Started with Oracle Application Express".

2.3 Setting Up Your Own Local Environment

Instead of using the hosted demo environment, you can install Oracle Application Express locally. If you do a local installation, you must set up your development environment. The steps you must perform include:

1. Install Oracle Application Express as described in Oracle Application Express Installation Guide.

2. Log in to Application Express Administration Services, as described in "Logging In To Administration Services".

3. Create a workspace, as described in "Creating a Workspace".

4. (Optional) Create additional users with developer or administrator privileges, as described in "Creating Additional User Accounts".

Note:
This tutorial explains a simplified method for setting up your development environment so that you can begin using Oracle Application Express. However, when you want to set up your development environment to accommodate your real-life development needs, review “Oracle Application Express Hosted Instance Administration" in Oracle Application Express Administration Guide.

2.3.1 Logging In To Administration Services

To set up your local development environment, you first must log in to Oracle Application Express Administration Services. This is a separate application for managing an entire Oracle Application Express instance.

To log in to the Oracle Application Express Administration Services:

1. In a web browser, go to the Oracle Application Express Administration Services application. Depending on which setup you are using, Oracle Application Express is installed in one of these locations:

- If your setup uses the Oracle Application Express Listener, go to:

http://hostname:port/apex/apex_admin

Where:

- hostname is the name of the system where Oracle Application Express Listener is installed.

- port is the port number assigned to Oracle Application Express Listener. In a default installation, this number is 8080. These defaults are correct at the time of the writing of this document. To learn more, see Oracle Application Listener Installation and Developer Guide.

- apex is the service name defined when configuring the Oracle Application Express Listener.

See Also:
Oracle Application Express Listener documentation

- If your setup uses the embedded PL/SQL gateway:

http://hostname:port/apex/apex_admin

Where:

- hostname is the name of the system where Oracle XML DB Protocol Server is installed.

- port is the port number assigned to HTTP on the Oracle XML DB Protocol Server. In a default installation, this number is 8080.

- apex is the database access descriptor (DAD) defined in the configuration file.
For users who have upgraded from earlier releases, or who have a custom configuration, this value may be htmlb or something else. Verify your DAD with your Instance administrator.

- If your setup uses the Oracle HTTP Server (Apache) with mod_plsql:

http://hostname:port/pls/apex/apex_admin

Where:

- hostname is the name of the system where Oracle HTTP Server is installed.

- port is the port number assigned to Oracle HTTP Server. In a default installation, this number is 7777. You can find information about your Oracle HTTP Server installation's port number from either of the following files:

ORACLE_BASE\ORACLE_HOME\install\portlist.ini

ORACLE_BASE\ORACLE_HTTPSERVER_HOME\Apache\Apache\conf\httpd.conf

Be aware that if you change a port number, it is not updated in the portlist.ini file. You can only rely on this file immediately after installation.

- pls is the indicator to use the mod_plsql cartridge.

- apex is the database access descriptor (DAD) defined in the mod_plsql configuration file.
For users who have upgraded from earlier versions, or who have a custom configuration, this value may be htmldb or something else. Verify the DAD with your Oracle Application Express administrator.

The Login page appears.

2. In Username, enter the username you specified when you installed Oracle Application Express.

3. In Password, enter the Oracle Application Express administrator account password you specified when you installed Oracle Application Express.

4. Click Login to Administration.
Oracle Application Express Administration Services appears.

2.3.2 Creating a Workspace

From Administration Services, create a workspace. A workspace is a shared work area within the Oracle Application Express development environment that has a unique ID and name. All users in the workspace can access all its applications and scripts. For more information about workspaces, see "About Workspaces".

To create a workspace:

1. Log in to Oracle Application Express Administration Services.
The Instance Administration Home page appears.

2. Click Manage Workspaces.

3. Under Workspace Actions, click Create Workspace.

The Create Workspace Wizard appears.

4. For Identify Workspace:

1. Workspace Name - Enter a unique workspace name. This guide uses 2DayPlus for the workspace name.
In general, you want to enter a workspace name that is significant to you. For example, you might enter your own name, your company name, or the name of the project or department to which your application pertains.

If you want to use the same name for both your workspace and schema, enter a workspace name that contains only alphabetic characters. Schema names are restricted to alphabetic characters.

2. Workspace ID - Leave Workspace ID blank to have the new Workspace ID automatically generated. A Workspace ID must be a positive integer greater than 100000.

3. Workspace Description - Enter a workspace description.

4. Click Next.

5. For Identify Schema:

1. Re-use existing schema - Select No if you are creating your first workspace.
A schema is a logical container for database objects. In this step, you are creating the container for database objects you add later in this tutorial.

2. Schema Name - Enter a schema name. This guide uses TWODAYPLUS for the schema name.
You must use only alphabetic characters in your schema name.

3. Schema Password - Enter a case-sensitive password.

4. Space Quota (MB) - Select at least 10 MB to allocate the necessary space for creating the objects required for this guide.

5. Click Next.

6. For Identify Administrator:

1. Administrator Username - Accept the default, ADMIN, or enter another user name to be used in Oracle Application Express.
You are creating an account for only one user, yourself, as an administrator. To see instructions for creating additional users, see "Creating Additional User Accounts".

2. Administrator Password - Enter a case-sensitive password.

3. Enter the remaining information, including your valid email address, and click Next.
The login credentials for accessing Oracle Application Express are sent to the email address you enter here, if you have configured the email settings for your Oracle Application Express environment.

7. Click Next.

8. Confirm your selections and click Create Workspace.

9. Click Done.

2.3.3 Logging In To Your Local Instance

To log in to your local instance of Oracle Application Express, you must have this information:

- URL where you can access Oracle Application Express

- Workspace name you use to develop applications

- Username set up for you for this workspace within Oracle Application Express

- Password set up for you for this workspace within Oracle Application Express

If you set up your development environment, you have your login credentials. Otherwise, contact the person who created your user account to supply the information.

To log in to Oracle Application Express:

1. In a web browser, go to the Oracle Application Express Login page. Depending on your setup, Oracle Application Express installs to one of these locations:

- If your setup uses the embedded PL/SQL gateway or the Oracle Application Express Listener:

http://hostname:port/apex

- If your setup uses the Oracle HTTP Server (Apache) with mod_plsql:

http://hostname:port/pls/apex

For an explanation of the URLs, see "Logging In To Administration Services".

The Login page appears.

2. On the Login page, enter your login credentials.

3. Click Login to Application Express.

2.4 Creating Additional User Accounts

As an administrator, you inherit all the privileges associated with the developer role. If you want to start developing the application shown in this guide, skip this section and go to "Logging In To Your Local Instance".

However, you might want to create user accounts for other developers who share this workspace. Associating users with the workspace grants them access to all applications and scripts within that workspace. You can also create additional user accounts for workspace administrators.

To create a user account:

1. Log in to the workspace where you want to add users. See "Logging In To the Hosted Demo Environment" or "Logging In To Your Local Instance".
The Workspace home page appears.

2. Click Administration.

3. Click Manage Users and Groups.

4. Click Create User.
The Create User page appears.

5. Under User Identification:

1. Username - Enter the username used to log in to the system. Restrictions include:

- Maximum length of 100 characters

- No spaces

- Only these special characters are permitted: ampersand (@) and period (.)

2. Email Address - Enter the valid email address for this user.

3. First Name - Enter the first or given name to further identify the user (optional).

4. Last Name - Enter the last or family name to further identify the user (optional).

5. Description - Enter comments about this user (optional).

6. Default Date Format - Specify the default Oracle date format for the user. This specification controls the default date format within SQL Workshop.

6. Under Account Privileges:

1. Default Schema - Specify the default schema used for data browsing, application creation, and SQL script execution.
When using workspaces that have multiple schemas available, this schema is the default. This setting does not control security, only the user's preference.

2. Accessible Schemas (null for all) - Leave this blank to enable the end user to access all applications in the workspace, or enter a colon-delimited list of schemas for which this user has permissions when using the SQL Workshop.

3. User is a workspace administrator - Specify if this user should have workspace administrator privileges.
Administrators are given access to all components. Additionally, they can manage user accounts, groups, and development services. Components may not be available if they are switched off by Instance Administrators.

4. User is a developer - Specify if this user should have developer privileges.
Developers must have access to either Application Builder, SQL Workshop, or both. Components may not be available if they are switched off by Instance Administrators.

5. Application Builder Access - Determines whether a developer has access to the Application Builder.

6. SQL Workshop Access - Determines whether a developer has access to the SQL Workshop.

7. Team Development Access - Determines whether a developer has access to the Team Development.

8. Set Account Availability - Select Locked to prevent the account from being used. Select Unlocked to allow the account to be used.

7. Under Password:

- Password - Enter a case-sensitive password.

- Confirm Password - Enter the password again.

- Require Change of Password On First Use:

- To require the user to change the password immediately after logging in the first time, select Yes.

- To keep user from having to change the password immediately after logging in the first time, select No.

8. Under User Groups, optionally select a user group.

9. Click Create User or Create and Create Another.

See also:
"Managing Application Express Users" in Oracle Application Express Administration Guide

3 Getting Started with Oracle Application Express

This section introduces you to areas of the Oracle Application Express user interface. It also shows you how to install the sample objects to use with this guide.

Before you begin, log in to Oracle Application Express. For instructions, see "Accessing Your Development Environment".

Topics:

- About the Workspace Home Page

- What Is Application Builder?

- Installing the Sample Objects

3.1 About the Workspace Home Page

When you log in to Oracle Application Express, the Workspace home page appears. The Workspace Home Page has the following large icons:

- Application Builder. Use Application Builder to assemble an HTML interface (or application) on top of database objects such as tables and procedures.

- SQL Workshop. Use the SQL Workshop to access tools for viewing and managing database objects.

- Team Development. Use Team Development to track new features, nonfeature to-do tasks, bugs, and milestones. Users can also provide real-time feedback which then can be categorized into features, to-do tasks, or bugs.

- Administration links to the Workspace Administration page.

Take a few minutes to explore the product.

About the Learn More Link

To the right of the Workspace Home Page icons is:

Click the Learn More link in the About box to view an informative introduction to Oracle Application Express. Topics covered include architecture, self service, security, Websheets, application development, SQL Workshop, Team Development, administration, and managing development.

3.2 What Is Application Builder?

You use the Application Builder component of Oracle Application Express to build your application. Through wizards or your direct input, you can assemble an HTML interface (or application) on top of database objects such as tables and procedures. Each application is a collection of linked pages using tabs, buttons, or hypertext links.

A page is the basic building block of an application. Pages also contain user interface elements such as tabs, lists, buttons, items, and regions. To see the definition of each page belonging to your application, you use the Page Definition page.

The Page Definition contains three main areas:

- Page Rendering lists user interface controls and logic that are executed when a page is rendered. Page rendering is the process of generating a page from the database.

- Page Processing lists logic controls (such as computations and processes) that are evaluated and executed when the page is processed.

- Shared Components lists components used by the current page that can also be referenced by other pages within your application.

3.3 Installing the Sample Objects

In Oracle Application Express, users log in to a workspace. You can think of each workspace as a shared work area that separates your objects, data, and applications into a virtual private database.

Before performing any tasks in this guide, you must create the appropriate sample objects within your workspace. These sample objects are copies of the objects that are typically installed in two schemas:

- Human Resources (HR)
The HR schema contains information about the employees and the facilities where they work. Each employee has an identification number, email address, job identification code, salary, and manager. Employees are assigned to a department, and each department is associated with one location that has a full address, including the street name, postal code, city, state or province, and country code.

- Order Entry (OE)
The OE schema tracks product inventories and sales of a company's products, including the product identification number, the product name, the associated associates product category, product descriptions, the weight group (for shipping purposes), the warranty periods, the suppliers, the availability status, and a minimum price.

To create the objects locally in your workspace, import the OEHR Sample Objects application.

Topics:

- Downloading OEHR Sample Objects

- Importing the OEHR Sample Objects

- Viewing Your Database Objects

Tip:
In order to successfully import the objects associated with the OEHR Sample Objects application, your Oracle database must include Oracle Spatial. If your database instance does not include Oracle Spatial, you can install it using Database Configuration Assistant. To learn more, see the Oracle Application Express Installation Guide for your operating environment.

3.3.1 Downloading OEHR Sample Objects

To import the OEHR Sample Objects application, you must download it from the Oracle Technology Network (OTN).

To download the OEHR Sample Objects application from OTN:

1. In your web browser, go to:

http://www.oracle.com/technetwork/testcontent/oehr-sample-objects-131098.zip

The File Download window appears.

2. In the File Download window, click Save.
The Save As window appears.

3. Save the oehr-sample-objects-131098.zip file to your computer.

4. Unzip and extract the oehr_sample_objects_installer.sql file:

- Microsoft Windows - Open the oehr-sample-objects-131098.zip file

- UNIX or Linux - Enter the following command:

$ unzip oehr_sample_objects.zip

3.3.2 Importing the OEHR Sample Objects

After you download and unzip the OEHR Sample Objects application, import it into Oracle Application Express. During the import process, specify the installation of both the application and the supporting objects. Installing the application creates the objects and sample data needed to complete the exercises in this guide.

To import and install the OEHR Sample Objects application:

1. Log in to Oracle Application Express.
For instructions, see "Logging In To the Hosted Demo Environment" or "Logging In To Your Local Instance".

2. On the Workspace home page, click Application Builder.
The Application Builder home page appears.

3. Click Import.

4. For Specify File, specify the following:

1. Import file - Click Browse and navigate to the oehr_sample_objects_installer.sql file.

2. File Type - Select Database Application, Page, or Component Export.

3. File Character Set - Select the correct character set.

4. Click Next.

Next, you install the imported file.

5. To install an imported file, click Next.
The Install Database Application Wizard appears.

6. For Install Application, specify the following:

1. Parsing Schema - Select the schema you created when you set up your development environment.

2. Build Status - Select Run and Build Application.

3. Install As Application - Select Auto Assign New Application ID.

4. Click Install Application.
After you install the application, you must install the supporting objects.

7. For Install Supporting Objects, select Yes and click Next.

8. Confirm your selections by clicking Install.

9. After the installation is completed, click the Home breadcrumb link at the top of the page.
The Application Builder home page appears.

Note:
The OEHR Sample Objects application that you just installed functions solely as a way to install the sample objects needed to complete the exercises in this document. You will not directly use this application.

3.3.2.1 Checking Your Workspace Storage Space

If you experience problems installing the OEHR Sample Objects application, verify the available space in your workspace. If you do not have enough space, request additional storage space.

If you are a workspace administrator, you can:

- Determine if you have enough storage space. See "About the Workspace Utilization Report" in Oracle Application Express Administration Guide.

- Request additional storage space. See "Requesting a New Schema, More Storage, or Terminating Service" in Oracle Application Express Administration Guide.

3.3.2.2 Deleting the OEHR Sample Objects Application

Deleting the OEHR Sample Objects application and deinstalling the supporting objects completely removes all associated objects and sample data.

To delete the OEHR Sample Objects application:

1. Log in to Oracle Application Express.

2. On the Workspace home page, click Application Builder.
The Application Builder home page appears.

3. Click the OEHR Sample Objects icon.

4. On the Tasks list, click Delete this Application.
The Deinstall page appears.

5. To remove all associated objects and sample data, select Remove Application Definition and Deinstall Supporting Objects.

6. Click Deinstall.
This message appears: "Deinstall successful. Application definition deleted."

3.3.3 Viewing Your Database Objects

Review the objects you created by going to Object Browser. Object Browser enables you to browse, create, and edit objects in your database.

To view the objects:

1. On the Workspace home page, click SQL Workshop.

2. Click Object Browser.
Object Browser appears. It has two panes:

- Object Selection pane displays on the left side of the Object Browser page and lists database objects of a selected type within the current schema.

- Detail pane displays to the right of the page and displays detailed information about a selected object.

3. From the list in the Object Selection pane on the left, select Tables.
The Detail pane lists the tables in your current schema.

4. In the Object Selection pane, click OEHR_EMPLOYEES from the list.
The Detail pane shows details about the table:

To see more rows of the table, use the scroll bar on the right side of the Detail Pane (not shown in preceding figure).

5. Click the Data tab at the top of the Detail pane.
The data in the OEHR_EMPLOYEES table appears. Other tabs show additional details about the object you select.

6. To search for an object name, enter a case-insensitive term in the Search field.
For example, search for "order":

7. To view all objects, leave the Search field blank.

See also:
"Managing Database Objects with Object Browser" in Oracle Application Express SQL Workshop Guide

4 Building Your Application

In this tutorial, you create a Human Resources (HR) application for a fictitious company called AnyCo Corp. This section shows you how to build the application, modify it, and preview it at different points during the development process.

Before you begin this section:

- Read "Getting Started with Oracle Application Express".

- Ensure that you have installed the database objects as described in "Installing the Sample Objects".

Topics:

- About the Application You Build in This Tutorial

- Creating the Initial Application

- Using an Interactive Report

- Modifying the Departments Report

- Adding an Employees Report and Form

- Editing the Employees Report

- Adding a Link on the Home Page to the Employees Report

- Adding a Department Column to the Employees Report

- Linking a Column Value to Another Page

- Adding a List of Values to the Employees Report

- Adding Your Company Name

- Switching Themes to Change the User Interface

4.1 About the Application You Build in This Tutorial

This tutorial guides you through the development of a Human Resources (HR) application for a fictitious company called AnyCo Corp. The application enables users to view and modify employee information stored in the OEHR_DEPARTMENTS and OEHR_EMPLOYEES tables.

When building the application, you perform these tasks:

1. Creating the Initial Application: Create an application that includes a Home page and a basic Departments report.

2. Modifying the Departments Report: Expand the report to pull in data from other tables.

3. Using an Interactive Report: Run and use the Interactive Report.

4. Adding an Employees Report and Form: Build an Employee form and report based on the OEHR_EMPLOYEES table.

5. Editing the Employees Report: Add calculated fields to the Employees report.

6. Adding a Link on the Home Page to the Employees Report: Add a link on the Home page.

7. Adding a Department Column to the Employees Report: Modify the Employees report to enable the user to select a department.

8. Linking a Column Value to Another Page: Add a link on the Departments report that navigates the user to the Employees report.

9. Adding a List of Values to the Employees Report: Add a report as a region that displays department details.

10. Adding Your Company Name: Add your company name so that it appears on all pages in your application.

11. Switching Themes to Change the User Interface: Switch the theme for your application.

4.2 Creating the Initial Application

This exercise guides you through creating your initial application. Using the Create Application Wizard, you create two pages and specify basic application functionality.

The pages created in this section include:

- Home - This page is the first page displayed when the application is run. This page contains a link to the Departments report.

- Departments - This page is an interactive report of all departments.
There are two types of reports, interactive and classic. Interactive is the default when creating applications, converting forms, and creating report regions. Select Interactive when you want to provide user customizations such as filters, sorting, compilation, and so on. If you have limited need for this functionality, use a classic report.

To create your initial application:

1. Log in to Oracle Application Express.
For instructions, see "Logging In To the Hosted Demo Environment" or "Logging In To Your Local Instance".

2. On the Workspace home page, click Application Builder.

3. Click Create.
The Create Application Wizard appears.

Each page within a wizard displays the title of the wizard (for example, Create Application). Each wizard page also displays a line at the top, representing the sequence of steps. The highlighted circle indicates the step you are performing.

To orient you, each step in these exercises generally begins with the block label. For example, the first step in the Create Application Wizard highlights the word Method. Therefore, the next step orients you by beginning with the words For Method.

4. In the Create Application Wizard, select Database and click Next.
The Create Wizard shows that you are on the Name step.

5. For Name:

1. Application - Accept the default ID. The system provides a unique ID for each application you create in this workspace.

2. Name - Enter AnyCo Corp

3. Schema - Select the schema that contains the objects for this tutorial (for example, TWODAYPLUS).

4. Create Options - Select Include Home Page.

5. User Interface - Accept the default, Desktop.

Tip:
When you move your cursor over an item that has Help, the mouse changes to a question mark. Clicking the item then displays Help in another window.

6. Click Next.

The Create Wizard shows that you are on the Pages step.

The Home page is now listed in the top area. The Add Page area appears so that you can continue adding pages to your initial application.

Next, add a report page on the OEHR_DEPARTMENTS table.

6. In the Add Page section, specify the following:

1. Select Page Type - Select Report.

2. Subordinate to Page - Select Home (1).
This sets up the hierarchy among the pages in your application.

3. Page Source - Accept the default, Table.

4. Table Name - Select OEHR_DEPARTMENTS.
The list shows all tables and views in the schema associated with the application.

5. Implementation - Accept the default, Interactive.

6. Click Add Page.
The pages listed in the Create Application section reflect the hierarchy of the pages in your application.

Next, change the default page name, OEHR_DEPARTMENTS, to Departments.

7. Click the link Oehr Departments.
The New Page Definition window appears.

8. Under Page Definition, change the Page Name to Departments and click Apply Changes.
The New Page Definition window closes.

You might have to refresh the page to see that the page name has changed to Departments.

9. On the Create Application page, click Next.
Next, define some application-level settings.

10. For Shared Components, accept the default, No, and click Next.

11. For Attributes, make these changes:

1. Authentication Scheme - Accept the default, Application Express.
Application Express is the default Authentication Scheme. The authentication scheme option enables you to control users' access to the application using Application Express authentication or another type of authentication.

2. Tabs - Select No Tabs.

3. Language - Accept the default, English (en).

4. User Language Preference Derived From - Accept the default, Application Primary Language.

5. Date Format - Click the up arrow and select 12-JAN-04.

6. Date Time Format - Click the up arrow and select 12-JAN-2004 1430.

7. Timestamp Format - Click the up arrow and select 12-JAN-2004 1430.

8. Timestamp Time Zone Format - Click the up arrow and select 12-JAN-2004 1430.

9. Click Next.

The Create Wizard shows that you are on the User Interface Theme step.

12. For Show, select All Themes.

13. For Select a theme, select Blue Builder (Theme 2) and click Next.
The Create Wizard shows that you are on the Confirm step.

14. Verify the information and click Create Application.
This message appears: "Application Created Successfully."

A report at the bottom of the page displays the two pages you created, Home and Departments and a Login page that Oracle Application Express adds automatically to your application.

Note:
To view the pages in Icon view, click the View Icons icon. Your view setting is retained from session to session.
Because these steps use the default setting, switch back to Report view before continuing.

Congratulations! You created your first application using Oracle Application Express. Next, preview the application to see the application the way it would appear to end users.

4.2.1 Previewing Your Application

You preview your application by running it. Running the application displays the rendered version of the application as end users would see it.

As you create pages, you can view them by running the page individually or by running the entire application. When you run a page or application, the Application Express engine dynamically renders it into viewable HTML based on data stored in the database.

You can run an application in the following ways:

- To run the application, click the icon Run Application.

- To run a specific page, click the icon Run Page.

To preview your application:

1. On the Application home page, click Run Application.

2. The first time you run an application you are prompted to enter a user name and password. To continue, enter your workspace user name and password and click Login.
You can run the application using your Application Express login credentials because you chose Application Express Authentication when creating the application. For more information, see "Establishing User Identity Through Authentication" in Oracle Application Express Application Builder User's Guide.

The Home page of your application appears.

The Home page has a link to the Departments page because you set up that hierarchy.

The Home page has the Developer toolbar at the bottom because you ran the application in the development environment. The Developer toolbar offers a quick way to edit the current page, create a page, region or page control, view the session state, or toggle in and out of Debug mode.

3. Click the link Departments.
The Departments report appears.

4.3 Modifying the Departments Report

When you run the Create Application Wizard, the wizard creates forms and reports based on the selections you make. Behind the scenes, Application Express writes a query for you to extract the appropriate data from the database.

In this exercise, you modify the query for the Departments report to include information from the OEHR_EMPLOYEES table. Three columns from the OEHR_EMPLOYEES table, Number of Employees, Manager Name and Location, are added to the Departments report. The Manager Name column replaces the Manager Id column and the Location column replaces the Location Id column.

To modify the Departments report:

1. On the Developer toolbar (at the bottom of the page), click Edit Page 2.
The Page Definition for Page 2 appears.

A page is the basic building block of an application. Pages contain user interface elements such as tabs, lists, buttons, items, and regions. To see the definition of each page belonging to your application, you use the Page Definition page. For more information, see "What Is Application Builder?".

2. Under Page Rendering, locate Regions.

3. Expand Regions and locate Departments.

4. Right-click Departments and select Edit.

Tip:
You can also double-click Departments.

The Region Definition appears.

5. Scroll down to Source, and replace the default Region Source script with the following:

SELECT d.DEPARTMENT_ID,
d.DEPARTMENT_NAME,
(select count(*)from oehr_employees where department_id = d.department_id)  "Number of Employees",
substr(e.first_name,1,1)||'.'||e.last_name "Manager Name",
c.COUNTRY_NAME "Location"
FROM OEHR_DEPARTMENTS d,
OEHR_EMPLOYEES e,
OEHR_LOCATIONS l,
OEHR_COUNTRIES c
WHERE d.LOCATION_ID=l.LOCATION_ID
AND l.COUNTRY_ID=c.COUNTRY_ID
AND d.DEPARTMENT_ID=e.department_id
AND d.manager_id=e.employee_id
AND instr(upper(d.department_name),upper(nvl(:P2_REPORT_SEARCH,d.department_name)))>0

6. Click Apply Changes.

7. To confirm, click Apply Changes.
This message appears: "Interactive Report query changed successfully."

8. Right-click Departments and select Edit Report Attributes.

9. Next to Number of Employees, click the icon Edit.

10. Under Column Definition, for Column Alignment, select center.
This message appears: "Actions Processed."

11. Click Apply Changes.
This message appears: "Actions Processed."

4.3.1 Run the Report to View Added Columns

To see how the page looks to end users, run the page. When you run a page, the Application Express engine dynamically renders and processes the page to display viewable HTML.

To run the page:

1. In the upper right corner, click the icon Run Page.

The revised Departments report appears.

The Manager Id and Location Id columns are not available. Also, the three new columns do not display on the revised report: Number of Employees, Manager Name, and Location.

2. To add the new columns, click the menu Actions.
The list of Action options appears.

3. From the Actions menu, select Select Columns.
The columns that were added by the new SQL query are in the Do Not Display box.

4. To add these three columns to the Display in Report box, click the icon Move All, which resembles two forward arrows.

5. Verify that the columns are in the following order. If they are not, click up and down arrows to the right of the Display in Report list to change the order:

- Department Id

- Department Name

- Number Of Employees

- Manager Name

- Location

6. Click Apply.
The Departments page appears and includes the new columns.

4.4 Using an Interactive Report

This exercise guides you through some commonly used report options available to users when they run interactive reports. These options enable users to perform certain tasks quickly.

Topics:

- Save Report Settings as the Default

- Create a Filter

- Change the Sort Order

- Add a Controlled Break

- Display the Single Row View

- Reset Report Settings

You used the Select Column option from the Actions menu to add columns to the report display. In this section, you run the application and use search, sort, highlight, and reset features to manipulate the Departments interactive report.

This tutorial only shows the most prominent functionality available with interactive reports. For complete details, see "Customizing Interactive Reports" in Oracle Application Express Application Builder User's Guide.

4.4.1 Save Report Settings as the Default

Both developers and end users can save an interactive report. However, only a developer can save the Primary Default report that initially displays.

There are four types of interactive reports:

- Primary Default (Developer Only). The Primary Default is the report that initially displays. Primary Default reports cannot be renamed or deleted.

- Alternative Report (Developer Only). Enables developers to create multiple report layouts. Only developers can save, rename, or delete an Alternative Report.

- Public Report (End user). Can be saved, renamed, or deleted by the end user who created it. Other users can view and save the layout as another report.

- Private Report (End user). Only the end user that created the report can view, save, rename, or delete the report.

To save current report settings as the default:

1. Click the menu Actions.

2. Select Save Report.
The Save Report settings appear.

3. For Save, select As Default Report Settings.
The Default Report Type settings appear.

4. Select Primary and click Apply.
The report shows all columns when the user selects the Reset option from the menu Actions or when the page is reset by the command Reset Interactive Report (RIR).

See Also:
For a description of how to save a report as a Named Report see "Customizing Interactive Reports" in the Oracle Application Express Application Builder User's Guide.

4.4.2 Create a Filter

This exercise shows you how to add a filter to the Departments report. This example creates a filter to show all departments except the department with Id 60.

There are multiple ways that a user can create a filter. The user can add a filter from the:

- Search Bar

- Actions Menu

- Column Heading

The Actions menu offers more options than the others. For a quick filter using the equals operator, the Search Bar or Column Heading are the quickest methods. For anything else, use the Filter option from the Actions menu.

To create a filter for all departments not equal to 60:

1. Click the menu Actions.

2. Select Filter.
The filter settings display. You can also click the column heading link to create a filter for that column. Creating a filter from the column heading menu, however, is limited to the equal operator.

3. From Operator, select the not equals operator (!=).

4. From Expression, select 60.

5. Click Apply.
The Departments report is displayed with the Department_Id!=60 filter applied. All departments, except for the IT department with a Department Id of 60, are included in the report.

The filter displays at the top of the report. You can edit, disable, or delete this filter. To edit, click the filter name. To disable, deselect the check box. To delete, click the Delete icon that looks like an X over the filter icon.

6. Deselect the check box next to the Department Id!=60 filter to disable it.
The report shows data for all Department Ids.

4.4.3 Change the Sort Order

In this exercise, you learn how to reorder the data for each column.

To change the sort order:

1. Click the menu Actions.

2. Select Format and then Sort.
The sort settings are displayed. This option is also available for each column by clicking the column heading. The Actions menu is quicker when changing the sort order for multiple columns.

3. For the first column entry, select Department Name.

4. Click Apply.
The report shows the Department Name column in ascending alphabetical order.

The Up Arrow icon after the Department Name indicates that the column has been sorted in ascending order. You can click this arrow to re-sort the column.

4.4.4 Add a Controlled Break

Another way to reformat a report is to create a controlled break. A controlled break enables the user to delineate data into clearly visible groups.

To add a controlled break:

1. Click the column heading Location.
The column heading menu appears.

2. Click the icon Control Break (shown below).
This option is also available from the menu Actions, Format.

The report is reformatted to show a break after each group of rows that have the same location.

The Location control break report setting displays under the Search bar.

4.4.5 Display the Single Row View

You can also display details for a row by selecting the Edit icon.

To display a single row view:

1. In the first row, locate the Edit icon .

2. In the first row, select the Edit icon.
The details page for the first row appears.

4.4.6 Reset Report Settings

You can revert the report settings to the saved default settings. When an interactive report is reset, the default settings are applied to the report. An interactive report can be reset by the user and by the developer under the following conditions:

- A user can reset an interactive report if the Reset option is available from the Actions menu. This option is enabled or disabled by the developer. For further details, see "Customizing Interactive Reports" in the Oracle Application Express Application Builder User's Guide.

- A developer can specify that an interactive report be reset when it is called from another page. The Reset Interactive Report command, RIR, is used for this purpose. For further details, see "Customizing Interactive Reports as a Developer" in the Oracle Application Express Application Builder User's Guide.

To return to the default settings:

1. Click Report View.

2. Click the Actions menu and select Reset.

3. When prompted to restore the default settings, click Apply.
The report goes back to the default report settings saved in the previous section.

4.5 Adding an Employees Report and Form

In this exercise, you add a report to display employee information and a form to create, update, and delete employee information.

To add an employee report and form:

1. On the Developer toolbar (at the bottom of the page), click the link Application ID.
The Application home page appears.

2. Click Create Page.

3. For Page:

1. Select Form and click Next.

2. Select Form on a Table with Report.
This option creates two pages, a report and form, based on a single table or view.

3. Click Next.

4. For Report Page, make these changes:

1. Page Name - Change to Employees.

2. Region Title - Change to Employees.

3. Region Template - Select Reports Region.

4. Breadcrumb - Select Breadcrumb.
The Create Breadcrumb Entry section appears.

5. For Select Parent Entry, click the link Home.
Home appears in the Parent Entry field.

6. Click Next.

5. For Data Source page:

1. Table/View Owner - Accept the default, TWODAYPLUS.

2. Table/View Name - Select OEHR_EMPLOYEES (table).

3. Click Next.

6. For Tabs Page, accept the default, Do not use tabs, and click Next.

7. For Report Columns page:

1. Adjust the selected columns so that these columns display in the right box:

- EMPLOYEE_ID

- FIRST_NAME

- LAST_NAME

- HIRE_DATE

- SALARY

- COMMISSION_PCT

2. Click Next.

You are still on the Report Columns step.

8. Accept the defaults for the link image and click Next.
Next, define the page and region information for the form.

9. For Form Page, make these changes:

1. Page Name - Enter Create/Edit Employee

2. Region Title - Enter Create/Edit Employee

3. Click Next.

10. For Primary Key Type, accept the default, Managed by Database (ROWID), and click Next.

11. In Select Column(s), move all columns from the left box to the right box and click Next.
These columns appear in the Create/Edit Employee form when the page is run.

12. For Identify Process Options, accept the defaults and click Next.
These selections enable users to add, update, and create employee records.

13. For Confirm, verify the information and click Create.
This message appears: "The Form and Report have been created successfully."

4.5.1 Previewing the Pages

To preview the two pages you created, run the current page. From the Employees report, you can then preview the form.

To preview the pages:

1. Click Run Page.

The Employees report appears.

Note the following about the Employees report:

- The Search Bar with the Actions menu appears at the top. For more information, see "Using an Interactive Report".

- The column headings are links that enable the user to quickly perform various sorting, filtering, and reformatting operations. For more information, see "Using an Interactive Report".

- The Edit icon you selected appears in each row. You can click the Edit icon to update the employee record. Because you created a form based on a table with a report, the wizard automatically linked the report to the form. If you create only a report, as described in the previous section, "Creating the Initial Application", the wizard automatically links the report to the single row view.

- The Create button appears in the upper right corner. You can click the Create button to add an employee to the underlying table.

- The Employees report includes the columns you specified. When you selected the columns and applied the changes, Oracle Application Express created the appropriate SQL code in the background to produce this result.

Your data might appear in a different order. If so, ignore this difference.

2. To review the form you also created, click the Edit icon in an Employee row.
The Create/Edit Employee form appears. For example, if you click the Edit icon for the employee Steven King:

Note the following about the Create/Edit Employee form:

- The Hire Date field displays a calendar, which is included because the data type of the underlying column is DATE.

- Fields with red asterisks are mandatory and cannot be blank or null.

4.6 Editing the Employees Report

In this exercise, you create a new column entitled Remuneration to display employee salaries in the Employees report.

Topics:

- Create a Function

- Add a Column

- Previewing the Page

- Changing the Column Format

4.6.1 Create a Function

First, create a function to calculate employees' salaries.

To create a function:

1. On the Developer toolbar, click Home.

2. Click SQL Workshop and then SQL Commands.
SQL Commands provides a window where you can run SQL commands (including those that create PL/SQL subprograms).

3. In the window (the SQL editor), enter the following script:

CREATE OR REPLACE FUNCTION calc_remuneration(
salary IN number, commission_pct IN number)
RETURN NUMBER IS
BEGIN
RETURN ((salary*12) + (salary * 12 * nvl(commission_pct,0)));
END;

When copying and pasting this SQL, make sure there is not an empty line before the first statement, CREATE OR REPLACE FUNCTION.

4. Click Run.
The Results section displays this message:

Function created.

4.6.2 Add a Column

Next, add a column to display the results of the employees' salary calculations.

To add a column:

1. Navigate to the Page Definition for the Employees page:

1. Click the tab Application Builder.

2. Select the application AnyCo Corp.

3. Click the Employees page.
The Page Definition for the Employees page appears.

2. Under Regions, locate Employees.

3. Right-click Employees and select Edit.
The Region Definition appears.

4. Scroll down to Source, and replace the existing code with the following:

SELECT "ROWID",
"EMPLOYEE_ID",
"FIRST_NAME",
"LAST_NAME",
"HIRE_DATE",
"SALARY",
"COMMISSION_PCT",
calc_remuneration(salary, commission_pct) REMUNERATION
FROM "#OWNER#"."OEHR_EMPLOYEES"

5. Click Apply Changes.

6. To confirm, click Apply Changes.
This message appears: "Interactive report query changed successfully."

4.6.3 Previewing the Page

To preview the page, in the upper right corner, click the icon Run Page. The Remuneration column does not appear. You must add the column by using the Select Column action.

To display the Remuneration column:

1. Click the Actions menu.

2. Select the action Select Columns.

3. Move the Remuneration column from the Do Not Display box to the Display in Report box.

4. Click Apply.
The Employees Report is displayed and includes the Remuneration column.

4.6.4 Changing the Column Format

Next, change the format of the columns that contain numeric values.

To change the column format:

1. On the Developer toolbar (at the bottom of the page), click Edit Page 3.
The Page Definition appears.

2. Under Regions, right-click Employees and select Edit Report Attributes.
The Interactive Report Attributes page appears.

3. Locate the section Column Attributes.
Next, change the format of the value in the Salary and Remuneration columns.

4. To edit the Salary format:

1. Next to SALARY, click the icon Edit.

2. For Number/Date Format, from the context menu, select $5,234.10.
The appropriate format mask appears in the field.

3. Click Apply Changes.
This message appears: "Action Processed."

5. Repeat the previous step for REMUNERATION.

6. To preview the page, in the upper right corner, click the Run Page icon.
The numbers in the Salary and Remuneration columns now appear with the dollar sign and include commas and decimals.

4.7 Adding a Link on the Home Page to the Employees Report

In this exercise, you add a link on the Home page to take users to the Employees report. This link appears in the Navigation region on the left side of the Home page.

To add a link on the Home page to the Employees report:

1. Navigate to the Page Definition for the Home page:

1. On the Developer toolbar (at the bottom of the page), click the link Application ID.

2. On the Application home page, click Home.

2. Under Regions, right-click Navigation and select Edit List.

3. On the List Details page, click Create List Entry.

4. On the Create/Edit page, make the following changes:

1. List Entry Label - Enter Employees

2. Page - From the context menu, select Employees.

5. Click Create List Entry.
This message appears: "Action Processed."

6. Run the page.

Your Home page now includes a link to Employees.

7. To test the link, click Employees.
The Employees report appears.

4.8 Adding a Department Column to the Employees Report

In this exercise, you link the Employees and Departments reports. When you complete this section, the Employees report has a Departments column showing which department each employee belongs to.

To perform this task, you create a column on the Employees page to enable the user to select a department. You then run the Employees report and add the Departments column to the report. The report settings are saved as the default.

Topics:

- Add a Column

- Display the Department Name Column in the Report

- Save Report Settings as the Default

4.8.1 Add a Column

In order to filter the Employees report by department, add a Department column to the report.

To add a column:

1. In the Developer toolbar, click Edit Page 3.

2. Under Regions, right-click Employees and select Edit.
The Region Definition appears.

3. Scroll down to Source.

4. Replace Region Source with the following SQL:

SELECT e.ROWID,
e.EMPLOYEE_ID,
e.FIRST_NAME,
e.LAST_NAME,
e.HIRE_DATE,
e.SALARY,
e.COMMISSION_PCT,
calc_remuneration(salary, commission_pct) REMUNERATION,
e.DEPARTMENT_ID,
d.DEPARTMENT_NAME
FROM OEHR_EMPLOYEES e,
OEHR_DEPARTMENTS d
WHERE e.DEPARTMENT_ID=d.DEPARTMENT_ID

5. Click Apply Changes.

6. To confirm, click Apply Changes.
This message appears: "Interactive Report query changed successfully."

The next section explains how to add the column to the report display and how to use this column to filter employee reports.

4.8.2 Display the Department Name Column in the Report

When you first run this report, use the Select Columns action to add the Department Name column to the display. After this column is visible on the report, make this report the default and filter by department.

To add the Department Name column to the report:

1. Click the icon Run Page.

2. Click the Actions menu and select Select Columns.

3. Move Department Name from the Do Not Display box to the last entry in the Display in Report box.

4. Click Apply.
The Employees Report is displayed and includes the Department Name column.

Next, make these report settings the default.

4.8.3 Save Report Settings as the Default

This section explains how to save the current report settings as the Primary Default report. Both developers and end users can save interactive reports. However, only a developer can save the report that initially displays, called the Primary Default report.

To save the current report settings as the default:

1. Run the report page Employees.

2. Click the Actions menu and select Save Report.

3. For Save, select As Default Report Settings.

4. Accept the Default Report Type setting, Primary, and click Apply.

Note:
If a reset is performed on this page, these default report settings are used. The Department Name column is displayed by default.

4.9 Linking a Column Value to Another Page

In this exercise, you add a link to the Number of Employees column on the Departments report that navigates the user to the Employees report. It also sets the focus to the selected department. The column link includes a Clear Interactive Report command, CIR, to clear the Employees report, when shown, of any filters, control breaks, highlights, aggregates, computed columns, chart settings, and flashback settings.

Topics:

- Change Column Value to a Link

- Run the Departments Report

- Create a Highlight to Test Clear Interactive Report Command

4.9.1 Change Column Value to a Link

To make this change, you edit the report attributes on the Departments report to change the value for the Number of Employees column to a link.

To change the column value to a link:

1. On the Developer toolbar, click Application ID.

2. Click Departments.

3. Under Regions, right-click Departments and select Edit Report Attributes.
The Report Attributes page appears.

4. Locate the section Column Attributes.

5. In the Column Attributes section, next to Number of Employees, click the Edit icon.

6. Scroll down to the section Column Link.

7. Under Column Link, make these changes:

1. Link Text - Select #Number of Employees#.

2. Page - From the context menu, select Employees.
In the Page field, the number of the Employees page, 3, appears.

3. Select Reset Pagination.

4. Clear Cache - Enter:

3,CIR

The 3 means the cache for page 3 is cleared and the string CIR clears the Employees interactive report of any filters, control breaks, highlights, aggregates, computed columns, chart settings or flashback settings when the report is displayed.

5. Item 1, Name - Enter IR_DEPARTMENT_ID
The prefix IR_ associates the URL item with an interactive report column rather than an item on the page.

6. Item 1, Value - From the context menu, select #DEPARTMENT_ ID#.
The Column Link section shows the options you selected.

In summary, these options enable the following behavior when the end user clicks the link:

- The end user is navigated to page 3 of the Employees report.

- On the Employees report, the selected department is in focus.

- The Employees report is cleared—any filters, control breaks, highlights, aggregates, computed columns, chart settings, or flashback settings are removed.

- The user is returned to the first set of employee records when the user selects another department.

7. Click Apply Changes.
This message appears: "Action Processed."

In the Column Attributes section, the Number of Employees row contains a check mark in the Link column, reflecting the change you made.

4.9.2 Run the Departments Report

Now, run the report and test the Number of Employees column link from the Departments report. The Employees report is displayed, showing all employees that belong to the selected department.

1. Click the icon Run Page.
The Departments report is displayed. End users can now drill down on the data in the Number of Employees column by clicking the numbers in that column.

2. In the Executive row, in the Number of Employees column, click 3.

The Department Id filter is displayed because this report is filtered by the Department Id value for the Executive department, 90, passed to this report from the Departments report. The Clear Interactive Report command is included at the end of the URL in your browser, as shown in this example:

f?p=100625:3:13870074215647::NO:RP,3,CIR:IR_DEPARTMENT_ID:90

4.9.3 Create a Highlight to Test Clear Interactive Report Command

This exercise demonstrates how to use the CIR command to clear a highlight before displaying the Employees report. You highlight any rows containing the first name of Neena, then display the Employees report from the Number of Employees column on the Departments report.

To highlight rows in the Employees report:

1. Click the Actions menu and select Format and then Highlight.
The Highlight options appear.

2. For Highlight options:

1. Name - Enter Neena

2. Background Color - Select [yellow]

3. Text Color - Select [red]

4. Column - Select First Name

5. Operator - Select =.

6. Expression - Select Neena

7. Click Apply.

The Employees report appears with the row for Neena highlighted.

3. Next, reset the report.

1. Click the breadcrumb Home.

2. Click link Departments.

3. In the Executive row, click Number of Employees.
The Employees report is displayed with the highlighting cleared, due to the CIR command specified in the column link.

4. To the right of DepartmentID = 90, click the icon Remove Filter.

5. On the Developer toolbar, click Application ID.

4.10 Adding a List of Values to the Employees Report

In this exercise, you add a list of values to the Employees page to display employees by department. You also change the Employees report query, edit the column link on the Department report, and turn off pagination.

Topics:

- Add a List of Values

- Add an Item to Display List of Values

- Change Employees Report Query

- Change Column Link on Department Report

- Turning Off Pagination

4.10.1 Add a List of Values

In this section, you create a list of values to select which department details to view. This is a dynamic list that queries the OEHR_DEPARTMENTS table for a list of the department names.

To create a list of values:

1. Click Shared Components.

2. Under User Interface, select Lists of Values.

3. Click Create.

4. Accept the default, From Scratch, and click Next.

5. For Name and Type:

1. Name - Enter DEPARTMENTS

2. Type - Select Dynamic.

3. Click Next.

6. For the Query, enter:

SELECT department_name d, department_id v
FROM oehr_departments
ORDER BY d

7. Click Create List of Values.
This message appears: "Dynamic list of values created."

4.10.2 Add an Item to Display List of Values

Now, you create an item in the Department Details region to display the list of departments.

To add an item:

1. Navigate to the Page Definition for the Employees page.

2. Under Region, right-click Employees and select Create Page Item.

3. Select Select List and click Next.

4. For Display Position and Name:

1. Item Name - Enter P3_DEPARTMENT_ID

2. Sequence - Enter 10

3. Region - Select Employee (10)

4. Click Next.

5. For Item Attributes:

1. Label - Enter Department

2. Accept the remaining defaults and click Next.

6. For Settings:

1. Value Required - Select No.

2. Page Action when Value Changed - Select Redirect and Set Value.

3. Click Next.

7. For List of Values, make these changes:

1. Named LOV - Select DEPARTMENTS

2. Display Null Value - Select Yes

3. Null Display Value - Enter:

- No Department Assigned -

4. Null Return Value - Enter:

-1

5. Click Next.

8. Click Create Item.
This message appears: "Item P3_DEPARTMENT_ID created."

4.10.3 Change Employees Report Query

Now, you change the Employees report query to display employees that belong to the selected department.

To change the query:

1. Under Regions, right-click Employees and click Edit.

2. For Region Source, enter:

SELECT e.ROWID,
e.EMPLOYEE_ID,
e.FIRST_NAME,
e.LAST_NAME,
e.HIRE_DATE,
e.SALARY,
e.COMMISSION_PCT,
calc_remuneration(salary, commission_pct) REMUNERATION,
e.DEPARTMENT_ID,
d.DEPARTMENT_NAME
FROM  OEHR_EMPLOYEES e,
OEHR_DEPARTMENTS d
WHERE  e.DEPARTMENT_ID = d.DEPARTMENT_ID(+) AND
(e.DEPARTMENT_ID = :P3_DEPARTMENT_ID or
(e.DEPARTMENT_ID is null and nvl(:P3_DEPARTMENT_ID,'-1') = '-1'))

3. Click Apply Changes.
This message appears: "Region Updated."

4.10.4 Change Column Link on Department Report

Because the Employees query has changed, the Number of Employees column link must initialize the P3_DEPARTMENT_ID item to the value of DEPARTMENT_ID.

To change the column link for Number of Employees:

1. Click the breadcrumb Application ID.

2. Click Departments.

3. Under Regions, right-click Departments and select Edit Report Attributes.

4. For Number of Employees, click the icon Edit.

5. Scroll down to Column Link.

6. For Item 1 Name, select P3_DEPARTMENT_ID.

7. Click Apply Changes.
This message appears: "Action Processed."

4.10.5 Turning Off Pagination

Next, turn off pagination for the Department Details report, because only one record (the department details report) displays at a time. If pagination is on, the region that displays the department details includes the information row 1 - 1.

To turn off pagination:

1. Click the breadcrumb Application ID.

2. Click Employees.

3. Under Regions, right-click Employees and select Edit Report Attributes.

4. Scroll down to Pagination.

5. For Pagination Type, select - No Pagination Selected -.

6. Click Apply Changes.
This message appears: "Action Processed."

7. Click the Run Page icon.

8. From the Department list, select No Department Assigned.

The row for employee Kimberely Grant appears. This employee is not currently assigned to a department.

Tip:
If no records initially display, reload the page and try again.

4.11 Adding Your Company Name

You can add a graphical logo or text to your application so that it displays on each page. Your page template determines the display location.

In this exercise, you add your company name to your application.

To add your company name to your application:

1. Navigate to the Application home page: On the Developer toolbar (at the bottom of the page), click Application ID.

2. In the upper right corner, click Edit Application Properties.
The Edit Application Definition page appears.

3. Click User Interface.

4. Under Logo:

1. Logo Type - Select Text.

2. Logo - Enter AnyCo Corp

3. Logo Attributes - Select Black Text.

This message appears: "Application id_number processed."

5. Click Apply Changes.

6. Click Home.

7. Click the Run Page icon.

The company name now appears on each page in your application.

4.12 Switching Themes to Change the User Interface

In this exercise, you switch the current theme to another one for your application. A theme is a collection of templates that defines the application user interface. Each theme contains templates for every type of application component and page control, including individual pages, regions, reports, lists, labels, menus, buttons, and list of values.

Oracle Application Express separates presentation (or user interface themes) from the application logic. You can design your application in one theme, change to another supplied theme, or create and use your own custom theme. By separating the application logic (such as queries, processes, and branches) from the HTML rendering, your application can take advantage of the latest designs and other technological advances without an application rewrite. Each theme provides a complete set of templates that accommodate every user interface pattern that may be needed in an application.

To switch the theme:

1. On the Developer toolbar (at the bottom of the page), click Application ID.

2. On the Application home page, click Shared Components.

3. Under User Interface, click Themes.

4. On the Themes page, click Create.
The Create Wizard appears.

5. For Method, accept the default, From the Repository, and click Next.

6. For User Interface, accept the default, Desktop, and click Next.

7. For Identify Theme, select Cloudy (Theme 24) and click Next.

8. Click Create.
This message appears: "Theme created."

9. Click Switch Theme.

10. For Identify Theme:

- For Currently Active Theme, select 2. Builder Blue.

- For Switch to Theme, select 24. Cloudy.

Click Next.

11. For Verify Compatibility, review the information, accept the defaults, and click Next.
The wizard verifies that corresponding templates exist in the selected theme for all templates used in your current application. If a template is missing, it warns you with a message in the Status column. For this tutorial, you can ignore this message because Oracle Application Express maps missing region templates to existing ones.

12. For Confirm Switch, click Switch Theme.

13. Click the icon Run Page.

The design and layout are changed in all your pages.

5 About Deploying Your Application

This section provides basic information about deploying your Oracle Application Express application. It also shows you how to create end users and determine the URL of your application.

Topics:

- Overview of Deploying Your Application

- Creating Users

- About Publishing the Application URL

5.1 Overview of Deploying Your Application

After building your application in your development environment, you must deploy it so that end users can begin using it. Deploying involves the following steps:

1. Collect your supporting object definitions (CREATE object statements, sample data, images, files, and so on). Review the Database Object Dependencies report to determine which supporting objects to move. See "Viewing Application Utilities and Reports" in Oracle Application Express Application Builder User's Guide.

2. Define your supporting objects. This includes the object definitions you collected in the previous step and other supporting objects, such as messages and prerequisites.

3. Export the application with its supporting objects.

4. Import and install the exported files.

Using Oracle Application Express greatly simplifies the deployment process. It enables you to migrate the application definition, associated files, and all supporting objects in only a few steps.

See also:
"Deploying an Application" in Oracle Application Express Application Builder User's Guide

5.2 Creating Users

After moving your application to a production environment, you must create user accounts within Oracle Application Express for your end users.

Note:
For the following procedure, you need workspace administrator privileges.

To create user accounts:

1. Navigate to the Workspace home page.

2. Click Administration.

3. Click Manage Users and Groups.
(This icon appears only if you have workspace administrator privileges.)

4. Click Create User.
The Create User page appears.

5. Under User Identification:

1. Username - Enter the username used to log in to the system. Restrictions are:

- Maximum length of 100 characters

- No spaces

- Only these special characters are permitted: ampersand (@) and period (.)

2. Email Address - Enter the email address for this user.

3. First Name - (Optional) Enter the first or given name to further identify the user.

4. Last Name - (Optional) Enter the last or family name to further identify the user.

5. Description - (Optional) Enter comments about this user.

6. Default Date Format - Specify the default Oracle date format for the user. This specification controls the default date format within SQL Workshop.

6. Under Account Privileges:

1. Default Schema - Specify the default schema used for data browsing, application creation, and SQL script execution.
When using workspaces that has multiple schemas available, this schema is the default. This setting does not control security, only the user's preference.

2. Accessible Schemas (null for all) - Leave this blank to enable the end user to access all schemas associated with the workspace.

3. User is a workspace administrator - Specify if this user should have workspace administrator privileges.
Administrators have access to all components. Additionally, they can manage user accounts, groups, and development services. Components may not be available if they are switched off by Instance Administrators.

4. User is a developer - Specify if this user should have developer privileges.
Developers must have access to either Application Builder, SQL Workshop, or both. Components may not be available if they are switched off by Instance Administrators.

5. Application Builder Access - Determines whether a developer has access to the Application Builder.

6. SQL Workshop Access - Determines whether a developer has access to the SQL Workshop.

7. Team Development Access - Determines whether a developer has access to the Team Development.

8. Set Account Availability - Select Locked to prevent the account from being used. Select Unlocked to allow the account to be used.

7. Under Password:

- Password - Enter a case sensitive password.

- Confirm Password - Enter the password again.

- Require Change of Password On First Use:

- To require the user to change the password immediately after logging in the first time, select Yes.

- To keep user from having to change the password immediately after logging in the first time, select No.

8. Under User Groups, optionally select a user group.

9. Click Create User or Create and Create Another.
This message appears: "User created."

See also:
"Managing Application Express Users" in Oracle Application Express Administration Guide

5.3 About Publishing the Application URL

After deploying your application, you must publish its URL so end users know how to access it.

To determine the URL:

1. Log in to Oracle Application Express in the production environment.

2. Select Application Builder.

3. Select the application.

4. On the Application home page, position the mouse over Run Application.

5. Note the URL that displays in the status bar at the bottom of the page.

For example:

http://apex.oracle.com/pls/apex/f?p=11563:1:3397731373043366363

Where:

- apex.oracle.com is the URL of the server.

- pls is the indicator to use the mod_plsql.

- apex is the database access descriptor (DAD) name. The DAD describes how Oracle HTTP Server connects to the database server so that it can fulfill an HTTP request. The default value is apex.

- f?p= is a prefix used by Oracle Application Express.

- 11563 is the application being called.

- 1 is the page within the application to be displayed.

- 3397731373043366363 is the session number, which is unique for every user's access to the application. Do not include a session number in the URL that you give to end users.

To run this example application, you would go to this URL:

http://apex.oracle.com/pls/apex/f?p=11563:1

See also:
"Deploying an Application" in Oracle Application Express Application Builder User's Guide

6 About Globalization

This section provides some basic information about globalization. It also leads you through the steps to specify how the application determines global identification.

Topics:

- About Language Identification and Rendering

- Specifying the Method for Global Identification

See also:
"Managing Application Globalization" in Oracle Application Express Application Builder User's Guide

6.1 About Language Identification and Rendering

You can develop applications in Application Builder that run concurrently in different languages. This feature enables different users to view the application in their own language and data in the appropriate formats.

When rendering a page in the application, Oracle Application Express first determines the language for an application based on the method you specified. Then, the Application Express engine alters the session language and territory settings for a specific page request. It then looks for a translated application in the appropriate language. If the Application Express engine finds that language, it renders the application using that definition. Otherwise, it renders the application in the base (or primary) application language.

Even if your application is not translated, the language display determines the format for displaying data so that end users view numbers, dates, and currency in the appropriate formats.

6.2 Specifying the Method for Global Identification

As part of the application definition settings, you can specify how the application determines which language and formats to display. You can base it on the user's browser language preference or restrict it to the language you specify.

To specify the method for determining global identification:

1. Click Application Builder.

2. Select the application.

3. Click Shared Components.

4. Under Globalization, click Globalization Attributes.

5. Under Globalization, specify the following:

1. Application Primary Language - Select the language you used when developing the application.

2. Application Language Derived From - Select Browser (use browser language preference).
This option enables users to view the application in the language specified in their browsers.

3. Application Date Format - Specify the date format to be used in the application.

4. Application Date Time Format - Specify the date time format to be used in the application.

5. Application Timestamp Format - Specify the timestamp format to be used in the application.

6. Application Timestamp Time Zone Format - Specify the timestamp with time zone format to be used in the application.

7. Character Value Comparison - Determines the collating sequence for character value comparison in various SQL operations and clauses, for example, ORDER BY, LIKE, MIN/MAX. To learn more, see item Help.

8. Character Value Comparison Behavior - Determines the collation behavior of SQL operations, for example, LIKE, MIN/MAX. To learn more, see item Help.

9. Automatic Time Zone - Controls the setting of the database session time zone. When set to Yes, the client time zone is derived from the client's web browser and set for the duration of the Application Express session.

10. Automatic CSV Encoding - Select Yes or No.
Automatic CSV Encoding controls the encoding of all comma-delimited (CSV) report output in an application. If Automatic CSV Encoding is set to Yes, CSV report output is properly converted to a character set compatible with localized desktop applications. The character set for the CSV encoding is determined by the Application Language Derived From setting.

For example, the end user whose browser setting is German (de) sees these changes on the Employees page of AnyCo Corp:

- The euro currency symbol appears for the amounts in the Salary and Remuneration columns.

- The amounts reflect the formatting used in Germany (commas and decimals).

The application fields are not yet translated. For instructions on translating your application, see "Managing Application Globalization" in Oracle Application Express Application Builder User's Guide.

7 Next Steps

Now that you have completed this guide, you are ready to take advantage of other resources to expand your knowledge of Oracle Application Express and boost your productivity. This section describes those resources.

Note:
Consider deleting the sample objects required to complete this tutorial to free up space in your workspace. For instructions, see "Deleting the OEHR Sample Objects Application".

7.1 Additional Resources

To continue learning about Oracle Application Express, review these additional resources designed for Application Express users.

Oracle Learning Library

Search for free online training content, including Oracle by Example (OBE), demos, and tutorials. To access the Oracle Learning Library, go to:

http://www.oracle.com/technetwork/tutorials/index.html

Training Courses

You can attend training courses for Oracle Application Express. To review these courses, go to the following website and enter Application Express in the search criteria field:

http://education.oracle.com

Oracle Technology Network

Oracle Technology Network (OTN) is a central website for Oracle Application Express resources and information. In addition to downloading the latest product version, sample code, and packaged applications, the OTN site includes:

- Discussion forum, where you can post questions and search for solutions

- How-to documents, which are technical notes written by subject matter experts

- Quick tour of the product

- News and magazine articles related to Oracle Application Express

To access the Oracle Application Express page on OTN, go to the following website:

http://www.oracle.com/technetwork/developer-tools/apex/overview/index.html

Index
A  B  C  D  E  F  G  H  I  L  N  O  P  Q  R  S  T  U  W

A

Actions menu, Select Columns action, 4.3.1

adding, 4.5

an Employees form, 4.5

an Employees report, 4.5

breadcrumbs, 4.5

columns, 4.6.2

end users, 5.2

functions, 4.6.1

links, 4.7

users, 2.4

workspaces, 2.3.2

Administration

Dashboards, 3.1

Manage Service, 3.1

Manage Users and Groups, 3.1

Monitor Activity, 3.1

Administration icon, 3.1 Administration Services,logging in to, 2.3.1 AnyCo Corp

about, 4.1

about building the application, 4

application

about Departments report, 4.3

about Home page, 4.2.1

adding company name, 4.11

creating, 4, 4.2

deploying, 5, 5.1

globalizing, 6

previewing, 4.2.1

running, 4.2.1

specifying a language preference, 6.1

Application Builder, 3.2 Application Express engine, 1.2 application overview of, 4.1 architecture, understanding, 1.2 Authentication scheme, about selecting, 4.2

B

breadcrumb, creating, 4.5

C

column

changing format, 4.6.4

creating, 4.6.2

column link

defining Link Text, 4.9.1

editing, 4.9.1

columns, adding, 4.3.1 company name, adding to application, 4.11 control break, adding, 4.4.4 Create Application Wizard, 4.2 creating

applications, 4, 4.2

breadcrumbs, 4.5

columns, 4.6.2

end users, 5.2

functions, 4.6.1

links, 4.7

user accounts, 2.4

workspaces, 2.3.2

D

database objects, viewing, 3.3.3

deleting, sample objects, 3.3.2.2

demo environment

accessing, 2.2

logging in to, 2.2.1

Departments report

changing value to link, 4.9.1

modifying the query for, 4.3

deploying

an application, 5

overview of, 5.1

deployment, about, 5 Developer toolbar

about, 4.2.1

about Application Id link, 4.5

developers, about user role, 1.4 development environment prerequisites, 2.1 development environment, accessing, 2 downloading sample objects, 3.3.1

E

embedded PL/SQL gateway, 1.2

Employees form, adding, 4.5

Employees report

adding, 4.5

adding a column, 4.6.2

adding a Department column, 4.8.1

adding a link, 4.7

adding list of values, 4.10

changing column format, 4.6.4

Create/Edit Employee form, 4.5.1

creating a function, 4.6.1

editing, 4.6

employees, sorting by department, 4.10 end user, about user roles, 1.4 end users, creating, 5.2 environment, setting up, 2.3

F

filter

deleting, 4.4.2

disabling, 4.4.2

editing, 4.4.2

function, creating, 4.6.1

G

global identification, specifying a method, 6.2

Globalization settings

Application Language Derived From, 6.2

Application Primary Language, 6.2

Automatic CSV Encoding, 6.2

H

Home page, adding links, 4.7

hosted demo environment, logging in to, 2.2.1

hosted environment

accessing, 2.2

signing up, 2.2

HR schema, installing, 3.3 Human Resources schema, installing, 3.3

I

importing sample objects, 3.3.2

installing, sample objects, 3.3

Instance administrator, about user role, 1.4

interactive report types

Alternative Report, 4.4.1

Primary Default, 4.4.1

Private Report, 4.4.1

Public Report, 4.4.1

interactive reports, 4.5

adding, 4.2

adding a column, 4.6.2

adding a column link, 4.9.1

adding columns from other tables, 4.3

adding controlled break, 4.4.4

changing column format, 4.6.4

changing sort order, 4.4.3

creating a filter, 4.4.2

creating a function, 4.6.1

editing, 4.6

resetting, 4.4.6

saving default, 4.4.1

single row view, 4.4.5

using, 4.4

L

language

method for determining, 6.2

preference, 6.1

Learn More button, 3.1 link

adding to Home page, 4.7

creating, 4.7

linking to another page, 4.9 local environment

logging in to, 2.3.3

setting up, 2.3

local instance

about, 2.3.3

logging in to, 2.3.3

logging in to

hosted demo environment, 2.2.1

local instance, logging in to

Application Express, 2.3.3

Oracle Application Express Administration Services, 2.3.1 logo, adding, 4.11

N

name, adding to application, 4.11

O

Object Browser

about Object Selection list, 3.3.3

about Object Selection pane, 3.3.3

viewing objects, 3.3.3

OEHR sample objects, 3.3, 3.3.1, 3.3.2

deleting, 3.3.2.2

Oracle Application Express

about, 1.1

about Application Express Administration Services, 2.3.1

about workspaces, 1.3.1

additional resources, 7.1

getting started with, 3

understanding the environment, 1.3

Oracle Application Express Listener, 1.2 Oracle Application Express, architecture, 1.2 Oracle HTTP Server (Apache), 1.2 Oracle Technology Network,accessing, 7.1 Order Entry schema, installing, 3.3 OTN, accessing, 7.1

P

Page Definition

about, 3.2

Page Processing section, 3.2

Page Rendering section, 3.2

Shared Components section, 3.2

pages

about, 3.2

linking to, 4.9

previewing, 4.3.1, 4.5.1, 4.6.3, 4.6.3

running, 4.3.1, 4.5.1, 4.6.3, 4.6.3

prerequisites, 2.1 previewing

applications, 4.2.1

pages, 4.3.1, 4.5.1

publishing application URL, 5.3

Q

query,modifying, 4.3

R

Region Definition, editing, 4.6.2

reports, 4.2

adding, 4.2, 4.5

adding a column, 4.6.2

adding a column link, 4.9.1

adding columns from other tables, 4.3

adding links, 4.7

changing column format, 4.6.4

creating a function, 4.6.1

editing, 4.6

resources

about, 7.1

Discussion forum, 7.1

How-to documents, 7.1

Quick tour, 7.1

training courses, 7.1, 7.1

Run Application icon, 4.2.1 Run Page icon, 4.2.1, 4.3.1 running

applications, 4.2.1

pages, 4.3.1, 4.5.1

S

sample application, building, 4

sample objects, 3.3

about, 3.3

about Human Resources schema, 3.3

about Order Entry schema, 3.3

checking space, 3.3.2.1

deleting, 3.3.2.2

downloading, 3.3.1

importing, 3.3.2

sample objects, installing, 3.3 sample objects, viewing, 3.3.3 single row view, 4.4.5 sorting employees by department, 4.10 space, checking available, 3.3.2.1 storage, checking available, 3.3.2.1

T

themes

about, 4.12

switching, 4.12

U

URL

determining, 5.3

publishing, 5.3

user interface, changing themes, 4.12 user privileges, about, 1.4 user roles

about, 1.4

developer, 1.4

end user, 1.4

Instance administrator, 1.4

workspace administrator, 1.4

users

relationship with schemas, 1.3.1

relationship with workspaces, 1.3.1

users accounts, creating, 2.4

W

web listener options

embedded PL/SQL gateway, 1.2

Oracle Application Express Listener, 1.2

Oracle HTTP Server and mod_plsql, 1.2

workspace administrators, about user role, 1.4 Workspace home page, about, 3.1 workspaces

about, 1.3.1

checking available storage, 3.3.2.1

creating, 2.3.2

relationship with schemas, 1.3.1

requesting space, 3.3.2.1

users, 1.3.1

Oracle Legal Notices

Copyright Notice

Copyright © 1994-2015, Oracle and/or its affiliates. All rights reserved.

Trademark Notice

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

License Restrictions Warranty/Consequential Damages Disclaimer

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

Warranty Disclaimer

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

Restricted Rights Notice

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

Hazardous Applications Notice

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Third-Party Content, Products, and Services Disclaimer

This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

Alpha and Beta Draft Documentation Notice

If this document is in preproduction status:

This documentation is in preproduction status and is intended for demonstration and preliminary use only. It may not be specific to the hardware on which you are using the software. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to this documentation and will not be responsible for any loss, costs, or damages incurred due to the use of this documentation.