If you need to modify a custom action template, you can create a new version of the existing template and make your changes to the new version. When you create a new version of a custom action template, CentraSite creates an identical copy of the existing template, and then you make your changes to the copy. (Note that the new version of the custom action template will get is own copy of the executable Groovy or Java file.)
Be aware that CentraSite does not automatically apply the new custom action template to policies that use existing versions of the custom action. Policies that use existing versions of the action will continue to use the versions that they have. If you want to apply the new version of the action to these policies, you must edit the policies (or create new versions of them) and replace the old version of the action with the newer one.
Similarly, modifying the parameter definitions in a new version of an action template will not affect the parameter definitions in any of the existing policies that use the action. Parameter definitions are specific to a version of the template.
When you create a new version of a custom action, be aware that:
You can only create a new version from the latest version of an action. For example, if an action already has versions 1.0, 2.0 and 3.0, CentraSite will only allow you to create a new version of the action from version 3.0.
Initially, the new version of the action will be identical to the version from which you created it (except for the system-assigned version identifier, which is always incremented by one).
CentraSite automatically establishes a relationship between the new version of the policy and the previous version. CentraSite uses this relationship to enforce rules related to versioned actions.
You can only create new versions of custom actions that exist on your instance of CentraSite (i.e., actions that you have added to CentraSite). You cannot create new versions of the predefined actions that are installed with CentraSite.
To version a custom action
In CentraSite Control, go to to display the list of action templates.
Locate the most recent version of the custom action for which you want to create a new version.
From the context menu for the custom action, click .
Modify the new version of the custom action as necessary and then save it.
Tip:
To make the new version of the custom action easy to distinguish
from earlier versions, consider appending the version number to the name of the
custom action. This will make the versions easier to tell apart when you view
or edit the action list for a policy.
