# Troubleshooting — every failure hit during the reference build Ordered roughly by how much time each one costs if you do not know about it. --- ## `pac` CLI gives confidently wrong answers | Command | Symptom | Trust instead | |---|---|---| | `pac application list --installState` | 33 apps appear in **both** Installed and NotInstalled | Org UI app list | | `pac solution list` | Returns 3 solutions for a fully-deployed org | Org UI app list | | `pac copilot list` | All agents "Published / Provisioned" when 37 are Draft | Copilot Studio Agents list | | `pac admin list` | Type = Sandbox after successful Production conversion | PPAC environment hub | | `pac admin list` | Omits environments entirely | Only shows envs **with a Dataverse database** | | `pac application install` | "already installed. Proceeding with update" then success, imports nothing | Org UI app list | **Rule: `pac` is fine for *doing* things, unreliable for *checking* things.** --- ## Installs that appear to hang `pac application install` frequently never returns even after the app fully deploys. Project Operations was verified live in the org UI while the CLI kept polling for another 50 minutes. At exactly 60 minutes it hard-errors: ``` Error: Failed to install application within maximum timeout of 60 minutes ``` That error does **not** mean the install failed. Check the org UI. **Do not declare an install dead before 60 minutes.** --- ## Agent admin pages stuck on "Loading" **Cause:** connection references are unbound. See `02-connections-and-agents.md`. There is no error message. The page just spins. This is the single highest-value thing in this skill. --- ## `PvaPublish` returns 409 Conflict ```json {"error":{"code":"0x80040265","message":"{\"statuscode\":409,\"statusdescription\":\"Conflict\", \"errors\":[{\"message\":\"Exception of type 'Microsoft.Dynamics.PowerVA.Plugins.Exceptions.ExternalServiceException' was thrown.\"}]}"}} ``` Accompanied by: Copilot Studio agent status **"Setting up…"** and a **disabled** Publish button. Server-side provisioning state. Not fixable client-side. Did not clear after 25+ minutes. See the publish section in `02-connections-and-agents.md`. --- ## Theme applied but nothing changes Three possible causes, in order of likelihood: 1. You used the **legacy `theme` entity**. It does nothing in modern UCI. See `03-branding-and-polish.md`. 2. You set `CustomThemeDefinition` but not **`EnableDesignLanguageThemeSystem = true`**. That is the master switch and it defaults to false. 3. You are checking the **app-selector page** (`pagetype=apps`), which has its own fixed chrome. Check inside a real app. --- ## `webresourceset` not found ``` The entity "webresourceset" cannot be found. ``` The entity logical name is **`webresource`**. `webresourceset` is the OData collection name and is not valid in `Xrm.WebApi.createRecord`. --- ## "undeclared property 'SettingDefinitionId'" Lookup binds are **lowercase**: ```js 'settingdefinitionid@odata.bind': '/settingdefinitions()' // correct 'SettingDefinitionId@odata.bind': '...' // fails ``` To discover the correct navigation property for any entity: ```js const r = await fetch(base + "/api/data/v9.2/EntityDefinitions(LogicalName='organizationsetting')?$select=LogicalName" + "&$expand=ManyToOneRelationships($select=ReferencingEntityNavigationPropertyName,ReferencedEntity)", {headers:{Accept:'application/json'}}); ``` --- ## "You cannot create system or default themes" You passed `type: false` when creating a `theme` record. Omit `type` entirely. (Moot anyway — the legacy theme entity has no visual effect. See above.) --- ## Unhandled server exception on `main.aspx` Adding arbitrary query parameters (e.g. a cache-buster `&t=123456`) to a `main.aspx` URL produces an error page: ``` Error Details: An unhandled exception occurred during the execution of the current web request. ``` Use the plain URL. --- ## Application-user dropdown shows only "None" The Case resolution settings page does not refresh its application-user list when you navigate directly to the settings control URL. **Fix:** go to the parent **Case Management Agent** page and click **Manage settings for case resolution**. The dropdown populates correctly. --- ## PPAC shows the wrong tenant If you are a Microsoft employee, PPAC silently opens in your **corporate** tenant. You will see corporate environments and conclude the Caldova environment does not exist. Check the account avatar. Get the Caldova tenant ID from the public openid-configuration endpoint and force PPAC to it. Related: **`az` CLI is very likely signed into your corporate tenant too.** Check with `az account show`. Use `pac` for anything that must land in the demo tenant. --- ## Cross-origin iframe failures in admin UIs ``` Failed to load resource: net::ERR_CONNECTION_CLOSED @ https://.environment.api.powerplatform.com/... ``` The Power Platform admin widgets embedded in model-driven apps are hosted on island-cluster domains and intermittently fail to load **in the browser** even when the host is reachable from PowerShell. **Workaround:** do the operation via `Xrm.WebApi` instead of the widget wherever possible. --- ## Coachmark / teaching-bubble dialogs block automation PPAC shows onboarding coachmarks ("Explore Power Platform Inventory") that intercept pointer events and cannot always be dismissed by clicking Next/Dismiss. **Workaround:** reload the page, then remove them from the DOM: ```js document.querySelectorAll('[role="dialog"]').forEach(d => { if (/Explore Power Platform Inventory|1 of 2/.test(d.innerText)) d.remove(); }); ``` --- ## Do not clear cookies to bust a cache It signs you out of the tenant and you will need to re-authenticate interactively. A normal reload is almost always enough. If content is genuinely cached server-side, waiting is the fix. --- ## MIP-protected PDFs cannot be parsed locally The Caldova setup guides are MIP-protected. `markitdown`, `PyMuPDF` etc. return only a protection stub. **Use WorkIQ Ask with the SharePoint URL:** ```powershell & "$env:USERPROFILE\.scout\bin\workiq.cmd" ask ` --file-urls "https://-my.sharepoint.com/personal/.../STEP 1 - ....pdf" ` -q "Summarize the setup steps, preserving all URLs, settings and values." ``` It refuses verbatim reproduction but will produce a faithful paraphrase with values intact. --- ## Solo-only app provisioning error ``` The CDS app 'X' cannot be provisioned with other apps. ``` Contact Center, M365 Copilot – Service Solution, Guides and Remote Assist each require their own dedicated environment. Remove them from the multi-select. --- ## `competitor` entity has no `description` field ``` Could not find a property named 'description' on type 'Microsoft.Dynamics.CRM.competitor'. ``` `competitor` supports `name` but **not** `description`. A `$select` including it returns HTTP 400 and, if your code assumes success, silently yields `undefined` counts. Always surface OData query failures explicitly rather than letting them fall through as empty arrays — `verify-environment.js` does this via an `ERROR` key. --- ## Customer Insights install path is not discoverable Three separate obstacles, all hit in sequence: **1. `pac` refuses** ``` Error: This application utilizes a Custom Install Experience through a Single Page Application. Install for such apps is not supported by this API. ``` **2. PPAC per-environment Applications page crashes** `/manage/environments/{envid}/applications` -> `Error: Cannot read properties of undefined (reading 'toString')` **3. The working surface is not linked from the environment** PPAC -> Products -> Dynamics 365 apps -> "Dynamics 365 Marketing Application" card -> Manage -> Open -> redirects to `https://public-usa.mkt.dynamics.com/fre/cio/manage` Bookmark that final URL. --- ## CI Journeys and CI Data install SERIALLY Starting the CI Journeys install immediately disables the CI Data Install link (`cursor: not-allowed`). You cannot run both at once. Wait for the first to complete. --- ## CI portal Install controls are `` not `