CentraSite Documentation : Working with the CentraSite Business UI : Administering the Business UI : CentraSite Business UI Pluggable Architecture : Installing an Extension : Configuring an Extension
Configuring an Extension
We have now created a Java project inside the Business UI web application. The extension functionality for the CentraSite Business UI is contained in the custom configuration file. You can configure this file to adapt to the appropriate extensions as required.
To configure an extension
1. On the file system, locate the custom configuration file.
2. Open the file in a text editor, and locate the configuration entry EXTENSION POINTS:
<Extensions src="">
<! --centrasitebuiextension/centrasitebuiextension.nocache.js -->
<ExtensionPointLogin custom="false" />
<ExtensionPointRegister custom="false" />
<ExtensionPointBrowseView custom="false" />
<ExtensionPointBrowseCriteria custom="false" />
<ExtensionPointSearchWidget custom="false" />
<ExtensionPointSearch custom="false" />
<ExtensionPointSearchCriteria custom="false" />
<ExtensionPointAssetDetails custom="false" />
<ExtensionPlaces protected="true">
<ExtensionPlace className=
"com.softwareag.centrasite.bui.client.place.home.ExtensionPlace"/>
</ExtensionPlaces>
</Extensions>
3. Specify the extensions file path as CentraSiteBUIExtension/centrasitebuiextension.nocache.js in order to point to the location of the Java script files.
4. Identify the extension point that you want to configure to the CentraSite Business UI.
5. Enable the extension point by modifying its custom value from “false” to “true”. The default value is “false”.
6. After making the above changes, the extension entry would look like this:
<Extensions src="centrasitebuiextension/centrasitebuiextension.nocache.js">
<ExtensionPointLogin custom="true" />
<ExtensionPointRegister custom="true" />
<ExtensionPointBrowseView custom="true" />
<ExtensionPointBrowseCriteria custom="true" />
<ExtensionPointSearchWidget custom="true" />
<ExtensionPointSearch custom="true" />
<ExtensionPointSearchCriteria custom="true" />
<ExtenstionPointAssetDetails custom="true" />
<ExtensionPlaces protected="true">
<ExtensionPlace className=
"com.softwareag.centrasite.bui.client.place.home.ExtensionPlace" />
</ExtensionPlaces>
</Extensions>
7. Save and close the file.
8. Locate the configuration file web.xml in the folder <CentraSiteInstallDir>\cast\cswebapps\BusinessUI\WEB-INF .
9. Open the file in a text editor, and locate the ExtensionServlet entry:
<servlet>
<servlet-name>ExtensionServlet</servlet-name>
<servlet-class>
com.softwareag.centrasite.ui.extension.service.ExtensionServiceImpl
</servlet-class>
</servlet>
 
<servlet-mapping>
<servlet-name>ExtensionServlet</servlet-name>
<url-pattern>/centrasitebuiextension/extensionService</url-pattern>
</servlet-mapping>
10. Uncomment the ExtensionServlet entry in order to enable the extension configurations that are performed in the previous actions. Similarly, if the extension configuration is already enabled and you want to disable it, simply comment out the ExtensionServlet entry.
11. Save and close the file.
12. Restart Software AG Runtime.
Note:  
The extension point's readme file is recommended for reading. The readme file is available in the <CentraSiteInstallDir>\demos\CentraSiteBUIExtension directory.
Copyright © 2005-2016 Software AG, Darmstadt, Germany.

Product LogoContact Support   |   Community   |   Feedback