Conversions in the ObjectServer is a handy way to provide for user-friendly text, often mapping numeric values to strings. These are then most commonly used for display on event lists. But what happens when you wish to customize conversions? If you guessed that you will need to update the conversions in the ObjectServer (log into OMNIbus Administrator -> Visual -> Conversions) , you would be only half-right. The reason for this is Web GUI intercepts conversions from the ObjectServer to provide multi-lingual support, thereby masking conversion values set in the latter.
For example, to correctly set custom conversions for Severity in Spanish, you will need to edit $TIPHOME/profiles/TIPProfile/installedApps/TIPCell/isc.ear/OMNIbusWeb GUI.war/WEB-INF/classes/ncw/nl/conversions_es.properties and set the correct values. See below for how the edited entries may look like.
priority.0=My custom val1
priority.1=My custom val2
priority.2=My custom val3
priority.3=My custom val4
...
Do this for as many language as you need by editing the corresponding language file. You'll need to restart the TIP server for this to take effect.
But what if you do not care about translations? Maybe you are only concerned with one language, and wish to maintain the conversion only in the ObjectServer? Continuing our previous example, you'll need to disable translation of conversions in Web GUI. You do this by commenting out the key-value pairs in the Spanish (conversions_es.properties) AND English (conversions.properties) translation files. This is needed because Web GUI will fall-back to English conversions if it fails to locate Spanish translations.
#priority.0=My custom val1
#priority.1=My custom val2
#priority.2=My custom val3
#priority.3=My custom val4
...
Once you've finished editing the files, restart TIP and you should see ObjectServer conversions take effect. You'll want to back-up your custom conversion files as these do get overwritten during upgrades (and possibly fix pack installs). Once you've upgraded Web GUI, re-apply the custom translations by copying entries from the old translation files to the new ones. Do not overwrite the new translation files with the old ones as they may contain new translations.
Also note that setting custom conversions via translation files in Web GUI will only work for default (non-customised) areas. Translations for any new customer-created conversions will not have translations in Web GUI, so the only way to customise these will be through ObjectServer.
Updated: conversion translation file location differ
from one release of WebGUI to another. Here's a list for Webtop 2.2, Web
GUI 7.3.0 and Web GUI 7.3.1
Webtop 2.2 & Web GUI 7.3.0 : $TIPHOME/systemApps/isclite.ear/Webtop.war/WEB-INF/classes/ncw/nl/
Web GUI 7.3.1: $TIP
HOME/profiles/TIPProfile/installedApps/TIPCell/isc.ear/OMNIbusWeb GUI.war/WEB-INF/classes/ncw/nl/
Tags:
webgui
Welcome to the Network and Service Assurance Blog, where you can read the perspectives from network and service assurance experts. This Blog provides insights into the network and service assurance solution, as well as technical details about specific IBM
Likes 3
