Skip to content

Upgrading

Jeffrey Kemp edited this page Jul 23, 2019 · 16 revisions

If you are using an older version of the plugin and wish to upgrade to the latest version, review the notes below for the version you are upgrading to.


Release 1.0 (from any earlier version)

Version 1.0 represents a major rework of the beta versions of the plugin. This includes many changes to its attributes and behaviour. For this reason v1.0 has a different internal ID (COM.JK64.REPORT_GOOGLE_MAP_R1) to the v0.x releases.

After installing v1.0, the two versions of the plugin can safely co-exist to give you time to update your application.

Don't be intimidated. It'll probably be easier than the instructions below make it seem. Also, feel free to email me with any questions, and I will endeavour to respond within 24 hours with an answer.

  1. Take a backup of your application by exporting it, in case you get stuck and need to revert all the changes.

  2. Install the plugin (find your APEX version in the list below). It will be created as a new plugin (i.e. it will leave any pre-1.0 version unchanged).

    • Oracle APEX 18.2 or later: region_type_plugin_com_jk64_report_google_map_r1.sql

    • Oracle APEX 5.0.3 to 18.1 (backport): backport/region_type_plugin_com_jk64_report_google_map_r1_503.sql

  3. Set the Component Settings for the plugin (at minimum, the Google Maps API Key).

  4. Review the Utilization report (found under Shared Components / Plugins / Utilization) to see where the old version of the plugin is being used.

  5. On each page that uses the plugin:

    1. Right-click on the old plugin region and select Duplicate.

    2. On the new region, change the region Type to JK64 Report Google Map R1 [Plug-In].

    3. If you are using the backport version (for APEX 5.03 to 18.1), you can skip this step.

      If your region was based on a SQL query, set the new region Source Location to Local Database and Type to SQL Query. Copy your SQL query from the old region to the new region. Note: some query features are no longer supported (circle radius, etc) - review the SQL Query Examples for more information.

    4. Check for any plugin attributes that were unable to be duplicated from the old plugin to the new one, and set their corresponding attributes on the new region, where supported.

    5. Convert any Dynamic Actions to respond to the equivalent event for the new (R1) plugin. The event names haven't changed, but you will need to explicitly change each of them to the new ("R1") actions - refer to Plugin Events Reference for more information.

    6. Re-implement features that have changed (for example, Set Item ID on Click); some features now require using a dynamic action on the plugin. Review the Plugin Attributes Reference for more information on each attribute that has been changed.

    7. Delete the old map region.

    8. Test all features and behaviour related to the map region.

  6. Once you have deleted all references to the old version of the plugin, you can delete the old plugin itself from Shared Components / Plugins.


From version 0.9.1 or earlier to version 0.10

Requires Oracle APEX 5.0.4 or later.

Review the Release Notes for v0.10

You can’t perform that action at this time.