SUPPORT & TROUBLESHOOTING GUIDE App Name: Np365SampleQMS Version: 25.2.5.4 1. Contact Support If you encounter any issues while using this Web Part or need technical assistance, please contact our support team: • Support Email: an@netpowertest.onmicrosoft.com • Response Time: We aim to respond to all inquiries within 24 - 48 hours. 2. CRITICAL SETUP: API Permission Approval (For Tenant Administrators) This Web Part requires Tenant Administrator consent for the Microsoft Graph – User.Read permission before it can function for any end - user. If the Web Part fails to load the Access Token, this critical step is the most common cause. Steps for Tenant Administrators to Approve Permissions: 1. Access Admin Center: As a Tenant Administrator, navigate to the SharePoint Admin Center (e.g., ` https://[yourtenant] - admin.sharepoint.com `). 2. Go to API Access: In the left navigation, go to Advanced > API access 3. Locate the Request: Look for the pending approval request associated with this application (or the SPFx deployment). The permission requested will be Microsoft Graph – User.Read 4. Approve: Select the request and click the Approve button to grant tenant - wide consent. Once approved, users may need to wait a few minutes and refresh their SharePoint page. 3 . Frequently Asked Questions (FAQ) Q: Where do I find the Client ID/App ID? A: The Client ID (Application ID) is generated when you register an application in Microsoft Entra ID (formerly Azure AD). Please ask your IT Administrator for this ID if you do not have it. Q: Why am I receiving an error when retrieving the token? A: Common reasons for token retrieval failure include: • Incorrect Client ID: Double - check that the ID you entered is correct. • Permissions: Ensure that the API permissions have been granted in the SharePoint Admin Center (API Access page). • Browser Blocker: Check if any pop - up blocker or strict privacy extension is interfering with the request. Q: Which browsers are supported? A: This Web Part is optimized for the latest versions of Microsoft Edge, Google Chrome, and Mozilla Firefox. 4. Guideline on how to create an app registration We have created a multi tenant app and you can follow the instructions below to add it to your tenant. Admin Consent URL Format Unique client id: a52c9be3 - cb8e - 4ce9 - 8306 - 1db0ee66367a https://login.microsoftonline.com/ {tenant - id} /adminconsent?client_id=a52c9be3 - cb8e - 4ce9 - 8306 - 1db0ee66367a&redirect_uri=https://office.com • Replace {tenant - id} by customer’s {tenant - id} • After replacing the {tenant - id} , run the URL Login with Global Admin account • Click Accept • Deploy webpart Approve QMS Auth in API Access https://{tenant - name} - admin.sharepoint.com/_layouts/15/online/AdminHome.aspx#/webApiPermissionManag ement • Replace {tenant - name} by customer’s {tenant - name} Click Approve API access page Click Approve Approve API access 5 . Troubleshooting Steps If the application is not working as expected: 1. Clear Cache: Clear your browser cache and cookies, then reload the SharePoint page. 2. Re - login: Sign out of your Microsoft 365 account and sign back in to refresh your session. 3. Check Console: If you are a developer, check the browser console (F12) for any specific error messages related to aadTokenProvider and include them in your support email.