6.2. Changing the User Interface Language

Procedure 6.1. Change the User Interface Language

  1. Edit the index.jsp file, which is located in the jboss-brms.war directory, to specify an alternative locale. The default index.jsp file uses United States English as the language.

    Example 6.1. The default index.jsp

    <%
     String redirectURL = "org.drools.guvnor.Guvnor/Guvnor.html";
     response.sendRedirect(redirectURL);
    %>
    
    To specify Japanese as the default language, edit the file as follows:

    Example 6.2. index.jsp with Japanese as the default language

    <%
     String redirectURL = "org.drools.guvnor.Guvnor/Guvnor.html?locale=ja_JP";
     response.sendRedirect(redirectURL);
    %>
    
    To specify Simplified Chinese as the default language, edit the file as follows:

    Example 6.3. index.jsp with Simplified Chinese as the default language

    <%
     String redirectURL = "org.drools.guvnor.Guvnor/Guvnor.html?locale=zh_CN";
     response.sendRedirect(redirectURL);
    %>
    
  2. Edit preferences.properties

    Edit the preferences.properties file to specify the required default country and default language codes. The preferences.properties file is located in the jboss-brms.war/WEB-INF/classes/ directory. The default preferences.properties file uses United States English as the language and the United States as the default country.

    Example 6.4. preferences.properties with US defaults

    drools.defaultlanguage=en
    drools.defaultcountry=US
    To specify Japanese as the default language, edit the file as follows:

    Example 6.5. preferences.properties with Japanese defaults

    drools.defaultlanguage=ja
    drools.defaultcountry=JP
    To specify Simplified Chinese as the default language, edit the file as follows:

    Example 6.6. preferences.properties with Simplified Chinese Defaults

    drools.defaultlanguage=zh
    drools.defaultcountry=CH
  3. Change the Date Format

    If multiple instances of the JBoss BRMS user interface are deployed with different languages specified, the format of the date must be changed so that each instance can correctly interpret the date. The following procedure can only be performed on new installations of JBoss Enterprise BRMS that do not include existing rules or test scenarios that include date values, as changing the format will corrupt existing date values.
    Specify the date format in preferences.properties.
    Change the date format from:
    drools.dateformat=dd-MMM-yyyy
    To:
    drools.dateformat=yyyy-MM-dd

    Note

    The change in format is only effective after the JBoss Enterprise BRMS server has been restarted.
An alternative language can be specified on a per session basis by manually entering the URL with the locale parameter included.