Condition Settings

Use the Conditions page to define conditions for a rule. When the conditions become true based on changes in the system, a notification is generated.

The following settings are available on the Conditions page:

Condition Comparisons

The following table describes each of the available comparisons, lists the applicable field types, and provides an example of how to use each comparison.
Note: Unless noted in the following table, comparisons for Sub-Relational fields are based on sub-fields. For example, the applicable comparisons for a Sub-Relational field with a Single Selection as its sub-type are the same as those for Single Selection fields.
Comparison Description Field Types Example
Added Becomes true if the new value of an object contains the item selected in the Value list and the previous value did not. File, Multi-Group, Multi-Selection, Multi-User, and URL.

Object = Change in Version(s)

Comparison = Added

Value = V4.5

A notification is generated when the value V4.5 is added to the Change in Version(s) field.

Added to Backlog Becomes true when items are added to a specific backlog in SBM Work Center. Any Item object (Primary items only)

Object = Any Work Item

Comparison = Added to backlog

Value = Sprint 1 Backlog

A notification is generated when any work item is added to the Sprint 1 Backlog.

Changes Becomes true when the selected object's value changes. Binary/Trinary, Date/Time (except Elapsed Time), File, Folder, Multi-Group, Multi-Relational, Multi-Selection, Multi-User, Numeric, Single-Relational, Single Selection, Text, URL, and User. Also Any Item, Note, and Attachment objects.

Object = Owner

Comparison = Changes

A notification is generated when the owner changes for an item.

Changes From Becomes true when a new value for the object changes from the selected value. Binary/Trinary, Folder, Multi-Relational, Single-Relational, Single Selection, Text, and User

Object = Engineer

Comparison = Changes From

Value = Laura Engineer

A notification is generated when the value of the Engineer field changes from Laura Engineer to another value.

Changes From (None) Becomes true when a field is given a value after it had no selected value. Binary/Trinary, File, Folder, Multi-Group, Multi-Relational, Multi-Selection, Multi-User, Numeric, Single Relational, Single Selection, Text, URL, and User.

Object = Customer

Comparison = Changes From (None)

Value = ACME

A notification is generated when the Customer field is given a value.

Changes To Becomes true when a new value for the object changes to the selected value. Binary/Trinary, Folder, Multi-Relational, Single-Relational, Single Selection, Text, and User

Object = Engineer

Comparison = Changes To

Value = Laura Engineer

A notification is generated when the value of the Engineer field changes to Laura Engineer.

Changes to (None) Becomes true when all values are removed from a field. Binary/Trinary, File, Folder, Multi-Group, Multi-Relational, Multi-Selection, Multi-User, Numeric, Single Relational, Single Selection, Text, URL, and User.

Object = Targeted Release

Comparison = Changes To (None)

With this condition, a notification is generated when a value is removed from the Target Release field. This may indicate that a work item is no longer planned.

Changes to Paused Becomes true when an item's Pause Status changes to Paused. "Any Paused/Unpaused Issue" object.

Object = Any Paused/Unpaused Issue

Comparison = Changes To Paused

Value = Paused by Demand Manager

A notification is generated when the value of the Pause Status field changes on an item to Paused.

Changes to Unpaused Becomes true when an item's Pause Status changes to Unpaused. "Any Paused/Unpaused Issue" object.

Object = Any Paused/Unpaused Issue

Comparison = Changes To Unpaused

Value = Approved by Demand Manager

OR

Value = Rejected by Demand Manager

A notification is generated when the value of the Pause Status field on an item changes to Unpaused because the item is approved or rejected.

Contains Becomes true if the current value of an object contains the selected value. This condition is evaluated for any records indicated as a change in the change history. File, Multi-Group, Multi-Relational, Multi-Selection, Multi-User, Single-Relational, Text , and URL

Object = Description

Comparison = Contains

Value = XML

A notification is generated when an item that contains the term "XML" in the Description field changes.

Deleted Becomes true when a value is removed from a field. File and URL Object = File

Comparison = Deleted

A notification is generated when a file is removed from a field.

Is Becomes true if the specified change is made to an item, or when the Transition operator is used, and the selected transition is executed. Any Item, Note, and Attachment objects, and Transition objects

Object = Attachment

Comparison = Is

Value = Added

A notification is generated when an attachment is added to an item.

Or:

Object = Transition

Comparison = Is

Value = Close

A notification is generated when the close transition is executed.

Is (None) Becomes true when the object has no specified value. Binary/Trinary, File, Folder, Multi-Group, Multi-Relational, Multi-Selection, Multi-User, Numeric, Single Relational, Single Selection, Text, URL, and User

Object = Customer Priority

Comparison = Is (None)

A notification is generated when the Customer Priority field does not have a value.

Is Not (None) Becomes true when the object is given a value. Binary/Trinary, File, Folder, Multi-Group, Multi-Relational, Multi-Selection, Multi-User, Numeric, Single Relational, Single Selection, Text, URL, and User

Object = Approver

Comparison = Is Not (None)

A notification is generated when a user is selected in the Approver field.

Is Equal To Becomes true when the value of the object is equal to the selected value. Binary/Trinary, Date/Time, File, Folder, Multi-Relational, Numeric, Single-Relational, Single Selection, Summation, Text, URL, and User

Object = Issue Type

Comparison = Is Equal to

Value = Bug Report

With this condition, a notification is generated when an item changes and the value in the Issue Type field is Bug Report.

Is Greater or Equal Becomes true when the value of the object is greater than or equal to the selected value. Numeric and Summation

Object = Price

Comparison = Is Greater or Equal

Value = 5.00

A notification is generated when an item changes and the value in the Price field is greater than or equal to 5.00.

Is Greater Than Becomes true when the value of the object is greater than the selected value. Date/Time, Numeric, and Summation

Object = Submit Date

Comparison = Is Greater Than

Value = 10/1/2011

A notification is generated when an item changes and the Submit Date is greater than 10/1/2011.

Is Less or Equal Becomes true when the value of the object is less than or equal to the selected value. Numeric and Summation

Object = Price

Comparison = Is Less or Equal

Value = 5.00

A notification is generated when an item changes and the value in the Price field is less than or equal to 5.00.

Is Less Than Becomes true when the value of the object is less than the selected value. Date/Time, Numeric, and Summation

Object = Submit Date

Comparison = Is Less Than

Value = 10/1/2011

A notification is generated when an item changes and the Submit Date is earlier than 10/1/2011.

Mentions Becomes true when a user is explicitly mentioned in a text field or note. The mention format is @user, where user is the user's login ID.
Note: By default, only Latin characters are allowed when mentioning users. To change the allowed character set, customize the ns.userismentioned.pattern property in the config.properties file, located on the SBM server that hosts the Notification Server:
installDir\SBM\Common\tomcat\
server\default\webapps\
notificationsrv\WEB-INF\classes
Any Field, Note

Object = Note

Comparison = Mentions

Value = (Current User)

A notification is generated when a note is added to an item that mentions the current user (for example, @bill or @bill@company.com).

Priority changed in Becomes true when the priority changes for any item in the specified backlog. Any Item object (Primary items only)

Object = Any Object

Comparison = Priority changed in

Value = Backlog Sprint 1

A notification is the priority changes for any item in Backlog Sprint 1.

Removed Becomes true if the specified value is removed from the field. Multi-Group, Multi-Selection, and Multi-User

Object = Change in Version(s)

Comparison = Removed

Value = V4.5

A notification is generated when the value V4.5 is removed from the Change in Version(s) field.

Removed from backlog Becomes true when any item is removed from the specified backlog. Any Item object (Primary items only)

Object = Any Item

Comparison = Removed  from backlog

Value = Sprint 1

A notification is generated any item is removed from the Sprint 1 backlog.