Skip to content

Commit 4f0c3f0

Browse files
authored
Update async-cascading.md
1 parent c6e84b4 commit 4f0c3f0

File tree

1 file changed

+34
-0
lines changed

1 file changed

+34
-0
lines changed

power-platform/admin/async-cascading.md

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -90,6 +90,40 @@ Assign, Delete, and Merge cascading transactions can be processed asynchronously
9090
> [!NOTE]
9191
> Other transactions, such as share/unshare, rollup view, and re-parent are are currently under review for asynchronous processing.
9292
93+
## Troubleshooting Issues with Asynchronous Cascading Operations
94+
When synchronous cascading jobs fail, they stop and roll back all the changes so that none of the records include the changes requested.
95+
This can be a time-consuming process as rollbacks can take as long as the original attempt and retrying the operation will start again
96+
from the first record.
97+
98+
Asynchronous operations will retry numerous times if a failure occurs. In most cases retrying the job results in success and the job can
99+
continue to completion. In some rare cases, retrying won’t resolve the issue. When this happens, the asynchronous job will pause, and the
100+
administrator and user can troubleshoot the issue and resume the job from the point where it paused.
101+
102+
### Common causes of failures in cascading operations
103+
Common reasons for failures in processing cascading operations include:
104+
- Plugin exceptions
105+
- Security exceptions
106+
107+
#### Plugin Exceptions
108+
Plugins are added to the processing of cascading operations to take specific actions when changes are made to a record (like sending an email
109+
or triggering a different update on other records). These may be provided by third parties or developed in house. If a plugin generates an exception,
110+
the cascading operation will fail. Depending on the reason for the exception, a retry may resolve the issue. If the asynchronous cascade job is
111+
paused due to failures, validate all plugins that are associated with the operations to make sure they are not generating exceptions. Once fixed,
112+
the job can be resumed.
113+
114+
#### Security Exceptions
115+
Security exceptions occur when the user who executed the cascading operation either lacks the necessary privileges to make a change to one or more
116+
records, or the user is disabled/removed from the system.
117+
118+
If the user is still in the system, validate they have the needed privileges to modify the records and that they have permissions to execute the
119+
specified actions. Once this is resolved resume the job.
120+
121+
If the user has been disabled/removed from the system, re-enabling or re-adding the user will resolve the issue and the job can be resumed.
122+
If the user is supposed to be deleted/disabled or is not supposed to have permissions for the actions or records. The job should be cancelled
123+
and restarted by someone with appropriate permissions.
124+
125+
For any other issues with failed jobs, contact Microsoft Support.
126+
93127

94128
### See also
95129
[Entity relationships overview](/powerapps/maker/common-data-service/create-edit-entity-relationships)

0 commit comments

Comments
 (0)