16.7 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 custom packaged application. See "How to Create a Custom Packaged Application".

Topics:

16.7.1 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. You can use the Export Repository to manage archived application exports, imports, and other files.

To access the Export Repository:

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

  2. Select an application.

  3. On the Application home page, click Utilities.

  4. Click Export Repository.

    The Export Repository appears.

16.7.2 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. See "Accessing the Export Repository".

  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 are 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" in Oracle Application Express Administration Guide.
    3. Install As Application - Select one of the following:

      • Auto Assign New Application ID

      • Reuse Application ID from Export File

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

16.7.2.1 About Installing a Custom Packaged Application

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

16.7.3 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. See "Accessing the Export Repository".

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

  3. Follow the on-screen instructions.

16.7.4 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. See "Accessing the Export Repository".

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

16.7.5 Installing Export Files from SQL*Plus

You can also install export files from SQL*Plus.

The following restrictions apply for export files:

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

  • If the export file is a database application, the application ID is 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.

  • If the export file is a Websheet application, the target workspace must have Websheet Database objects set-up.

  • If the export file is a Websheet application, the export file must be installed using the Websheet schema in the target workspace.

  • If the export file is a Websheet application, the application ID is overwritten.

Topics:

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