The expression builder dialog helps you develop an expression by displaying
field names, attachments, workflow groups for you to select. In addition,
if functions are appropriate in the expression, it displays the function
name and syntax.
To access the Expression Builder dialog, click Expression
Builder in any field where an expression is
permitted.
To build an expression
The name of the item for which you are building the expression displays
in the title bar of the window. Build the expression in the expression
area by inserting the names of existing fields and operators, and by typing
directly in the expression area.
To use the names of existing data fields, attachments, and workflow
groups in building the expression
Select the category (Data Fields, Attachments, Workflow Groups,
System field, Functions) from the list of options at the top of the
dialog.
Select an item from the list on the left.
Click Insert to insert the item
into the expression area at the bottom.
Click the appropriate buttons
to insert operators, parentheses, and the AND and OR operators in
the expression.
To type literals into the expression area, enter values in the appropriate
format: a string must be enclosed in quotes; array values must be
separated by commas (,) and surrounded by braces { }.
To use functions in the expression
Select Functions from the dropdown
list.
Select the appropriate category.
Select the appropriate function from the list in the right column.
Click Insert to insert the function
into the expression.
Edit the function parameters to include the appropriate values,
such as the name of a data field.
To define an expression for an attachment, click Browse,
then locate and insert a document, folder, or other file.
To define an expression for a workflow group, click Browse,
then locate and insert a user name.
You can also enter an expression using the "@" character
with a user ID or a field name.
Use the following syntax to assign the name of the user at the current
step to a selected workflow group that will process a subsequent step "@"+numbertostring(F_BoundUser)
You can also use the following syntax to specify a user name.
@<user-ID> where user-ID
is an integer constant. For example, @14
@<user-field-name>
where user-field-name can be one of the following:
- an integer field, single or array, that represents user-IDs
- a string field, single or array, that represents a user name or
a workflow group
TIP
When you browse for a document, folder, or file name, or a user or group
name, the selected item is inserted into the expression area in the
format required by the Process Engine.
NOTE The
Clear button deletes the contents of
the expression area.