API Management : CentraSite Developers Guide : Customizing CentraSite : Customization of CentraSite Business UI : Customizing Content Pages : Adding 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 custom configuration file.
2. Locate the Actions Configuration section under CLL Configuration.
This is a sample configuration snippet.
<CLLConfigurations>
<Actions>
<Action id="SaveAction" inbox="false" bulk="false" group="basic"
icon="images/system/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/system/actionbar/02_Edit.gif"
class="com.softwareag.centrasite.api.csom.action.impl.
EditActionImpl">INMCL_ACTION_EDIT
</Action>
<Action id="NewVersionAction" inbox="false" bulk="true" group="basic"
icon="images/system/actionbar/03_NewVersion.gif"
class="com.softwareag.centrasite.api.csom.action.impl.
NewVersionActionImpl">INMCL_ACTION_VERSION
</Action>
<Action id="DeleteAction" inbox="false" bulk="true" group="basic"
icon="images/system/actionbar/04_Delete.gif"
class="com.softwareag.centrasite.api.csom.action.impl.
DeleteActionImpl">INMCL_ACTION_DELETE
</Action>
...
</Actions>
</CLLConfigurations>
3. Append the required custom action (for example, Change Owner) configuration statement.
<Action id="ChangeOwnerAction" inbox="false" bulk="false" group="basic"
icon="images/system/actionbar/ChangeOwner.gif"
class="com.softwareag.centrasite.api.csom.action.impl.
ChangeOwnerActionImpl"> INMCL_ACTION_CHANGE_OWNER
</Action>
wherein,
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 com.softwareag.centrasite.api.csom.action.impl.Cha ngeOwnerActionImpl interface.
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 will internally identify 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 will simply display a plain text name.
The Actions Configuration section, now, looks similar to this.
<CLLConfigurations>
<Actions>
<Action id="SaveAction" inbox="false" bulk="false" group="basic"
icon="images/system/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/system/actionbar/02_Edit.gif"
class="com.softwareag.centrasite.api.csom.action.impl.
EditActionImpl">INMCL_ACTION_EDIT
</Action>
<Action id="NewVersionAction" inbox="false" bulk="true" group="basic"
icon="images/system/actionbar/03_NewVersion.gif"
class="com.softwareag.centrasite.api.csom.action.impl.
NewVersionActionImpl">INMCL_ACTION_VERSION
</Action>
<Action id="DeleteAction" inbox="false" bulk="true" group="basic"
icon="images/system/actionbar/04_Delete.gif"
class="com.softwareag.centrasite.api.csom.action.impl.
DeleteActionImpl">INMCL_ACTION_DELETE
</Action>
<Action id="ChangeOwnerAction" inbox="false" bulk="false" group="basic"
icon="images/system/actionbar/ChangeOwner.gif"
class="com.softwareag.centrasite.api.csom.action.impl.
ChangeOwnerActionImpl"> INMCL_ACTION_CHANGE_OWNER
</Action>

...
</Actions>
</CLLConfigurations>
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.
Copyright © 2015- 2016 Software AG, Darmstadt, Germany.

Product LogoContact Support   |   Community   |   Feedback