Merge pull request #120 from epolevikov/master

Updates for Report Designer | Use Barcodes and Federation Data Source

Author: serge-andreyev

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

@@ -14,7 +14,7 @@ The Report Designer allows you to create data-bound reports and provides a rich
 * [Save Reports](report-designer-for-winforms/save-reports.md)
 * [Introduction to Banded Reports](report-designer-for-winforms/introduction-to-banded-reports.md)
 * [Bind to Data](report-designer-for-winforms/bind-to-data.md)
-* [Create Popular Reports](report-designer-for-winforms/create-popular-reports.md)
+* [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)
 * [Shape Report Data](report-designer-for-winforms/shape-report-data.md)

interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/bind-to-data/bind-a-report-to-a-federated-master-detail-data-source.md

@@ -69,7 +69,7 @@ Once you rename the query, update the report's **Data Member** property.
 
     ![](../../../../images/eurd-data-federation-report-wizard-table-report.png)
 
-3. Select data members for the report and its [detail reports](../../../../articles/report-designer/report-designer-for-winforms/create-popular-reports/create-a-master-detail-report-use-detail-report-bands.md). Select data fields to display in the report and click **Finish**. You can also go to the [next page](../../../../articles/report-designer/report-designer-for-winforms/report-designer-tools/report-wizard/table-report/add-grouping-levels.md) to continue layout creation.
+3. Select data members for the report and its [detail reports](../../../../articles/report-designer/report-designer-for-winforms/create-reports/master-detail-reports-with-detail-report-bands.md). Select data fields to display in the report and click **Finish**. You can also go to the [next page](../../../../articles/report-designer/report-designer-for-winforms/report-designer-tools/report-wizard/table-report/add-grouping-levels.md) to continue layout creation.
 
     ![](../../../../images/eurd-data-federation-master-detail-report-wizard-select-fields.png)
 

interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/bind-to-data/bind-a-report-to-a-join-based-federated-data-source.md

@@ -42,6 +42,14 @@ This topic describes how to create a federated data source that joins data from
 
     ![](../../../../images/eurd-data-federation-query-builder-select-fields.png)
 
+    You can specify a different name for a field. Click the field's **Alias** cell and type the alias.
+
+    ![](../../../../images/eurd-data-federation-query-builder-specify-alias.png)
+
+    Use the grid's empty line to add an unbound field to a query. Click the field's ellipsis button to invoke the [Expression Editor](../use-expressions.md) and construct an expression that specifies the field's value.
+
+    ![](../../../../images/eurd-data-federation-query-builder-construct-expression.png)
+
 7. Click **OK** to close the Query Builder. Click **Finish** to complete the Data Source Wizard.
 
 The Wizard creates a new **FederationDataSource** that includes the single query. This data source becomes available in the [Report Explorer](../../../../articles/report-designer/report-designer-for-winforms/report-designer-tools/ui-panels/report-explorer.md)'s **Components** node. The [Field List](../../../../articles/report-designer/report-designer-for-winforms/report-designer-tools/ui-panels/field-list.md) reflects the data source structure.

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

@@ -0,0 +1,170 @@
+---
+title: Bind a Report to a Transformation-Based Data Source
+author: Eugene Polevikov
+---
+
+# Bind a Report to a Transformation-Based Data Source
+
+If you bind a report to a [JSON](bind-a-report-to-json-data.md), [Object](bind-a-report-to-an-object-data-source.md), [Entity Framework](bind-a-report-to-an-entity-framework-data-source.md), or [XPO](bind-a-report-to-an-xpo-persistent-object.md) data source that contains a collection property, you can flatten the data source structure:
+
+![](../../../../images/federated-data-source-transformation.png)
+
+This tutorial illustrates how to use the **Federation Data Source**'s **Transformation** mode to flatten a JSON Data Source that contains a collection property.
+
+## Create a Report and Bind it to a Data Source
+
+1. [Create a new blank report](../add-new-reports.md)
+
+2. [Add a JSON data source](bind-a-report-to-json-data.md)
+
+	This tutorial uses the following JSON string:
+
+    ```
+    [
+    {
+        "CategoryId": 1,
+        "CategoryName": "Beverages",
+        "Description": "Soft drinks, coffees, teas, beers, and ales",
+        "Products": [
+        {
+            "ProductId": 1,
+            "ProductName": "Chai",
+            "SupplierId": 1,
+            "CategoryId": 1,
+            "QuantityPerUnit": "10 boxes x 20 bags",
+            "UnitPrice": 18.0000,
+            "UnitsInStock": 39,
+            "UnitsOnOrder": 0,
+            "ReorderLevel": 10,
+            "Discontinued": false,
+            "Supplier": null
+        },
+        {
+            "ProductId": 2,
+            "ProductName": "Chang",
+            "SupplierId": 1,
+            "CategoryId": 1,
+            "QuantityPerUnit": "24 - 12 oz bottles",
+            "UnitPrice": 19.0000,
+            "UnitsInStock": 17,
+            "UnitsOnOrder": 40,
+            "ReorderLevel": 25,
+            "Discontinued": false,
+            "Supplier": null
+        }
+        ]
+    },
+    {
+        "CategoryId": 2,
+        "CategoryName": "Condiments",
+        "Description": "Sweet and savory sauces, relishes, spreads, and seasonings",
+        "Products": [
+        {
+            "ProductId": 3,
+            "ProductName": "Aniseed Syrup",
+            "SupplierId": 1,
+            "CategoryId": 2,
+            "QuantityPerUnit": "12 - 550 ml bottles",
+            "UnitPrice": 10.0000,
+            "UnitsInStock": 13,
+            "UnitsOnOrder": 70,
+            "ReorderLevel": 25,
+            "Discontinued": false,
+            "Supplier": null
+        },
+        {
+            "ProductId": 4,
+            "ProductName": "Chef Anton's Cajun Seasoning",
+            "SupplierId": 2,
+            "CategoryId": 2,
+            "QuantityPerUnit": "48 - 6 oz jars",
+            "UnitPrice": 22.0000,
+            "UnitsInStock": 53,
+            "UnitsOnOrder": 0,
+            "ReorderLevel": 0,
+            "Discontinued": false,
+            "Supplier": null
+        }
+        ]
+    }
+    ]
+    ```
+
+The [Field List](../report-designer-tools/ui-panels/field-list.md) displays the created JSON data source.
+
+![](../../../../images/federated-data-source-json-field-list.png)
+
+## Create Data Federation and Transform the Data Source
+
+1. Click the report's smart tag, expand the **DataSource** property's drop-down menu, and click **Add Report Data Source**.
+
+    ![](../../../../images/federated-data-source-add-federated-data-source.png)
+
+2. In the invoked **Data Source Wizard**, select **Data Federation** and click **Next**.
+
+    ![](../../../../images/data-federation-wizard-choose-data-federation.png)
+
+3. On the next page, click **Add Query**.
+
+    ![](../../../../images/federated-data-source-add-query.png)
+
+4. In the invoked [Query Builder](../report-designer-tools/query-builder.md), select the **Transformation** query type. Select the data source or query that contains columns you want to transform. Select the **Transform** check box next to the column you need to unfold and flatten. The bottom pane allows you to specify the aliases for the generated columns.
+
+    ![](../../../../images/federated-data-source-transformation-query.png)
+
+    Click **OK** to create the query and click **Finish** to create the data source.
+
+The **Field List** displays the created Federation Data Source.
+
+![](../../../../images/federated-data-source-result.png)
+
+## Prepare the Report Layout
+
+1. Set the **Landscape** orientation for report pages. Select the report and switch to the **Properties** panel. Enable the **Landscape** property.
+
+    ![Set Landscape Page Orientation](../../../../images/federated-data-source-landscape-orientation.png)
+
+2. Drop data fields from the **Field List** onto the report's [Detail](../introduction-to-banded-reports.md) band. Hold CTRL or SHIFT and click the fields to select multiple fields.
+
+    ![Drop Fields Onto the Report](../../../../images/federated-data-source-drop-fields.png)
+
+3. Add a **ReportHeader** band to the report. Right-click the report and select **Insert Band** / **ReportHeader**.
+
+    ![Add Report Header](../../../../images/federated-data-source-insert-reportheader.png)
+
+4. Create headers for the report columns. Select data fields and drop them onto the added **ReportHeader** band with the right mouse button.
+
+    ![Drop Table Headers](../../../../images/federated-data-source-drop-headers.png)
+
+5. Change header titles as necessary. Double-click a cell and type the new title.
+
+    ![Change Header Titles](../../../../images/federated-data-source-change-header-titles.png)
+
+6. Resize report columns. Select cells and drag their edges.
+
+    ![Resize Table Cells](../../../../images/federated-data-source-resize-cells.png)
+
+7. Change the header cells' appearance. Select cells and specify the following properties:
+
+    | Property | Value |
+    | --- | --- |
+    | **Foreground Color** | White |
+    | **Background Color** | DimGray |
+    | **Padding** | 10, 10, 0, 0 |
+    | **Font** | Arial, 9pt, style=Bold |
+
+    ![Change Cell Appearance](../../../../images/federated-data-source-change-cell-appearance.png)
+
+8. Change the band heights to match the table rows. Select the bands and drag their edges the same way as for the table cells.
+
+9. Add a style for the table's even rows. Select **TableRow2** in the **Properties** window, expand the **Styles** property, and select **New** for the **Even Style** property. Then select **Style1** and set the **Background Color** property to **216, 216, 216**.
+
+    ![Set Even Style](../../../../images/federated-data-source-set-even-style.png)
+
+10. Format the price values. Select the cell that displays the **Products_UnitPrice** value and set its [Format String] to **{0:c2}**.
+
+    ![Specify Cell Format](../../../../images/federated-data-source-set-format-string.png)
+
+The report is ready. Upper-level data source records are repeated as many times as there are flattened records:
+
+![Records Repeated](../../../../images/federation-data-source-report-result.png)

interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/bind-to-data/bind-a-report-to-a-union-based-federated-data-source.md

@@ -48,16 +48,12 @@ You can create a federated data source for your report to display data combined
     <!--image-->
     ![](../../../../images/DataFederationUnion-Common-Fields.png)
 
-6. Enable check boxes for the data fields you want to include in the query result set.
-
-    <!--image-->
-
-7. Rename fields.
+6. Rename fields.
 
     <!--image-->
     ![](../../../../images/DataFederation-FieldAliases.png)
 
-8. Click **OK** to close the Query Builder. Click **Finish** to complete the Data Source Wizard.
+7. Click **OK** to close the Query Builder. Click **Finish** to complete the Data Source Wizard.
 
 The Wizard creates a new **FederationDataSource** that includes the single **Customers** query. This data source becomes available in the [Report Explorer](../../../../articles/report-designer/report-designer-for-winforms/report-designer-tools/ui-panels/report-explorer.md)'s **Components** node. The [Field List](../../../../articles/report-designer/report-designer-for-winforms/report-designer-tools/ui-panels/field-list.md) reflects the data source structure. 
 

interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/bind-to-data/use-embedded-fields-mail-merge.md

@@ -43,7 +43,7 @@ This adds the selected format to the target data field by separating it from the
 ## <a name="supportedcontrols"></a>Supported Controls
 You can apply the mail merge feature to the **Text** of the following report controls:
 
-* [Bar Code](../use-report-elements/use-bar-codes.md)
+* [Barcode](../use-report-elements/use-bar-codes.md)
 * [Character Comb](../use-report-elements/use-basic-report-controls/character-comb.md)
 * [Check Box](../use-report-elements/use-basic-report-controls/check-box.md)
 * [Label](../use-report-elements/use-basic-report-controls/label.md)

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

@@ -0,0 +1,73 @@
+---
+title: Create Reports
+author: Anna Gubareva
+---
+# Create Reports
+
+This section contains tutorials that explain how to create different reports.
+
+## Basic Reports
+
+### [Table Reports](create-reports/table-reports.md)
+![](../../../images/table-report-preview.png)
+
+### [Vertical Reports](create-reports\vertical-reports.md)
+![](../../../images/vertical-report-preview.png)
+
+## Reports with Hierarchical Data
+
+### [Master-Detail Reports with Detail Report Bands](create-reports/master-detail-reports-with-detail-report-bands.md)
+![](../../../images/master-detail-with-detail-report-bands-preview.png)
+
+### [Master-Detail Reports with Subreports](create-reports/master-detail-reports-with-subreports.md)
+![](../../../images/master-detail-with-subreport-preview.png)
+
+### [Hierarchical Reports](create-reports/hierarchical-reports.md)
+![](../../../images/hierarchical-report-preview.png)
+
+## Invoice Reports
+
+### [Invoices](create-reports/invoices.md)
+![](../../../images/manual-invoice-preview.png)
+
+### [Invoices from Templates](create-reports/invoices-from-templates.md)
+![](../../../images/template-invoice-preview.png)
+
+## Cross-Tab Reports
+
+### [Cross-Tab Reports](create-reports/cross-tab-reports.md)
+![](../../../images/cross-tab-report-preview.png)
+
+### [Balance Sheets](create-reports/balance-sheets.md)
+![](../../../images/balance-sheet-report-preview.png)
+
+## Multi-Column Reports
+
+### [Labels and Badges](create-reports/labels-and-badges.md)
+![](../../../images/labels-and-badges-report-preview.png)
+
+### [Multi-Column Reports](create-reports/multi-column-reports.md)
+![](../../../images/multi-column-report-preview.png)
+
+## Interactive Reports
+
+You can add interactive elements to your report to customize it in Print Preview:
+
+### [Interactive E-Forms](create-reports/interactive-e-forms.md)
+![](../../../images/interactive-eform-preview.png)
+
+> [!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.
+
+## 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)
+![](../../../images/report-with-pdf-content-preview.png)
+
+### [Reports with a Visual PDF Signature](create-reports/reports-with-visual-pdf-signature.md)
+![](../../../images/report-with-a-visual-pdf-signature.png)

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

@@ -2,14 +2,14 @@
 title: Create a Balance Sheet
 author: Anna Gubareva
 ---
-# Create a Balance Sheet
+# Balance Sheets
 
 This tutorial describes how to use the Cross Tab control to create a **Balance Sheet** report.
 
 ![](../../../../images/eurd-win-balance-sheet-report.png)
 
 > [!Tip]
-> This tutorial shows how to configure a Cross Tab using the [Report Wizard](../report-designer-tools/report-wizard.md). See [Create a Cross-Tab Report](create-a-cross-tab-report.md) for information on how to use the Cross-Tab Report Wizard.
+> This tutorial shows how to configure a Cross Tab using the [Report Wizard](../report-designer-tools/report-wizard.md). See the [Cross-Tab Reports](cross-tab-reports.md) tutorial for information on how to use the Cross-Tab Report Wizard.
 
 ## Add a Cross Tab and Bind It to Data
 

…opular-reports/create-a-balance-sheet.md …informs/create-reports/balance-sheets.mdinterface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/create-popular-reports/create-a-balance-sheet.md renamed to interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/create-reports/balance-sheets.md interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/create-popular-reports/create-a-balance-sheet.md renamed to interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/create-reports/balance-sheets.md

@@ -1,15 +1,15 @@
 ---
-title: Create a Cross-Tab Report
+title: Cross-Tab Reports
 author: Anna Gubareva
 ---
-# Create a Cross-Tab Report
+# Cross-Tab Reports
 
 This tutorial describes how to use the Cross Tab control to create a **Sales Summary** report.
 
 ![](../../../../images/eurd-win-cross-tab-report-result-final.png)
 
 > [!TIP]
-> This tutorial demonstrates how to use the Cross-Tab Report Wizard. See [Create a Balance Sheet](create-a-balance-sheet.md) for information on how to configure a Cross Tab on the Design Surface.
+> This tutorial demonstrates how to use the Cross-Tab Report Wizard. See [Balance Sheets](balance-sheets.md) tutorial for information on how to configure a Cross Tab on the Design Surface.
 
 ## Add a Cross-Tab Report