For many users the default installation may not match exactly their process requirements. There may be the need to have other priorities and severities defined, or the state model has to be modified. In this chapter it is outlined how to adapt the Track+ system to these requirements.
Entries for the defined priorities can be found in table TPRIORITY. The table carries three attributes, PKEY, LABEL, and SORTORDER. PKEY has to be a unique integer, and it is recommended to use the lowest available positive integers available. “Label” describes what the user sees unless the entry is being localized. So changing this label usually does not change what the user sees at the interface!
Adding a new priority means adding a new row to table TPRIORITY, for instance with a PKEY of 4, a LABEL of ”MyNewPriority” and SORTORDER of 0 to have the new priority appear at the top of the list where the user can select it. That would be it unless one wants to localize this label. Localization takes place via files WEB-INF/classes/resources/BoxResources xy.properties, where xy stands for your locale (”en” for English, ”de” for German, ”no” for Norwegian, “it” for Italian and so on. Look at your browsers language menu for more).
Here is an excerpt from the standard version of this file:
...
TCATEGORY.WorkPackage=Work Package
TPRIORITY=x; occasionally; soon; immediate
TPRIORITY.immediate=immediate
TPRIORITY.occasionally=occasionally
TPRIORITY.soon=soon
TROLE=x; Administrator; Developer; System Proving; PM; External;
Manager; Responsible
TROLE.Administrator=Administrator
...
We need to add a new line which looks like this:
TPRIORITY.MyNewPriority=My new Priority
If we want to change priority “soon” to “fast” we change this line:
TPRIORITY.soon=fast
The same procedure holds true for all entries except for the TSORT entry. The state table has an additional attribute called STATEFLAG. This integer indicates if a state belongs to category ”open” (STATEFLAG=0) such as “opened”, “analyzed”, etc., category ”closed” (STATEFLAG=1) such as ”closed” or ”suspended”, or category ”ready for final test or closing” (STATEFLAG=2).
The localization of TSORT pertains to the sort order box in the report configuration menu; it is not related to any database table. Lines of the form TXYZ=xyz are legacy entries. This format should has been deprecated and should not be used any more.