The WSO2 SOA Enablement Server Administration Console (SSAC) is based on a Java/XML Web framework. The logic of the web application is coded in Java and the design is handled separately through XSLT. Pages are made from components represented in a tree structure. Each component is rendered as XML. The DTD is located in:
WASP_HOME/app/system/console/webroot/wf.dtd.
Output XML from Web framework is converted to HTML by an XSLT 1.0 processor. SSAC uses the Xalan (http://xml.apache.org/xalan-j/) XSLT parser by default. Version 2.5.1 is included in WSO2 SOA Enablement Server.
In XSLT you can:
Remove a component (tab, button, group) from the rendering.
Change texts in pages.
Change graphic, fonts, colors, etc.
You cannot:
Add new functionality.
Change the page flow logic.
If you want to modify the console style sheets, edit WASP_HOME/app/system/console/WASP-INF/console_config.xml.
It is best to disable the XSLT cache and enable writing of the current page as XML. This way, WSO2 SOA Enablement Server does not need to be restarted after you modify the style sheets. Edit the <init> and <debug> elements in console_config.xml to read as follows:
<init clearStylesheetCache=true reloadConfig=false/> <debug display=false displayTimeInfo=false outputXMLPath=temp/debug.xml writeOutputXML=true/>
The XML Page is saved in WASP_HOME/app/system/console/temp/debug.xml after the first request. On the following response it is written with the current page.
Each page (task) has its own style sheet. The main console style sheet, named application.xslt, is in the WASP_HOME/app/system/console/console-xslt directory. Style sheets for specific tasks are in the WASP_HOME/app/system/console/console-xslt/task/directory. Descriptions of each page are also located there.
For example, the style sheet for the main page could be: <xsl:include href=task/MainTask.xslt/>
Top level components (header, footer of page, page title) are defined in WASP_HOME/app/system/console/console-xslt/application-layout.xslt.
Generic Web Framework style sheets are stored in the app/system/console/xslt directory. These include definitions of basic components, such as input fields, tables, groups and text areas.
You can extend the functionality of WSO2 SOA Enablement Server Administration Console (SSAC) without making changes in its source code. The structure of selected menus can be configured from the console configuration file (app/system/console/WASP-INF/console_config.xml) or console plug-ins config files.
Plug-ins to SSAC consist of:
JAR with application logic classes.
Plug-in configuration file that contains new page configuration, configuration of menus, services in use and optionally its style sheet location.
Optional Plug-in XSL style sheets.
Security web - Will be installed only if WSO2 SOA Enablement Server is installed with security. It adds security settings, permissions, roles and users management features to SSAC.
WSDL2Java Utility Service web - Web UI client for WSDL2JavaService.
Server Preferences web - Web UI client for server preferences.