@@ -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