Skip to content

Commit 637c757

Browse files
committed
Revised per email Update to Common issues and resolutions for solution checker
1 parent bd1b422 commit 637c757

File tree

2 files changed

+19
-17
lines changed

2 files changed

+19
-17
lines changed

powerapps-docs/maker/common-data-service/common-issues-resolutions-solution-checker.md

Lines changed: 19 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: "Common issues and resolutions for solution checker | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces"
33
description: " A list of common issues and resolutions within solution checker"
44
keywords: ""
5-
ms.date: 04/07/2020
5+
ms.date: 07/30/2020
66
ms.service: powerapps
77
ms.custom:
88
- ""
@@ -76,25 +76,27 @@ To install Power Apps Checker back into your Common Data Service environment:
7676
2. Select **Solutions**.
7777
3. On the solution toolbar select **Solution checker**, and then select **Install**.
7878

79-
## Solution Checker can't access organizations in Administration Mode
79+
## Solution Checker can't access environments in Administration Mode
8080

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.
8282

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.
8484

8585
### How to disable administration mode
8686

8787
To disable administration mode for an organization instance:
8888

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. Select the environment that has issues running solution checker, and then select **Convert to sandbox** on the command bar.
9291

93-
![Instance Admin](media/solution-checker-instance-admin.png)
92+
> [!NOTE]
93+
> The conversion to sandbox may take several minutes to complete.
9494
95-
4. Clear **Enable administration mode**, and then select **Save**.
95+
3. Open the environment, and then select **Edit**.
9696

97-
![Disable Admin mode](media/solution-checker-instance-disable-admin-mode.png)
97+
4. Set **Administration mode** to disabled, and then select **Save**.
98+
99+
![Disable Admin mode](media/solution-checker-instance-disable-admin-mode.png)
98100

99101
5. Run solution checker again.
100102

@@ -167,9 +169,9 @@ Typical Common Data Service operations requested by solution checker:
167169
- Create, update, and retrieve analysis job, analysis component, and analysis result entity data
168170
- Export solutions
169171

170-
### Plugin step registered to execute in context of a unlicensed user
172+
### Plugin step registered to execute in context of an unlicensed user
171173

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.
174+
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.
173175

174176
>[!IMPORTANT]
175177
>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 +184,7 @@ When solution checker fails due to Common Data Service denying access based on a
182184

183185
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.
184186

185-
## Solution checker fails due to disabled first-party application in AAD
187+
## Solution checker fails due to disabled first-party application in Azue Active Directory
186188

187189
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.
188190

@@ -200,7 +202,7 @@ To verify and/or modify the enabled status of the PowerApps-Advisor enterprise a
200202

201203
4. Select **'PowerApps-Advisor'** to view the app details.
202204
5. Select **Properties**.
203-
6. Check the state of **Enabled for users to sign-in**. If **'No'**, then the application has been disabled.
205+
6. Check the state of **Enabled for users to sign in**. If **'No'**, then the application has been disabled.
204206

205207
![Disabled enterprise app](media/solution-checker-disabled-app.png)
206208

@@ -224,17 +226,17 @@ Reference [KB Article #4337537: Invalid Export - Business Process Entity Missing
224226

225227
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.
226228

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).
229+
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).
228230

229231
## Solution checker will not analyze empty solutions
230232

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.
233+
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.
232234

233235
## Solution Checker fails to export large solutions
234236

235237
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.
236238

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).
239+
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).
238240

239241
> [!IMPORTANT]
240242
> To minimize false positives, ensure you add dependent customizations. When you create a solution and add these components, include the following:
500 KB
Loading

0 commit comments

Comments
 (0)