1 Getting Started with Application Migration Workshop

Oracle Application Express Application Migration Workshop (Application Migration) 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.

1.1 Understanding How to Migrate a Microsoft Access Application

This section describes the process of migrating a Microsoft Access Application to Oracle Application Express.

1.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.

1.1.2 Preparation Checklist for Migrating Microsoft Access Applications

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

  • Oracle Application Express release 4.0 or later

    You must install Oracle Application Express 4.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 release 2.1 or later (available in English only)

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

    Note:

    SQL Developer release 4.1, which runs on Java Development Kit (JDK) 8, does not support the creation of connections to Microsoft Access. In order to migrate your Microsoft Access MDBs to Oracle, you need to use an earlier version of SQL Developer (for example, SQL Developer 4.0 and JDK 7).
  • Exporter tool release 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 "Exporting Microsoft Access Metadata."

    If you are using Oracle SQL Developer release 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.3 Analyzing Your MDB File in Microsoft Access

Tip:

Recent releases of Microsoft Access use a file format of *.accdb. In order to proceed with the migration process, you should convert those file formats to *.mdb using the Save As option.

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.4 About the Microsoft Access Migration to Oracle Application Express Forum

In addition to Oracle support, you can post questions on database migrations to the SQL Developer forum:

https://community.oracle.com/community/database/developer-tools/sql_developer

You can post questions on application migrations to the Oracle Application Express forum:

https://community.oracle.com/community/database/developer-tools/application_express

1.2 Understanding How to Convert an Oracle Forms Application

This section describes the process of converting an Oracle Forms application to Oracle Application Express.

1.2.1 About Creating 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.

1.2.2 Preparation Checklist for Converting Oracle Forms Applications

Before you begin the conversion process, you must:

  • Install Oracle Application Express release 4.0 or later

    You must install Oracle Application Express release 4.0 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.3 About the Oracle Application Express Forum

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

https://community.oracle.com/community/database/developer-tools/application_express