Expressions Overview

<< Click to Display Table of Contents >>

Raynet One Data Hub > 14.0 > Dashboards and Reports Customization Guide > Designing Reports > Use Expressions 

Expressions Overview

Use expressions to accomplish the following tasks:

 

Retrieve data

Format data values

Create calculated fields

Calculate summaries

Specify conditions for report elements

Specify conditions for data source queries

 

How to Specify an Expression

In the Report Designer, properties that support expressions have an ƒ button in the Properties panel. Click this button to specify an expression in the invoked Expression Editor.

 

eurd-web-f-button

 

In Expressions Advanced mode, the Report Designer allows you to specify expressions that are evaluated within specific events:

 

The BeforePrint event where you can use data fields from all queries in the data source.

The PrintOnPage event fetches the number of pages in the report and the current page. You can use these variables to specify conditions for report items.

 

See the following topic for more information: Data Binding Modes.

 

Expression Editor

The Report Designer's Expression Editor has a graphical interface that allows you to create and edit expressions.

 

eurd-web-expression-editor

 

Use one of the following ways to invoke the Expression Editor:

Select a report, band, or control. The ƒ button appears next to the selection. Click this button to invoke the Expression Editor.
 
eurd-web-smarttag-f-button
 

In the Properties window, if an expression can be set for a property, the ƒ button appears near the value editor. Click this button to invoke the Expression Editor.
 
eurd-web-f-button
 
The ƒ button changes its color to blue to indicate that an expression is set for a property.
 
eurd-web-properties-window-f-button-blue
 

The Editor lists all properties for which you can specify an expression.

 

Click a property to specify an expression.

 

eurd-web-expression-editor-properties-list

 

An ƒ icon appears next to a property where an expression is set.

 

eurd-web-expression-editor-properties-list-expression-set

 

The Editor highlights an expression's syntax and supports intelligent code completion (which suggests functions and available data elements as you type).

 

eurd-web-expression-editor-intellisense

 

The Expression Editor displays all the errors it finds in the specified expression.

 

eurd-web-expression-editor-syntax-error

 

The Editor lists a tree with language elements and items that you can use in an expression.

 

eurd-web-expression-editor-expression-items

 

FilterString Editor

You can use the Report Designer's FilterString Editor to specify the FilterString property of a report, Cross Tab, or Chart Series.

 

The FilterString Editor's visual interface allows you to use an unlimited number of conditions and combine them with logical operators to create filter criteria. You can also switch to Text mode and type a filter string.

 

eurd-web-filterstring-editor

 

The FilterString Editor highlights an expression's syntax and supports intelligent code completion (which suggests functions and available data elements as you type).

 

eurd-web-filterstring-editor-intellisense

 

Expression Syntax

An expression can include field names, constants, operators, functions, data fields, and parameters.

 

See the following topic for more information: Expression Language.