Customize Oracle Web Determinations

Customize Oracle Web Determinations

The styling of Oracle Web Determinations can be customized to suit your needs. Some simple changes can be done by modifying the messages.<locale>.properties file and the appearance.properties file. The default location for these files in a rulebase project is: \Release\web-­determinations\WEB-­INF\classes\configuration.

For information on more advanced customizations of Web Determinations, see the Oracle Policy Automation Developer's Guide.

Note: The default Oracle Web Determinations (OWD) user interface has a number of accessibility features (for more information, see Accessibility features in OWD). If you customize this user interface, you will need to perform your own checks to ensure that your modifications do not compromise the accessibility of your application.

What do you want to do?

Change the Oracle Web Determinations banner

Configure the Oracle Web Determinations labels

Change the appearance of a drop down list in Oracle Web Determinations

Change the locale list in Oracle Web Determinations

Change the Oracle Web Determinations banner

The Web Determinations banner is made up of an Oracle graphic (oralogo_small.gif) and the text "Web Determinations":

 

 

This banner can be modified to use a different logo and name.

Change the image in the Oracle Web Determinations banner

To replace the Oracle graphic:

  1. Save the new graphic as oralogo_small.gif in \Release\web-­determinations\WEB-­INF\classes\images.
  2. Build and run the rulebase to view the new image in the Web Determinations banner.

 

TIP: To hide the banner image completely, modify the 'show header image' setting in the appearance.properties file as follows:

show-header-image = false

Change the text in the Oracle Web Determinations banner

The "Web Determinations" banner text is defined in the 'application-name' setting in the messages.<locale>.properties file:

To change the text in the banner:

  1. Open the messages.<locale>.properties file using Notepad.
  2. Edit the 'application-name' configuration line, eg
    application-name = Income Assistance

  3. Save the file.
  4. Build and run the rulebase to view the new text in the Web Determinations banner.

TIP: To remove the banner text completely (eg if your image/logo contains the necessary text), modify the 'show application name' setting in the appearance.properties file as follows:

show-application-name = false

Configure the Oracle Web Determinations labels

The label text of all links and buttons (eg Save As, Load, Restart, Close, Yes, No, Submit, Add Instance, [Why?]) in Oracle Web Determinations can be modified in the messages.<locale>.properties file. For example:

 

 

Here the out-of-the-box label text for the boolean answers "Yes" and "No", has been replaced with "True" and "False" respectively.

To change the text of a label:

  1. Open the messages.<locale>.properties file using Notepad.
  2. Edit the appropriate configuration line for the text, eg
    boolean-true = True
    boolean-false = False

  3. Save the file.
  4. Build and run the rulebase to view the new label text in Web Determinations.

Change the appearance of a drop down list in Oracle Web Determinations

By default, drop down lists in Oracle Web Determinations are searchable. This means that the list of items is filtered based on the text that the user inputs.

Matches that take place at the start of the string will take priority over ones that occur somewhere else in the string and will be shown higher up in the list. Note that the text search is case insensitive.

 

 

To turn off searchable drop down lists in your project (making them render as normal HTML drop down lists):

  1. Open the appearance.properties file using Notepad.
  2. Modify the 'enable-searching-comboboxes' configuration line as follows:
    enable-searching-comboboxes = false
  3. Save the file.
  4. Build and run the rulebase to view the change in Web Determinations.

 

In searchable drop down lists you can configure the number of results displayed, the tooltip displayed for the trigger button, and the text displayed when the maximum number of results has been exceeded.

 

 

To change the maximum number of results to be displayed in the drop down list at any one time (the default is 10):

  1. Open the appearance.properties file using Notepad.
  2. Modify the 'max-search-results' configuration line as follows:
    max-search-results =20
  3. Save the file.
  4. Build and run the rulebase to view the change in Web Determinations.

Note that this number can have a substantial impact on performance - the lower the number is, the better the performance will be. Setting this number to 0 will cause all matching results to be displayed.

 

By default, the tooltip text that is displayed when the user hovers over the drop down trigger button is "Show all items". To change the tooltip text:

  1. Open the messages.<locale>.properties file using Notepad.
  2. Edit the 'searching-combo-trigger-tooltip' configuration line, eg
    searching-combo-trigger-tooltip =Show list

  3. Save the file.
  4. Build and run the rulebase to view the change in Web Determinations.

 

You can change the text that is displayed at the bottom of the drop down list when the maximum number of search results has been exceeded (by default it is "..."). To change this text:

  1. Open the messages.<locale>.properties file using Notepad.
  2. Edit the 'searching-combo-more-results' configuration line, eg
    searching-combo-more-results =Start typing text to see more options

  3. Save the file.
  4. Build and run the rulebase to view the change in Web Determinations.

Change the locale list in Oracle Web Determinations

The locale list that is displayed when running a translated rulebase in Web Determinations can be modified in the appearance.properties file as follows:

  1. Open the appearance.properties file using Notepad.
  2. In the locale list (under 'Locale listings for localizing your language selection') change the locale name, eg
    locale-en-NZ =English (New Zealand)
    could be changed to
    locale-en-NZ =English (NZ)
  3. Save the file.
  4. Build and run the rulebase to view the new locale text in Web Determinations.