Expression Dialog

Dialogs Overview

The expression dialog is used for specifying an expression for an expression type property.

The caption of the dialog will be displayed differently depending on the property to modify.

 

Expression

In this field, you can input and modify an expression. Enter the expression directly in the text box. You can directly input an expression or insert an expression by selecting from registered expressions and internal functions.
You can enter a keyword which expresses the objects ME, OTHER, HOLDER and PROJECT.

When a keyword is followed by a period, "." a drop down list (intellisense) will be displayed showing the properties available for use within that object.


In case of not-specified object, such as Child, Parent and so on, all properties are displayed with long names. (From Ver.9.0.0)


In an Enum type or a Boolean type, you can also enter a

==

!=

into the operator. At that time, a drop down list of possible values will be displayed.


IntelliSense display is filtered by the internal name, display name, or alias or properties or enumerations that include the entered text. (After Ver.12.0.2, Ver.13 restricted feature)

IntelliSense disappears if a special character other than an underscore is entered.

 

Hint display by data tip (From Ver.13)

Placing the mouse cursor over an object keyword, property, or internal function causes a description to be displayed in a data tip.

Object keyword (in the following example, ME)

 

Property (in the following example, ME.Operation.Order)

 

Internal function (in the following example, FValid)

 


Data tip during internal function input (From Ver.13)

When an internal function is input, the return value type and parameter type of that internal function are displayed in a data tip.

 

Sample display of partial selection (From Ver.13)

When part of an expression is placed in the selected state, only the selected part is evaluated and that result is displayed in the sample result.

 

 

Space trimming and saving of page breaks during editing

In versions earlier than Ver. 15.2, when a dialog is closed with the OK button, unnecessary single-byte spaces are deleted (trimming), and page breaks made during editing are not saved.
In Ver. 15.2 and later versions, when a dialog is closed with the OK button, unnecessary single-byte spaces are not deleted, and wraps made during editing are saved with newline code '\r’.
Therefore, in Ver. 15.2 and later, when a dialog is launched, the previously edited state is restored as is.


Comments

From Ver. 15.2, comments can be written in expressions as strings enclosed between /* and */. This part is ignored at runtime. The presence of comments does not affect the speed of evaluation of the expression.
However, you cannot set a comment-only expression.


Error highlighting

When entering an expression, if parts of the expression cannot be recognized correctly, for example

- a property name or function name is misspell. Eg. Customer instead of Customer
- the case of the property name is incorrect. Eg. Starttime instead of StartTime
- the number of brackets used is incorrect. Eg. (10 + (10 * 2) is missing one closing bracket

that part of the expression will be highlighted in red to show that it is invalid.
Please check for any possible errors in that part of the expression.

 

From Ver. 15.2, if a page break is inserted in the middle of a reserved word (e.g., ME, PROJECT), a property name, a string enclosed in single quotations, a date enclosed in #, a real number, or the like, this is treated as an error and the OK button cannot be pressed as a result.


Bracket matching shown in color

When using expression with many sets of brackets, each bracket will be shown in the same color as its matching bracket to clarify the pairing of brackets.

 

Starting an expression dialog box

The size of the text box area of the expression dialog can be changed by resizing the dialog window itself.
The dialog window can be resized in the same way as other windows by dragging the edges of the dialog to the desired size. The dialog window can be resized in the same way as other windows by dragging the edges of the dialog to the desired size.

 

Wrap display ( Ver.13 restricted features. )

Press the Wrap button for Wrapping display of an expression.


Wrap display of expressions is done according to the following rules.

A wrap is done after the newline character ('\n') in the expression.

 

A wrap is done before the logical operator && or || in the expression.

 

A wrap is done after a comma delimiting parameters of the internal function. When a wrap is done, another wrap is also done before the last parenthesis. An indent is made at the wrap.

 


Standard registered expressions

List of examples of expressions that can be used for the property to modify. You can insert the expression you selected in the Expression field by clicking on the Insert button while the expression is selected.

 

User registered expressions

List of examples of expressions that can be used for the property to modify. Expressions available as standard are listed under the "Standard registered expressions" tab and expressions registered by the user are listed under the "User registered expressions" tab. You can insert the expression you selected in the Expression field by clicking on the Insert button while the expression is selected.
You can also register newly created expressions in the user registered expressions list by clicking on the Register button in the dialog.

You can delete registered expressions by right-clicking on an expression to delete and selecting [Delete] from the popup menu.

 

Internal Functions

List of internal functions and user plug-in functions registered in Asprova. You can insert a setting example of the selected function in the Expression field of the dialog by selecting a function and clicking on the Insert button.

 

Font button

Specifies the font in a text box. This setting is saved in the Expression editor dialog font properties.

 

Use aliases/display names

When checked, displays the Expression field of the dialog in aliases / display names. If you enter a period ("."), the list of displayed properties will show aliases / display names, as well as internal names in parentheses.
For how to enter expressions when "Use aliases/display names" is checked, click here.

 

Insert

Inserts an expression selected from the list of registered expressions and internal functions at the position where the mouse is currently located in the Expression field of the dialog.

 

Clear

Clears the contents of the Expression field of the dialog.

 

Register

Registers the expression specified in the Expression field in the list of user registered expressions.

Clicking on this button will display the dialog below to input a name for the expression.Enter any name.
Clicking on the OK button will add the expression to the registered expressions under the name you specified.


If you enter a name that is already registered, the message below will appear.
Clicking on the OK button will overwrite the expression with the new expression.

 

Expand

Displays details about the expression that is already specified or currently being specified.

 

Less

Closes the details.

 

HOLDER

The object which this property belongs to.

 

ME

Shows the object indicated my ME in the context of the expression.
You can select which object to use as OTHER in order to check the outcome of the expression.
If the object you want to use is not listed in the select box by default, you can enter the code of the desired object into the select box to check it. The code you entered will be added to the contents of the list in the select box. (Closing the dialog will discard the code you entered.)
If the code entered cannot be recognized as a valid object to use for OTHER, a message explaining this will be shown.

 

OTHER

Shows the object indicated my OTHER in the context of the expression. It will be blank if OTHER cannot be used.
You can select which object to use as OTHER in order to check the outcome of the expression.
If the object you want to use is not listed in the select box by default, you can enter the code of the desired object into the select box to check it. The code you entered will be added to the contents of the list in the select box. (Closing the dialog will discard the code you entered.)
If the code entered cannot be recognized as a valid object to use for OTHER, a message explaining this will be shown.

 

Auto update

If the Auto update check box is selected, the sample result is updated immediately when the expression is changed or when the object selected from the drop-down list is changed. ( After Ver.12.0.4 )

 

Update

If the check box is not selected, click Update to update the sample results. ( After Ver.12.0.4 )
If sample updating takes a long time when the data is large or when the expression is complicated, you can clear the Auto update check box to edit the expression more smoothly.

 

Result data type Expression result on selected sample

Displays the type of data to be returned by the expression.

 

Expression result on selected sample

The expression entered using the objects selected from the ME and OTHER drop-down lists is evaluated, and the result is displayed.

 

OK

Confirms the setting.

 

Cancel

Cancels the setting.

 

For how to describe basic expressions, click here.



HelpNo.:737000
© Since 2019 Asprova Corporation, All rights reserved.