1 Getting Started with Application Migration Workshop

Oracle Application Express Application Migration Workshop (Application Migrations) enables you to migrate a Microsoft Access application or convert an Oracle Forms application to an Oracle Application Express application.

This section provides a general description of the steps needed to migrate applications from Microsoft Access or Oracle Forms to Oracle Application Express to Oracle Application Express.

Topics:

1.1 About Migrating a Microsoft Access Application

You begin the migration process by exporting your Microsoft Access metadata using the Exporter tool and Oracle SQL Developer. After this initial step, you use Application Migration to review the retrieved objects and resolve any issues regarding invalid objects. As the final step, you have the option of generating either an application based on valid forms and reports or a maintenance application based on valid tables and views.

Once you have generated the application, you can take advantage of all the functionality in Oracle Application Express to further develop and enhance the migrated application.

Topics:

1.1.1 Preparation Checklist for Migrating Microsoft Access Applications

Before you begin the migration process, verify that your system meets these requirements:

  • Oracle Application Express version 3.0 or later

    You must install Oracle Application Express 3.0 or later. You use the Application Migration feature within Oracle Application Express to download the Exporter tool and to migrate Microsoft Access forms and reports to Oracle Application Express.

  • Oracle SQL Developer 2.1 or later (available in English only)

    You must install Oracle SQL Developer version 2.1 or later. You use the migration capabilities extension to migrate the Microsoft Access schema and data to Oracle.

  • Exporter tool version 10.2.0.2.5 or later (available in English only)

    You can install the Exporter tool using the Download Exporter link within Oracle Application Express. For instructions, see "Export Microsoft Access Metadata".

    If you are using Oracle SQL Developer version 2.1 or later, you can access the Exporter tool directly from the Migration menu.

  • Microsoft Access

    Your local system must have Microsoft Access installed, and it must be installed where the Exporter tool and .mdb file reside.

  • Microsoft Data Access Components (MDAC)

    Your local system should have the latest version of Microsoft Data Access Components (MDAC) installed. You can download the latest version from the Microsoft website.

  • Printer

    Your local system must have a printer installed so that a report can be opened in design view. This is a requirement for exporting your Reports information from an .mdb file.

  • Analyze your .mdb file before you export your database. Follow the instructions in the next section.

1.1.2 Analyze Your MDB File in Microsoft Access

Using Microsoft Access, you should analyze your .mdb file before you export your database. Performing these steps minimizes errors in the migration.

  1. In Microsoft Access, analyze the objects in your .mdb file:

    1. From the Microsoft Access menu bar, select Tools, Analyze, and then Documenter.

    2. Select the All Object Types tab, and then click the Select All button to select all the objects within the application for analysis.

    3. Remove or resolve any erroneous objects reported by the Documenter.

  2. Ensure the application contains no missing references:

    1. In Microsoft Access, launch the design IDE (press Alt+F11 keys).

    2. From the menu bar, select Tools and then References.

    3. Remove or resolve any missing references.

  3. Ensure the application compiles successfully:

    1. From the menu bar in the IDE view, select Debug and then Compile.

    2. Resolve any reported errors.

  4. Perform a compact and repair on the database:

    • From the menu bar in Microsoft Access, select Tools, Database Utilities, and then Compact and Repair Database.

  5. Ensure that all linked tables are valid links:

    1. From the menu bar in Microsoft Access, select Tools, Database Utilities, and then Linked Table Manager.

    2. Verify that all links are up-to-date and pointing to an existing .mdb file that is not read-only.

1.1.3 About the Microsoft Access Migration to Oracle Application Express Forum

In addition to Oracle support, you can post questions on the Database and Applications Migrations forum:

http://forums.oracle.com/forums/category.jspa?categoryID=27

1.2 About Converting an Oracle Forms Application

You begin the process by converting Oracle Forms metadata to Extensible Markup Language (XML). Then, you create a conversion project within Oracle Application Express. Once you have reviewed and edited the application metadata within the project, you generate an Oracle Application Express application. Then, you can customize your application and change application attributes or add new pages within Application Builder.

Topics:

1.2.1 Preparation Checklist for Converting Oracle Forms Applications

Before you begin the conversion process, you must:

  • Install Oracle Application Express version 3.2 or later

    You must install Oracle Application Express 3.2 or later to convert an Oracle Forms application to Oracle Application Express.

  • Install Oracle9i Oracle Developer Suite or later

    You must install Oracle Developer Suite to convert Oracle Forms applications and Oracle Reports to XML format. Specifically, you need:

    • Oracle Forms Builder

      You must have Oracle Forms Builder installed to access the Forms2XML conversion tool and the File Conversion utility for converting Oracle Forms application files.

    • Oracle Reports Builder

      You must have Oracle Reports installed, to convert Oracle Reports (including, binary (.RDF), ASCII (.REX), and .JSP) to XML format.

  • Convert Oracle Forms Metadata

    To start the conversion process, you convert:

    • Oracle Forms FormModule (.FMB), ObjectLibrary (.OLB), or MenuModule (.MMB) files to XML format using the Forms to XML conversion tool, Forms2XML

    • Oracle Reports (including, binary (.RDF), ASCII (.REX), and .JSP) to XML format using the File Conversion option in Reports Builder

    • PL/SQL library .PLL files to .PLD text files using the File Conversion option in Oracle Forms Builder

  • Associate Oracle Forms Schema with Oracle Application Express workspace

    You must ensure the schema associated with your Oracle Application Express workspace contains the database objects for your Oracle Forms application. Further information on Oracle Application Express workspaces and associating schemas is provided in subsequent chapters.

1.2.2 About the Oracle Application Express Forum

In addition to Oracle support, you can post questions on the Oracle Application Express Forum:

http://forums.oracle.com/forums/forum.jspa?forumID=137