Skip to content

Commit fa5f58b

Browse files
authored
Merge pull request #3214 from MicrosoftDocs/matp-solution-checker-admin-mode
Matp solution checker admin mode
2 parents fa26bcb + d6bebf2 commit fa5f58b

File tree

2 files changed

+18
-21
lines changed

2 files changed

+18
-21
lines changed

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

Lines changed: 18 additions & 21 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: 08/04/2020
66
ms.service: powerapps
77
ms.custom:
88
- ""
@@ -76,27 +76,24 @@ 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. Open the environment that has issues running solution checker, and then select **Edit**.
9291

93-
![Instance Admin](media/solution-checker-instance-admin.png)
92+
3. Set **Administration mode** to disabled, and then select **Save**.
9493

95-
4. Clear **Enable administration mode**, and then select **Save**.
94+
![Disable Admin mode](media/solution-checker-instance-disable-admin-mode.png)
9695

97-
![Disable Admin mode](media/solution-checker-instance-disable-admin-mode.png)
98-
99-
5. Run solution checker again.
96+
4. Run solution checker again.
10097

10198
## Solution checker fails due to missing security roles
10299

@@ -118,7 +115,7 @@ To assign missing security roles to the Power Apps Checker user:
118115

119116
5. Run solution checker again.
120117

121-
## Solution Checker fails due to restricted access mode
118+
## Solution checker fails due to restricted access mode
122119

123120
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.
124121

@@ -167,9 +164,9 @@ Typical Common Data Service operations requested by solution checker:
167164
- Create, update, and retrieve analysis job, analysis component, and analysis result entity data
168165
- Export solutions
169166

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

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

174171
>[!IMPORTANT]
175172
>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
182179

183180
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.
184181

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
186183

187184
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.
188185

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

201198
4. Select **'PowerApps-Advisor'** to view the app details.
202199
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 sign in**. If **'No'**, then the application has been disabled.
204201

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

@@ -220,21 +217,21 @@ If a solution contains a business process flow component in draft state that has
220217

221218
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.
222219

223-
## Solution Checker fails to export patched solutions
220+
## Solution checker fails to export patched solutions
224221

225222
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.
226223

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 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).
228225

229226
## Solution checker will not analyze empty solutions
230227

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

233230
## Solution Checker fails to export large solutions
234231

235232
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.
236233

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).
238235

239236
> [!IMPORTANT]
240237
> 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)