Merge pull request #162 from epolevikov/master

EUD 21.2 (Use Report Parameters, PDF Content, Reports with Embedded PDF, Query Builder)

Author: serge-andreyev

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

@@ -17,6 +17,7 @@ The Report Designer allows you to create data-bound reports and provides a rich
 * [Create Reports](report-designer-for-winforms/create-reports.md)
 * [Configure Design Settings](report-designer-for-winforms/configure-design-settings.md)
 * [Use Report Elements](report-designer-for-winforms/use-report-elements.md)
+* [Use Report Parameters](report-designer-for-winforms/use-report-parameters.md)
 * [Shape Report Data](report-designer-for-winforms/shape-report-data.md)
 * [Lay out Dynamic Report Content](report-designer-for-winforms/lay-out-dynamic-report-content.md)
 * [Customize Appearance](report-designer-for-winforms/customize-appearance.md)

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

@@ -33,7 +33,7 @@ This tutorial describes how to bind a report to an object data source:
 
 8. The next wizard page allows you to specify the constructor parameters.
 
-	Enabling the checkbox in the **Expression** column allows you to specify the parameter expression (using the **Expression Editor**), as well as pass an existing [report parameter](../shape-report-data/use-report-parameters.md) to the constructor (or create a new report parameter using the in-place editor).
+	Enabling the checkbox in the **Expression** column allows you to specify the parameter expression (using the **Expression Editor**), as well as pass an existing [report parameter](../use-report-parameters.md) to the constructor (or create a new report parameter using the in-place editor).
 
 	![](../../../../images/eurd-win-data-source-wizard-object-constructor-parameters.png)
 

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

@@ -49,7 +49,7 @@ This topic describes how to bind a report to JSON data.
 
     ![JSON-specify-parameter-expression](../../../../images/eurd-win-JSON-path-parameter-specify-expression.png)
 
-    - Expressions can include [report parameters](../shape-report-data/use-report-parameters.md). Select **New Report Parameter** from the **Value** property's drop-down list, configure the report parameter in the invoked **Report Parameter** dialog, and click **OK**.
+    - Expressions can include [report parameters](../use-report-parameters.md). Select **New Report Parameter** from the **Value** property's drop-down list, configure the report parameter in the invoked **Report Parameter** dialog, and click **OK**.
 
     ![JSON-add-report-parameter](../../../../images/eurd-win-JSON-add-report-parameter.png)
 

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

@@ -8,7 +8,7 @@ The Report Designer works in one of the following data binding modes:
 
 * **Expressions** is the default binding mode.
 
-    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).
+    This mode enables you to specify complex [expressions](../use-expressions.md) that include two or more data fields, [report parameters](../use-report-parameters.md), or [functions](../use-expressions/expression-language.md#functions). 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).
 
     Click a property's marker to see whether the invoked context menu has the **PropertyName Expression** item that invokes the **Expression Editor**.
 

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

@@ -51,7 +51,7 @@ The following properties are available for each query parameter:
 * **Name** - specifies the parameter's name.
 * **Type** - specifies the parameter value's data type.
 * **Expression** - determines whether the actual parameter value is static or generated dynamically.
-* **Value** - determines the query parameter's actual value. If the **Expression** option is enabled, the actual parameter value is produced dynamically by calculating an associated expression. This is useful when you map the query parameter value to the [report parameter](../shape-report-data/use-report-parameters.md) value. Refer to the next document section for more information.
+* **Value** - determines the query parameter's actual value. If the **Expression** option is enabled, the actual parameter value is produced dynamically by calculating an associated expression. This is useful when you map the query parameter value to the [report parameter](../use-report-parameters.md) value. Refer to the next document section for more information.
 
 ## <a name="providevalue"></a>Provide the Query Parameter Value
 Below, you can see how a value is specified for a query parameter within the Data Source Wizard's page. You can also specify query parameter values in the Report Wizard or the Query Parameters dialog in the same way.
@@ -89,12 +89,12 @@ Below, you can see how a value is specified for a query parameter within the Dat
 		![](../../../../images/eurd-win-query-parameters-existing-report-parameter.png)
 
 ## <a name="PassMultiValueParameterValueToQuery"></a>Pass a Multi-Value Parameter Value to a Query
-You can map [multi-value parameters](../shape-report-data/use-report-parameters/multi-value-report-parameters.md) to query parameters. For instance, the following query selects the orders whose IDs can be found within the values the _\@OrderID_ query parameter provides.
+You can map [multi-value parameters](../use-report-parameters/multi-value-report-parameters.md) to query parameters. For instance, the following query selects the orders whose IDs can be found within the values the _\@OrderID_ query parameter provides.
 
 ![](../../../../images/eurd-win-query-parameters-map-to-multi-value-parameter.png)
 
 ## <a name="multivalueparameterinstoredprocedure"></a>Pass a Multi-Value Report Parameter Value to a Stored Procedure
-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:
+You cannot pass a [multi-value parameter](../use-report-parameters/multi-value-report-parameters.md) value to a stored procedure directly. Use one of the following expression functions:
 
 * 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.
 

interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/create-reports.md

@@ -59,14 +59,14 @@ You can add interactive elements to your report to customize it in Print Preview
 > [!Note]
 > See the [Provide Interactivity](provide-interactivity.md) section for information on how to provide drill-down and drill-through functionality in your reports.
 > 
-> See [Use Report Parameters](shape-report-data/use-report-parameters.md) for instructions on how to submit parameter values in Print Preview to customize your reports.
+> See [Use Report Parameters](use-report-parameters.md) for instructions on how to submit parameter values in Print Preview to customize your reports.
 
 ## Layout Features
 
 ### [Reports with Cross-Band Content and Populated Empty Space](create-reports/reports-with-cross-band-content-and-populated-empty-space.md)
 ![](../../../images/cross-band-and-populated-empty-space-report-preview.png)
 
-### [Reports with PDF content](create-reports/reports-with-pdf-content.md)
+### [Reports with PDF content](create-reports/reports-merged-with-pdf.md)
 ![](../../../images/report-with-pdf-content-preview.png)
 
 ### [Reports with a Visual PDF Signature](create-reports/reports-with-visual-pdf-signature.md)

…eate-reports/reports-with-pdf-content.md …reate-reports/reports-merged-with-pdf.mdinterface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/create-reports/reports-with-pdf-content.md renamed to interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/create-reports/reports-merged-with-pdf.md interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/create-reports/reports-with-pdf-content.md renamed to interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/create-reports/reports-merged-with-pdf.md

@@ -1,8 +1,8 @@
 ---
-title: Reports with PDF Content
+title: Reports Merged with PDF
 author: Sergey Andreev
 ---
-# Reports with PDF Content
+# Reports Merged with PDF
 
 This tutorial describes how to add PDF content to a report.
 

interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/create-reports/reports-with-embedded-pdf-content.md

@@ -0,0 +1,237 @@
+---
+title: Reports with Embedded PDF Content
+author: Eugene Polevikov
+---
+
+# Reports with Embedded PDF Content
+
+This tutorial explains how to use the [PDF Content](../use-report-elements/use-basic-report-controls/pdf-content.md) control to do the following:
+
+* Append PDF file pages to a report and make their paper kind the same as in the inital report.
+* Add sequential page numbers to the report and PDF file pages.
+* Include additional information in the embedded PDF file pages.
+
+The image below shows an invoice report that contains information about order items.
+
+![Final Report Page 1](../../../../images/create-report-with-pdf-content-final-report-page1.png)
+
+The following image illustrates the first PDF file page embedded to the invoice report. This page has the same paper kind as the initial report. [Report controls](../use-report-elements/use-basic-report-controls.md) are used to add item title, item price, line, logo image, and sequential page numbers to this page.
+
+![Final Report Page 2](../../../../images/create-report-with-pdf-content-final-report-page2.png)
+
+To create the above report with PDF content, follow the steps described in these sections:
+
+* [Create the Main Report](#create-the-main-report)
+* [Create a Report with PDF Content](#create-a-report-with-pdf-content)
+* [Add the Report with PDF content to the Main Report](#add-the-report-with-pdf-content-to-the-main-report)
+
+## Create the Main Report
+
+1. Open the [Report Designer](../../report-designer-for-winforms.md) and [add a new blank report](../../report-designer-for-winforms/add-new-reports.md).
+2. Design the report layout. In this tutorial, we create an invoice report that contains information about order items.
+
+    ![Main Report Layout](../../../../images/pdfcontent-embedded-mode-main-report-layout.png)
+
+    To supply the report with data, use the following JSON string:
+
+    ```
+    {
+        "InvoiceNumber": 241756,
+        "OrderDate": "2018-04-23T18:25:43.511Z",
+        "Customer": {
+            "Name": "Walters",
+            "HomeOffice_Line": "200 Wilmot Rd",
+            "HomeOffice_City": "Deerfield",
+            "HomeOffice_StateName": "IL",
+            "HomeOffice_ZipCode": "60015"
+        },
+        "Store": {
+            "Address_City": "Anaheim",
+            "Address_Line": "1720 W La Palma Ave",
+            "Address_StateName": "CA",
+            "Address_ZipCode": "83709"
+        },
+        "Employee": {
+            "FullName": "Harv Mudd"
+        },
+        "PONumber": "122023",
+        "ShipMethod": 0,
+        "OrderTerms": "15 Days",
+        "OrderItems": [
+            {
+                "ProductName": "SuperLED 42",
+                "ProductPrice": 1050,
+                "ProductUnits": 2,
+                "Discount": 50,
+                "Total": 2050
+            },
+            {
+                "ProductName": "SuperLED 50",
+                "ProductPrice": 1100,
+                "ProductUnits": 5,
+                "Discount": 500,
+                "Total": 5000
+            },
+            {
+                "ProductName": "Projector PlusHD",
+                "ProductPrice": 600,
+                "ProductUnits": 5,
+                "Discount": 250,
+                "Total": 2750
+            },
+            {
+                "ProductName": "HD Video Player",
+                "ProductPrice": 220,
+                "ProductUnits": 10,
+                "Discount": 200,
+                "Total": 2000
+            }
+        ],
+        "ShippingAmount": 375,
+        "TotalAmount": 12175
+    }
+    ```
+
+The following image illustrates the main report's **Preview**:
+
+![Main Report Preview](../../../../images/pdfcontent-embedded-mode-main-report-preview.png)
+
+## Create a Report with PDF Content
+
+1. Create a new blank report. Remove the report's margins.
+
+    ![Add a New Blank Report and Remove Margins](../../../../images/create-report-with-pdf-content-add-new-blank-report-and-remove-margins.png)
+
+2. Drop the [PDF Content](../use-report-elements/use-basic-report-controls/pdf-content.md) control from the **Toolbox** onto the *Detail* band.
+
+    ![Drop the PDF Content Control Onto the Detail Band](../../../../images/create-report-with-pdf-content-drop-xrpdfcontent-control-onto-detail-band.png)
+
+3. Expand the control's smart tag, click the **Source** or **Source URL** property's ellipsis button, and select PDF file. In this demo, we use the following PDF specification: [Specification.pdf](https://github.com/DevExpress-Examples/DataSources/blob/master/Specification.pdf).
+
+    ![Specify PDF File Source](../../../../images/create-report-with-pdf-content-specify-pdf-file-source.png)
+
+4. Disable the control's **Generate Own Pages** property. Adjust the control size to make PDF content fit the entire *Detail* band. For this, set the *Detail* band's **Height** to *1095* and the control's **Width** and **Height** to *850* and *1095*.
+
+    ![Make PDF Content Fit the Entire Detail Band](../../../../images/create-report-with-pdf-content-make-pdf-content-fit-entire-detail-band.png)
+
+5. Disable the report's **Designer Options -> Show Export Warnings** property. Bind the report to the following JSON data:
+    
+    ```
+    {
+        "InvoiceNumber": 241756,
+        "OrderDate": "2018-04-23T18:25:43.511Z",
+        "Customer": {
+            "Name": "Walters",
+            "HomeOffice_Line": "200 Wilmot Rd",
+            "HomeOffice_City": "Deerfield",
+            "HomeOffice_StateName": "IL",
+            "HomeOffice_ZipCode": "60015"
+        },
+        "Store": {
+            "Address_City": "Anaheim",
+            "Address_Line": "1720 W La Palma Ave",
+            "Address_StateName": "CA",
+            "Address_ZipCode": "83709"
+        },
+        "Employee": {
+            "FullName": "Harv Mudd"
+        },
+        "PONumber": "122023",
+        "ShipMethod": 0,
+        "OrderTerms": "15 Days",
+        "OrderItems": [
+            {
+                "ProductName": "SuperLED 42",
+                "ProductPrice": 1050,
+                "ProductUnits": 2,
+                "Discount": 50,
+                "Total": 2050
+            },
+            {
+                "ProductName": "SuperLED 50",
+                "ProductPrice": 1100,
+                "ProductUnits": 5,
+                "Discount": 500,
+                "Total": 5000
+            },
+            {
+                "ProductName": "Projector PlusHD",
+                "ProductPrice": 600,
+                "ProductUnits": 5,
+                "Discount": 250,
+                "Total": 2750
+            },
+            {
+                "ProductName": "HD Video Player",
+                "ProductPrice": 220,
+                "ProductUnits": 10,
+                "Discount": 200,
+                "Total": 2000
+            }
+        ],
+        "ShippingAmount": 375,
+        "TotalAmount": 12175
+    }
+    ```
+    
+6. Place two [labels](../use-report-elements/use-basic-report-controls/label.md), a [line](../use-report-elements/draw-lines-and-shapes/draw-lines.md), and a [picture box](..\use-report-elements\use-basic-report-controls\picture-box.md) on the PDF page header as shown below:
+
+    ![Add Controls to Page Header](../../../../images/create-report-with-pdf-content-make-pdf-content-add-controls-to-page-header.png)
+
+    Use the following locations and sizes:
+
+    | Control Name | Location | Size |
+    | --- | --- | --- |
+    | label1 | 105, 94 | 280, 44 |
+    | label2 | 105, 138 | 118, 30 |
+    | line1 | 105, 69 | 687, 20 |
+    | pictureBox1 | 647, 24 | 145, 45 |
+
+7. Set the line's **Width** and **Fore Color** to *2* and *Orange* respectively. Assign the following image to the picture box's **Image Source** property:
+
+    ![DevAV Icon](../../../../images/devav.png)
+
+    Make the label1's font bold. Set up label appearance as shown in the table below:
+
+    | Control Name | Font | Font Size | Text Property's Expression | Text Format String |
+    | --- | --- | --- | --- | --- |
+    | label1 | Segoe UI | 21 | *ProductName* | - |
+    | label2 | Segoe UI | 12 | *ProductPrice* | {0:$0} |
+
+    ![Bind Labels to Data](../../../../images/create-report-with-pdf-content-make-pdf-content-bind-labels-to-data.png)
+
+    To display a product name and price of each order item on a corresponding PDF file page, set the PDF Content **Page Range** property's [expression](../use-expressions.md) to *[DataSource.CurrentRowIndex] + 1*.
+
+    ![Assign Expression to the Page Range Property](../../../../images/create-report-with-pdf-content-assign-expression-to-page-range.png)
+
+8. Add the [Page Info](..\use-report-elements\use-basic-report-controls\page-info.md) control to the PDF page footer. Use the following settings for this control:
+
+    | Location | Size | Font | Font Size | Text Alignment | Text Format String |
+    | --- | --- | --- | --- | --- | --- |
+    | 0, 1045 | 850, 50 | Segoe UI | 12 | Middle Center | Page {0} of {1} |
+
+    ![Add Page Numbers](../../../../images/create-report-with-pdf-content-add-page-numbers.png)
+
+Open **Preview** to show the result. The image below shows the report's first page:
+
+![Final Report Preview](../../../../images/create-report-with-pdf-content-preview.png)
+
+## Add the Report with PDF Content to the Main Report
+
+1. Add a footer to the main report. Right-click the design surface, choose **Insert Band**, and select **ReportFooter**.
+
+    ![Add Report Footer](../../../../images/create-report-with-pdf-content-add-report-footer.png)
+
+2. Add the [Subreport](..\use-report-elements\use-basic-report-controls\subreport.md) control to the footer. Assign the path the report with PDF content to the control's **Report Source URL** property. Enable the control's **Generate Own Pages** property.
+
+    ![Add the Subreport](../../../../images/create-report-with-pdf-content-add-subreport.png)
+
+3. Add the [Page Info](..\use-report-elements\use-basic-report-controls\page-info.md) control to the report's **Bottom Margin** band. Set the control's **Text Alignment** propery to *Middle Center* and the **Text Format String** property to *Page {0} of {1}*.
+
+    ![Add Page Numbers to Main Report](../../../../images/create-report-with-pdf-content-add-page-number-to-main-report.png)
+
+Open **Preview** to show the result.
+
+![Final Report Page 1](../../../../images/create-report-with-pdf-content-final-report-page1.png)
+
+![Final Report Page 2](../../../../images/create-report-with-pdf-content-final-report-page2.png)

interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/provide-interactivity/edit-content-in-print-preview.md

@@ -36,7 +36,7 @@ The sections below provide information about options these controls expose. You
 * Changes made to a control's content in Print Preview does not effect the document's other parts (for example, summary results, grouping, sorting, bookmarks and other settings that were processed before the document was generated).
 * A control's **Can Grow** setting is ignored for editable fields. The edited area cannot exceed the control's original dimensions.
 * Multi-line values can only be entered when no mask is applied to an editable field.  
-* Values entered into editable fields are reset after the document is refreshed (for example, when you submit [report parameter](..\shape-report-data\use-report-parameters.md) values or expand/collapse data in a [drill-down report](create-drill-down-reports.md)).
+* Values entered into editable fields are reset after the document is refreshed (for example, when you submit [report parameter](../use-report-parameters.md) values or expand/collapse data in a [drill-down report](create-drill-down-reports.md)).
 * It is not possible to edit content in bands if their **DrillDownControl** property is specified.
 * The entered values are not preserved in the Top Margin and Bottom Margin bands when the report is exported as a single file to the following formats: