Versioning a Custom Action Template
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 (that is, 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
1. In CentraSite Control, go to Policies > Action Templates to display the list of action templates.
2. Locate the most recent version of the custom action for which you want to create a new version.
3. From the context menu for the custom action, click Create New Version.
4. 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. |
