Defining a rule phrase on the EmailPlus Rule tab
On the EmailPlus Rule tab, you can define a rule phrase based on the values in fields or based on field values that have changed.
About this task
Procedure
- From the <Field Name Selection> list, select a field name that is associated with a record type.
- From the <Comparison Operator> list, select a comparison operator.
- From the <Comparison Value> list,
select a comparison value, which is the value or list of values against
which the selected <Field Name Selection> is
compared by using the <Comparison Operator>.
A <Comparison Value> is not required when using IS NULL and NOT NULL comparison operators. String values must be in double quotation marks, for example "Project A".
Include a list of values as a comma-separated list with strings that are enclosed in double quotation marks. Enclosing strings in double quotation marks is important for values that contain spaces. For example enter "Project A", "Project B", "Project C" for a list of strings or 1, 2, 3 for a list of numbers. The <Comparison Value> can also be specified as a Perl expression that returns a value of the same type as the value specified in the <Field Name Selection> list. The expression can call a routine defined in your schema or an HCL Compass API call. For example, to send an email if the current user is the submitter, you could use the HCL Compass GetUserLoginName() API call to return the current user. You can add your own dynamic comparison values to the value criteria. For example, you could add your own function to the schema that returns date comparison values such as YESTERDAY or LAST_WEEK.
The following table lists the operators that you can use in the value criteria. The following table lists the operators that you can use in the value criteria.
When multiple value criteria conditions are specified, you can combine them by using theTable 1. EmailPlusRule record supported comparison operators Operator Description = Equal <> Not equal < Less than <= Less than or equal > Greater than => Greater than or equal IN The value criteria return TRUE
if the value of <Field Name Selection> is one of the values that are specified in the <Comparison Value> element. Otherwise, the value criteria returnFALSE
.NOT IN The value criteria return TRUE
if the value of <Field Name Selection> value is not one of the values that is specified in <Comparison Value>. Otherwise, the value criteria returnFALSE
.LIKE The value criteria return TRUE
if the value of <Field Name Selection> value contains the text that is specified in <Comparison Value>. Otherwise, the value criteria returnFALSE
. String comparisons are case sensitive.NOT LIKE The value criteria return TRUE
if the value of <Field Name Selection> value does not contain the text that is specified in <Comparison Value>. Otherwise, the value criteria returnFALSE
.IS NULL The value criteria return TRUE
if the value of <Field Name Selection> value is empty or has no value. Otherwise, the value criteria returnFALSE
. This comparison operator does not that require the <Comparison Value> contain a value.NOT NULL The value criteria return TRUE
if the value of <Field Name Selection> contains a value. Otherwise, the value criteria returnFALSE
.AND
orOR
logical operators. - Add a phrase to the rule condition to look for fields that
have changed in the Fields area. The rule condition
looks for fields that have changed. A rule phrase has three parts
- From the <Phrase Operand> list
that is outside the Fields area, select
AND
orOR
to look for changed fields. This operand combines the fields that are specified in Fields Changed with any value criteria phrases that are defined. Even if there are no value criteria, you must select a phrase operand to edit the input fields that are associated with this rule phrase. - From the <Fields Operand> list
that is inside the Fields area, specify the
combination of field changes to look for. You can select one of three
operands:
- Select ALL to specify that all the listed
fields in <Fields Changed> must have changed
for this phrase to be
TRUE
. - Select ANY to specify that at least one
of the listed fields in <Fields Changed> must
have changed for this phrase to be
TRUE
. - Select NONE to specify that none of the
listed fields in <Fields Changed> have changed
for this phrase to be
TRUE
.
- Select ALL to specify that all the listed
fields in <Fields Changed> must have changed
for this phrase to be
- In the Fields area, click More next to the Fields Changed field.
- In the Editor dialog box, select the field or fields on which to base this rule phrase from the Choice List list, and then click Add To to add them to the Selections list. Repeat this step for all the other fields that you want to use. Then, click OK.
- From the <Phrase Operand> list
that is outside the Fields area, select