Configure Prioritization

Several things relating to the prioritization of Work Items can be customized from the system defaults. These include:

  • Priority Ranks

  • Priority Increment

Priority Ranks

When the standard Priority field of Work Items is used as the field for prioritizing Work Items, the priority of a Work Item is a float value between 0.0 and 100.0. The higher the number, the higher the item's priority. The value is used by the LivePlan engine along with other factors to calculate where Work Items fall in the project plan.

Polarion's default configuration provides priority ranks, which are simply text labels representing a priority range. The default values are:

  • Highest (minimum value 90)

  • High (minimum value 70)

  • Medium (minimum value 50)

  • Low (minimum value 30)

  • Lowest (minimum value 10)

Thus, an item with a Priority value of 75 has a priority rank of High, and an item with Priority value 49 is ranked Low, and so on.

You can change the total number of ranks (add or delete ranks), the rank labels, and the rank Minimum Value. For example, you might decide you don't need the rank Lowest, so you would delete that row in the configuration page and adjust the Minimum Value field of the other ranks.

End users see the result of this configuration in the Priority field of Work Items, and in the Prioritization sidebar of the Work Items table (used to reprioritize multiple Work Items at once).

Priority Increment

The Priority Increment value is used by Polarion when the position of an item in the table is changed by using the Up or Down buttons in the Prioritization sidebar, or by dragging, to place the item at the top or bottom position in the table. Such an item is assigned the numeric priority value of the item that formerly occupied the top/bottom position, plus or minus the configured increment value. The default increment value is 10. Thus, if a Work Item is moved to first position in the table, and the item that was in that position before has a priority value of 50, the moved item would get a new priority value of 60. If a different increment value is desired for such operations, system configuration can be modified to use a different Priority Increment value.

To change the default increment value, add the system property prioritizationModeIncrement to the system configuration file polarion.properties (follow link if you need the location). Set the property to an integer value. (As with any change to the system properties, the Polarion server must be restarted before the change takes effect.)

Examples: prioritizationModeIncrement=5 or prioritizationModeIncrement=20