You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: powerapps-docs/developer/data-platform/configure-entity-relationship-cascading-behavior.md
+15-8Lines changed: 15 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,7 @@ suite: powerapps
5
5
author: NHelgren
6
6
ms.author: nhelgren
7
7
ms.topic: article
8
-
ms.date: 04/25/2023
8
+
ms.date: 06/01/2023
9
9
ms.subservice: dataverse-developer
10
10
search.audienceType:
11
11
- developer
@@ -116,6 +116,7 @@ If you update the owner:
116
116
- Child records' business unit is not updated (no cascade)
117
117
118
118
#### Allowed record ownership across business units is enabled
119
+
119
120
When [allow record ownership across business units](/power-platform/admin/wp-security-cds#to-enable-this-matrix-data-access-structure-preview) is enabled,
120
121
the Owning Business Unit column can be explicitly updated when changing the record's owner. The following lists the cascading behaviors when the parent's record owner and/or the business unit is updated.
121
122
@@ -167,6 +168,7 @@ the Owning Business Unit column can be explicitly updated when changing the reco
167
168
- Child records' business unit is not updated
168
169
169
170
#### Change the cascade behaviors with the OrgDBSettings AlwaysMoveRecordToOwnerBusinessUnit
171
+
170
172
You can set **AlwaysMoveRecordToOwnerBusinessUnit** to false; the user owned records' Business unit is not moved to the new user's business unit.
171
173
172
174
**AlwaysMoveRecordToOwnerBusinessUnit** can be set in [environment database settings](/power-platform/admin/environment-database-settings) and can also be set using the [OrgDBOrgSettings tool for Microsoft Dynamics CRM](https://support.microsoft.com/help/2691237/orgdborgsettings-tool-for-microsoft-dynamics-crm).
@@ -233,12 +235,15 @@ You can set **AlwaysMoveRecordToOwnerBusinessUnit** to false; the user owned rec
233
235
234
236
<aname="BKMK_ReparentAction"></a>
235
237
236
-
### About the reparent action
237
-
The reparent action is very similar to the share action except that it deals with the inherited access rights instead of explicit access rights. The reparent action is when you change the value of the referencing column in a parental relationship. When a reparent action occurs, the desired scope of the inherited access rights for related tables might change for ReadAccess, WriteAccess, DeleteAccess, AssignAccess, ShareAccess, AppendAccess and AppendToAccess. It will not change for CreateAccess. The cascade actions related to the reparent action refer to changes to access rights indicated above for the table record and any table records related to it.
238
+
### About the reparent action
239
+
240
+
The reparent action is very similar to the share action except that it deals with the inherited access rights instead of explicit access rights. The reparent action is when you change the value of the referencing column in a parental relationship. When a reparent action occurs, the desired scope of the inherited access rights for related tables might change for ReadAccess, WriteAccess, DeleteAccess, AssignAccess, ShareAccess, AppendAccess and AppendToAccess. It will not change for CreateAccess. The cascade actions related to the reparent action refer to changes to access rights indicated above for the table record and any table records related to it.
241
+
242
+
<aname="BKMK_MergeAction"></a>
243
+
244
+
### About the merge action
238
245
239
-
<aname="BKMK_MergeAction"></a>
240
-
### About the merge action
241
-
The merge action can sometimes have problems completing if a record that is part of the operation set is deleted while the merge system job is running. Often this will result in an error indicating that the record will be "differently parented" or the child record "might lose its parenting". If this occurs, and you would prefer the merge continue forward even if the record is missing, you can choose to disable the parent check when you select the columns to merge.
246
+
The merge action can sometimes have problems completing if a record that is part of the operation set is deleted while the merge system job is running. Often this will result in an error indicating that the record will be "differently parented" or the child record "might lose its parenting". If this occurs, and you would prefer the merge continue forward even if the record is missing, you can choose to disable the parent check when you select the columns to merge.
242
247
243
248
244
249
> [!NOTE]
@@ -250,8 +255,10 @@ You can use two cascade async notification helper messages to provide notificati
250
255
251
256
The two notification messages are:
252
257
253
-
-``cascadeAsync_FailureAPI`` <br/>This message is processed (executed) when an asynchronous cascade job is paused due to multiple failures. This can be used to inform users they need to review their dataset for issues with existing plug-ins, data issues, or workflow problems.
254
-
-``cascadeAsync_SuccessAPI`` <br/>This message is processed (executed) when the asynchronous cascade job is successfully completed. This is helpful to let users know when longer running jobs are finished.
258
+
|Name|Description|
259
+
|---------|---------|
260
+
|`cascadeAsync_FailureAPI`|This message is processed (executed) when an asynchronous cascade job is paused due to multiple failures. This can be used to inform users they need to review their dataset for issues with existing plug-ins, data issues, or workflow problems.<br />**InputParameters**:<br />`casadeAsyncExceptionDetails`: Details of the exception causing cascade async job failure.<br />`casadeAsyncJobName`:Name of the cascade async job.|
261
+
|`cascadeAsync_SuccessAPI`|This message is processed (executed) when the asynchronous cascade job is successfully completed.<br />**InputParameters**:<br />`casadeAsync_JobName`: Name of the cascade async job.|
255
262
256
263
The custom plug-in must be registered during the post-operation stage and must be set to asynchronous mode. The following figure shows an example plug-in registration using the Plug-in Registration tool.
0 commit comments