• 7.1

2013-09-23

Building Expressions

Expressions are built from the following components:

• Database Fields: You can add fields from your database into the Expression Editor, by double-clicking on the field in the "Data Fields:" list. Database fields are always surrounded by square brackets (e.g. : [FirstName])
• Variables: You can refer to any variable except the one that you are currently editing. Variables are always surrounded by the variable markers (e.g.: @MyVariable@)
• Constants: PrintShop Mail has a few constant values you can use such as "true" and "false".
• Functions: You can use functions to manipulate the data into many different ways. Functions are built from the function name followed by its parameters surrounded by parenthesis, such as FUNCTION(Param1,"Param2").
• Strings: You can add static text to the expressions. Static text is always surrounded by double quotes (e.g.: "Hello World!").
• Operators: You can manipulate data using operators such as mathematical operators (+, -, etc) and concatenations (&, AND, OR, etc).

You build your expression by adding these components so they work together. You can do this manually by starting to type any of the component's name in the Expression Edit field.

You can also add components to the expression automatically by using the function list, data field list and operators box below the Expression Edit field. For example, double-clicking on the PROPER() function will automatically add PROPER(Text) to your Expression Edit field.

The Expression Assistant

When using functions in your expression, you can use the Expression Assistant to help you fill in the function's parameters and values. To do this, click on the [...] icon next to the function name. You can also double-click on the function name in the Expression Edit field to open the Expression Assistant.

To help you to add the correct names of database fields, variables or functions, you can select those items from the pop up menu on the right hand side of the edit box.

The result of the function you created here, will be pasted into the Expression Edit field. For example: PROPER ([First name]).

Result and debugging

You can always see the result of the expression itself just under the Expression Edit field. If there are any errors in the expression or if your expression returns no result, this box will be empty. If the result is a constant such as PRINT or SKIP, or if it is a number, the result is always shown as a string of text in the Expression Results box.

If there is any error in your expression, a few things can happen:

• Database fields that do not exist will be shown in darker purple, and will be italicized.
• Functions that do not exist will remain in normal, black text.
• Parameters of the wrong type will be underlined and put in bold (example: putting a number in the PROPER() function, which expects a string)
• The Expression Result box will not display anything.
• An error will be displays in a small tooltip with a red X icon. This tooltip should explain the error in a basic way.

When you click OK to save the expression and close the Expression Editor, further validation is done, and any error will be shown in the Expression Edit field as a tooltip. The expression will not be saved until you correct the error and click OK again.

Variable Dependencies

You can use regular and global variables within your expression the same way you would use them in your document by entering the variable name surrounded by the variable marker (by default the @ symbol, e.g. @MyVariable@). If you attempt to use the name of a variable within its expression (such as entering @MyVariable@ while editing the MyVariable expression), this causes a "Deadlock" error, also known as a circular reference. This permits you to re-use expressions by calling their variable within another expression, as well as break up complex expressions into smaller parts.