Special Values

Special values are used within rules to reference values outside the issue, or to set specific values to aid in manipulating the issue.

EMAIL_IGNORE_GROUP

EMAIL_IGNORE_GROUP – This allows you to check or uncheck the checkbox that sends notification with the EMAIL_CUSTOMER field on the add and the edit screens. Normally this is the Guest or Customer Role. Set to a value of 'Y' to set the value to checked, or to a value of 'N' to set a value of unchecked. Use a preupdate rule such as:

if (SCREEN_NAME=’ADD’ && STATUS=’Fixed’)
  EMAIL_IGNORE_GROUP = ’Y’;
}

Valid values are ’Y’ and ’N’. Note that the value may be in upper or lower case.

GENERATE_EMAIL

GENERATE_EMAIL – This allows you to check or uncheck the checkbox that governs notification on the add and the edit screens. Use a preupdate rule such as:

if (SCREEN_NAME=’ADD’ && CATEGORY=’Undetermined’)
  GENERATE_EMAIL = ’N’;
}

Valid values are ’Y’ and ’N’. Note that the value may be in upper or lower case.

SCREEN_NAME

SCREEN_NAME – This has four possible values, ADD, EDIT, ADD_CONFIRMATION or MASS_UPDATE. This allows you to define a rule that will only be executed on the Add, Edit, Add Confirmation or mass update screens. For example:

if (SCREEN_NAME=’ADD’ && STATUS=’OPEN’) will execute the rule, only if you are adding an issue and the status is OPEN.

SYSDATE

SYSDATE – This provides a value of the current timestamp.

SYSDAY

SYSDAY – This provides the Date Value of the current time.

USER

USER – This references the current user.

USER_ROLE

USER_ROLE – This references or sets the current user role.

Setting the user role is only allowed under specific conditions:

  1. This will only work on the edit screen, not the add screen
  2. To set a new role to the current user, the current user must be able to adopt the new role. I.e., their user account must specify that they are allowed to adopt the new role as part of the user configuration.
  3. If the rule attempts to set a role to a role to which the user does not have permission, the role will be changed to the role identified by the behavior setting named LIMITED_USER_ROLE. Thus, you may still affect a role change to a user who has a single role defined, but this will typically be the Guest or Customer role.