Import Operations

Description

A guide to using import operations and how to use the import genie in desktop applications.

Discussion

Alpha Anywhere can copy data from a variety of file formats into existing tables or a result table. For example, you have an ASCII file which contains customer information.

Import File (Character-Separated ASCII Format)
"001","Adams","555-8211"
"002","Baker","555-2211"
"003","Pertwee","555-8765"
"004","Phillips","555-4567"

You can import the file into an Alpha Anywhere table.

images/import_table.png

Alpha Anywhere's Import Builder supports a variety of file formats including:

  • Character separated ASCII
  • Table ASCII
  • Rich Text Format (RTF)
  • Damaged dBASE files
  • Microsoft Excel Versions 3 and 4
  • Lotus 1-2-3 Version 1 through 3

When you import a file, the result table is automatically added to the current database. If you want to import a (non-damaged) dBASE, dBASEIII, or FoxPro (v2.6 or before) file (*.DBF), you do not need to use the Import Card since dBASE is Alpha Anywhere's native file format. To add a dBASE / FoxPro file to the current database, switch to the Control Panel and select File > Add Table.

Alpha Anywhere supports the ADO Import Genie , which can import data from Microsoft Access, Microsoft SQL Server, MySQL, Oracle, or any other database for which an ADO provider or ODBC driver is available. The ADO Import Genie also imports data from the latest versions of Microsoft Excel spreadsheets. There is no limit on the number of records that can be imported.

To import a file:

  1. Click the Operations tab on the Control Panel.

  2. Click the New button. The Create New Operation dialog box appears.

  3. Select "Import records" in the Select Operation list.

  4. Optionally, click Create Using Genie to display the Import Genie.

  5. Optionally click Create to display the New Import Operation dialog.

    • 1. Optionally select ASCII File and click OK to display the ((|#Import_Builder|Import Builder)).

    • 2. Optionally select ADO/ODBC Data Source and click OK to display the ADO Import Genie.

      images/Import_Card.png

Import Builder 

  1. Select the type of file you are importing in the Import type list.

  2. In the Field names list indicate whether the import data contains field names and whether to use them by choosing either:

  3. "No field names"

  4. "Ignore field names"

  5. "Use field names"

    Replace all space " " characters in Field Names with underscore characters "_" before running the import.
  6. Select the file to import in the Import file field.

  7. Select whether you are importing into a New table or an Existing table.

  8. If you are importing into an existing table, optionally click Duplicate record settings... display the Duplicate Record Information dialog and to define how to handle duplicates.

  9. Enter the name of the resulting Alpha Anywhere table in the Result table field.

  10. If you are importing an ASCII file or a damaged dBASE file, click Import Properties to specify how fields and records will be delimited. You may also specify an Offset column in which you specify the starting point for each field.

  11. Click Suggest Table Structure to have Alpha Anywhere identify fieldnames, types, and sizes.

Adjusting the Result Table Structure 

At the bottom of the Import Builder is a table control used to determine the structure of the result table. This table control is similar to that in the Create Table Card, except it contains an Import column, in which you specify whether or not you want to include the field in the result table.

  1. By default all fields are imported; to stop a field from being imported, choose "No" in the Import column.

  2. For each field, set the values for Type, Width, and Dec (Decimal Characters).If you have created a table using the Table Editor (refer to Create a New Table ) you should already be familiar with these settings.

Select Records 

  1. Optionally, click the following button on the toolbar to open the Select Records dialog box and change the record selection.

    images/Select_Records_to_Summarize_button.gif
  2. Click the 'lightning' button to run the operation.

    images/Run_button.gif

Character-Separated ASCII Import Settings 

Your Character-Separated ASCII file may not be in the standard comma-delimited format. To import a file that is not in this format, you need to change the import settings.

This box has the following categories:

  • File header 

    The source file may have information at the beginning that you do not want to import. If so, you can specify how many lines or bytes to skip before the Import begins. A byte is equivalent to a single ASCII character. Use the Skip over spin box to specify the number of bytes or lines you want to skip; use the second box to indicate whether the Skip box refers to lines or bytes.

  • Delimiters 

    A character-separated file uses a special character to indicate where a data value ends and another begins. In most items, it is a comma (the default value). If the file you are importing uses a different character, enter it in the Field text box. Most character-separated files use a carriage return and line feed to indicate the end of a record, so that each record starts on a new line. However, you can use a different record delimiter; either type the character(s) directly in the Record Length field, or use its drop-down list box to specify the record delimiter character.

  • Options 

    If the source file has character fields preceded by blank spaces, check the Remove leading blanks box to remove the spaces when you enter the data in the Result database.

ASCII Table and Damaged dBASE File Import Settings 

Both dBASE files and Table ASCII files are fixed record length files. This means that each record contains exactly the same number of characters, and in cases where fields are not completely filled, they are padded with spaces. This assures that each row (record) ends at exactly the same position. For example, you may have an import file which looks like this:

NAME

PHONE

John Smith

555-1892

Trey Adams

555-1122

Judith Anderson

555-1212

Frank Fizz

555-1211

When you select the import file, Alpha Anywhere examines its structure and determines how to divide the file's data into the appropriate records and fields. Sometimes Alpha Anywhere cannot correctly determine these settings, and data is imported incorrectly. In these cases, you need to manually specify how to divide the file's data.

There are two ways to specify these criteria. If you already know the starting point and width for each of the fields in the file, you can type these values into the table control at the bottom of the Import Card. Use the Offset column to specify the field's starting point and the Width column to specify the field's width.

If you do not know the starting point and width of the fields in the file, you can graphically set these criteria using the Table-by-example interface in either the Import Damaged dBASE File dialog box or the Import ASCII Table File dialog box, depending on the type of file you are importing.

images/Import_Damaged_Dbase_File.gif

To use this control, specify the number of characters to skip by adjusting the Skip over spin box until the first character of the first field of the first record appears at the top left corner of the Table-by-example control.

images/Import_Damaged_Dbase_File_2.gif

Next adjust the record length in the Record Length spin box until each row is neatly aligned with the other rows. Picture

images/Import_Damaged_Dbase_File_3.gif
If you cannot get the data to line up properly, the records are not of a fixed length and the file is incompatible with the Alpha Anywhere Import Builder. To correct this, open the file in a word processor or text editor and make manual edits by adding spaces so that the data is aligned.

The last step is to graphically set the starting and ending points of each field. The Table-by-example control has vertical divider lines that indicate the starting and ending point of each field. When you first open the dialog box, Alpha Anywhere guesses as to where the divider lines should be placed.

images/Import_Damaged_Dbase_File_4.gif

These lines can be adjusted in the following way:

  • To change the position of the last divider line on the right, click the position on the ruler at which the records end.

  • To move a divider line, click and drag the diamond at the top of the line. The last divider line has a square on it, and cannot be dragged.

  • To insert a new divider line, click the position on the rules at which you want to insert it.

  • To remove a divider line, click in the region to the right of the line, then press Delete.

When you have finished each of the fields should be separated with a divider line, and you can import the file correctly.

Using the Import Genie 

  1. Click Next > to continue.

  2. Select the File type to import. the options are:

    • "ASCII text file"
    • "Excel spreadsheet"
    • "1-2-3 spreadsheet"
  3. Click Next > to continue.

  4. Navigate to and select the file you wish to import using the input file selector bar.

  5. Click Next > to continue.

  6. Specify whether you are going to import the data into a new table or an existing table. If an existing table, enter the table's name.

  7. Click Next > to continue.

  8. In the case of ASCII file import, indicate whether the data is Character delimited or in Table form.

  9. Optionally, check Strip leading blanks if you need to trim character fields.

  10. Optionally, check Do not import first and specify how many lines to skip. You might use these options to avoid importing field names.

  11. Click Next > to continue.

    images/UG_Import_Genie_5.gif
  12. In the case of character delimited fields, indicate how the fields are identified.

  13. Click Next > to continue.

    images/UG_Import_Genie_7.gif
  14. If you selected to import the data into a new table, specify the name of the Result table.

  15. Click Next > to continue.

  16. Indicate whether you want to run the operation now, save the operation and then run it, or view the settings of the Import Builder.

  17. Click Finish.

  18. If you selected Run the Import operation now, (but first save the definition for future use), the Save import settings as... dialog box will appear.

  19. Enter the name of the operation into the Name field and click OK.

  20. If you selected Don't run the Import operation now, just show me how the genie has filled in the Import Builder, the Import Builder will appear.

  21. Optionally, click Save to display the Save import settings as... dialog box.

  22. Enter the name of the operation into the Name field and click OK.

  23. Optionally, click the Run button on the toolbar to run the operation.

Limitations

Desktop Applications Only

See Also