Creating a Data Load Wizard for Your Application with Oracle Application Express 5.1

Purpose

This tutorial shows you how to create a Data Loading Wizard for your application so that end users can add data into a table.

Time to Complete

Approximately 15 minutes

Background

Applications with data loading capability allow end users to dynamically import data into a table within any schema to which the user has access. To do this, end users run a Data Load Wizard that uploads data from a file or copies and pastes data entered by the end user directly into the wizard.

With Oracle Application Express 5.1, you can create a series of data load wizard pages in your application using the new Data Loading page wizard. The wizard allows you to add table lookups and transformation rules that are executed when the Data Load Wizard runs.

Context

In this tutorial, you create a DEPENDENTS table and EMP table, create an application with a report, use the Data Loading page wizard to create the Data Load wizard pages in your application that the end user uses to load the data. The Data Loading definition contains a table lookup for the relative name and a data transformation rule to make sure that Gender is stored in uppercase.

What Do You Need?

Before starting this tutorial, you should:

• Download and unzip the files.zip file into a working directory to use during this tutorial.
  
  

In this section, you upload a SQL Script and run it to create the DEPENDENTS table. To run the script, you should first log into your Oracle Application Express workspace and perform the following steps:

1. In the Application Express login page, enter the following login credentials and click Sign In:

   • Workspace: obe

   • Username: obe

   • Password: oracle

   

2. On the Oracle Application Express Home Page, select SQL Scripts from the SQL Workshop  menu.

   

3. Click Upload.

   

4. Click Browse.

   

5. Select dependents.sql from your working directory and click Open.

   

6. Click Upload.

   

7. Your script was uploaded successfully. Click the Run icon.

   

8. Click Run Now.

   

9. Click the View Results icon.

   

10. The script ran successfully. In the next section, you create the EMP table using a SQL script.

    

In this section, you upload a SQL Script and run it to create the EMP table. Perform the following steps:

1. From the SQL Workshop  menu, select SQL Scripts.

   

2. Click Upload.

   

3. Click Browse.

   

4. Select employees.sql from your working directory and click Open.

   

5. Click Upload.

   

6. Your script was uploaded successfully. Click the Run icon.

   

7. Click Run Now.

   

8. Click the View Results icon.

   

9. The script ran successfully. The result shows two errors because the EMP table and EMP_SEQ sequence did not exist when the DROP statements were executed. In the next section, you create an instant application and a report region on the Home page.

   

In this section, you create an instant database application and create an interactive report that shows all the data in the DEPENDENTS table. Perform the following steps:

1. From the  Application Builder menu, select Database Applications.

   

2. Click Create.

   

3. Change the Name field to Data Loading and click Create Application.

   

4. Click Create Application.

   

5. Your application was created successfully. You want to create a report region on the Home page. Click the Home icon.

   

6. Right-click Regions and select Create Region.
   

   

7. Type Dependents List for Title and select Interactive Report for Type.
   

   

8. Enter the following SQL SELECT statement and click the Save and Run Page icon.
   

    select FIRST_NAME,LAST_NAME,BIRTHDATE,RELATION,GENDER,RELATIVE_ID 
   from DEPENDENTS

   

9. Type a valid user name and password and click Log In.

   

10. The Home page displays the report. The reason you don't see any data is because the table is currently empty. In the next section, you use the Data Loading Page wizard to create a Data Load wizard. You will then use the Data Load wizard to load data into the DEPENDENTS table. After you load the data into the table, this report will display the loaded data. Click the Application link in the developer toolbar.

    

In this section, you use the Data Loading page wizard to create four pages in your application that an end user will run to load data into the DEPENDENTS table. Perform the following steps:

1. Click Create Page.

   

2. For Page type, click the Data Loading icon.
   

   

3. You need to specify the table you want to load data into and what columns uniquely identify the dependent in the table. In this case, the concatenation of FIRST_NAME and LAST_NAME uniquely identify a Dependent in the DEPENDENTS table. Specify and/or select the following and click Next.
   

   Data Load Definition Name	Load Dependents
   Table Name	DEPENDENTS
   Unique Column 1	FIRST_NAME (Varchar2)
   Unique Column 2	LAST_NAME (Varchar2)

   

4. You want to create a transformation rule to make sure that when the data is stored, the data for the GENDER column is stored in Upper Case. Specify and/or select the following and click Add Transformation.
   

   Column Name	Gender
   Rule Name	Uppercase Gender
   Type	To Upper Case

   

5. The transformation was created. Click Next.

   

6. You want to add a lookup for this data load. In this case, the relative_id should correspond to the id of the EMP table so that it is a valid employee of this dependent. Specify and/or select the following and click Add Lookup.
   

   Column Name	RELATIVE_ID
   Table Name	EMP
   Column Name(of key value)	EMPNO
   Uploaded Column	ENAME

   

7. The lookup for RELATIVE_ID was created, click Next.

   

8. The Data Load Wizard will contain the four pages as described in the Pages Attributes page. Click Next.

   

9. For Navigation Preference, select Identify an existing navigation menu entry for this page option. For Existing Navigation Menu Entry, select Home. Click Next.

   

10. If the user selects the Cancel or Finish buttons, the Home page should be displayed. For this, type 1 in the Cancel Button Branch to Page and Finish Button Branch to Page fields and click Next.

    

11. Click Create to create the wizard pages for the data load. In the next section, you test the Data Load Wizard pages that were created.

    

In this section, you test your data load wizard pages by loading some data. Perform the following steps:

1. Click Save and Run Page.

   

2. Type your login information and click Login.

   

3. You want to load the data using a tab delimited file. Click the Upload file option for Import From.

   

4. Click Browse.

   

5. Select the dependent_data1.txt file and click Open.

   

6. Click Next.

   

7. Notice that there are some values for the GENDER column that are lower case and that the values for RELATIVE_ID are the employee names that the dependents are relatives of. When you click Next, the Lookup and Transformation Rules will be applied. Click Next.

   

8. Notice now that all the values for GENDER are uppercase and the EMPNO of the relative is applied for each ENAME that is found in the EMP table. Notice that there are two names it did not find so an error will be generated when the Load takes place. Click Load Data.

   

9. Notice that 9 rows were inserted and the 2 rows for the lookup that were not found failed. Click Finish.

   

10. The Home page is now displayed and the report contains the data that you just loaded.
    

    

11. This time you want to use the Copy and Paste option instead of uploading a file. Click Copy and Paste.

    

12. Open the dependent_data2.txt file and copy the entire contents of the file to your clipboard (ctrl+c).

    

13. Paste the contents into the Copy and Paste Delimited Data area, make sure the First Row has Column Names is still checked and click Next. Note that the third column name is set to BIRTHDAY instead of the column name in the DEPENDENTS table which is BIRTHDATE.

    

14. Because the column name did not match, you need to select the column name from the list. Select BIRTHDATE from the list for the third column.

    

15. Click Next to apply the lookup and transformation rule.

    

16. Notice the values for GENDER are in uppercase and all the EMPNO values were found in the EMP table. All the data will be inserted and one row will be updated because it had the same FIRST_NAME and LAST_NAME as the previous load. Click Load Data.

    

17. The data load results are displayed. Click Finish to return to the Home page.

    

18. The report is updated with the additional and revised data. In the next section, you review the data load definition. Click the Application link in the developer toolbar.

    

In this section, you review the Data Load definition so that if desired, you can make changes. Perform the following steps:

1. Notice that four Data Load pages were created in your application. To see the Data Load definition for these pages, Click Shared Components.

   

2. Under Data References, click Data Load Definitions.

   

3. Click the Load Dependents definition.

   

4. The definition is displayed. Note that you can create or modify any existing Table Lookups or Transformation Rules from this page.

   

• Oracle Technology Network Application Express Home Page

• Oracle Application Express Learning Library