6.4. Customizing the User Interface
The BRMS user interface is produced dynamically by the GWT framework. The user interface's appearance can be customized for branding or integration purposes by editing the images and CSS stylesheets.
The
.css
files and some of the images are found in the jboss-brms.war/org.drools.guvnor.Guvnor/
directory. (The remainder of the images are located in the images
sub-directory.) To access them, the WAR file must be deployed as an exploded archive as described in the BRMS Getting Started Guide.
Edit or replace the images and
CSS
files and leave the filenames unchanged. If problems are encountered, restore the original versions of the files from the WAR
archive.
Note
Red Hat recommends adding any modified files to a version control system for easy maintenance.
The change most commonly undertaken is to replace the branding images, these being the logo at the top of the screen and the "site favorites" icon (
hdrlogo_brms.gif
and drools.gif
respectively.)
The
Guvnor.css
controls the overall styling of the page elements.
Warning
The GWT components use several additional
CSS
files. Do not change these.
Customize the URLs used by the BRMS Platform by editing the deployment descriptor, namely
jboss-brms.war/WEB-INF/web.xml
. Use the same process as for any other Java web application.