Skip to content

Commit 4b8f199

Browse files
Merge pull request #161 from serge-andreyev/master
21.2 Reporting Updates
2 parents 8bfb4f4 + 51d6de7 commit 4b8f199

File tree

137 files changed

+2219
-1368
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

137 files changed

+2219
-1368
lines changed

interface-elements-for-desktop/articles/expression-editor/expression-operators-functions-and-constants.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ The following DevExpress products extend and/or override this syntax. The table
1010

1111
|Product | Article |
1212
|---|---|
13-
|Reporting | [Expression Constants, Operators, and Functions](../report-designer/report-designer-for-winforms/use-expressions/expression-syntax.md)
13+
|Reporting | [Expression Constants, Operators, and Functions](../report-designer/report-designer-for-winforms/use-expressions/expression-language.md)
1414
|Pivot Grid | [Pivot Grid Expression Syntax](../pivot-table/data-editing/pivot-grid-expression-syntax.md)
1515

1616
## Operators

interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/bind-to-data/bind-a-report-to-json-data.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ This topic describes how to bind a report to JSON data.
4545

4646
You can enable the new parameter's **Expression** property and [use expressions](../use-expressions.md) to set path parameter and query parameter values.
4747

48-
- Select **Expression Editor** from the Value property's drop-down list, specify the expression in the invoked [Expression Editor](../use-expressions.md#expression-editor), and click **OK**.
48+
- Select **Expression Editor** from the Value property's drop-down list, specify the expression in the invoked [Expression Editor](../use-expressions/expressions-overview.md#expression-editor), and click **OK**.
4949

5050
![JSON-specify-parameter-expression](../../../../images/eurd-win-JSON-path-parameter-specify-expression.png)
5151

interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/bind-to-data/data-binding-modes.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ The Report Designer works in one of the following data binding modes:
88

99
* **Expressions** is the default binding mode.
1010

11-
This mode enables you to specify complex [expressions](../use-expressions.md) that include two or more data fields, [report parameters](../shape-report-data/use-report-parameters.md), or [functions](../use-expressions/expression-syntax.md). You can also use expressions to [calculate summaries](../shape-report-data/calculate-summaries/calculate-a-summary.md) of any complexity or [conditionally shape your data](../shape-report-data/specify-conditions-for-report-elements.md).
11+
This mode enables you to specify complex [expressions](../use-expressions.md) that include two or more data fields, [report parameters](../shape-report-data/use-report-parameters.md), or [functions](../use-expressions/expression-language.md). You can also use expressions to [calculate summaries](../shape-report-data/calculate-summaries/calculate-a-summary.md) of any complexity or [conditionally shape your data](../shape-report-data/specify-conditions-for-report-elements.md).
1212

1313
Click a property's marker to see whether the invoked context menu has the **PropertyName Expression** item that invokes the **Expression Editor**.
1414

@@ -24,12 +24,12 @@ The Report Designer works in one of the following data binding modes:
2424

2525
![property-grid-expression-advanced-tab](../../../../images/eurd-win-binding-modes-expressions-advanced.png)
2626

27-
The **Expression Editor** allows you to use event argument values in the constructed expressions. Event arguments are available in the [Variables](../use-expressions/expression-syntax.md) section.
27+
The **Expression Editor** allows you to use event argument values in the constructed expressions. Event arguments are available in the [Variables](../use-expressions/expression-language.md) section.
2828

2929
In the **BeforePrint** event, you can use data fields from all queries in the data source.
3030

3131
![Expression Editor for the BeforePrint event](../../../../images/eurd-win-binding-modes-data-fields.png)
3232

33-
In the **PrintOnPage** event, data source fields are not available because data was fetched when this event occurs. You can use the event arguments that are available in the [Variables](../use-expressions/expression-syntax.md) section.
33+
In the **PrintOnPage** event, data source fields are not available because data was fetched when this event occurs. You can use the event arguments that are available in the [Variables](../use-expressions/expression-language.md) section.
3434

3535
![Expression Editor for the PrintOnPage event](../../../../images/eurd-win-binding-modes-event-arguments.png)

interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/bind-to-data/specify-query-parameters.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -96,10 +96,10 @@ You can map [multi-value parameters](../shape-report-data/use-report-parameters/
9696
## <a name="multivalueparameterinstoredprocedure"></a>Pass a Multi-Value Report Parameter Value to a Stored Procedure
9797
You cannot pass a [multi-value parameter](../shape-report-data/use-report-parameters/multi-value-report-parameters.md) value to a stored procedure directly. Use one of the following expression functions:
9898

99-
* Use the [Join() expression function](../use-expressions/expression-syntax.md) to convert the array of parameter values to a string if you use MS SQL Server, MySQL or Oracle database systems.
99+
* Use the [Join() expression function](../use-expressions/functions-in-expressions.md) to convert the array of parameter values to a string if you use MS SQL Server, MySQL or Oracle database systems.
100100

101101
![](../../../../images/eurd-win-query-parameters-join-expression-function.png)
102102

103-
* Use the [CreateTable() expression function](../use-expressions/expression-syntax.md) to prepare a table using values of several multi-value parameters.
103+
* Use the [CreateTable() expression function](../use-expressions/functions-in-expressions.md) to prepare a table using values of several multi-value parameters.
104104

105105
![](../../../../images/eurd-win-query-parameters-createtable-expression-function.png)

interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/report-designer-tools/ui-panels/field-list.md

Lines changed: 39 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -6,58 +6,69 @@ seealso: []
66
---
77
# Field List
88

9-
This panel displays the schema of a report's data sources. You can right-click a data source item to access its settings. For example, you can add a data source to the [Report Gallery](report-gallery.md) to later re-use it in other reports.
9+
This panel displays the schemas of a reports data sources.
1010

11-
![design-time-field-list-data-source-add-to-gallery](../../../../../images/eurd-win-field-list-data-source-add-to-gallery.png)
11+
![Field List](../../../../../images/eurd-win-field-list.png)
1212

13-
The Field List enables you to perform the following actions.
13+
Right-click a data source to access its settings. For instance, you can add the data source to the [Report Gallery](report-gallery.md) to reuse it in other reports.
14+
15+
![Field List - Add Data Source to Report Gallery](../../../../../images/eurd-win-field-list-data-source-add-to-gallery.png)
16+
17+
The Field List allows you to do the following:
18+
19+
## Search fields
20+
21+
Enter a search string in the search box. The Field List filters fields and tables to match the entered string.
22+
23+
![Field List - Search](../../../../../images/eurd-win-field-list-search.png)
1424

1525
## Bind controls to data
1626

17-
Dropping a field onto a report's surface creates a new report control bound to a corresponding field.
27+
Drop a field onto a report's surface to create a new report control bound to this field.
1828

19-
![eurd-win-field-list-drop-fields](../../../../..//images/eurd-win-field-list-drop-fields.png)
29+
![Field List - Drop Field Onto the Surface](../../../../..//images/eurd-win-field-list-drop-fields.png)
2030

21-
Dropping a field onto an existing control binds this control to a corresponding field.
31+
Drop a field onto an existing report control to bind this control to the field.
2232

23-
![eurd-win-field-list-drop-field-to-control](../../../../../images/eurd-win-field-list-drop-field-to-control.png)
33+
![Field List - Drop Field Onto a Control](../../../../../images/eurd-win-field-list-drop-field-to-control.png)
2434

25-
You can preserve data bindings of an existing control by holding down the CTRL key when dropping a data field on this control. This creates a new report control on top of the existing control.
35+
Hold the CTRL key when you drop a field on top of an existing control to keep the control's current data binding setting. In this case, a new report control is created.
2636

27-
![eurd-win-field-list-avoid-data-binding](../../../../../images/eurd-win-field-list-avoid-data-binding.png)
37+
![Field List - Drop Field Onto a Control and Keep Binding](../../../../../images/eurd-win-field-list-avoid-data-binding.png)
2838

29-
## Create specific controls
39+
**Select which control to create**
3040

31-
To create a data-bound control of a specific type, do any of the following:
41+
Do any of the following:
3242

33-
* Hold down the SHIFT key and drop a data field onto a report's surface.
34-
* Right-click a corresponding data field and drop it onto a report's surface.
43+
* Hold the SHIFT key when you drop a data field onto the report surface.
44+
* Right-click a data field and drop it onto the report surface.
3545

36-
This invokes a context menu enabling you to select which control to create.
46+
This invokes a context menu where you can select which control to create.
3747

38-
![eurd-win-fieldlist-create-specific-contols](../../../../../images/eurd-win-fieldlist-create-specific-contols.png)
48+
![Field List - Select Which Control to Create](../../../../../images/eurd-win-fieldlist-create-specific-contols.png)
3949

4050
## Create tables
4151

42-
Dropping an entire data table onto a report creates a table with its columns bound to fields contained in the data table.
52+
Drop an entire data table onto the report to create a report table with columns bound to the data table's fields.
4353

44-
![eurd-win-field-list-drop-table](../../../../../images/eurd-win-field-list-drop-table.png)
54+
![Field List - Drop Table](../../../../../images/eurd-win-field-list-drop-table.png)
4555

46-
To select multiple fields, click them with holding the CTRL or SHIFT key. Dropping these fields onto a report creates a new table with its cells bound to the corresponding fields.
56+
Hold the CTRL or SHIFT key to select multiple data fields in the Field List. Drop these fields onto the report to create a report table that only has the selected fields.
4757

48-
![design-time-field-list-drop-multiple-fields](../../../../../images/eurd-win-list-drop-multiple-fields.png)
58+
![Field List - Select Specific Fields](../../../../../images/eurd-win-list-drop-multiple-fields.png)
4959

50-
To create column headers, right-click the required fields with holding the CTRL or SHIFT key and drop them onto a report surface. This creates a new table with its cells displaying the field names.
60+
Hold the SHIFT key when you drop the selected fields onto the report to only create column headers. This creates a new table whose cells display the selected field names. Alternatively, you can drag and drop fields with the right mouse button.
5161

52-
![eurd-win-field-list-multi-select-bound-table-cells](../../../../../images/eurd-win-field-list-multi-select-bound-table-cells.png)
62+
![Field List - Create Column Headers](../../../../../images/eurd-win-field-list-multi-select-bound-table-cells.png)
5363

5464
## Data shaping operations
5565

56-
In addition, the Field List can help you solve the following tasks:
66+
The Field List can help you do the following:
67+
68+
* Add [calculated fields](../../shape-report-data/use-calculated-fields/calculated-fields-overview.md) to data tables.
69+
70+
![Field List - Add Calculated Field](../../../../../images/eurd-win-field-list-add-calculated-field.png)
71+
72+
* Add [report parameters](../../shape-report-data/use-report-parameters.md) or change existing parameters.
5773

58-
* Add [calculated fields](../../shape-report-data/use-calculated-fields/calculated-fields-overview.md) to data columns for performing various calculations in a report.
59-
60-
![design-time-field-list-add-calculated-field](../../../../../images/eurd-win-field-list-add-calculated-field.png)
61-
* Manage the collection of [report parameters](../../shape-report-data/use-report-parameters.md).
62-
63-
![design-time-field-list-add-report-parameter](../../../../../images/eurd-winield-list-add-report-parameter.png)
74+
![Field List - Add Report Parameter](../../../../../images/eurd-winield-list-add-report-parameter.png)

interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/shape-report-data/calculate-summaries/calculate-an-advanced-summary.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ This document describes how to calculate an advanced summary for report groups u
2727
![](../../../../../images/eurd-win-label-advanced-summary-expression.png)
2828

2929
> [!TIP]
30-
> See the [Expression Constants, Operators, and Functions](../../use-expressions/expression-syntax.md) topic for a complete list of supported summary functions.
30+
> See the [Functions in Expressions](../../use-expressions/functions-in-expressions.md) topic for a complete list of supported summary functions.
3131

3232
6. You can use the **Format String** property to format the summary's value.
3333

interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/shape-report-data/use-calculated-fields/calculate-an-aggregate-function.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ This tutorial describes the steps required to create a report with an _aggregate
3131

3232
You can refer to the currently processed group using the Parent Relationship Traversal Operator ('^'). This allows you to calculate aggregates within groups using expressions like the following: _[][[^.CategoryID] == [CategoryID]].Sum([UnitPrice])_.
3333

34-
For more information, see [Expression Syntax](../../use-expressions/expression-syntax.md).
34+
For more information, see [Expression Language](../../use-expressions/expression-language.md).
3535

3636
5. Click **OK** to close the dialog and save the expression.
3737

interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/shape-report-data/use-calculated-fields/calculated-fields-overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@ _[\<Collection>][\<Condition>].\<Aggregate>(\<Expression>)_
6363

6464
You can refer to the currently processed group using the Parent Relationship Traversal Operator ('^'). This allows you to calculate aggregates within groups using expressions like the following: _[][[^.CategoryID] == [CategoryID]].Sum([UnitPrice])_.
6565

66-
For more information, see [Expression Syntax](../../use-expressions/expression-syntax.md).
66+
For more information, see [Expression Language](../../use-expressions/expression-language.md).
6767

6868
## <a name="examples"></a>Examples
6969
The following tutorials demonstrate the use of calculated fields in various environments:

interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/shape-report-data/use-report-parameters/create-a-report-parameter.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ The Report Designer offers multiple ways to create a parameter:
1818

1919
![Create Report Parameter from PRoperty Grid](../../../../../images/eurd-win-create-report-parameter-from-property-grid.png)
2020

21-
* Create a parameter in-place in dialogs and wizards. The image below shows how to create a parameter in a [FilterString Editor](../../use-expressions.md#filterstring-editor). Select **Add Parameter** from the context menu when you construct a condition.
21+
* Create a parameter in-place in dialogs and wizards. The image below shows how to create a parameter in a [FilterString Editor](../../use-expressions/expressions-overview.md#filterstring-editor). Select **Add Parameter** from the context menu when you construct a condition.
2222

2323
![Filter String - Add Parameter](../../../../../images/eurd-win-parameters-filter-string-add-parameter.png)
2424

@@ -28,7 +28,7 @@ Specify the following basic options:
2828
| --- | --- |
2929
| **Name** | A parameter should have a unique name. You can use this name to refer to this parameter in expressions and filter strings. |
3030
| **Type** | Specifies which values a parameter can accept. |
31-
| **Default Value** or **[Expression](../../use-expressions.md#expression-syntax)** | Specifies a parameter's value. Expressions can include data source fields or other parameters. When evaluated, expressions are parsed and processed to obtain a value. |
31+
| **Default Value** or **[Expression](../../use-expressions/expression-language.md)** | Specifies a parameter's value. Expressions can include data source fields or other parameters. When evaluated, expressions are parsed and processed to obtain a value. |
3232

3333
## Use the Parameters Panel to Ask for User Input
3434

interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/use-expressions.md

Lines changed: 6 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -4,46 +4,10 @@ owner: Mary Sammal
44
---
55
# Use Expressions
66

7-
Use expressions to [retrieve and format data](use-report-elements\bind-controls-to-data.md), [create calculated fields](shape-report-data\use-calculated-fields.md) and [calculate summaries](shape-report-data\calculate-summaries\calculate-a-summary.md), [conditionally shape data and change a report control's appearance](shape-report-data\specify-conditions-for-report-elements.md).
7+
Topics in this section describe how to use expressions in a report:
88

9-
## Expression Syntax
10-
11-
An expression is a string that is parsed and processed to evaluate a value. Expressions consist of field names, constants, operators, and functions. Field names are wrapped in square brackets.
12-
13-
_"[Quantity] * [UnitPrice] * (1 - [BonusAmount])"_
14-
15-
_"[FirstName] + ' ' + [LastName]"_
16-
17-
_"[Country] == 'USA'"_
18-
19-
_"[OrderDate] > #8/16/1994# AND [Quantity] > 20"_
20-
21-
You can use [operators, functions, and constants](use-expressions\expression-syntax.md) in your expressions.
22-
23-
See the [Data Binding Modes](use-expressions/data-binding-modes.md) topic for details on the available binding modes.
24-
25-
## Expression Editor
26-
27-
The Report Designer's Expression Editor provides functions, operators, data source fields, report elements, constants, and variables to construct expressions.
28-
29-
![Expressions_ExpressionEditor](../../../images/eurd-win-expression-editor.png)
30-
31-
The Expression Editor highlights an expression's syntax and supports intelligent code completion (it suggests functions and available data elements as you type).
32-
33-
![Expressions_ExpressionEditor_Intellisense](../../../images/eurd-win-expression-editor_intellisense.png)
34-
35-
The Expression Editor displays all the errors it finds in the specified expression.
36-
37-
![Expressions_ExpressionEditor_ErrorValidation](../../../images/eurd-win-expression-editor_error-validation.png)
38-
39-
## FilterString Editor
40-
41-
The Report Designer's FilterString Editor allows you to specify filter criteria for a report, [Cross Tab](use-report-elements/use-cross-tabs.md), or [Chart](use-report-elements/use-charts-and-pivot-grids.md)'s series.
42-
43-
The FilterString Editor provides a visual interface where you can use an unlimited number of conditions and combine them with logical operators to create filter criteria. You can also switch to the Text mode and type a filter string.
44-
45-
![Expressions_FilterEditor](../../../images/eurd-win-filter-editor.png)
46-
47-
The FilterString Editor highlights an expression's syntax and supports intelligent code completion (it suggests functions and available data elements as you type).
48-
49-
![FilterEditor_New_Features](../../../images/eurd-win-filter-editor-validation.png)
9+
* [Expressions Overview](use-expressions/expressions-overview.md)
10+
* [Expression Language](use-expressions/expression-language.md)
11+
* [Functions in Expressions](use-expressions/functions-in-expressions.md)
12+
* [How to: Use Expressions](use-expressions/how-to-use-expressions.md)
13+
* [Data Binding Modes](use-expressions/data-binding-modes.md)

0 commit comments

Comments
 (0)