Skip to content

Commit 0c03df9

Browse files
authored
Merge branch 'main' into patch-2
2 parents 6089f46 + ce18b1b commit 0c03df9

File tree

81 files changed

+403
-410
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

81 files changed

+403
-410
lines changed

powerapps-docs/cards/manage-cards/delete-cards.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ ms.collection:
1313

1414
# Delete a card
1515

16-
To delete a card, you need to be the app owner. An administrator, such as Global admin, Microsoft Entra Global admin, or Dynamics 365 admin can't delete card.
16+
To delete a card, you need to be the app owner. An admin can't delete a card.
1717

1818
1. Sign in to [Power Apps](https://make.powerapps.com).
1919
1. From the [left navigation](../../maker/canvas-apps/intro-maker-portal.md#1--left-navigation-pane), select **Cards**.

powerapps-docs/developer/component-framework/react-controls-platform-libraries.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ After you build the control, you can package it inside solutions and use it for
6767

6868
## Differences from standard components
6969

70-
Thi section describes the differences between a React component and a standard component.
70+
This section describes the differences between a React component and a standard component.
7171

7272
### ControlManifest.Input.xml
7373

powerapps-docs/developer/data-platform/fetchxml/aggregate-data.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -144,7 +144,7 @@ You can select which part of the date to use when grouping by date. Set [attribu
144144

145145
[!INCLUDE [dategrouping-table](reference/includes/dategrouping-table.md)]
146146

147-
By default date groupings use the UTC time. Set the [attribute element](reference/attribute.md) `usertimezone` attribute to specify that the user's time zone be used instead.
147+
By default date groupings use the user's time zone. Set the [attribute element](reference/attribute.md) `usertimezone` attribute to `"false"` to specify that the UTC time zone be used instead.
148148

149149
The following query groups account records showing number of employees by when the records were created:
150150

powerapps-docs/developer/data-platform/fetchxml/reference/attribute.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Use this element to specify which columns in the containing entity
44
author: pnghub
55
ms.author: gned
66
ms.reviewer: jdaly
7-
ms.date: 02/29/2024
7+
ms.date: 07/12/2024
88
ms.topic: reference
99
ms.subservice: dataverse-developer
1010
search.audienceType:
@@ -50,7 +50,7 @@ contributors:
5050
|`groupby`|No|When you aggregate data, this attribute specifies the column to use to group the data. [Learn more about grouping](../aggregate-data.md#grouping).|
5151
|`name`|Yes|The logical name of the column.|
5252
|`rowaggregate`|No|When this value is set to `CountChildren` a value that includes the total number of child records for the record is included in the results. [Learn how to use this attribute](../../query-hierarchical-data.md#retrieve-the-number-of-hierarchically-related-child-records).|
53-
|`usertimezone`|No|Used by aggregate queries that group by datetime columns. Specifies that the grouping use the user's time zone, otherwise UTC is used. Depending on the time zone, the same datetime value can fall in different days. [Learn about grouping by parts of a date](../aggregate-data.md#grouping-by-parts-of-a-date)|
53+
|`usertimezone`|No|Used by aggregate queries that group by datetime columns. Depending on the time zone, the same datetime value can fall in different days. [Learn about grouping by parts of a date](../aggregate-data.md#grouping-by-parts-of-a-date)<br /><br />Use this attribute with a `false` value to force the grouping to use UTC value. When you don't set this attribute, the default value is `true`, and the user's time zone is used.<br /><br />**Note**: With QueryExpression, the grouping always uses UTC. When using the SDK [FetchXmlToQueryExpressionRequest class](/dotnet/api/microsoft.crm.sdk.messages.fetchxmltoqueryexpressionrequest), this setting is lost. There's [no way to set this using QueryExpression](../../org-service/queryexpression/aggregate-data.md#time-zone-when-grouping-by-date).|
5454

5555
## Parent elements
5656

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
Indicates that all column values for each row are returned. It is the same as not adding any [attribute elements](../attribute.md). We don't recommend using this element for most cases.
1+
Indicates that all non-null column values for each row are returned. It is the same as not adding any [attribute elements](../attribute.md). We don't recommend using this element for most cases.

powerapps-docs/developer/data-platform/fetchxml/retrieve-data.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Use FetchXml to retrieve data
33
description: Learn how to use the Dataverse SDK for .NET or Web API to send a request to retrieve data using FetchXml
4-
ms.date: 02/29/2024
4+
ms.date: 07/16/2024
55
ms.reviewer: jdaly
66
ms.topic: how-to
77
author: pnghub
@@ -61,7 +61,7 @@ static EntityCollection RetrieveMultipleRequestExample(IOrganizationService serv
6161
Pass your FetchXml query as a URL-encoded string value to the entity set collection using the `fetchXml` query parameter.
6262

6363
> [!NOTE]
64-
> Unlike queries that use the OData syntax, FetchXML queries sent using Web API don't return properties with null values.
64+
> Unlike queries that use the OData syntax, FetchXML queries sent using Web API don't return properties with null values. [Learn more about this behavior](#null-column-values-are-not-returned)
6565
6666
For example, if you want to retrieve data from the [account entity set](xref:Microsoft.Dynamics.CRM.account), you will compose a fetchXml query setting the [entity element](reference/entity.md) `name` parameter to the `account`.
6767

@@ -147,6 +147,12 @@ The length of a URL in a `GET` request [is limited to 32 KB (32,768 characters)]
147147

148148
---
149149

150+
## Null column values are not returned
151+
152+
When a table column contains a null value, or if the column wasn't requested, the record returned won't include the value. There isn't a key to access it or a value to return. The absence of the attribute indicates that it's null. This is the behavior using the SDK for .NET. [Learn more about this behavior](../org-service/entity-operations-query-data.md#null-column-values-are-not-returned)
153+
154+
Columns that are not valid for read always return null values. The definition of these columns have the [AttributeMetadata.IsValidForRead](/dotnet/api/microsoft.xrm.sdk.metadata.attributemetadata.isvalidforread) property set to false.
155+
150156
## Next steps
151157

152158
Learn how to select columns.

powerapps-docs/developer/data-platform/file-column-data.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -67,9 +67,6 @@ sample_filecolumn: <file id>
6767
sample_filecolumn_name: 25mb.pdf
6868
```
6969

70-
> [!NOTE]
71-
> You must explicitly request the column to return the file id. If you use [ColumnSet.AllColumns](xref:Microsoft.Xrm.Sdk.Query.ColumnSet.AllColumns) to true in your query the file column will not be returned. If you used `new ColumnSet(true)` in the function above, the result would be a <xref:System.Collections.Generic.KeyNotFoundException?displayProperty=fullName>.
72-
7370
More information:
7471

7572
- [What is the SDK for .NET](org-service/overview.md)

powerapps-docs/developer/data-platform/webapi/compose-http-requests-handle-errors.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -172,7 +172,7 @@ When you execute batch operations, you must apply many different headers in the
172172
|`304 Not Modified`|Expect this status code when testing whether an entity has been modified since it was last retrieved. More information: [Conditional retrievals](perform-conditional-operations-using-web-api.md#bkmk_DetectIfChanged)|Redirection|
173173
|`403 Forbidden`|Expect this status code for the following types of errors:<br /><br />- `AccessDenied`<br />- `AttributePermissionReadIsMissing`<br />- `AttributePermissionUpdateIsMissingDuringUpdate`<br />- `AttributePrivilegeCreateIsMissing`<br />- `CannotActOnBehalfOfAnotherUser`<br />- `CannotAddOrActonBehalfAnotherUserPrivilege`<br />- `CrmSecurityError`<br />- `InvalidAccessRights`<br />- `PrincipalPrivilegeDenied`<br />- `PrivilegeCreateIsDisabledForOrganization`<br />- `PrivilegeDenied`<br />- `unManagedinvalidprincipal`<br />- `unManagedinvalidprivilegeedepth`|Client Error|
174174
|`401 Unauthorized`|Expect this status code for the following types of errors:<br /><br />- `BadAuthTicket`<br />- `ExpiredAuthTicket`<br />- `InsufficientAuthTicket`<br />- `InvalidAuthTicket`<br />- `InvalidUserAuth`<br />- `MissingCrmAuthenticationToken`<br />- `MissingCrmAuthenticationTokenOrganizationName`<br />- `RequestIsNotAuthenticated`<br />- `TamperedAuthTicket`<br />- `UnauthorizedAccess`<br />- `UnManagedInvalidSecurityPrincipal`|Client Error|
175-
|`413 Payload Too Large`|Expect this status code when the request length is too large.|Client Error|
175+
|`413 Payload Too Large`|Expect this status code when the request length is too large. [Learn about request and response payload size limitations](../work-with-data.md#request-and-response-payload-size-limitations)|Client Error|
176176
|`400 BadRequest`|Expect this status code when an argument is invalid.|Client Error|
177177
|`404 Not Found`|Expect this status code when the resource doesn't exist.|Client Error|
178178
|`405 Method Not Allowed`|This error occurs for incorrect method and resource combinations. For example, you can't use DELETE or PATCH on a collection of entities.<br /><br /> Expect this for the following types of errors:<br /><br />- `CannotDeleteDueToAssociation`<br />- `InvalidOperation`<br />- `NotSupported`|Client Error|

powerapps-docs/developer/data-platform/work-with-data.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -40,11 +40,11 @@ Dataverse provides two ways to retrieve, add, and modify data: SDK for .NET & We
4040
If you are working with .NET, we recommend using our [SDK for .NET](org-service/overview.md).
4141

4242
- Use the [ServiceClient class](/dotnet/api/microsoft.powerplatform.dataverse.client.serviceclient) in the [DataverseServiceClient NuGet package](https://www.nuget.org/packages/Microsoft.PowerPlatform.Dataverse.Client/) if you have a client application.
43-
- Use the [Microsoft.CrmSdk.CoreAssemblies NuGet package](https://www.nuget.org/packages/Microsoft.CrmSdk.CoreAssemblies/) when you are writing a plug-in or custom workflow activity.
43+
- Use the [Microsoft.CrmSdk.CoreAssemblies NuGet package](https://www.nuget.org/packages/Microsoft.CrmSdk.CoreAssemblies/) when you're writing a plug-in or custom workflow activity.
4444

4545
The Dataverse SDK for .NET supports build targets for both .NET Framework and .NET 6+. However, plug-in and custom workflow activities must use .NET Framework.
4646

47-
If you are using our [PowerShell module](https://www.powershellgallery.com/packages/Microsoft.Xrm.Tooling.CrmConnector.PowerShell/) or using our [custom log-in control](xrm-tooling/use-xrm-tooling-common-login-control-client-applications.md) with a Windows client application, use the [the Xrm.Tooling](xrm-tooling/build-windows-client-applications-xrm-tools.md)
47+
If you're using our [PowerShell module](https://www.powershellgallery.com/packages/Microsoft.Xrm.Tooling.CrmConnector.PowerShell/) or using our [custom log-in control](xrm-tooling/use-xrm-tooling-common-login-control-client-applications.md) with a Windows client application, use the [the Xrm.Tooling](xrm-tooling/build-windows-client-applications-xrm-tools.md)
4848

4949
- [Use the SDK for .NET](org-service/overview.md)
5050
- [Quickstart: Execute an SDK for .NET request (C#)](org-service/quick-start-org-service-console-app.md)
@@ -75,10 +75,12 @@ The [Power Query Dataverse connector](/power-query/connectors/dataverse) uses th
7575
[Learn to use SQL to query data](dataverse-sql-query.md)
7676

7777

78-
## Limitations
78+
## Request and Response payload size limitations
7979

80-
There's a 1-GB size limitation on the size of a response that Dataverse returns. Few APIs or queries are capable of returning this much data. If you encounter this limit, you should consider what other options are available to get the data in multiple, smaller requests.
80+
The maximum payload size for any request sent to Dataverse is 128 MB. Requests with payloads over this limit receive a [413 Payload Too Large](https://devdoc.net/web/developer.mozilla.org/docs/Web/HTTP/Status/413.html) HTTP status code in the response.
8181

82-
The deprecated SOAP endpoint returns serialized XML data that is much more verbose than the serialized JSON data returned by the Web API. If you're using the deprecated SOAP endpoint, you should use the Web API equivalent operation. More information: [About the legacy SOAP endpoint](org-service/overview.md#about-the-legacy-soap-endpoint)
82+
There's a 1-GB size limitation on the size of a response that Dataverse returns. Few APIs or queries are capable of returning this much data. If you encounter this limit, you should consider what other options are available to get the data in multiple, smaller requests.
83+
84+
The deprecated SOAP endpoint payloads use serialized XML data that is much more verbose than the serialized JSON data payloads the Web API uses. You're less likely to encounter errors where the request or response payload is too large when you use the Web API. [Learn about the legacy SOAP endpoint](org-service/overview.md#about-the-legacy-soap-endpoint)
8385

8486
[!INCLUDE[footer-include](../../includes/footer-banner.md)]

powerapps-docs/developer/model-driven-apps/clientapi/clientapi-grid-context.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
22
title: "Client API grid context in model-driven apps| MicrosoftDocs"
33
description: "Describes the client api grid context"
4-
author: jasongre
5-
ms.author: jasongre
4+
author: fikaradz
5+
ms.author: fikaradz
66
ms.date: 04/18/2024
77
ms.reviewer: jdaly
88
ms.topic: "conceptual"

0 commit comments

Comments
 (0)