Merge branch 'live' into patch-1

Author: KumarVivek

powerapps-docs/developer/common-data-service/TOC.yml

@@ -431,6 +431,8 @@
     items:
     - name: Download tools from NuGet 
       href: download-tools-nuget.md
+    - name: Install Power Apps CLI
+      href: powerapps-cli.md
   - name: Community Tools
     href: community-tools.md
   - name: Testing tools

powerapps-docs/developer/common-data-service/org-service/metadata-option-sets.md

@@ -26,7 +26,9 @@ context of the publisher set for the solution that the option set is created in.
 This prefix helps reduce the chance of creating duplicate option sets for a managed solution, 
 and in any option sets that are defined in organizations where your managed solution is installed. For more information, 
 see [Merge option set options](../understand-managed-solutions-merged.md#merge-option-set-options).  
- 
+
+You can download the sample from [here](https://github.com/microsoft/PowerApps-Samples/tree/master/cds/orgsvc/C%23/WorkWithOptionSets).
+
 ## Messages Request Classes  
 
 Use the following message request classes to work with global option sets

powerapps-docs/developer/common-data-service/org-service/metadata-relationshipmetadata.md

@@ -2,7 +2,7 @@
 title: "Create and retrieve entity relationship (Common Data Service) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
 description: "Shows code samples to create and retrieve entity relationships." # 115-145 characters including spaces. This abstract displays in the search result.
 ms.custom: ""
-ms.date: 10/31/2018
+ms.date: 01/28/2020
 ms.reviewer: ""
 ms.service: powerapps
 ms.topic: "article"
@@ -17,12 +17,12 @@ search.app:
 ---
 # Create and retrieve entity relationships
 
-<!-- https://docs.microsoft.com/dynamics365/customer-engagement/developer/org-service/create-retrieve-entity-relationships -->
-
-This topic shows how to create and retrieve entity relationships.  
+This topic shows how to create and retrieve entity relationships. You can download the sample from [here](https://github.com/microsoft/PowerApps-Samples/tree/master/cds/orgsvc/C%23/CreateRetrieveEntityRelationships).
 
 <a name="BKMK_Create1NEntityRelationship"></a>   
+
 ## Create a 1:N entity relationship  
+
  The following sample uses the [EligibleCreateOneToManyRelationship](#eligiblecreateonetomanyrelationship) method to verify that the `Account` and `Campaign` entities can participate in a 1:N entity relationship and then creates the entity relationship by using <xref:Microsoft.Xrm.Sdk.Messages.CreateOneToManyRequest>.  
 
 ```csharp
@@ -68,7 +68,7 @@ if (eligibleCreateOneToManyRelationship)
 
 
     CreateOneToManyResponse createOneToManyRelationshipResponse =
-        (CreateOneToManyResponse)_serviceProxy.Execute(
+        (CreateOneToManyResponse)service.Execute(
         createOneToManyRelationshipRequest);
 
     _oneToManyRelationshipId =
@@ -106,7 +106,7 @@ public bool EligibleCreateOneToManyRelationship(string referencedEntity,
     };
 
     CanBeReferencedResponse canBeReferencedResponse =
-        (CanBeReferencedResponse)_serviceProxy.Execute(canBeReferencedRequest);
+        (CanBeReferencedResponse)service.Execute(canBeReferencedRequest);
 
     if (!canBeReferencedResponse.CanBeReferenced)
     {
@@ -123,7 +123,7 @@ public bool EligibleCreateOneToManyRelationship(string referencedEntity,
     };
 
     CanBeReferencingResponse canBeReferencingResponse =
-        (CanBeReferencingResponse)_serviceProxy.Execute(canBereferencingRequest);
+        (CanBeReferencingResponse)service.Execute(canBereferencingRequest);
 
     if (!canBeReferencingResponse.CanBeReferencing)
     {
@@ -189,7 +189,7 @@ if (accountEligibleParticipate && campaignEligibleParticipate)
     };
 
     CreateManyToManyResponse createManytoManyRelationshipResponse =
-        (CreateManyToManyResponse)_serviceProxy.Execute(
+        (CreateManyToManyResponse)service.Execute(
         createManyToManyRelationshipRequest);
 
 
@@ -224,7 +224,7 @@ public bool EligibleCreateManyToManyRelationship(string entity)
     };
 
     CanManyToManyResponse canManyToManyResponse =
-        (CanManyToManyResponse)_serviceProxy.Execute(canManyToManyRequest);
+        (CanManyToManyResponse)service.Execute(canManyToManyRequest);
 
     if (!canManyToManyResponse.CanManyToMany)
     {
@@ -248,15 +248,15 @@ public bool EligibleCreateManyToManyRelationship(string entity)
 RetrieveRelationshipRequest retrieveOneToManyRequest =
     new RetrieveRelationshipRequest { MetadataId = _oneToManyRelationshipId };
 RetrieveRelationshipResponse retrieveOneToManyResponse =
-    (RetrieveRelationshipResponse)_serviceProxy.Execute(retrieveOneToManyRequest);
+    (RetrieveRelationshipResponse)service.Execute(retrieveOneToManyRequest);
 
 Console.WriteLine("Retrieved {0} One-to-many relationship by id", retrieveOneToManyResponse.RelationshipMetadata.SchemaName);
 
 //Retrieve the Many-to-many relationship using the Name.
 RetrieveRelationshipRequest retrieveManyToManyRequest =
     new RetrieveRelationshipRequest { Name = _manyToManyRelationshipName};
 RetrieveRelationshipResponse retrieveManyToManyResponse =
-    (RetrieveRelationshipResponse)_serviceProxy.Execute(retrieveManyToManyRequest);
+    (RetrieveRelationshipResponse)service.Execute(retrieveManyToManyRequest);
 
 Console.WriteLine("Retrieved {0} Many-to-Many relationship by Name", retrieveManyToManyResponse.RelationshipMetadata.MetadataId);
 ```

powerapps-docs/developer/common-data-service/org-service/samples/create-retrieve-outlook-filters.md

@@ -36,9 +36,11 @@ Checks for the current version of the org.
 
 ### Demonstrate
 
-The `SavedQuery` method creates and retrieves the offline filter. In your Outlook client , this will appear in the System filters tab under **File** > **CRM** > **Synchronize** > **Outlook Filters**.
+1. The `fetchXml` method creates asn retrieves offline filter. In your Outlook client, this will appear in System Filters tab under **File -> CRM -> Synchronize -> Outlook Filters**.
+2. The `InstantiateFiltersRequest` method activates the selected offline templates for the current user.
+3. The `ResetUserFilterRequest` method resets the current user's offline templates to the defaults.
 
 ### Clean up
 
-No Clean up is required for this sample.
+Display an option to delete the sample data that is created in [Setup](#setup). The deletion is optional in case you want to examine the entities and data created by the sample. You can manually delete the records to achieve the same result.
 

powerapps-docs/developer/common-data-service/org-service/samples/download-report-definition.md

@@ -0,0 +1,47 @@
+---
+title: " Download report definition (Common Data Service) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
+description: "This sample showcases how to download report definition" # 115-145 characters including spaces. This abstract displays in the search result.
+ms.custom: ""
+ms.date: 12/20/2019
+ms.reviewer: ""
+ms.service: powerapps
+ms.topic: "samples"
+author: "JimDaly" # GitHub ID
+ms.author: "jdaly" # MSFT alias of Microsoft employees only
+manager: "ryjones" # MSFT alias of manager or PM counterpart
+search.audienceType: 
+  - developer
+search.app: 
+  - PowerApps
+  - D365CE
+---
+
+
+# Download report definition
+
+This sample shows how to download a report definition (.rdl) file by using the [DownloadReportDefinitionRequest](https://docs.microsoft.com/dotnet/api/microsoft.crm.sdk.messages.downloadreportdefinitionrequest?view=dynamics-general-ce-9) message. You can download the sample from [here](https://github.com/microsoft/PowerApps-Samples/tree/master/cds/orgsvc/C%23/DownloadReportDefinition).
+
+## How to run this sample
+
+[!include[cc-how-to-run-samples](../../includes/cc-how-to-run-samples.md)]
+
+## What this sample does
+
+The `DownloadReportDefinitionRequest` message is intended to be used in a scenario where it contains the data that is needed to download a report definition.
+
+## How this sample works
+
+In order to simulate the scenario described in [What this sample does](#what-this-sample-does), the sample will do the following:
+
+### Setup
+
+Checks for the current version of the org.
+
+### Demonstrate
+
+1. The `QueryByAttribute` method  queries for an existing report.
+2. The `DownloadReportDefinitionRequest` method downloads  the report definition.
+
+### Clean up
+
+Display an option to delete the sample data that is created in [Setup](#setup). The deletion is optional in case you want to examine the entities and data created by the sample. You can manually delete the records to achieve the same result.

powerapps-docs/developer/common-data-service/org-service/samples/query-using-linq.md

@@ -0,0 +1,50 @@
+---
+title: "Query data using LINQ (Common Data Service) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
+description: "This sample showcases how to assign records to a team." # 115-145 characters including spaces. This abstract displays in the search result.
+ms.custom: ""
+ms.date: 02/05/2020
+ms.reviewer: ""
+ms.service: powerapps
+ms.topic: "samples"
+author: "phecke" # GitHub ID
+ms.author: "pehecke" # MSFT alias of Microsoft employees only
+manager: "KumarVivek" # MSFT alias of manager or PM counterpart
+search.audienceType: 
+  - developer
+search.app: 
+  - PowerApps
+  - D365CE
+---
+# Sample: Query data using LINQ
+
+These samples show how to query business data using [Language-Integrated Query (LINQ)](https://docs.microsoft.com/dotnet/csharp/programming-guide/concepts/linq/introduction-to-linq-queries). You can download the sample from [here](https://github.com/microsoft/PowerApps-Samples/tree/master/cds/orgsvc/C%23/QueriesUsingLINQ). 
+
+## How to run this sample
+
+See [How to run samples](https://github.com/microsoft/PowerApps-Samples/blob/master/cds/README.md) for information about how to run this sample. There are multiple projects in the solution. Each project demonstrates some aspect of LINQ queries.
+
+## What this sample does
+
+Read each sample's comments to find out what each sample does. There are samples that:
+* Create a simple LINQ query
+* Create a LINQ query using entity late binding
+* Retrieve multiple records using condition operators
+* Complex queries - a wide assortment of LINQ examples
+
+## How this sample works
+
+In order to simulate the scenario described in [What this sample does](#what-this-sample-does), the sample will do the following:
+
+### Setup
+
+Creates any entity instances required by the `Demonstrate` region of each `Main`() method.
+
+### Demonstrate
+
+Code in the `Demonstrate` region of the `Main`() method performs one or more LINQ queries.
+
+### Clean up
+
+Displays an option to delete the records created in [Setup](#setup).
+
+The deletion is optional in case you want to examine the entities and data created by the sample. You can manually delete the records to achieve the same result.

powerapps-docs/developer/common-data-service/org-service/samples/toc.yml

@@ -258,8 +258,8 @@
   items:
   - name: Execute multiple requests
     href: execute-multiple-requests.md
-  - name: Execute multiple requests in trnasaction
-    hre4f: execute-multiple-transaction.md
+  - name: Execute multiple requests in transaction
+    href: execute-multiple-transaction.md
 - name: Solutions
   items:
   - name: Work with solutions
@@ -272,6 +272,8 @@
     href: retrieve-time-zone-information.md
 - name: Query Data
   items:
+  - name: Query data using LINQ
+    href: query-using-linq.md
   - name: Use QueryExpression with a paging cookie
     href: use-queryexpression-with-a-paging-cookie.md
   - name: Retrieve multiple with the QueryExpression class

powerapps-docs/developer/common-data-service/org-service/samples/use-outlook-methods.md

@@ -0,0 +1,47 @@
+---
+title: " Use Outlook methods (Common Data Service) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
+description: "This sample showcases how to use the Outlook methods." # 115-145 characters including spaces. This abstract displays in the search result.
+ms.custom: ""
+ms.date: 12/20/2019
+ms.reviewer: ""
+ms.service: powerapps
+ms.topic: "samples"
+author: "JimDaly" # GitHub ID
+ms.author: "jdaly" # MSFT alias of Microsoft employees only
+manager: "ryjones" # MSFT alias of manager or PM counterpart
+search.audienceType: 
+  - developer
+search.app: 
+  - PowerApps
+  - D365CE
+---
+
+# Sample: Use Dynamics 365 for Outlook methods
+
+This sample shows how to use the methods available in the [Microsoft.Crm.Outlook.Sdk.dll](https://docs.microsoft.com/dotnet/api/microsoft.crm.outlook.sdk?view=dynamics-outlookclient-ce-9) assembly. You can download the sample from [here]().
+
+## How to run this sample
+
+[!include[cc-how-to-run-samples](../../includes/cc-how-to-run-samples.md)]
+
+## What this sample does
+
+The `Microsoft.Crm.Outlook.sdk` assembly is used in a scenario where it contains types that provide programmatic interaction with Microsoft Dynamics 365 for Outlook and Microsoft Dynamics 365 for Microsoft Office Outlook with Offline Access.
+
+## How this sample works
+
+In order to simulate the scenario described above, the sample will do the following:
+
+### Setup
+
+Checks for the current version of the org.
+
+### Demonstrate
+
+1. The `CrmOutlookService` method sets up the service.
+2. The `CrmOutlookService.IsCrmClientOffline` method checks if the client is offline.
+3. The `CrmOutlookService.GoOnline()` method takes the client to online. This method will automatically sync up with database, there is no need to call the `Sync()` method.
+
+### Clean up
+
+Display an option to delete the sample data that is created in [Setup](#setup). The deletion is optional in case you want to examine the entities and data created by the sample. You can manually delete the records to achieve the same result.

powerapps-docs/developer/common-data-service/powerapps-cli.md

@@ -0,0 +1,79 @@
+---
+title: Install Power Apps CLI | Microsoft Docs
+description: "Get the Microsoft Power Apps CLI to create, debug, and deploy code components using Power Apps component framework."
+keywords: Power Apps CLI, code components, component framework, CLI
+ms.author: nabuthuk
+author: Nkrb
+manager: kvivek
+ms.date: 01/28/2020
+ms.service: "powerapps"
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f393f227-7a88-4f25-9036-780b3bf14070
+---
+
+# What is Microsoft Power Apps CLI? 
+
+Microsoft Power Apps CLI is a simple, single-stop developer command-line interface that empowers developers and app makers to create code components. 
+
+Power Apps CLI tooling is the first step toward a comprehensive application life cycle management (ALM) story where the enterprise developers and ISVs can create, build, debug, and publish their extensions and customizations quickly and efficiently.  
+
+## Install Power Apps CLI
+
+To get Power Apps CLI, do the following:
+
+1. Install [Npm](https://www.npmjs.com/get-npm) (comes with Node.js) or [Node.js](https://nodejs.org/en/) (comes with npm). We recommend LTS (Long Term Support) version 10.15.3 or higher.
+
+1. Install [.NET Framework 4.6.2 Developer Pack](https://dotnet.microsoft.com/download/dotnet-framework/net462). 
+
+1. If you don’t already have Visual Studio 2017 or later, follow one of these options:
+   - Option 1: Install [Visual Studio 2017](https://docs.microsoft.com/visualstudio/install/install-visual-studio?view=vs-2017) or later.
+   - Option 2: Install [.NET Core 3.1 SDK](https://dotnet.microsoft.com/download/dotnet-core/current) and then install [Visual Studio Code](https://code.visualstudio.com/Download).
+
+1. Install [Power Apps CLI](https://aka.ms/PowerAppsCLI).
+
+1. To take advantage of all the latest capabilities, update the Power Apps CLI tooling to the latest version using this command:
+
+    ```CLI
+    pac install latest
+    ```
+
+> [!NOTE]
+> Currently, Power Apps CLI is supported only on Windows 10.
+
+## Common commands
+
+This table lists some common commands used in the CLI:
+
+|Command|Description|Examples|
+|------|-----------|--------|
+|**pcf**|Commands for working with [Power Apps component framework](/powerapps/developer/component-framework/overview). It has the following parameters: <br/> - **init**: Initializes the code component project. It has the following parameters <br/> - *namespace*: Namespace of the code component. <br/> - *name*: Name of the code component. <br/> - *template*: Field or dataset <br/> - **push**: Pushes the code component to the Common Data Service instance with all the latest changes. It has the following parameter: <br/> - *publisher-prefix*: Publisher prefix of the organization.| `pac pcf init --namespace <specify your namespace here> --name <Name of the code component> --template <component type>` <br/> <br/> `pac pcf push --publisher-prefix <your publisher prefix>`|
+|**solution**|Commands for working with Common Data Service solution projects. It has the following parameters: <br/> - **init**: Initializes the solution project. It has the following parameters:<br/>  - *publisher-name*: Publisher name of the organization. <br/>  - *publisher-prefix*: Publisher prefix of the organization. <br/> - **add-reference**: Sets the reference path to the component project folder by passing the `path` parameter.<br/> - **clone**: Creates a solution project based up on the existing solution project by passing the following parameters `name`, `version`, and `include`|`pac solution init --publisher-name <enter your publisher name> --publisher-prefix <enter your publisher prefix>` <br/><br/> `pac solution add-reference --path <path to your Power Apps component framework project>`<br/><br/> `pac solution clone –name<name of the solution to be exported> --version <version of your solution> --include <settings that should be included>`|
+|**auth**|Commands to authenticate to Common Data Service. It has the following parameters: <br/> - **create**: Creates the authentication profile for your organization by passing the `url` parameter. You need to pass the organization url for the `url` parameter. <br/> - **list**: Provides the list of authentication profiles. <br/> - **select**: Provides a way to switch between previously created authentication profiles by passing the `index` parameter.<br/>**delete**: Deletes the authentication profile created by passing  the `index` parameter.|`pac auth create --url <your Common Data Service org’s url>` <br/> <br/> `pac auth list` <br/><br/> `Pac auth select --index <index of the active profile>`|
+|**telemetry**|Manages the telemetry settings. It has the following parameters: <br/>- *enable*: Enables the telemetry option.<br/> - *disable*: Disables the telemetry option.<br/> - *status*: Returns whether the telemetry is enabled or disabled.|`pac telemetry enable` <br/><br/> `pac telemetry disable`|
+|**org**|Command to work with Common Data Service.|`pac org who`|
+|**plugin**|Manages to create a [plug-in](/powerapps/developer/common-data-service/plug-ins) project|`pac plugin init`|
+
+## Uninstall Power Apps CLI
+
+To uninstall the Power Apps CLI tooling, run the MSI from [here](https://aka.ms/PowerAppsCLI).
+
+If you are a **Private Preview** participant and have an older version of CLI, follow these steps:
+
+1. To find out where the Power Apps CLI is installed, open a command prompt and type `where pac`.
+
+1. Delete the PowerAppsCLI folder.
+
+1. Open the Environment Variables tool by running the command `rundll32 sysdm.cpl,EditEnvironmentVariables` in the command prompt.
+
+1. Double-click `Path` under the `User variable for...` section.
+
+1. Select the row containing the PowerAppsCLI path and select the **Delete** button on the right-hand side.
+
+1. Select **OK** twice.
+
+
+## See also
+
+[Power Apps component framework](../component-framework/overview.md)

powerapps-docs/developer/component-framework/community-resources.md

@@ -64,7 +64,6 @@ The following is the list of videos created by Power Apps community.
 - [Power Apps component framework Academy: Working with manifest file](https://www.youtube.com/watch?v=qbSpDVTxt7U&t=5s)
 - [Power Apps component framework code components](https://www.youtube.com/watch?v=FxWF-LCCB4g&feature=youtu.be)
 
-
 ## Tools
 
 The [Code component builder](https://www.xrmtoolbox.com/plugins/Maverick.PCF.Builder/) is a tool from XrmToolBox that lets you create code components in visual manner using the Power Apps CLI.