Skip to content

Commit de65ec0

Browse files
KumarVivekKumarVivek
authored
Merge pull request #2039 from MicrosoftDocs/mabolan/support-page
Added troubleshooting guide
2 parents 337a469 + d508092 commit de65ec0

File tree

3 files changed

+160
-0
lines changed

3 files changed

+160
-0
lines changed

‎powerapps-docs/maker/TOC.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1425,6 +1425,8 @@
14251425
href: ./canvas-apps/common-issues-and-resolutions.md
14261426
- name: Get a session or app ID
14271427
href: ./canvas-apps/get-sessionid.md
1428+
- name: Troubleshoot startup issues for PowerApps
1429+
href: troubleshooting-startup-issues.md
14281430
- name: Troubleshoot Power Query
14291431
href: ./common-data-service/data-platform-cds-newentity-troubleshooting-mashup.md
14301432
- name: Support

‎powerapps-docs/maker/media/troubleshooting-startup-issues/error.png

51.1 KB
Loading

‎powerapps-docs/maker/troubleshooting-startup-issues.md

Lines changed: 158 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,158 @@
1+
---
2+
title: Troubleshooting startup issues for PowerApps | Microsoft Docs
3+
description: This troubleshooting guide helps fix common configuration problems that prevent PowerApps from starting.
4+
author: matthewbolanos
5+
manager: kvivek
6+
ms.service: powerapps
7+
ms.topic: conceptual
8+
ms.custom: canvas
9+
ms.reviewer:
10+
ms.date: 10/28/2019
11+
ms.author: mabolan
12+
search.audienceType:
13+
- maker
14+
search.app:
15+
- PowerApps
16+
---
17+
# Troubleshooting startup issues for PowerApps
18+
19+
This troubleshooting topic helps fix the following two common configuration problems that prevent PowerApps from starting:
20+
21+
- When you receive a “Hmmm … We couldn’t sign you in” error message and identifier that resembles the following image:
22+
23+
![Hmmm … We couldn’t sign you in. The information below may be helpful](./media/troubleshooting-startup-issues/error.png "Hmmm … We couldn’t sign you in. The information below may be helpful")
24+
25+
- When you try to create an app from a SharePoint list, you receive the following "abnormal termination" error message
26+
```
27+
WebAuthoring abnormal termination.
28+
29+
Client date/time: <Client Time>Thh:mm:ss.sssZ
30+
Version: 2.0.602
31+
Session ID: xxxx-xxxxx-xxxxxxx--xxxxxxxx
32+
description: {"error":{"detail":{"exception":{}},"colno":0,"filename":"https://paaeuscdn.azureedge.net/v2.0.602.0/studio/openSource/modified/winjs/js/base.js?v=39de0f2edf1...",
33+
"lineno":0,"message":"Script error","initErrorEvent":"[function]","bubbles":false,"cancelBubble":false,"cancelable":false,"currentTarget":"[window]","defaultPrevented":true,
34+
"eventPhase":2,"isTrusted":true,"srcElement":"[window]","target":"[window]","timeStamp":1490711965955,"type":"error","initEvent":"[function]","preventDefault":"[function]",
35+
"stopImmediatePropagation":"[function]","stopPropagation":"[function]","AT_TARGET":2,"BUBBLING_PHASE":3,"CAPTURING_PHASE":1},"errorLine":0,"errorCharacter":0,
36+
"errorUrl":"https://paaeuscdn.azureedge.net/v2.0.602.0/studio/openSource/modified/winjs/js/base.js?v=39de0f2edf1... error","setPromise":"[function]","exception":{}}
37+
stack: null
38+
errorNumber: 0
39+
errorMessage: Script error
40+
```
41+
42+
If you experience one of the issues that's described in this section, check out the common errors matrix later, and then try one of the resolutions listed later to resolve the problem.
43+
44+
## Common error matrix
45+
46+
| Error identifier | Microsoft Internet Explorer 11 | Microsoft Edge | Google Chrome |
47+
|-------------------------------------------------------------------------------|-------------------------------|-------------------------------|-------------------------------|
48+
| UserInterventionNeeded_CookiesBlocked UserInterventionNeeded_StorageBlocked | Enable storage of local data | Enable storage of local data | Enable storage of local data |
49+
| UserInterventionNeeded_NavigateToAadTimeout | Possible network problem | Configure Trust Zones | Possible network problem |
50+
| UserInterventionNeeded_NavigateToAadDenied UserInterventionNeeded_StorageLost | Configure Trust Zones | Configure Trust Zones | Not applicable |
51+
| AadError | Azure Active Directory Errors | Azure Active Directory Errors | Azure Active Directory Errors |
52+
53+
## Resolution 1: Enable storage of local data in your browser
54+
PowerApps stores some data locally in your browser, including user identity and preferences. PowerApps can’t function if the browser is configured to disallow this.
55+
56+
### Instructions for Internet Explorer 11
57+
58+
- **Option 1: Enable local data for all sites**
59+
60+
1. Close all Internet Explorer and Edge windows.
61+
2. Select **OK** to close the **Internet Options** dialog box.
62+
3. Select **OK**.
63+
4. Remove any entries for **powerapps.com**.
64+
5. In the **Settings** section, select **Sites**.
65+
6. Select **OK**.
66+
7. Select **Accept** for third-party cookies.
67+
8. Select **Accept** for first-party cookies.
68+
9. In the **Settings** section, select **Advanced**.
69+
10. Select the **Privacy** tab.
70+
11. Select **Internet Options**.
71+
12. On the browser toolbar, select the gear icon.
72+
13. Open Internet Explorer.
73+
74+
- **Option 2: Create exceptions to enable local data for PowerApps and associated services**
75+
1. Open Internet Explorer.
76+
2. On the browser toolbar, select the gear icon.
77+
3. Select **Internet Options**.
78+
4. Select the **Privacy** tab.
79+
5. In the **Settings** section, select **Sites**.
80+
6. Add an entry to “Allow” **powerapps.com**.
81+
7. Select **OK**.
82+
8. Select **OK** to close the Internet Options dialog box.
83+
9. Close all Internet Explorer and Edge windows.
84+
85+
### Instructions for Edge
86+
1. Open Edge.
87+
2. On the Edge toolbar, select **More** > **Settings**.
88+
3. Near the bottom of the panel, select **View advanced settings**.
89+
4. Near the bottom of the panel, find the **Cookies** drop-down options list.
90+
5. Select **Don’t block cookies**.
91+
6. Close all Internet Explorer and Edge windows.
92+
93+
### Instructions for Chrome
94+
95+
- **Option 1: Enable local data for all sites**
96+
1. On your browser toolbar, select **More**.
97+
2. Select **Settings**.
98+
3. Near the bottom of the page, select **Show advanced settings**.
99+
4. In the "Privacy" section, select **Content settings**.
100+
5. Select **Allow local data to be set (recommended)**.
101+
6. Make sure that **Block third-party cookies and site data** is not selected.
102+
7. Select Manage exceptions and make sure that there are no exceptions for **https://create.powerapps.com**, **https://\*.create.powerapps.com**, **https://make.\*.powerapps.com**, **https://make.powerapps.com**, and **https://login.microsoftonline.com**. If there are such exceptions, remove them by clicking on the x sign for the corresponding rows.
103+
8. Select **Done**.
104+
105+
- **Option 2: Create exceptions to allow local data for PowerApps and associated services**
106+
107+
1. On the browser toolbar, select **More**.
108+
2. Select **Settings**.
109+
3. Near the bottom of the page, select **Show advanced settings**.
110+
4. In the Privacy section, select **Content settings**.
111+
5. Select **Manage exceptions** and create exceptions to “Allow” data storage for **https://create.powerapps.com**, **https://\*.create.powerapps.com**, **https://make.\*.powerapps.com**, **https://make.powerapps.com**, and **https://login.microsoftonline.com**.
112+
6. Select **Done**.
113+
114+
115+
## Resolution 2: Configure Trust Zones for Internet Explorer and Edge
116+
117+
Internet Explorer and Edge use *Trust Zones*. Problems can occur if services on which PowerApps relies are in different Trust Zones in your browser settings. While these settings apply to both Internet Explorer and Edge, the easiest way to access them is from Internet Explorer. (You might need assistance from your IT administrator to change some of these settings.)
118+
119+
- **Option 1: Add the required PowerApps domains to the Trusted Sites zone**
120+
1. On the browser toolbar, select the gear icon.
121+
2. Select **Internet Options**.
122+
3. Select the **Security** tab.
123+
4. Select **Trusted sites**.
124+
5. Select **Sites**.
125+
6. Add the following sites by typing the address and selecting **Add** for each:
126+
- **https://login.microsoftonline.com**
127+
- **https://create.powerapps.com**
128+
- **https://*.create.powerapps.com** (the asterisk is part of the address, don't replace it)
129+
- **https://make.powerapps.com**
130+
- **https://make.*.powerapps.com** (the asterisk is part of the address, don't replace it)
131+
- **https://*.powerapps.com** (the asterisk is part of the address, don't replace it)
132+
7. Select **Close**.
133+
8. Select **OK**.
134+
9. Close all Internet Explorer and Edge windows.
135+
136+
137+
- **Option 2: Remove all the PowerApps domains from the Trusted Sites zone**
138+
1. On the browser toolbar, select the gear icon.
139+
2. Select **Internet Options**.
140+
3. Select the **Security** tab.
141+
4. Select **Trusted sites**.
142+
5. Select **Sites**.
143+
6. Remove all existing entries for the following sites:
144+
- **https://login.microsoftonline.com**
145+
- **https://create.powerapps.com**
146+
- **https://*.create.powerapps.com**
147+
- **https://make.powerapps.com**
148+
- **https://make.*.powerapps.com**
149+
- Any other address that ends in **powerapps.com** or **create.powerapps.com**.
150+
7. Select **Close**.
151+
152+
## Resolution 3: Azure Active Directory Errors
153+
154+
Azure Active Directory (Azure AD) is the technology on which the PowerApps ecosystem relies for user authentication and authorization.
155+
156+
The error page that you see might contain additional information that can help diagnose and fix the problem.
157+
158+
To resolve Azure AD errors, you might need assistance from your IT department.

0 commit comments

Comments
 (0)