Rules Guide

CHAPTER 8

Installed Conditions

This chapter describes the conditions installed with your exteNd Director project.

For more information For information:

About how to use conditions and actions in the Rule Editor, see Rule and Macro Editors.
About accessing sources and supporting files, see Accessing condition and action sources.

Alphabetical list of conditions

Check Component Parameter

Description

Compares the portal component parameter value with a value you specify. If the comparison is true, the condition returns true.

Properties

Any property with the ^ character supports the !valueOf template construct. For more information, see Properties that support string templates.

Property	Description
Key ^	The name of the component parameter.
Compare	The type of comparison you want to make. Select from the dropdown list: For numeric values: use the various equal to, greater than, and less than conditions For text: use equal, begins, ends, and contains
Value ^	The value to which you want to compare the parameter.

Property

Description

Key ^

The name of the component parameter.

Compare

The type of comparison you want to make. Select from the dropdown list:

For numeric values: use the various equal to, greater than, and less than conditions
For text: use equal, begins, ends, and contains

Value ^

The value to which you want to compare the parameter.

Check Date

Description

Compares the current date with the date you specify and returns true if they are the same.

Properties

Property	Description
Date	The date you want to check against the current date. Click Pick Date to use a calendar tool to select a date: The << and >> buttons change the year The < and > buttons cycle through the months of the year

Check Date Within Range

Description

Returns true when the current date is within the specified range. If the date is out of range or if you don't specify a date for both start and end, the condition returns false.

Properties

Property	Description
Start Date	The start date of the range. Click the button to use a calendar tool to select a date.
End Date	The end date of the range. Click the button to use a calendar tool to select a date: The << and >> buttons change the year The < and > buttons cycle through the months of the year
Inclusive	Whether the start and end dates are considered part of the range: If selected, the dates are included—the current date must be greater than or equal to the start and less than or equal to the end If not selected, the current date must be greater than the start and less than the end

Property

Description

Start Date

The start date of the range. Click the button to use a calendar tool to select a date.

End Date

The end date of the range. Click the button to use a calendar tool to select a date:

The << and >> buttons change the year
The < and > buttons cycle through the months of the year

Inclusive

Whether the start and end dates are considered part of the range:

If selected, the dates are included—the current date must be greater than or equal to the start and less than or equal to the end
If not selected, the current date must be greater than the start and less than the end

Check Day

Description

Returns true when the current weekday is in the set of selected weekdays.

Properties

Property	Description
List of weekdays	Check one or more weekdays to select them.

Check For Cookie

Description

Returns true if the specified cookie is defined in the user's browser.

Properties

Property	Description
Cookie Name	The name of the cookie you want to find.

Check Month

Description

Returns true when the current month is in the set of selected months.

Properties

Property	Description
List of months	Check one or more months to select them.

Check Request Data

Description

Checks whether a parameter value in the request header matches a value you specify. If the comparison is true, the condition returns true.

Properties

Property	Description
Key	The name of a request parameter.
Value	The value to which you want to compare the parameter.
Condition	The type of comparison you want to make: For numeric values: use the various equal to, greater than, and less than conditions For text: use equal, begins, ends, and contains

Property

Description

Key

The name of a request parameter.

Value

The value to which you want to compare the parameter.

Condition

The type of comparison you want to make:

For numeric values: use the various equal to, greater than, and less than conditions
For text: use equal, begins, ends, and contains

Check Time

Description

Returns true if the current time is between the hours you specify.

Properties

Property	Description
hours of ... and ...	Select an hour from each of the two dropdown lists to specify the start and end of the time span.

Check User

Description

Compares the current user with the specified user based on the text of the user ID. If the comparison is true, the condition returns true.

Properties

Property	Description
User	A user ID defined in your server directory realm. If you are accessing an LDAP realm, use the distinguished name—for example: cn=user,ou=users
Condition	The relational operator for the comparison: The most useful comparisons are equal and not equal Greater than and less than comparisons are based on the ASCII values of the characters in the ID Starts with, ends with, and contains are less useful, since the condition compares the whole user ID (you can't specify part of an ID for the comparison)

Property

Description

User

A user ID defined in your server directory realm.

If you are accessing an LDAP realm, use the distinguished name—for example:

  cn=user,ou=users

Condition

The relational operator for the comparison:

The most useful comparisons are equal and not equal
Greater than and less than comparisons are based on the ASCII values of the characters in the ID
Starts with, ends with, and contains are less useful, since the condition compares the whole user ID (you can't specify part of an ID for the comparison)

Check User Group

Description

Returns true if the user is a member of the specified group in the authentication directory.

NOTE: Users can be assigned to groups in the DAC.

Properties

Property	Description
Group	A group name defined in your server directory realm. NOTE: If you are accessing an LDAP realm, use the distinguished name—for example: cn=managers,ou=management

Property

Description

Group

A group name defined in your server directory realm.

NOTE: If you are accessing an LDAP realm, use the distinguished name—for example:

  cn=managers,ou=management

Check User Property

Description

Compares the value of a user attribute for the current context with a value you specify in the condition property. Returns true if they are the same.

Properties

Any property with the ^ character supports the !valueOf template construct. For more information, see Properties that support string templates.

Property	Description
Key ^	The name of the user attribute.
Compare	The type of comparison you want to make. Select from the dropdown list: For numeric values: use the various equal to, greater than, and less than conditions For text: use equal, begins, ends, and contains
Value ^	The value to which you want to compare the attribute value.

Property

Description

Key ^

The name of the user attribute.

Compare

The type of comparison you want to make. Select from the dropdown list:

For numeric values: use the various equal to, greater than, and less than conditions
For text: use equal, begins, ends, and contains

Value ^

The value to which you want to compare the attribute value.

Check Whiteboard

Description

Returns true if the specified whiteboard key exists.

Properties

Any property with the ^ character supports the !valueOf template construct. For more information, see Properties that support string templates.

Property	Description
Whiteboard Key ^	The name of the whiteboard key.

Check Whiteboard Value

Description

Compares the value of the specified whiteboard key to a value based on the data type of the value in the whiteboard key. If the comparison is true, the condition returns true.

Properties

Any property with the ^ character supports the !valueOf template construct. For more information, see Properties that support string templates.

Property	Description
Value	The value to which you want to compare the whiteboard value. The condition will convert the value you specify to the data type of the whiteboard value. If the value can't be converted, the condition returns false.
Whiteboard Key ^	The name of the whiteboard key.
Condition	Select the relational operator for the comparison.

Check Whiteboard Value Is Empty

Description

Returns true if the value of a whiteboard key is null or an empty string ("").

Properties

Any property with the ^ character supports the !valueOf template construct. For more information, see Properties that support string templates.

Property	Description
Whiteboard Key ^	The name of the whiteboard key.

Check Workitem Value

Description

Compares a value you specify to a workitem document value and returns true if the values are the same.

Properties

Any property with the ^ character supports the !valueOf template construct. For more information, see Properties that support string templates.

Property	Description
Value	The value to use for the comparison.
Document ID ^	The document ID containing the property to compare with.
Document Property ID ^	The property ID for the compare value.
Condition	Select the relational operator for the comparison.

Usage

For use with a Rule activity or Rule link in the Workflow Designer.

See also

Workflow Designer chapter in the Workflow Guide

Default

Description

This condition does nothing—by returning false. If Default is the only condition in a When section, the actions for that case won't be executed.

Is Form Get Data Available

Description

Returns true if the request header contains parameters from an HTML form.

Is New Session

Description

Returns true if this is the first request for this user's session.

Save Cookies To Whiteboard

Description

Puts the cookies the browser has sent onto the whiteboard. Returns true if successful and false if an error occurs.

See also

Save Cookies To Whiteboard action

Save Form Get Data To Whiteboard

Description

Puts the query string from the browser on the whiteboard using the specified key. Returns true if successful and false if an error occurs.

See also

Save Form Get Data To Whiteboard action

Save Request Data To Whiteboard

Description

Puts the parameters in the request header on the whiteboard. The names of the request parameters are used as the whiteboard keys, and the values of the request parameters are their values. Returns true if successful and false if an error occurs.

See also

Save Request Data To Whiteboard action

Set Action Off

Description

Returns false. If it is the only condition in a When section, the actions for that case are not executed. If there are other conditions, the actions may or may not be executed depending on the values of the other conditions and the logical operators used.

Set Action On

Description

Returns true. If it is the only condition in a When section, the actions for that case are executed. If there are other conditions, the actions may or may not be executed depending on the values of the other conditions and the logical operators used.

Set Action On Or Off

Description

Returns true if the On? property is selected and false if it is not.

Properties

Property	Description
On?	Whether the condition returns true or false.

See also

Set Action Off and Set Action On conditions (just above)

PSQL Check For Column

Description

Executes a SQL query with a WHERE clause and returns true if the result set contains any rows. The SQL query is built from the condition's properties and looks like this:

  SELECT fields FROM table WHERE column condition value

Properties

Any property with the ^ character supports the !valueOf template construct. For more information, see Properties that support string templates.

Property	Description
User ID ^	The user ID expected by the database.
Column	The name of a column for the WHERE clause.
Database Name ^	The URL for the database. The format for the URL depends on the DBMS. For more information, see Properties that support database drivers and URLs.
Condition	A SQL comparison operator for the WHERE clause.
JDBC Driver ^	The Java class name for the JDBC driver. For more information, see Properties that support database drivers and URLs.
Fields	The columns to include in the result set. Use an asterisk (*) to specify all columns.
Value	The value you want to match in the WHERE clause.
Password ^	The password expected by the database. This is not necessarily the same as the portal user's password.
Table	The table for the SQL query.

SQL String

Description

Executes a SQL query and returns true if the result set contains any rows.

See also

SQL String action