23.8 Installing Export Files

This section describes how to install export files.

Topics:

23.8.1 About 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 App 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 Also:

23.8.2 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 App Builder icon.
  2. Select an application.
  3. On the Application home page, click Utilities.
  4. Click Export Repository.

    The Export Repository appears.

23.8.3 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 App Builder.

To install an application export from the Export Repository:

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

    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.

      Tip:

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

See Also:

23.8.4 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 App Builder.

To install files stored in the Export Repository:

  1. Navigate to the Export Repository.
  2. Select the file to be installed and click Install in the Action column.
  3. Follow the on-screen instructions.

See Also:

"Accessing the Export Repository."

23.8.5 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.
  2. Select the file to be deleted and click Delete Checked.

See Also:

"Accessing the Export Repository."

23.8.6 Installing Export Files from SQL*Plus

You can also install export files from SQL*Plus. The export file must originate from the same user database account as the one into which you are installing.

The following restrictions apply for export files:

  • If the export file is a database application, then the application ID is overwritten. Therefore, the target workspace must own the ID of the application being installed.

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

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

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

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