Merge branch 'master' into repo_sync_working_branch

Author: KumarVivek

powerapps-docs/developer/common-data-service/define-alternate-keys-entity.md

@@ -54,7 +54,7 @@ You should be aware of the following constraints when creating alternate keys:
 
 - **Unicode characters in key value**
 
-  If the data within a field that is used in an alternate key will contain one of the following characters `<`,`>`,`*`,`%`,`&`,`:`,`\\` then patch or upsert actions will not work.  If you only need uniqueness then this approach will work, but if you need to use these keys as part of data integration then it is best to create the key on fields that won't have data with those characters.
+  If the data within a field that is used in an alternate key will contain one of the following characters `<`,`>`,`*`,`%`,`&`,`:`,`\\` then get or patch actions will not work.  If you only need uniqueness then this approach will work, but if you need to use these keys as part of data integration then it is best to create the key on fields that won't have data with those characters.
 
 <a name="BKMK_crud"></a>   
 

powerapps-docs/developer/common-data-service/event-framework.md

@@ -2,7 +2,7 @@
 title: " Event Framework (Common Data Service) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
 description: "Describes the event framework and information developers should know when working with it." # 115-145 characters including spaces. This abstract displays in the search result.
 ms.custom: ""
-ms.date: 05/25/2019
+ms.date: 06/18/2019
 ms.reviewer: ""
 ms.service: powerapps
 ms.topic: "article"
@@ -45,7 +45,27 @@ Generally, you can expect to find a message for most of the **Request* classes i
 
 Data about messages is stored in the [SdkMessage](reference/entities/sdkmessage.md) and [SdkMessageFilter](reference/entities/sdkmessagefilter.md) entities. The Plug-in registration tool will filter this information to only show valid messages.
 
-To verify if a message and entity combination supports execution of plug-ins using a database query, use Advanced Find or a community tool (e.g., [FetchXML Builder](http://fxb.xrmtoolbox.com)) to execute the following fetchXML query. When using Advanced Find, you must create the query interactively.
+To verify if a message and entity combination supports execution of plug-ins using a database query, you can use the following Web API query:
+
+```
+{{webapiurl}}sdkmessages?$select=name
+&$filter=isprivate eq false 
+and (name ne 'SetStateDynamicEntity' 
+and name ne 'RemoveRelated' 
+and name ne 'SetRelated' and 
+name ne 'Execute') 
+and sdkmessageid_sdkmessagefilter/any(s:s/iscustomprocessingstepallowed eq true 
+and s/isvisible eq true)
+&$expand=sdkmessageid_sdkmessagefilter($select=primaryobjecttypecode;
+$filter=iscustomprocessingstepallowed eq true and isvisible eq true)
+&$orderby=name
+```
+
+> [!TIP]
+> You can export this data to an Excel worksheet using this query and the instructions provided in this blog post: [Find Messages and entities eligible for plug-ins using the Common Data Service](https://powerapps.microsoft.com/en-us/blog/find-messages-and-entities-eligible-for-plug-ins-using-the-common-data-service/)
+
+
+You can also use the following FetchXML to retrieve this information. The [FetchXML Builder](http://fxb.xrmtoolbox.com) is a useful tool to execute this kind of query.
 
 ```xml
 <fetch>

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

@@ -70,16 +70,16 @@
   items: # We may need a topic here about CRUD?
     - name: Build queries with LINQ (.NET language-integrated query)
       href: build-queries-with-linq-net-language-integrated-query.md
-    - name: LINQ query examples
-      href: linq-query-examples.md
+    - name: Use LINQ to construct a query
+      href: use-linq-construct-query.md
+    - name: Use late-bound entity class with a LINQ query
+      href: use-late-bound-entity-class-linq-query.md
     - name: Order results using entity attributes with LINQ
       href: order-results-entity-attributes-linq.md
     - name: Page large result sets with LINQ
       href: page-large-result-sets-linq.md
-    - name: Use late-bound entity class with a LINQ query
-      href: use-late-bound-entity-class-linq-query.md
-    - name: Use LINQ to construct a query
-      href: use-linq-construct-query.md
+    - name: LINQ query examples
+      href: linq-query-examples.md
 - name: Detect duplicate data
   href: detect-duplicate-data.md
 - name: Generate classes for early-bound programming

powerapps-docs/developer/common-data-service/org-service/build-queries-with-linq-net-language-integrated-query.md

@@ -19,27 +19,14 @@ search.app:
 
 You can use .NET Language-Integrated Query (LINQ) to write queries in Common Data Service. You can use the <xref:Microsoft.Xrm.Sdk.Client.OrganizationServiceContext> class or a deriving class created by the CrmSvcUtil tool to write [LINQ](https://msdn.microsoft.com/library/bb397897.aspx) queries that access the SOAP endpoint (Organization.svc). The <xref:Microsoft.Xrm.Sdk.Client.OrganizationServiceContext> class contains an underlying LINQ query provider that translates LINQ queries from Visual C# or Visual Basic .NET syntax into the query API used by Common Data Service.  
 
- When you use early-bound programming classes you can generate a class derived from the <xref:Microsoft.Xrm.Sdk.Client.OrganizationServiceContext> class if you specify the name of the class using the **servicecontextname** parameter when using the Code Generation Tool (CrmSvcUtil.exe). Use of this class allows for referencing an [IQueryable](https://msdn.microsoft.com/library/system.linq.iqueryable.aspx) entity set using the pattern `<entity schema name>+Set`, for example **AccountSet** to reference the collection of `Account` entity records. All samples in the Common Data Service Web Services, use **ServiceContext** as the name for this class but your code may use a different name. More information: [Create Early Bound Entity Classes with the Code Generation Tool (CrmSvcUtil.exe)](/dynamics365/customer-engagement/developer/org-service/create-early-bound-entity-classes-code-generation-tool.md) 
+ When you use early-bound programming classes you can generate a class derived from the <xref:Microsoft.Xrm.Sdk.Client.OrganizationServiceContext> class if you specify the name of the class using the **servicecontextname** parameter when using the Code Generation Tool (CrmSvcUtil.exe). Use of this class allows for referencing an [IQueryable](https://msdn.microsoft.com/library/system.linq.iqueryable.aspx) entity set using the pattern `<entity schema name>+Set`, for example **AccountSet** to reference the collection of `Account` entity records. All samples in the Common Data Service Web Services, use **ServiceContext** as the name for this class but your code may use a different name. More information: [Generate early-bound classes for the Organization service)](generate-early-bound-classes.md).
 
-## In This Section  
+### See Also
+
  [Use LINQ to Construct a Query](use-linq-construct-query.md)  
 
  [Use Late-Bound Entity Class with a LINQ Query](use-late-bound-entity-class-linq-query.md)  
 
  [Use Entity Lookup Attributes with LINQ](order-results-entity-attributes-linq.md)  
-  
- [Order Results Using Entity Attributes with LINQ](/dynamics365/customer-engagement/developer/org-service/order-results-entity-attributes-linq)  
-  
- [Paging Large Result Sets with LINQ](/dynamics365/customer-engagement/developer/org-service/page-large-result-sets-linq)  
-  
- [LINQ Query Examples](/dynamics365/customer-engagement/developer/org-service/linq-query-examples)  
-  
- [Sample: Create a LINQ Query](/dynamics365/customer-engagement/developer/org-service/sample-create-linq-query)  
-  
- [Sample: LINQ Query Examples](/dynamics365/customer-engagement/developer/org-service/sample-complex-linq-queries)  
-  
- [Sample: RetrieveMultiple With Condition Operators Using LINQ](/dynamics365/customer-engagement/developer/org-service/sample-retrieve-multiple-with-condition-operators-using-linq)  
-  
- [Sample: More LINQ Query Examples](/dynamics365/customer-engagement/developer/org-service/sample-more-linq-query-examples)  
-  
- [Sample: Use LINQ with Late Binding](/dynamics365/customer-engagement/developer/org-service/sample-create-linq-query-late-binding)
+
+ [LINQ query examples](linq-query-examples.md)

powerapps-docs/developer/common-data-service/org-service/handle-exceptions-code.md

@@ -2,7 +2,7 @@
 title: "Handle exceptions in your code (Common Data Service) | Microsoft Docs"
 description: "This article discusses the exceptions that are returned from a Dynamics 365 Customer Engagement web service method call. The sample in this article highlights the common faults and exceptions that your application design should handle."
 ms.custom: ""
-ms.date: 10/31/2018
+ms.date: 06/17/2019
 ms.reviewer: ""
 ms.service: powerapps
 ms.topic: "article"
@@ -23,7 +23,7 @@ There are a number of exceptions that can be returned from a Common Data Service
 
 ## Common exceptions and faults  
 
- The following code is used in most Common Data Service Web Services samples. It highlights the common faults and exceptions that your application design should handle.  
+The following code is used in most Common Data Service Web Services samples. It highlights the common faults and exceptions that your application design should handle.  
 
 ```csharp
 catch (FaultException<Microsoft.Xrm.Sdk.OrganizationServiceFault> ex)
@@ -71,27 +71,23 @@ catch (System.Exception ex)
 > [!NOTE]
 >  If you’re accessing the Discovery web service, your code should catch <xref:Microsoft.Xrm.Sdk.DiscoveryServiceFault> instead of the <xref:Microsoft.Xrm.Sdk.OrganizationServiceFault> fault shown previously.  
   
- In addition to these exceptions and faults, your code must handle the following exceptions:  
+In addition to these exceptions and faults, your code must handle the following exceptions:  
 
--   [SecurityTokenValidationException](https://msdn.microsoft.com/library/system.identitymodel.tokens.securitytokenvalidationexception.aspx)  
+- [SecurityTokenValidationException](/dotnet/api/system.identitymodel.tokens.securitytokenvalidationexception)  
+- [ExpiredSecurityTokenException](/dotnet/api/system.servicemodel.security.expiredsecuritytokenexception)  
+- [SecurityAccessDeniedException](/dotnet/api/system.servicemodel.security.securityaccessdeniedexception)  
+- [MessageSecurityException](/dotnet/api/system.servicemodel.security.messagesecurityexception)  
+- [SecurityNegotiationException](/dotnet/api/system.servicemodel.security.securitynegotiationexception)  
 
--   [ExpiredSecurityTokenException](https://msdn.microsoft.com/library/system.servicemodel.security.expiredsecuritytokenexception.aspx)  
-  
--   [SecurityAccessDeniedException](https://msdn.microsoft.com/library/system.servicemodel.security.securityaccessdeniedexception.aspx)  
-  
--   [MessageSecurityException](https://msdn.microsoft.com/library/system.servicemodel.security.messagesecurityexception.aspx)  
-  
--   [SecurityNegotiationException](https://msdn.microsoft.com/library/system.servicemodel.security.securitynegotiationexception.aspx)  
-  
- When connecting to Common Data Service, a `SecurityAccessDeniedException` exception can be thrown if you use a valid Microsoft account and your account is not associated with any Common Data Service organization. A `MessageSecurityException` can be thrown if your Microsoft account isn’t valid or there was an authentication failure.  
+When connecting to Common Data Service, a `SecurityAccessDeniedException` exception can be thrown if you use a valid Microsoft account and your account is not associated with any Common Data Service organization. A `MessageSecurityException` can be thrown if your Microsoft account isn’t valid or there was an authentication failure.  
 
 <a name="BKMK_BusinessRuleErrors"></a>
 
 ## Custom errors from business rules
 
- With Common Data Service, customizers can create business rules that are evaluated on the server. Customizers can throw error messages based on conditions set in the business rule. Developers should be sure to include robust error handling in their code to catch and handle these exceptions.  
+With Common Data Service, customizers can create business rules that are evaluated on the server. Customizers can throw error messages based on conditions set in the business rule. Developers should be sure to include robust error handling in their code to catch and handle these exceptions.  
 
- The following is an example of the trace log produced when one of these errors is returned from a business rule named **Name of Entity Scope Business Rule returning Error** and the error message is **custom error message**.  
+The following is an example of the trace log produced when one of these errors is returned from a business rule named **Name of Entity Scope Business Rule returning Error** and the error message is **custom error message**.  
 
 ```csharp
 Unhandled Exception: System.ServiceModel.FaultException`1[[Microsoft.Xrm.Sdk.OrganizationServiceFault, Microsoft.Xrm.Sdk, Version=7.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]: custom error messageDetail:   
@@ -123,15 +119,16 @@ Sync workflow 'Name of Entity Scope Business Rule returning Error' terminated wi
 </OrganizationServiceFault>  
 ```  
 
- More information: [Create and edit Business Rules](https://technet.microsoft.com/library/dn531086.aspx).  
+More information: [Create a business rule for an entity](../../../maker/common-data-service/data-platform-create-business-rule.md)  
 
-<a name="BKMK_AdditionalInfo"></a>   
-## Additional information about exceptions  
- When an uncaught exception is thrown that contains sensitive information that the user doesn’t have permission to see, the sensitive information in the exception is hidden from the user and a reference number is provided. This reference number refers to the related server event log entry and server trace entry. A system administrator can look up those entries and find more information about the exception.  
+<a name="BKMK_AdditionalInfo"></a>
+
+## Additional information about exceptions
+
+When an uncaught exception is thrown that contains sensitive information that the user doesn’t have permission to see, the sensitive information in the exception is hidden from the user and a reference number is provided. This reference number refers to the related server event log entry and server trace entry. A system administrator can look up those entries and find more information about the exception.  
 
 ### See also  
- [Troubleshooting and error handling](/dynamics365/customer-engagement/developer/troubleshooting-error-handling)   
- [Troubleshooting tips](/dynamics365/customer-engagement/developer/troubleshooting-tips)   
+
  [Web service error codes](web-service-error-codes.md)   
  [Handle exceptions in plug-ins](../handle-exceptions.md)   
  [.NET Framework Developer Center](https://docs.microsoft.com/dotnet/framework/development-guide)

powerapps-docs/developer/common-data-service/org-service/use-linq-construct-query.md

@@ -149,8 +149,8 @@ select new Contact
 }
  ```
 ### See also  
- [Sample: Create a LINQ Query](/dynamics365/customer-engagement/developer/org-service/sample-create-linq-query.md)   
- [Sample: LINQ Query Examples](/dynamics365/customer-engagement/developer/org-service/sample-complex-linq-queries.md)   
- [Build Queries with LINQ (.NET Language-Integrated Query)](/dynamics365/customer-engagement/developer/org-service/build-queries-with-linq-net-language-integrated-query.md)   
- [Use Late-Bound Entity Class with a LINQ Query](/dynamics365/customer-engagement/developer/org-service/use-late-bound-entity-class-linq-query.md)   
+ [Sample: Create a LINQ Query](/dynamics365/customer-engagement/developer/org-service/sample-create-linq-query)   
+ [Sample: LINQ Query Examples](/dynamics365/customer-engagement/developer/org-service/sample-complex-linq-queries)   
+ [Build Queries with LINQ (.NET Language-Integrated Query)](/dynamics365/customer-engagement/developer/org-service/build-queries-with-linq-net-language-integrated-query)   
+ [Use Late-Bound Entity Class with a LINQ Query](/dynamics365/customer-engagement/developer/org-service/use-late-bound-entity-class-linq-query)   
  [Blog: LINQPad 4 Driver for Dynamics CRM REST/Web API are available on CodePlex](http://blogs.msdn.com/b/crminthefield/archive/2015/06/11/linqpad-4-driver-for-dynamics-crm-rest-webapi-are-available-on-codeplex.aspx)