Skip to content

Commit 1880ee9

Browse files
committed
Merge branch 'master' into michu-pachecker-4599547-api-docs
2 parents fb3fcc7 + 014aac6 commit 1880ee9

18 files changed

+3652
-3309
lines changed

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ You should be aware of the following constraints when creating alternate keys:
5454

5555
- **Unicode characters in key value**
5656

57-
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.
57+
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.
5858

5959
<a name="BKMK_crud"></a>
6060

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

Lines changed: 18 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: "Handle exceptions in your code (Common Data Service) | Microsoft Docs"
33
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."
44
ms.custom: ""
5-
ms.date: 10/31/2018
5+
ms.date: 06/17/2019
66
ms.reviewer: ""
77
ms.service: powerapps
88
ms.topic: "article"
@@ -23,7 +23,7 @@ There are a number of exceptions that can be returned from a Common Data Service
2323

2424
## Common exceptions and faults
2525

26-
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.
26+
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.
2727

2828
```csharp
2929
catch (FaultException<Microsoft.Xrm.Sdk.OrganizationServiceFault> ex)
@@ -71,27 +71,23 @@ catch (System.Exception ex)
7171
> [!NOTE]
7272
> 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.
7373
74-
In addition to these exceptions and faults, your code must handle the following exceptions:
74+
In addition to these exceptions and faults, your code must handle the following exceptions:
7575

76-
- [SecurityTokenValidationException](https://msdn.microsoft.com/library/system.identitymodel.tokens.securitytokenvalidationexception.aspx)
76+
- [SecurityTokenValidationException](https://msdn.microsoft.com/library/system.identitymodel.tokens.securitytokenvalidationexception.aspx)
77+
- [ExpiredSecurityTokenException](https://msdn.microsoft.com/library/system.servicemodel.security.expiredsecuritytokenexception.aspx)
78+
- [SecurityAccessDeniedException](https://msdn.microsoft.com/library/system.servicemodel.security.securityaccessdeniedexception.aspx)
79+
- [MessageSecurityException](https://msdn.microsoft.com/library/system.servicemodel.security.messagesecurityexception.aspx)
80+
- [SecurityNegotiationException](https://msdn.microsoft.com/library/system.servicemodel.security.securitynegotiationexception.aspx)
7781

78-
- [ExpiredSecurityTokenException](https://msdn.microsoft.com/library/system.servicemodel.security.expiredsecuritytokenexception.aspx)
79-
80-
- [SecurityAccessDeniedException](https://msdn.microsoft.com/library/system.servicemodel.security.securityaccessdeniedexception.aspx)
81-
82-
- [MessageSecurityException](https://msdn.microsoft.com/library/system.servicemodel.security.messagesecurityexception.aspx)
83-
84-
- [SecurityNegotiationException](https://msdn.microsoft.com/library/system.servicemodel.security.securitynegotiationexception.aspx)
85-
86-
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.
82+
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.
8783

8884
<a name="BKMK_BusinessRuleErrors"></a>
8985

9086
## Custom errors from business rules
9187

92-
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.
88+
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.
9389

94-
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**.
90+
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**.
9591

9692
```csharp
9793
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
123119
</OrganizationServiceFault>
124120
```
125121

126-
More information: [Create and edit Business Rules](https://technet.microsoft.com/library/dn531086.aspx).
122+
More information: [Create and edit Business Rules](https://technet.microsoft.com/library/dn531086.aspx).
127123

128-
<a name="BKMK_AdditionalInfo"></a>
129-
## Additional information about exceptions
130-
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.
124+
<a name="BKMK_AdditionalInfo"></a>
125+
126+
## Additional information about exceptions
127+
128+
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.
131129

132130
### See also
133-
[Troubleshooting and error handling](/dynamics365/customer-engagement/developer/troubleshooting-error-handling)
134-
[Troubleshooting tips](/dynamics365/customer-engagement/developer/troubleshooting-tips)
131+
135132
[Web service error codes](web-service-error-codes.md)
136133
[Handle exceptions in plug-ins](../handle-exceptions.md)
137134
[.NET Framework Developer Center](https://docs.microsoft.com/dotnet/framework/development-guide)

0 commit comments

Comments
 (0)