CentraSite 10.7 | CentraSite Developer's Guide | Customizing CentraSite | Customization of CentraSite Business UI | Customizing CentraSite Content Page | Extending Action Menu | Enable Action through Configuration
 
Enable Action through Configuration
After you define a custom action as an extension, you have to enable the custom action configuration so as to display the action in the CentraSite Business UI.
Important:
The action configuration parameters initially defined in the configuration file are editable and cannot be protected.
*To enable an action through configuration
1. Open the customization file, centrasite.xml, in a rich text editor.
You can find the centrasite.xml file on <CentraSiteInstall_Directory>\cast\cswebapps\BusinessUI\custom\conf.
2. Locate Actions under <CLL Configuration>.
The Actions snippet looks like this:
<Actions>
<Action id="SaveAction" inbox="false" bulk="false"
group="basic"
icon="images/custom/actionbar/01_Save.gif"
class="com.softwareag.centrasite.api.csom.action.impl.
SaveActionImpl">INMCL_ACTION_SAVE
</Action>
<Action id="EditAction" inbox="false" bulk="false"
group="basic"
icon="images/custom/actionbar/02_Edit.gif"
class="com.softwareag.centrasite.api.csom.action.impl.
EditActionImpl">INMCL_ACTION_EDIT
</Action>
.....
.....
<Action id="RuntimeAliasAction" inbox="false" bulk="true"
group="addRuntimeAction" applicable="policy"
icon="images/custom/actionbar/managerRuntimeAlias.png"
class="com.softwareag.centrasite.api.csom.action.runtime.impl.
ManageRuntimeAliasActionImpl">INMCL_ACTION_AddRuntimeAlias
</Action>
<Action id="AddGateway" inbox="false" bulk="true"
group="addRuntimeAction" applicable="policy"
icon="images/custom/actionbar/add_gateway_32X32.png"
class="com.softwareag.centrasite.api.csom.action.runtime.impl.
ManageGatewayActionImpl">INMCL_ACTION_AddGateway
</Action>
</Actions>
3. Append the property configuration statement for custom action. For example, Change Owner.
<Action id="ChangeOwnerAction" inbox="false" bulk="false"
group="basic"
icon="images/custom/actionbar/ChangeOwner.gif"
class="com.softwareag.centrasite.api.csom.action.impl.
ChangeOwnerActionImpl">INMCL_ACTION_CHANGE_OWNER
</Action>
The input parameters are:
Parameter
Denotes
Action id
A unique identifier for the action, in this example ChangeOwnerAction. It uniquely distinguishes an action in the CentraSite registry. If you want to reset the action at a later stage, you identify the action using this id.
class
The implementation class of interface:
com.softwareag.centrasite.api.csom.action.impl.ChangeOwnerActionImpl
INMCL_ACTIVITY
The i18n string to display the action in CentraSite Business UI.
If you want to specify a localized name, type the message ID starting with a prefix INMBU (in this example, INMCL_ACTION_CHANGE_OWNER). The action internally identifies the message ID, and display the localized name, if available in the message database. Else, if you specify a name without INMBU prefix, the action displays a plain text name.
The Actions snippet now looks similar to this.
<Actions>
<Action id="SaveAction" inbox="false" bulk="false"
group="basic"
icon="images/custom/actionbar/01_Save.gif"
class="com.softwareag.centrasite.api.csom.action.impl.
SaveActionImpl">INMCL_ACTION_SAVE
</Action>
<Action id="EditAction" inbox="false" bulk="false"
group="basic"
icon="images/custom/actionbar/02_Edit.gif"
class="com.softwareag.centrasite.api.csom.action.impl.
EditActionImpl">INMCL_ACTION_EDIT
</Action>
.....
<Action id="ChangeOwnerAction" inbox="false" bulk="false"
group="basic"
icon="images/custom/actionbar/ChangeOwner.gif"
class="com.softwareag.centrasite.api.csom.action.impl.
ChangeOwnerActionImpl">INMCL_ACTION_CHANGE_OWNER
</Action>

.....
<Action id="RuntimeAliasAction" inbox="false" bulk="true"
group="addRuntimeAction" applicable="policy"
icon="images/custom/actionbar/managerRuntimeAlias.png"
class="com.softwareag.centrasite.api.csom.action.runtime.impl.
ManageRuntimeAliasActionImpl">INMCL_ACTION_AddRuntimeAlias
</Action>
<Action id="AddGateway" inbox="false" bulk="true"
group="addRuntimeAction" applicable="policy"
icon="images/custom/actionbar/add_gateway_32X32.png"
class="com.softwareag.centrasite.api.csom.action.runtime.impl.
ManageGatewayActionImpl">INMCL_ACTION_AddGateway
</Action>
</Actions>
4. To enable an action entry for bulk usage, change false to true. Similarly, if the action is already available for bulk usage and you want to revert, set the value to false.
5. Save and close the configuration file.
6. Restart Software AG Runtime.