Pull changes from upstream

Author: epolevikov

dashboard-for-desktop/articles/dashboard-designer/provide-data.md

@@ -19,3 +19,4 @@ This section contains the following topics.
 * [Binding to XPO Data Sources](provide-data/binding-to-XPO-data-sources.md)
 * [Connect to EF Data Sources](provide-data/connect-to-ef-data-sources.md)
 * [Binding to Federated Data Source](provide-data/binding-to-federated-data-source.md)
+* [Binding to MongoDB](provide-data/binding-to-mongodb.md)

dashboard-for-desktop/articles/dashboard-designer/provide-data/binding-to-federated-data-source.md

@@ -5,72 +5,77 @@ author: Margarita Zakhodyaeva
 
 # Binding to Federated Data Source
 
-A _federated data source_ combines multiple data sources (except OLAP) in one.
+You can create a federated data source if a dashboard contains at least one data source. Create a federated query where you specify how to federate existing data sources.
 
-## Overview
+You can create federated queries of the following types:
 
-You can create a federated data source if a dashboard contains at least one data source. To do this, create a query where you specify how to federate existing data sources. The federated query can be one of the following types:
+- **Join**
 
-### Join
-Combines rows from two or more tables based on a column they share. The join type specifies records that have matching values in both tables.
+  Combines rows from two or more tables based on a clause. 
 
-### Union
-Combines rows from two or more tables into one data set and removes duplicate rows in merged tables. You can only create a union query for data sources that contain columns with the same name. Data types of such columns should be [implicitly converted](https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/types/casting-and-type-conversions#implicit-conversions).
+- **Union and Union All**
 
-### Union All
-Operates like **Union**, but duplicates rows from different tables when they contain the same data.
-
-### Transformation
-Unfolds complex objects and flattens them in a simple data set. The dashboard does not support data source fields that store collections, so you need to transform the data source into a new flattened data table.
+  The **Union** query combines rows from two or more tables into one data set and removes duplicate rows in merged tables. The **UnionAll** query does the same, except it doesn't remove duplicated rows. You can create a union query for data sources if data types of their columns are [implicitly converted](https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/types/casting-and-type-conversions#implicit-conversions). 
+- **Transformation**
 
+  If a data source contains a complex column (an object), you can transform its properties to display columns separately in a flattened view.
+  
 ## Create a Federated Data Source with the Data Source Wizard
 
-To create a federated data source with the Data Source Wizard, perform the following steps:
+Follow the steps below to create a federated data source with the Data Source Wizard:
+### Create a New Federated Data Source
 
-1. Click the **New Data Source** button in the **Data Source** ribbon tab.
+Click the **New Data Source** button in the **Data Source** ribbon tab.
 
-   ![Choose_new_data_source](../../../images/choose-new-data-source.png)
+![Choose_new_data_source](../../../images/choose-new-data-source.png)
 
-2. On the first page of the invoked **Data Source Wizard** dialog, select **Data Federation** and click **Next**.
+On the first page of the invoked **Data Source Wizard** dialog, select **Data Federation** and click **Next**.
 
-   ![Choose_federated_data_source](../../../images/choose-federated-data-source.png)
+![Choose_federated_data_source](../../../images/choose-federated-data-source.png)
+### Select the Query Type 
 
-3. The [Query Builder](../../dashboard-designer/work-with-data/using-the-query-builder.md) dialog displays available data sources.
+The [Query Builder](../../dashboard-designer/work-with-data/using-the-query-builder.md) displays the available data sources you can use to create queries.
 
    ![Query_Builder_available_sources](../../../images/query-builder-available-sources.png)
 
-4. Select the **Query Type**:
-
    **Join**
+     
+   Drag the data sources you want to join to the diagram pane, specify the related column to create the relationship between tables, and select the columns you want to include in the query. Use _* (All Columns)_ to get a complete list of columns from a table. Columns included in the query are displayed in the bottom pane where you can configure their settings.
 
-   Drag-and-drop the data sources, specify the related column to create the relationship between tables, and select the columns you want to include in the query. Use _* (All Columns)_ to get a complete list of the columns from a table. Columns included in the query are displayed in the bottom pane where you can configure their settings.
-
-   ![Federated_data_source_settings](../../../images/federated-source-settings.png)
+   ![Data-Federation-Query-Builder](../../../images/data-federation-querybuilder.png)
 
    **Union**
 
-   Double-click the data sources you want to combine. Unlike join queries, you cannot select individual columns. Columns included in the query are displayed in the bottom pane where you can specify their aliases.
+   Double-click the data sources you want to combine. Unlike Join queries, you cannot select individual columns. Columns included in the query are displayed in the bottom pane where you can specify their aliases.
 
-   ![data-federation-querybuilder-union](../../../images/data-federation-querybuilder-union.png)
+   ![Query-builder-union](../../../images/data-federation-querybuilder-union.png)
 
    **Union All** 
 
    Double-click the data sources you want to combine. A **UnionAll** query duplicates rows from different tables even if they contain the same data. Columns included in the query are displayed in the bottom pane where you can specify their aliases.
 
-   ![data-federation-querybuilder-union-all](../../../images/data-federation-querybuilder-union-all.png)
+   ![Query-builder-union-all](../../../images/data-federation-querybuilder-union-all.png)
 
    **Transformation**
 
    Select a data source/query that contains columns you want to transform. Select the **Transform** checkbox next to the column you want to unfold and flatten. The bottom pane allows you to specify the aliases for the generated columns.
 
-   ![data-federation-querybuilder-transformation](../../../images/data-federation-querybuilder-transformation.png)
+   ![Query-builder-transformation](../../../images/data-federation-querybuilder-transformation.png)
+
+Click **OK** to create a query.
+
+### Copy Calculated Fields
+The Data Source Wizard invokes the following page if one of the selected data sources contains calculated fields. Drag or double-click the calculated field you want to copy to the resulting federated data source. You can specify the name of the copied calculated field in the left Grid. 
+
+![Copy-calculated-fields](../../../images/data-federation-data-source-browser-copy-calculated-fields.png)
+
+
+### See the Result
 
-   Click **OK** to create a query.
- 
-5. The [Data Source Browser](../ui-elements/data-source-browser.md) displays the newly created Federated Data Source.
+The [Data Source Browser](../ui-elements/data-source-browser.md) displays the newly created Federated Data Source. 
 
-   The image below displays a new _Federation Data Source 1_ with a joined _SQlite Orders_ query.
+The image below displays a new _Federation Data Source 1_ with a joined _SQlite_ Orders query.
 
-   ![Federated_data_source_configuration](../../../images/data-source-browser-federated-data-source.png)
+![Federated_data_source_configuration](../../../images/data-source-browser-federated-data-source.png)
 
-    The query name is the same as the root table's name in the query builder. Click the **Rename** button in the **Query** group on the **Data Source** ribbon tab to change the query name.
+The query name is the same as the root table's name in the query builder. Click the **Rename** button in the **Query** group on the **Data Source** ribbon tab to change the query name.

dashboard-for-desktop/articles/dashboard-designer/provide-data/binding-to-mongodb.md

@@ -0,0 +1,37 @@
+---
+title: Binding to MongoDB
+author: Margarita Zakhodyaeva
+---
+# Binding to MongoDB
+
+The WinForms Designer allows you to connect to MongoDB in the Data Source Wizard. 
+
+> [!NOTE]
+> The [MongoDB.Driver](https://www.nuget.org/packages/MongoDB.Driver) package should be installed in your project to supply MongoDB data at runtime.
+
+Follow the steps below to establish a database connection:
+
+1. Click the **New Data Source** button in the **Data Source** ribbon tab.
+	
+    ![new-data-source](../../../images/new-data-source.png)
+2. On the first page of the invoked **Data Source Wizard** dialog, select **MongoDB** and click **Next**.
+
+	![Data Source Wizard DataBase MongoDB](../../../images/win-data-source-wizard-database-mongodb.png)
+    
+3. Specify connection parameters on the next page in the following ways: 
+
+    - Pass an entire string. 
+
+        ![MongoDB Connection String](../../../images/win-data-source-wizard-mongo-specify-connection-parameters.png)
+
+        Refer to the following topic for information about connection string format and options: [Connection String URI Format](https://docs.mongodb.com/manual/reference/connection-string/).
+
+    - Enter connection fields individually.
+
+        ![MongoDB Individual Connection Fields](../../../images/win-data-source-wizard-database-mongodb-individual.png)
+
+   
+
+4. The following page allows you to configure queries. Select databases and collections that you want to load from the MongoDB instance. A string stored in a query's **Collection** column is the default name for the query. The names of MongoDB queries should be unique. You can use the **Alias** column to set unique names for queries in the same collection. To filter queries, add a filter string to the **Filter** column.
+
+    ![Data Source Wizard MongoDB specify quueries](../../../images/win-data-source-wizard-mongodb-specify-queries.png) 

dashboard-for-desktop/articles/dashboard-designer/provide-data/supported-data-sources.md

@@ -6,7 +6,7 @@ legacyId: 17239
 # Supported Data Sources
 The Dashboard Designer allows you to establish a connection to various data sources such as SQL databases, Microsoft Excel workbooks, XML/CSV data files or OLAP cubes.
 
-The following data source types are supported.
+The following data source types are supported:
 * [SQL Data Source](#sql-data-source)
 * [OLAP Data Source](#olap-data-source)
 * [Microsoft Excel Workbooks/CSV Files](#microsoft-excel-workbookscsv-files)
@@ -16,9 +16,7 @@ The following data source types are supported.
 * [Object Data Source](#object-data-source)
 * [Entity Framework Data Source](#entity-framework-data-source)
 * [Federated Data Source](#federated-data-source) 
-
-
-
+* [MongoDB](#mongodb)
 
 
 ## SQL Data Source
@@ -41,16 +39,16 @@ To connect to various SQL databases, the Dashboard Designer requires correspondi
 | MySQL | 4.1 or higher | ADO.NET driver for MySQL | MySql.Data.dll | [Download link](http://dev.mysql.com/downloads/connector/net/) |
 | Pervasive PSQL | 9.x or higher | PSQL ADO.NET Data Provider | Pervasive.Data.SqlClient.dll | [Download link](http://www.pervasive.com/database/Home/Products/psqlv12.aspx) |
 | PostgreSQL | 7.x or higher | .NET data provider for PostgreSQL | Npgsql.dll | [Download link](http://www.npgsql.org/) |
-| VistaDB | 4, 5 | VistaDB ADO.NET Provider | VistaDB.5.NET40.dll | [Download link](http://www.gibraltarsoftware.com/VistaDB) |
+| VistaDB | 4, 5, 6 | VistaDB ADO.NET Provider | VistaDB.5.NET40.dll | [Download link](http://www.gibraltarsoftware.com/VistaDB) |
 | SQLite | 3.x | ADO.NET provider for SQLite | System.Data.SQLite.dll | [Download link](https://system.data.sqlite.org/index.html/doc/trunk/www/index.wiki) |
 | XML file | n/a | n/a | n/a | n/a |
 
-To create a connection to a SQL data source, see [Binding to SQL databases](connecting-to-sql-databases.md).
+See the following topic for information on how to create a connection to a SQL data source: [Binding to SQL databases](connecting-to-sql-databases.md).
 
 ## OLAP Data Source
-To use the OLAP data source, the Dashboard Designer requires Microsoft Analysis Services OLE DB and Microsoft ADOMD.NET providers to be installed on your machine. To learn more, see [Data providers used for Analysis Services connections](https://msdn.microsoft.com/en-us/library/dn141152.aspx#bkmk_OLE).
+To use the OLAP data source, the Dashboard Designer requires Microsoft Analysis Services OLE DB and Microsoft ADOMD.NET providers to be installed on your machine. Refer to the following topic for more information: [Data providers used for Analysis Services connections](https://msdn.microsoft.com/en-us/library/dn141152.aspx#bkmk_OLE).
 
-The following OLAP servers are supported.
+The following OLAP servers are supported:
 * Microsoft SQL Server 2000 Analysis Services
 * Microsoft SQL Server 2005 Analysis Services
 * Microsoft SQL Server 2008 Analysis Services
@@ -62,7 +60,7 @@ The following OLAP servers are supported.
 To create a connection to an OLAP cube data source, see [Binding to OLAP cubes](connecting-to-olap-cubes.md).
 
 ## Microsoft Excel Workbooks/CSV Files
-The following Microsoft Excel/text formats are supported.
+The following Microsoft Excel/text formats are supported:
 * XLS
 * XLSX
 * XLSM
@@ -98,7 +96,7 @@ This data is saved to a local file and can be updated from the original data sou
 
 ## Object Data Source
 
-The Dashboard Designer provides a connection to an object data source defined in a separate class within a current project.
+The Dashboard Designer allows you to connect to an object data source defined in a separate class within the current project.
 
 To create a connection to an Object data source, see [Binding to Object Data Sources](binding-to-object-data-sources.md).
 
@@ -118,8 +116,21 @@ To create a connection to an EF data source, see [Connect to EF Data Sources](co
 * [SQL Data Source](#sql-data-source)
 * [Excel Data Source](#microsoft-excel-workbookscsv-files)
 * [Object Data Source](#object-data-source)
+* [MongoDB](#mongodb)
+
+See the following topic for information on how to create a federated data source with the **Data Source Wizard**: [Binding to Federated Data Source](binding-to-federated-data-source.md).
+
+## MongoDB
+
+The Dashboard Designer allows you to connect to a MongoDB instance and stores data in JSON-like documents.
+
+The [MongoDB.Driver](https://www.nuget.org/packages/MongoDB.Driver) package should be installed in your project to supply MongoDB data at runtime.
+
+You can use MongoDB as the original data source to create an Extract database. MongoDB can be used to create a federated data source.
+
+You can filter the MongoDB data source and add calculated fields.
 
-To create a Federated data source with the **Data Source Wizard**, see [Binding to Federated Data Source](binding-to-federated-data-source.md).
+Refer to the following article for more information on how to connect to MongoDB: [Binding to MongoDB](binding-to-mongodb.md).