Skip to main content

Quick Upgrade Guide

When you already have an older version of AOP installed, follow this guide.

This guide will update the PL/SQL packages and the Oracle APEX plug-ins for AOP​

  1. Unzip the file you downloaded from https://www.apexofficeprint.com

  2. Update the PL/SQL API.

    • Go in APEX to SQL Workshop > SQL Scripts > Upload
    • Select file /db directory/aop_db_pkg.sql
    • Give it a name and click the Upload button.
    • Click the run icon for the script you just uploaded, confirm that the schema in the upper right-hand corner of the screen is correct and click Run Now.
    • All statements should be successful.

    The aop_db_pkg.sql file will update the AOP tables, PL/SQL API for the new version, and synonyms needed to use AOP. The synonyms will be set to point to the new version of AOP, but you can easily switch back to the previous version by changing the synonyms.

    Repeat the above for /db directory/aop_modal_pkg.sql The aop_modal_pkg.sql file will update the required components for the AOP Modal APEX plug-in.

  3. Import new versions of the plug-ins.

    • Go in APEX to App Builder > Your application > Shared Components > Plug-ins > Import
    • Be sure to select the directory that corresponds to the version of Oracle APEX you are using - NOT the version of AOP.
    • Select file /plugin/process_type_plugin_be_apexrnd_aop.sql (for the AOP Process type plug-in)
    • Select file /plugin/dynamic_action_plugin_be_apexrnd_aop_da.sql (for the AOP Dynamic Action type plug-in)
    • Select file /plugin/dynamic_action_plugin_be_apexrnd_aop_convert_da.sql (for the Convert Dynamic Action type plug-in)
    • Select file /plugin/dynamic_action_plugin_be_apexrnd_aop_modal.sql (for the Modal Dynamic Action type plug-in)
    • Enter the details of the AOP Server or in case the AOP Cloud is used the API key. If using the cloud version of AOP, make sure the API Key is set for each plug-in.
      An API Key is not necessary for on-premises installations.

That is it!

Optional you can also update the sample code​

  1. Update the Sample PL/SQL Scripts.

    • Go in APEX to SQL Workshop > SQL Scripts > Upload
    • Select file /db/aop_db_sample_pkg.sql
    • Give it a name and click the Upload button.
    • Click the run icon for the script you just uploaded, confirm that the schema in the upper right-hand corner of the screen is correct and click Run Now.
    • All statements should be successful.

  2. Update the AOP Sample Applications.

    • If you already installed an older version of the AOP Sample App, we recommend to remove it first.
    • Import the AOP Sample Apps you find in /app

For on-premises versions of AOP: Update the AOP Server​

  1. Stop the AOP executable.
  2. Copy the server folder from the install package to your AOP Server
  3. Restart AOP with the new executable