Merge branch 'master' into test-studio-canvas-app

Author: tapanm-MSFT

.openpublishing.redirection.json

@@ -1,5 +1,15 @@
 {
   "redirections": [
+    {
+      "source_path": "powerapps-docs/maker/canvas-apps/add-images-to-excel.md",
+      "redirect_url": "add-images-pictures-audio-video",
+      "redirect_document_id": "false"
+    },    
+    {
+      "source_path": "powerapps-docs/maker/canvas-apps/tutorial-working-with-images-in-excel.md",
+      "redirect_url": "add-images-pictures-audio-video",
+      "redirect_document_id": "false"
+    },    
     {
       "source_path": "powerapps-docs/developer/common-data-service/fill-app-submission-form-appsource.md",
       "redirect_url": "register-microsoft-partner-network",

powerapps-docs/developer/common-data-service/image-attributes.md

@@ -256,8 +256,7 @@ byte[]
 In the above request, the next block of data is being uploaded. After all image data has been received by the web service, a thumbnail image is automatically created by the web service.
 
 ### See also  
-[Sample: Set and retrieve entity images](/dynamics365/customer-engagement/developer/sample-set-retrieve-entity-images)
 [File attributes](file-attributes.md)  
 [Introduction to Entities in Dynamics 365](/dynamics365/customer-engagement/developer/introduction-entities)   
- [Introduction to entity attributes in Dynamics 365](/dynamics365/customer-engagement/developer/introduction-entity-attributes)   
- [Sample: Set and retrieve entity images](/dynamics365/customer-engagement/developer/sample-set-retrieve-entity-images)
+[Introduction to entity attributes in Dynamics 365](/dynamics365/customer-engagement/developer/introduction-entity-attributes)   
+[Sample: Set and retrieve entity images](/dynamics365/customerengagement/on-premises/developer/sample-set-retrieve-entity-images)

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

@@ -43,8 +43,8 @@
         href: page-large-result-sets-with-queryexpression.md
       - name: Use a left outer join in QueryExpression to query for records "not in"
         href: use-left-outer-join-queryexpression-query-records-not-in.md
-      - name: Use the QueryByAttribute class
-        href: use-querybyattribute-class.md
+    - name: Use the QueryByAttribute class
+      href: use-querybyattribute-class.md
   - name: Create entities
     href: entity-operations-create.md
   - name: Retrieve an entity

powerapps-docs/developer/common-data-service/org-service/samples/Create-retrieve-entity-relationships.md

@@ -0,0 +1,58 @@
+---
+title: "Sample: Create and retrieve entity relationships  (Common Data Service) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
+description: "This sample shows how 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.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
+---
+
+# Create and retrieve entity relationships
+
+This sample shows how to create and retrieve entity relationships. The following methods are used to create and retrieve the relationships:
+
+- [CreateOneToManyRequest](https://docs.microsoft.com/dotnet/api/microsoft.xrm.sdk.messages.createonetomanyrequest?view=dynamics-general-ce-9)
+- [CreateManyToManyRequest](https://docs.microsoft.com/dotnet/api/microsoft.xrm.sdk.messages.createmanytomanyrequest?view=dynamics-general-ce-9)
+- [CanBeReferencedRequest](https://docs.microsoft.com/dotnet/api/microsoft.xrm.sdk.messages.canbereferencedrequest?view=dynamics-general-ce-9)
+- [CanBeReferencingRequest](https://docs.microsoft.com/dotnet/api/microsoft.xrm.sdk.messages.canbereferencingrequest?view=dynamics-general-ce-9)
+- [CanManyToManyRequest](https://docs.microsoft.com/dotnet/api/microsoft.xrm.sdk.messages.canmanytomanyrequest?view=dynamics-general-ce-9)
+- [RetrieveRelationshipRequest](https://docs.microsoft.com/dotnet/api/microsoft.xrm.sdk.messages.retrieverelationshiprequest?view=dynamics-general-ce-9)
+
+You can download the sample from [here](https://github.com/microsoft/PowerApps-Samples/tree/master/cds/orgsvc/C%23/CreateRetrieveEntityRelationships).
+
+## How to run this sample
+
+[!include[cc-how-to-run-samples](../../includes/cc-how-to-run-samples.md)]
+
+## What this sample does
+
+The `CreateOneToManyRequest`, `CreateManyToManyRequest`, `CanManyToManyRequest`, `CreateOneToManyRequest`, `CanBeReferencedRequest`, `CanBeReferencingRequest`, and `RetrieveRelationshipRequest` messages are intended to be used in a scenario where it contains the data that is needed to create and retrieve entity relationships.
+
+## 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 `CreateOneToManyRequest` method creates a new One-to-Many (1:N) relationship. 
+2. The `CreateManyToManyRequest` method creates a new Many-To-Many (N:N) relationship.
+3. The `EligibleCreateManyToManyRelationship` method verifies whether entities can participate in N:N relationship.
+4. The `RetrieveRelationshipRequest` method retrieves the two entity relationships previously created.
+
+
+### Clean up
+
+Display an option to delete the records created in the [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/access-discovery-service.md

@@ -23,7 +23,7 @@ This sample code shows how to use the discovery service with SDK assemblies. You
 
 This sample will not open dialog to prompt you for connection information.
 
-If you have set `Username` and `Password` values in the App.config connection strings it will use them. Otherwise, set the `username` and `password` variables in the `SampleProgram.Main` method.
+If you have set  and  values in the App.config connection strings, it will use them. Otherwise, set the `username` and `password` variables in the `SampleProgram.Main` method.
 
 ## What this sample does
 

powerapps-docs/developer/common-data-service/org-service/samples/add-record-queue-early-bound.md

@@ -19,7 +19,7 @@ search.app:
 
 This sample shows how to add a record to a queue. It creates source and destination queues. It adds a letter activity to the source queue and then moves it to the destination queue. You can download the sample from [here](https://github.com/Microsoft/PowerApps-Samples/tree/master/cds/orgsvc/C%23/RecordToQueue).
 
-This sample requires additional users that are not in your system. Create the users manually in **Office 365** in order to run the sample without any errors. For this sample create a user profile **as is** shown below. 
+This sample requires additional users that are not in your system. Create the users manually in **Office 365** in order to run the sample without any errors. For this sample, create a user profile **as is** shown below. 
 
 **First Name**: Kevin<br/>
 **Last Name**: Cook<br/>

powerapps-docs/developer/common-data-service/org-service/samples/add-security-principal-user-team-queue-early-bound.md

@@ -38,7 +38,7 @@ In order to simulate the scenario described in [What this sample does](#what-thi
 3. The `QueryExpression` retrieves the default business unit for the creation of the team and role.
 4. Creates a new example team and role required for the sample.
 5. Retrieves the `prvReadQueue` and `prvAppendToQueue` privileges.
-6. The `AddPrivilegeRoleRequest` method adds the `prvReadQueue` abd `prvAppendToQueue` privileges to the example role.
+6. The `AddPrivilegeRoleRequest` method adds the `prvReadQueue` and `prvAppendToQueue` privileges to the example role.
 
 ### Demonstrate
 

powerapps-docs/developer/common-data-service/org-service/samples/assign-record-to-new-owner.md

@@ -0,0 +1,51 @@
+---
+title: " Assign a record to a new owner (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 new owner." # 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
+---
+
+# Assign a record to a new owner
+
+This sample shows how to assign an account to another user by using the [IOrganizationService.Update](https://docs.microsoft.com/dotnet/api/microsoft.xrm.sdk.iorganizationservice.update?view=dynamics-general-ce-9) message.
+
+This sample uses the `IOrganization.Update` method rather than the [AssignRequest](https://docs.microsoft.com/dotnet/api/microsoft.crm.sdk.messages.assignrequest?view=dynamics-general-ce-9) because there is an effort to remove specialized messages. More information: [Perform specialized operations using update](https://docs.microsoft.com/powerapps/developer/common-data-service/special-update-operation-behavior)
+
+You can download the sample from [here](https://github.com/microsoft/PowerApps-Samples/tree/master/cds/orgsvc/C%23/AssignRecordToNewOwner).
+
+## How to run this sample
+
+[!include[cc-how-to-run-samples](../../includes/cc-how-to-run-samples.md)]
+
+## What this sample does
+
+The [IOrganizationService.Update](https://docs.microsoft.com/dotnet/api/microsoft.xrm.sdk.iorganizationservice.update?view=dynamics-general-ce-9) message is intended to be used in a scenario where it contains the data that is needed to update existing record.
+
+## 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
+
+1. Checks for the current version of the org. 
+1. Creates required data that this sample requires.
+
+### Demonstrate
+
+1. The `Retrieve` method retrieves the account records created in the setup(#setup).
+1. The `Update` message updates the `ownerid` attribute to the user who you want to own the record. 
+
+### Clean up
+
+Displays an option to delete all the data created in the sample. The deletion is optional in case you want to examine the data created by the sample. You can manually delete the data to achieve same results.

powerapps-docs/developer/common-data-service/org-service/samples/assign-records-to-team.md

@@ -25,6 +25,7 @@ You can download the sample from [here](https://github.com/microsoft/PowerApps-S
 ## How to run this sample
 
 [!include[cc-how-to-run-samples](../../includes/cc-how-to-run-samples.md)]
+
 ## What this sample does
 
 The [AssignRequest](https://docs.microsoft.com/dotnet/api/microsoft.crm.sdk.messages.assignrequest?view=dynamics-general-ce-9) message is intended to be used in a scenario where it contains the data that is needed to assign the specified record to a new owner (user or team) by changing the OwnerId attribute of the record.

powerapps-docs/developer/common-data-service/org-service/samples/associate-security-role-user.md

@@ -0,0 +1,56 @@
+---
+title: " Associate security role to a user (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 a security role to a user " # 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: Associate security role to a user
+
+This sample shows how to assign a security role to a user by using the [IOrganizationService.Associate](https://docs.microsoft.com/dotnet/api/microsoft.xrm.sdk.iorganizationservice?view=dynamics-general-ce-9) message. 
+
+This sample requires an additional user that isn't available in your system. Create the required user manually in **Office 365** in order to run the sample without any errors. For this sample create a user profile **as is** shown below. 
+
+**First Name**: Dan<br/>
+**Last Name**: Park<br/>
+**Security Role**: User without any roles assigned<br/>
+**UserName**: [email protected]<br/>
+
+You can download the sample from [here](https://github.com/microsoft/PowerApps-Samples/tree/master/cds/orgsvc/C%23/AssociateSecurityRoleToUser)
+
+## How to run this sample
+
+[!include[cc-how-to-run-samples](../../includes/cc-how-to-run-samples.md)]
+
+## What this sample does
+
+The [IOrganizationService.Associate](https://docs.microsoft.com/dotnet/api/microsoft.xrm.sdk.iorganizationservice?view=dynamics-general-ce-9) message is intended to be used in a scenario where it provides programmatic access to the metadata and data for an organization.
+
+## 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
+
+1. Checks for the current version of the org.
+2. The `CreateRequiredRecords` method creates the records required by the sample.
+
+### Demonstrate
+
+1. The `QueryExpression` method retrieves a role from Common Data Service.
+2. The `Associate` message assigns the role to a user.
+
+### Clean up
+
+Display an option to delete the sample data 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.