4
Sample Orders Application

This document discusses the Mobile Development Kit for Palm sample application. Topics include:

• Overview

• Sample Orders Application Files

• Enabling the Sample Orders Application

• Installing the Sample Application on the Device

• Replicating the Data to the Device

• Using the Sample Application for the Palm Computing Platform

4.1 Overview

The Mobile Development Kit for Palm Computing devices includes a sample Orders application that demonstrates how to build a replication-enabled application using the Oracle Lite database and the Mobile Server.

The application's user interface contains a master list of orders, a detailed line item for each order, and a quantity confirmation for each line item. The sample application replicates the order data with two tables on the Oracle server. The sample also use an index to increase the speed of searches performed for each individual order's line items.

This release of the sample Orders application supports the Palm Computing devices and the Palm OS Emulator.

4.2 Sample Orders Application Files

The following files comprise the sample Orders application for Palm.

Table 4-1 Palm Computing Platform Files

Directory\File	Description
Oracle_Home\Mobile\SDK\palm\sdk\examples\cw\okDemo \okDemo.mcp	Sample application project file.
Oracle_Home\Mobile\SDK\palm\sdk\examples\cw\okDemo\ okDemo.prc	Compiled application file. Ready to install and run.
Oracle_Home\Mobile\SDK\palm\sdk\examples\cw\okDemo\Src	This directory contains the sample application source code files.

4.3 Enabling the Sample Orders Application

To use the Sample Orders application with the Palm OS Emulator:

• Drag the okdemo.prc file from the Oracle_Home\Mobile\SDK\palm\sdk\examples\cw\okdemo directory and drag it over the Palm OS Emulator.

4.4 Using the Sample Application for the Palm Computing Platform

The sample application uses the following forms:

• Main

• Order

• Item

4.4.1 The Main Form

When you start the application, the Main form displays. The Main form lists the orders in the database.

Figure 4-1 Main Form for Palm

4.4.2 Changing the Sort Order

To change the sorting column in the Main form, tap the header of the desired sorting column. The table is sorted by the selected column. Tap the arrow to the right of the table header to toggle between ascending and descending order.

4.4.3 The Order Form

To view information about a single order, tap the order item in the table. The Order form appears.

Figure 4-2 Order Form

The Order form displays the following information about the order:

• company name

• Order ID

• creation date

• description

• status

• list of order items (for the order)

To return to the Main form, tap the Done button.

To view or change an order item, tap the item in the list box. The Order Item form appears.

4.4.4 The Order Item Form

The Order Item form allows you to view and modify information about a specific item in the order.

Figure 4-3 Order Item Form

You can edit the following information in the Order Item form:

• quantity ordered

• quantity shipped

• quantity received

Tap the Save button to commit the changes, or the Cancel button to discard the changes, and return to the Order form.

4.5 Installing the Sample Application on the Device

Use the Install Tool from the Palm Desktop.

To install the sample application:

1. Start the Palm Install Tool from the Palm Desktop program group. The Palm Install Tool screen appears.

2. Click the Add button.

3. Select the okdemo.prc file from the Oracle_Home\Lite\pda40\palm\SDK\examples\cw\okdemo directory.

4. Click the Done button.

5. Place the device in the HotSync Cradle.

6. Press the HotSync button. The sample Orders application is installed on the device.

4.6 Replicating the Data to the Device

You must click the Sync button in the Mobile Sync Client on the Palm device prior to running okdemo.

Use "S11U1" as the Mobile Sync Client name and "MANAGER" as the password. Both the client name and the password are case-sensitive.