3 Running a Demonstration Application

Running an Application from Demonstration Applications

The simplest way to run a demonstration application is navigate to the Demonstration Applications page.

To run a demonstration application from the Demonstration Applications page:

1. Log in to Oracle HTML DB as described in "Logging in to Oracle HTML DB".

   The Workspace home page appears.

2. From the Workspace Administration list, select Review Demonstration Applications.

3. On the Demonstration Applications page, locate the application you wish to run.

4. In the Action column, click Run.

5. Enter the appropriate username and password and click Login

   • For User Name, enter either demo or admin

   • For Password, enter the name of the current workspace using all lowercase letters

Running an Application from the Workspace Home Page

Once you have installed a demonstration application, you can run it from Workspace home page.

To run a demonstration application from the Workspace home page:

1. Log in to Oracle HTML DB as described in "Logging in to Oracle HTML DB".

   The Workspace home page appears.

2. Locate the application you wish to run in the Applications list.

3. Click the Run icon to the right of the application name.

4. Enter the appropriate username and password and click Login

   1. For User Name, enter one of the following:

      • demo

      • admin

   2. For Password, enter the name of the current workspace using all lowercase letters.

About the Home Page

As shown in Figure 3-1, the Home page contains four regions:

• My Quota

• My Top Orders

• Sample Application 1.6

• Tasks list

My Quota demonstrates the use of a new SVG chart called a Dial Chart. This chart displays a value based on an underlying SQL statement. Although not demonstrated in this example, you can enable an asynchronous refresh by editing the attributes of any SVG chart.

My Top Orders is a simple report based on a SQL query. This report displays a subset of the information that appears on the Orders page. Users can link to order details by selecting the Edit icon.

Sample Application 1.6 is a simple HTML region that displays static text. You can create this type a region to display explanatory information to users.

Tasks list contains an Oracle HTML DB list with links to other pages in Sample Application. Links available on the Home page Tasks list include:

• About this Application links to an informational page that describes this application.

• Enter a New Order links to a wizard for creating a new order.

• Add a New Customer links to a form for entering new customer information.

• Add a New Product links to a form for adding a new product.

About the Customers Page

As shown in Figure 3-2, the Customers page enables users to view and edit customer information. The Customers page consists of two main regions:

• Customers

• Top Customers

Figure 3-2 Sample Application, Customers Page

Description of the illustration customer.gif

Customers is an updatable report for tracking customer information. This region is also based on a SQL query. To search for a customer, type a customer name in the Search for field and click Go. To sort by customer name, click the column heading. A Sort icon appears to the right of the heading, Customer Name. To update existing customer information, click the Edit icon.

Top Customers ranks customers by order amount. This report is based on a SQL query which returns top customers based on their orders.

About the Products Page

As shown in Figure 3-3, the Products page enables users to view and edit product information. The Products page consists of two main regions:

• Products

• Top 10 Products

Figure 3-3 Sample Application, Products Page

Description of the illustration products.gif

Products displays an updatable report for tracking product information. This region is based on a SQL query which makes use of a custom function for displaying images stored in the database. To sort by product category, click the column heading. A Sort icon appears to the right of the heading. To edit a product description, click the Edit icon. To add a new product, click the Create Product button at the bottom of the page. Users can export the data in the Products report to a spreadsheet, by clicking Export to Spreadsheet.

Top 10 Products is also a SQL report. This report outlines the top ten products based on quantities sold.

About the Orders Page

The Orders page (see Figure 3-4) enables users to view and edit customer orders. The Orders page contains two regions:

• My Orders

• Order by Day

Figure 3-4 Sample Application, Orders Page

Description of the illustration orders.gif

My Orders is an Easy Report which summarizes the current orders in the system. To sort a column, click the column heading. A Sort icon appears next to column heading. To edit an existing order, click the Edit icon. To add a new order, click the Enter New Order button.

Order by Day is a Calendar report. This report displays the amount of an order on its corresponding date in a calendar. Users can select a calendar entry to view order details.

About the Charts Page

The Charts page illustrates three of the several types of SVG charts available in Oracle HTML DB: cluster bar, pie chart, and stacked bar. To view a chart, select a chart type.

About the Admin Page

The Admin page only displays if you log in to Sample Application using the user name admin. Sample Application makes use of a custom authentication scheme that stores user names and obfuscated passwords in a table. The Manage Users page enables you to manage additional users.

Note the this custom authentication scheme does not utilize any user names or passwords associated with Oracle HTML DB developers.

Viewing Pages in Printer Friendly Mode

Clicking Print in the upper right corner of the page displays the current page in Printer Friendly mode. When in Printer Friendly mode, the HTML DB engine displays all text within HTML form fields as text.

To enable your application to display in Printer Friendly mode, you need to create and then specify a Print Mode Page Template on the Edit Application Attributes page.

About the Developer Toolbar

When you log in to Oracle HTML DB having developer privileges and run an application, a Developer toolbar displays at the bottom of every page. As shown in Figure 3-5, the Developer toolbar offers a quick way to edit the currently running page, create a new page, control, or component, view session state, or turn edit links on or off.

Figure 3-5 Developer Toolbar in Sample Application

Description of the illustration d_toolbar_149.gif

The Developer toolbar consists of the following links:

• Edit Application links you to the Application Builder home page. (See "Viewing a Page".)

• Edit Page accesses the Page Definition for the currently running page. (See "Viewing a Page".)

• New links to a wizard that enables you to create a new blank page, a component (report, chart, or form), a page control (region, button, or item), or a shared component (menu, list, or tab).

• Session links you to session state information for the current page. (See "Viewing Session State".)

• Debug runs the current page in debug mode. (See "Accessing Debug Mode".)

• Show Edit Links toggles between Show Edit Links and Hide Edit Links. Clicking Show Edit Links displays edit links next to each object on the page that can be edited. Each edit link resembles two colons (::) and appears to the right of navigation bar items, tabs, region titles, buttons, and items. Clicking on the link displays another window in which to edit the object.

Editing a Demonstration Application

There are two common ways to edit a demonstration application:

• From Demonstration Applications page, click Edit next to the desired application.

• If you are running an application, click Edit Application on the Developer toolbar.

The Application Builder home page appears. As shown in Figure 3-6, the Application Builder home page displays the current application name and application ID, last update date, and parsing schema.

Figure 3-6 Application Builder Home Page

Description of the illustration bldr_home.gif

You can run the current application, edit application attributes, create shared components, export and import information, or create a new page by clicking the one of the following:

• Run submits the pages in the current application to the HTML DB engine to render viewable HTML

• Edit Attributes displays the Edit Application Attributes page

• Shared Components links to a new page for building shared application components and user interface controls

• Export/Install links you to the Export Import Wizard

• Create Page links to a wizard for creating a new page

The Pages list displays at the bottom of the page. To access a specific page, select the page name. To search for a specific page number, enter a page number in the Find field and click Find.