Upgrading Plug-ins

To create an upgrade:

Increment the number of theversion attribute of the<identifier> element in plugin.xml.
Create a<migrate> element in upgrade.xml with ato-version attribute containing the new number.
Place the property and step-type elements that match the updated plugin.xml file within this element, as shown in the following example.

    <?xml version="1.0" encoding="UTF-8"?>
    <plugin-upgrade
            xmlns="http://www.&company;.com/UpgradeXMLSchema_v1"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
      <migrate to-version="3">
        <migrate-command name="Run SQLPlus script">
          <migrate-properties>
            <migrate-property name="sqlFiles" old="sqlFile"/>
          </migrate-properties>
        </migrate-command>  
      </migrate>
      <migrate to-version="4">
        <migrate-command name="Run SQLPlus script" />
      </migrate>
      <migrate to-version="5">
        <migrate-command name="Run SQLPlus script" />
      </migrate>
    </plugin-upgrade>

Of course, you can also make a script-only upgrade, that is, an upgrade that contains changes to the step's associated scripts and files but does not change plugin.xml. This mechanism can be useful for plug-in development and for minor bug-fixes/updates.