version-callbacks.adp

Delivered as text/html

Related Files

[ hide source ] | [ make this the default ]

File Contents

<master>
<property name="doc(title)">@page_title;literal@</property>
<property name="context">@context;literal@</property>


<p><listtemplate name="callbacks"></listtemplate>

<h3>Help</h3>

<p>
  Below is the list of available callbacks and the parameters they will be called with. Note that the parameters are sent as named parameters.
</p>

<p>
  For install, uninstall, and upgrade, the before/after part of the
  name refers to before or after the database create/upgrade/drop
  scripts have been run. For mounting and instantiating, well, that should be fairly obvious.
</p>

<p>
  For the upgrade callbacks, you should definitely check out the proc <a
  href="/api-doc/proc-view?proc=apm%5fupgrade%5flogic">apm_upgrade_logic</a>,
  which makes it very easy to handle the logic of which things to
  process depending on which version you're upgrading from and to.
</p>

<table cellspacing="1" cellpadding="4" style="background: #999999">
  <tr style="background: white">
    <th>Callback</th>
    <th>Parameters</th>
  </tr>

  <tr style="background: white">
    <td>
      before-install
    </td>
    <td>
      
    </td>
  </tr>

  <tr style="background: white">
    <td>
      after-install
    </td>
    <td>
      
    </td>
  </tr>

  <tr style="background: white">
    <td>
      before-upgrade
    </td>
    <td>
      -from_version_name
      -to_version_name
    </td>
  </tr>

  <tr style="background: white">
    <td>
      after-upgrade
    </td>
    <td>
      -from_version_name
      -to_version_name
    </td>
  </tr>

  <tr style="background: white">
    <td>
      before-uninstall
    </td>
    <td>
      
    </td>
  </tr>

  <tr style="background: white">
    <td>
      after-instantiate
    </td>
    <td>
      -package_id      
    </td>
  </tr>

  <tr style="background: white">
    <td>
      before-uninstantiate
    </td>
    <td>
      -package_id
    </td>
  </tr>

  <tr style="background: white">
    <td>
      after-mount
    </td>
    <td>
      -package_id
      -node_id
    </td>
  </tr>

  <tr style="background: white">
    <td>
      before-unmount
    </td>
    <td>
      -package_id 
      -node_id
    </td>
  </tr>

</table>