Installing Export Files

After you import an application and any related files into the target Oracle Application Express instance, the files are stored in the Export Repository. Next, you must install them.

You can install export files in the following ways:

  • After you import the export file, click the Install button and follow the on-screen instructions.

  • Import the export files into Application Builder and then install the files from the Export Repository.

  • Install the export files from SQL*Plus.

Tip:

You can simplify the steps needed to deploy an application by creating a packaged application. See "How to Create a Packaged Application".

This section contains the following topics:

Accessing the Export Repository

When you import an application and any related files into a target Oracle Application Express instance, the files are stored in the Export Repository.

To access the Export Repository:

  1. On the Workspace home page, click the Application Builder icon.

  2. Select an application.

  3. On the Tasks list, click Manage Export Repository.

    The Export Repository appears.

Tip:

You can also access the Export Repository by clicking Export Repository on the Tasks list on either the Application home or Application Builder home pages.

Installing an Application Export from the Export Repository

After you import an application export into an Oracle Application Express instance, you must install it before it can become active or available in Application Builder.

To install an application export from the Export Repository:

  1. Navigate to the Export Repository:

    1. On the Workspace home page, click the Application Builder icon.

    2. Select an application.

    3. On the Tasks list, click Manage Export Repository.

      The Export Repository appears.

  2. Select an application export and click Install in the Action column.

  3. Specify the following:

    1. Parsing Schema - Select a schema.

      This is the schema against which all of the application's SQL and PL/SQL will be parsed.

    2. Build Status - Select one of the following:

      • Run Application Only

      • Run and Build Application

      Select Run Application Only to run the application in the target instance and make it inaccessible to developers.

      Tip:

      If you select Run Application Only, the only way to change this setting after you import the application is to log in to Oracle Application Express Administration Services. See "Changing Application Build Status Set During Deployment" Oracle Application Express Administration Guide.
    3. Install As Application - Select one of the following:

      • Reuse Application ID from Export File

      • Auto Assign New Application ID

      • Change Application ID

      Use these options to avoid application ID conflicts. Use these options when you must have two versions of the same application in the same instance. For example, you might be migrating an application to a production instance and still need to maintain the development version.

    4. Click Install.

About Installing a Packaged Application

If you are installing a packaged application, the installer prompts you to install the packaged installation scripts. Follow the on-screen instructions.

Installing Other Files from the Export Repository

After you import files into an Oracle Application Express instance, you must install them before they can become active or available in Application Builder.

To install files stored in the Export Repository:

  1. Navigate to the Export Repository.

    1. On the Workspace home page, click the Application Builder icon.

    2. Select an application.

    3. On the Tasks list, click Manage Export Repository.

      The Export Repository appears.

  2. Select the file to be installed and click Install in the Action column.

  3. Follow the on-screen instructions and click the Install button.

Deleting Files from the Export Repository

You can delete a file from the Export Repository.

To delete a file from the Export Repository:

  1. Navigate to the Export Repository.

    1. On the Workspace home page, click the Application Builder icon.

    2. Select an application.

    3. On the Tasks list, click Manage Export Repository.

      The Export Repository appears.

  2. Select the file to be deleted and click Delete Checked.

Installing Export Files from SQL*Plus

You can also install export files from SQL*Plus. Note there are two restrictions:

  • The export file must originate from the same user database account as the one into which you are installing.

  • If the export file is an application, the application ID will be overwritten. Therefore, the target workspace must own the ID of the application being installed.

  • If the export file contains Supporting Object scripts, the scripts are not run when the application is installed. You can either log in to the Application Builder to install Supporting Objects, or copy the installation scripts to a standalone SQL*Plus script and run them from there.

This section contains the following topics:

Verifying If Source and Target Workspace IDs Are Identical

You can verify that the source and target workspaces are identical by running a query in SQL Command Processor.

To verify that the source and target workspaces are identical:

  1. Log in to the source workspace.

  2. Click the SQL Workshop icon on the Workspace home page.

  3. Click SQL Commands.

  4. Enter the following in the SQL editor pane and click Run:

    SELECT &WORKSPACE_ID. FROM DUAL
    
  5. Note the workspace ID.

  6. Log in to the target workspace.

  7. Repeat steps 2 through 5 to verify the workspace IDs match.

Using SQL*Plus to Install Export Files

To install Oracle Application Express export files from SQL*Plus:

  1. Log in to SQL*Plus.

  2. Run the export file.

    For example, if your export file is names f144.sql by default, you would type @f144 at the command prompt.