4 Data Loading Wizard Examples

End users can 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.

Applications with data loading capability enable end users 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.

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

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.
   
   
   Description of the illustration GUID-27A02801-6A1A-4D2E-B1CC-79AA53BFD4EB-default.png
   
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 the illustration GUID-C5E6675A-506E-4917-9683-8DD23129368A-default.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 the illustration GUID-9AC63457-3139-44D9-B1CD-75DC3799A1B4-default.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.

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

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.
   
   

   
   Description of the illustration GUID-1664458E-2D53-44CA-A3DE-297BE7A6116E-default.png

   
   
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 the illustration GUID-C5E6675A-506E-4917-9683-8DD23129368A-default.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 the illustration GUID-9AC63457-3139-44D9-B1CD-75DC3799A1B4-default.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.