1. End User's Guide
  2. Data Loading Wizard Examples

4 Data Loading Wizard Examples

You can import data into an Oracle Application Express application using an existing application Data Loading Wizard.

Tip:

To use the functionality described in this section, your application must be built with Data Upload capability. To learn more, see "Creating Applications with Data Loading Capability" in Oracle Application Express App Builder User’s Guide.

About Using the Data Loading Wizard

You can run a Data Load Wizard to upload data from a file or copy and paste data that you have entered directly into the wizard.

Applications with data loading capability enables you to directly import data into a table which has been configured by the application developer.

The Data Loading wizard for your application may have been built to include the ability to apply table lookup and transformation rules during the data upload process. Before the data is actually imported into the database, you can preview the data after all look up and transformation rules have been applied.

  • Table Lookups - These rules automatically map data in the import file or copy and paste field to data that is found in another table. For example, if the import file contains a department name for the DEPTNO column but the upload table requires a number for that column, use a table lookup rule to find the corresponding department number for that department name in another table.

  • Data transformation rules - These rules automatically perform formatting transformations such as changing import data to uppercase, lowercase, and so on. For example, if the import file includes column data with both upper and lowercase and the destination table requires all uppercase, data transformation rules can automatically insert only uppercase into that column during data upload.

Parent topic: Data Loading Wizard Examples

Importing Data from a File into Your Application

Use the Data Load Wizard to import data into your application from a file, such as a text file.

This procedure includes examples from the sample packaged application, Sample Database Application.

To upload data to your application, the application must have been built with Data Upload capability and the file must be formatted properly.

To upload data from a file:

  1. Run the sample packaged application, Sample Database Application.
  2. On the Customers page, click Upload Data.
    The Data Load wizard appears. Next, select how to upload data.
  3. For Import From, select Upload file, comma separated (*.csv) or tab delimited.
  4. Under Data Load Source:
    1. File Name - Browse to the file name containing the data to upload.

      Tip:

      To create a text file with sample data, copy and paste the data shown at the top of the page into a text file. If you use this sample data, remember to enter a comma (,) in the Separator attribute.

    2. Separator - Enter the column separator character. Enter a comma (,) for comma separators or \t for tab separators.
    3. Optionally Enclosed By - Enter a delimiter character.
      Use this character to delineate the starting and ending boundary of a data value. If you specify a delimiter character, Data Workshop ignores whitespace occurring before the starting and ending boundary of a data value. You can also use this option to enclose a data value with the specified delimiter character.
    4. First Row has Column Names - Select this option if your data contains column names in the first row.
    5. Optionally select Use Advanced Settings and configure the following attributes:

      • Decimal Character - Enter a decimal character to separate the integer and decimal parts of a number. To learn more, see field-level Help.

      • Group Separator - Enter a group separator to separate integer groups. Any non-numeric character can function as the group separator with a few exceptions. To learn more, see field-level Help.

      • Currency Symbol - If your data contains an international currency symbol, enter it here. See field-level Help for examples.

      • File Character Set - Select the file character set associated with the file to be uploaded.

      • Date / Number Formats to use - Select Use application standard format masks to use the Application Date and Timestamp formats during data loading or Provide custom formats for uploaded columns to input your own.

    6. Click Next.

      The Data/Table Mapping page appears.


      Description of data_table_mapping.png follows
      Description of the illustration data_table_mapping.png

  5. For Data/Table Mapping:
    1. Target Column - Indicates the destination column name. To change the column name, select a new column name from the list. To hide a column, select Do Not Load.
    2. Click Next.

    The Data Validation page appears showing the data to be inserted or updated after any table lookup and transformation rules have been applied.


    Description of validation.png follows
    Description of the illustration validation.png

  6. Review the data to be uploaded and click Load Data.

    The Data Load Results page displays:

    • Inserted Row(s) - This is the number of new rows uploaded to the table.

    • Updated Row(s) - This is the number of rows in the table updated with new information.

    • Failed Row(s) - This is the number of rows from the upload file that were not added or updated.

    • To be Reviewed Row(s) - This is the number of rows needing review.

  7. Click Finish.

See Also:

Parent topic: Data Loading Wizard Examples

Copying and Pasting Data into Your Application

Use the Data Load wizard to copy and paste data from a file, such as a text file.

This procedure includes an example from the sample packaged application, Sample Database Application.

To upload data to your application, the application must have been built with Data Upload capability and the pasted data must be formatted properly.

To upload data by copying and pasting:

  1. Run the sample packaged application, Sample Database Application.
  2. On the Customers page, click Upload Data.
    The Data Load wizard appears. Next, select how to upload data.
  3. From Import From, select Copy and Paste.
  4. Under Data Source Load:
    1. Copy and Paste Delimited Data - Copy the example comma-separated list shown in the Data Load Source dialog (First Name,Last Name,Street ...), and paste it here.
    2. Separator - Enter the column separator character. Enter a comma (,) for comma separators or \t for tab separators.
    3. Optionally Enclosed By - Enter a delimiter character. Use this character to delineate the starting and ending boundary of a data value.
    4. First Row has Column Names - Select this option if f your data contains column names in the first row.
    5. Optionally select Use Advanced Settings and configure the following attributes:

      • Decimal Character - Enter a decimal character to separate the integer and decimal parts of a number. To learn more, see field-level Help.

      • Group Separator - Enter a group separator to separate integer groups. Any non-numeric character can function as the group separator with a few exceptions. To learn more, see field-level Help.

      • Currency Symbol - If your data contains an international currency symbol, enter it here. See field-level Help for examples.

      • File Character Set - Select the file character set associated with the file to be uploaded.

      • Date / Number Formats to use - Select Use application standard format masks to use the Application Date and Timestamp formats during data loading or Provide custom formats for uploaded columns to input your own.

    6. Click Next.

      The Data/Table Mapping page appears.


      Description of data_table_mapping.png follows
      Description of the illustration data_table_mapping.png

  5. For Data/Table Mapping:
    1. Target Column - Indicates the destination column name. To change the column name, select a new column name from the list. To hide a column, select Do Not Load.
    2. Click Next.

      The Data Validation page appears showing the data that to be inserted or updated after any table lookup and transformation rules have been applied.


      Description of validation.png follows
      Description of the illustration validation.png

  6. For Data Validation, review the data to be uploaded and click Load Data.

    The Data Load Results page shows:

    • Inserted Row(s) - This is the number of new rows uploaded to the table.

    • Updated Row(s) - This is the number of rows in the table updated with new information.

    • Failed Row(s) - This is the number of rows from the upload file that were not added or updated.

    • To be Reviewed Row(s) - This is the number of rows needing review.

  7. Click Finish.

See Also:

Parent topic: Data Loading Wizard Examples