25.3.2.6 Exporting Application Components

Create a Component Export to back up a component before editing it, or create an export that functions as a patch to another Oracle APEX instance.

Tip:

If you wish to export an application and some components, such as pages, that are not yet ready for testing, Oracle recommends you use Build Options to include or exclude various application components.

To export shared components or page components:

  1. Navigate to the Component Export page:
    1. On the Workspace home page, click the App Builder icon.
    2. On the App Builder home page, click Workspace Utilities.
    3. Click Export.

      The Export page appears.

      Tip:

      You can also access the Export page by selecting the application, Export/Import, and then Export.
  2. Click the Components tab.
  3. Under Export Components:
    1. Application - Select the application that contains the components to be exported.
    2. Export Format - Select a page format. Options include:
      • SQL - Export as a single SQL file containing all the selected components.

      • ZIP - export the selected components as a ZIP archive containing separate SQL files for each components.

        To learn more about the Zip archive, see Splitting Export Files into Separate Scripts.

    3. Include Installation files - Only displays if Export Format is set to ZIP. Options include:
      • On - Generates a ZIP archive including installation files specifically for the exported page (for example, install.sql, set_environment.sql and end_environment.sql).

      • Off - Generates a ZIP file without the installation files. As a best practice, Oracle recommends Off when saving the files to a version control system so that application installation files are not overwritten.

        Oracle recommends Off when saving files to a version control system so that application installation files are not overwritten.

    4. As of - Specify a time in minutes to go to back to for your export. This option enables you to go back in time in your application, perhaps to get back a deleted object.

      This utility uses the DBMS_FLASHBACK package. Because the timestamps to System Change Number (SCN) mapping is refreshed approximately every five minutes, you may have to wait that amount of time to locate the version for which you are looking. The time undo information is retained and influenced by the start up parameter UNDO_RETENTION (the default is three hours). However, this only influences the size of the undo table space. While two databases may have the same UNDO_RETENTION parameter, you are able to go back further in time on a database with fewer transactions because it is not filling the undo table space, forcing older data to be archived.

    5. File Character Set - Indicates the character set in which the export file will be encoded. When importing this file you will need to specify the same character set.
  4. Add Application Components:
    1. Click the Application Components tab.
    2. Use the navigation bar to search for components.
    3. Select the appropriate components and click Add to Export.
      The selected components display in the Components to Export region.
  5. Add Build Options:
    1. Click the Build Options tab.
    2. Use the navigation bar to search for build options.
    3. Select the appropriate build options and click Add to Export.
      The selected build options display in the Components to Export region.
  6. Review your selections.
  7. To remove selected components from the export, deselect the component in the Components to Export region.
  8. Click Export.
  9. Import the Component Export into the target instance.