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/maker/common-data-service/common-issues-resolutions-solution-checker.md
+18-21Lines changed: 18 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
title: "Common issues and resolutions for solution checker | Microsoft Docs"# Intent and product brand in a unique string of 43-59 chars including spaces"
3
3
description: " A list of common issues and resolutions within solution checker"
4
4
keywords: ""
5
-
ms.date: 04/07/2020
5
+
ms.date: 08/04/2020
6
6
ms.service: powerapps
7
7
ms.custom:
8
8
- ""
@@ -76,27 +76,24 @@ To install Power Apps Checker back into your Common Data Service environment:
76
76
2. Select **Solutions**.
77
77
3. On the solution toolbar select **Solution checker**, and then select **Install**.
78
78
79
-
## Solution Checker can't access organizations in Administration Mode
79
+
## Solution checker can't access environments in Administration Mode
80
80
81
-
Organizations that have been placed into [Administration Mode](https://docs.microsoft.com/dynamics365/customer-engagement/admin/manage-sandbox-instances#administration-mode) purposely restrict access to only users with System Administrator and System Customizer roles. Because the Power Apps Checker application identity has neither of these roles assigned by default, it can't access organizations operating in this mode.
81
+
Environments that have been placed into [Administration Mode](https://docs.microsoft.com/dynamics365/customer-engagement/admin/manage-sandbox-instances#administration-mode) purposely restrict access to only users with System Administrator and System Customizer roles. Because the Power Apps Checker application identity has neither of these roles assigned by default, it can't access organizations operating in this mode.
82
82
83
-
In order to use solution checker in this organization, Adminstration Mode must be disabled.
83
+
In order to use solution checker in this organization, Administration Mode must be disabled.
84
84
85
85
### How to disable administration mode
86
86
87
87
To disable administration mode for an organization instance:
88
88
89
-
1. Open the Dynamics 365 instance picker: https://port.crm.dynamics.com/G/Instances/InstancePicker.aspx.
90
-
2. Select the organization instance that has issues running solution checker.
91
-
3. Select **ADMIN**.
89
+
1. Sign in to the [Power Platform admin center](https://admin.powerplatform.microsoft.com/environments/).
90
+
2. Open the environment that has issues running solution checker, and then select **Edit**.
## Solution checker fails due to missing security roles
102
99
@@ -118,7 +115,7 @@ To assign missing security roles to the Power Apps Checker user:
118
115
119
116
5. Run solution checker again.
120
117
121
-
## Solution Checker fails due to restricted access mode
118
+
## Solution checker fails due to restricted access mode
122
119
123
120
The application user for solution checker requires an access mode of **'Non-Interactive'** or **'Read-Write'** in order to communicate with the Common Data Service organization. If the access mode has been changed to another value such as **'Administrative'**, then attempts to run analysis, download results, and run cancelation will fail.
124
121
@@ -167,9 +164,9 @@ Typical Common Data Service operations requested by solution checker:
167
164
- Create, update, and retrieve analysis job, analysis component, and analysis result entity data
168
165
- Export solutions
169
166
170
-
### Plugin step registered to execute in context of a unlicensed user
167
+
### Plugin step registered to execute in context of an unlicensed user
171
168
172
-
When solution checker fails due to an "unlicensed user" exception, it is often caused by a triggered plugin step configured to execute in the context of a specific systemuser that is currently unlicensed. Ensure that any plugin steps that could be triggered by solution checker execute in context of a licensed user.
169
+
When solution checker fails due to an "unlicensed user" exception, it is often caused by a triggered plugin step configured to execute in the context of a specific system user that is currently unlicensed. Ensure that any plugin steps that could be triggered by solution checker execute in context of a licensed user.
173
170
174
171
>[!IMPORTANT]
175
172
>It is highly recommended that plugin steps be configured to execute in context of the calling user rather than specific users which are subject to assigned license being revoked.
@@ -182,7 +179,7 @@ When solution checker fails due to Common Data Service denying access based on a
182
179
183
180
When solution checker fails due to the error "ISV aborted code", a plugin step was triggered that explicitly interrupted execution by throwing an InvalidPluginExcecutionException. Either reconfigure the plugin step to not execute on the operation invoked by solution checker or adjust the plugin implementation not to interrupt execution based on the conditions presented by solution checker.
184
181
185
-
## Solution checker fails due to disabled first-party application in AAD
182
+
## Solution checker fails due to disabled first-party application in Azure Active Directory
186
183
187
184
The first-party enterprise application identity used by solution checker (PowerApps-Advisor) should not be disabled in Azure Active Directory (AAD). If disabled, the identity cannot authenticate when requesting bearer tokens for Common Data Service and other required resource providers on-behalf of the requesting user.
188
185
@@ -200,7 +197,7 @@ To verify and/or modify the enabled status of the PowerApps-Advisor enterprise a
200
197
201
198
4. Select **'PowerApps-Advisor'** to view the app details.
202
199
5. Select **Properties**.
203
-
6. Check the state of **Enabled for users to sign-in**. If **'No'**, then the application has been disabled.
200
+
6. Check the state of **Enabled for users to signin**. If **'No'**, then the application has been disabled.
@@ -220,21 +217,21 @@ If a solution contains a business process flow component in draft state that has
220
217
221
218
Reference [KB Article #4337537: Invalid Export - Business Process Entity Missing](https://support.microsoft.com/en-hk/help/4337537/invalid-export-business-process-entity-missing) for details about the issue and steps to resolve.
222
219
223
-
## Solution Checker fails to export patched solutions
220
+
## Solution checker fails to export patched solutions
224
221
225
222
If a solution has had a [patch](https://docs.microsoft.com/powerapps/developer/common-data-service/create-patches-simplify-solution-updates) applied, Solution Checker will fail to export the solution for analysis. When a solution has had a patch applied, the original solution becomes locked and it can't be changed or exported as long as there are dependent patches that exist in the organization that identify the solution as the parent solution.
226
223
227
-
To resolve this issue, clone the solution so that all patches related to the solution are rolled into the newly-created solution. This unlocks the solution and allows the solution to be exported from the system. For more information, see [Clone a Solution](/power-platform/alm/update-solutions-alm#clone-a-solution).
224
+
To resolve this issue, clone the solution so that all patches related to the solution are rolled into the newlycreated solution. This unlocks the solution and allows the solution to be exported from the system. For more information, see [Clone a Solution](/power-platform/alm/update-solutions-alm#clone-a-solution).
228
225
229
226
## Solution checker will not analyze empty solutions
230
227
231
-
If Solution Ccecker exports a solution that contains no components to analyze, it will terminate further processing and consider the run a failure. Ensure that the selected solution submitted for a Solution Checker analysis contains at least one component.
228
+
If Solution Checker exports a solution that contains no components to analyze, it will terminate further processing and consider the run a failure. Ensure that the selected solution submitted for a Solution Checker analysis contains at least one component.
232
229
233
230
## Solution Checker fails to export large solutions
234
231
235
232
The primary scenario for failure to export a large solution from the Common Data Service environment involves a timeout exception on the export request. This will occur if the request exceeds 20 minutes. Large solutions, such as the Default Solution, may fail to get exported within this time frame, and the check will not complete successfully. If solution checker encounters a timeout during export, it will retry three times before it fails to process the job, so it may take over an hour before you receive a failure notification.
236
233
237
-
The workaround is to create smaller solutions with fewer components to be analyzed. If the large file size of the solution is due to many plug-in assembly components, please see guidance to [Optimize custom assembly development](../../developer/common-data-service/best-practices/business-logic/optimize-assembly-development.md).
234
+
The workaround is to create smaller solutions with fewer components to be analyzed. If the large file size of the solution is due to many plug-in assembly components, see guidance to [Optimize custom assembly development](../../developer/common-data-service/best-practices/business-logic/optimize-assembly-development.md).
238
235
239
236
> [!IMPORTANT]
240
237
> To minimize false positives, ensure you add dependent customizations. When you create a solution and add these components, include the following:
0 commit comments