Skip to content

Issue triage (CoE Starter Kit)

Manuela Pichler edited this page Apr 26, 2023 · 16 revisions

Please check out our documentation:

Below are some frequent questions that are raised on GitHub, and the guidance provided should help you resolve those issues:

Setup Wizard issues

Can't open setup wizard: It looks like this app isn't compliant with the latest data loss prevention policies.

We've added the PowerQuery connector with the latest release, so you'll have to update your DLP policy to include that. Note, you can always find our latest required DLP requirements in our documentation: https://learn.microsoft.com/en-us/power-platform/guidance/coe/setup#validate-data-loss-prevention-dlp-policies

Audit Log issues

Audit Log connector not working after upgrade

The custom connector needs to be updated after an upgrade to use the connection again. See detailed walkthrough:

Audit Log connector authentication failed

The default identity provider for setting up a custom connector has changed from Azure Active Directory to Generic Oauth2 and needs to be changed when updating the security tab, see details here: https://github.com/microsoft/coe-starter-kit/issues/4808

Can't turn on flow

ChildFlowNeverPublished error message

Many of the flows in the CoE kit call child flows. The parent flow can only be activated (turned on) if all child flows are turned on. If you see an error message stating ChildFlowNeverPublished this means a child flow this flow depends on is not turned on. To find the child flow, look at the solution dependencies of the parent flow you're trying to turn on image

Under required object, look for object type Process and note the display name image

Go back to the solution and check that the flows you noted are on: image

Can't turn on flow with "Attribute 'value' was not found for environment variable 'admin_....'

This means you missed to set an environment variable. You can set the environment variable by opening the CoE Admin Command Center and navigating to the Environment variables screen and updating from there

Connection issues (can't turn on flow, flow fails to run)

Usually an issue like this - either flow run fails or flow can't be turned on. This can happen when there's different people using the kit, e.g. one imported it, the other one turns on the flows and connection references get mixed up. image

Can you please try going to the Default Solution > Connection references > Filter to the connector that's failing > click on it > make sure they have the user there that you're trying to turn on the flow with image

Why have apps been marked as [deprecated] and what to do with them?

If you're upgrading to a more recent version of the CoE Starter Kit, you may notice some apps have been marked as [deprecated] image

We deprecated some canvas apps and replaced them with model driven apps that use custom pages, as that allowed us to use Creator Kit components for a Fluent UI look and feel and made collaboration on development easier for us. Unfortunately the change from canvas to model-driven apps isn't as seamless as just replacing the app, so here's some actions for you:

Here's what you need to do: If you are currently using one of the apps that's been marked as deprecated, unshare the deprecated version and re-share the new app with your colleagues.

Here's what we will do: The deprecated apps were left in the solution so that customers who are using them have time to unshare them and re-share the new version, get familiar with the new version or take a copy of the old version if they want to stick with it. There's no need for you to delete the app, we will delete it from the solution in about 3 months but we needed to give customers some time to migrate to the new apps - hence why we didn't just delete them.

Why are some flows still using the Dataverse (legacy) connector when it's been marked for deprecation?

The inventory of certain Power Platform resources is stored in Dataverse tables of the environments they're created from - desktop flows are stored in the Processes table, Chatbots are stored in the Bots table etc etc etc. We use the Dataverse (legacy) connector to loop through all environments in your tenant to get the inventory for those resources.

The modern/latest Dataverse connector has a few limitations - primarily that you can't connect to environments other than the current environment. https://learn.microsoft.com/en-us/power-platform/important-changes-coming#microsoft-dataverse-legacy-connector-for-power-automate-flows-will-be-deprecated-and-replaced-with-another-connector

Due to this limitation we are not yet able to shift to the modern/latest connector yet, but we will once that limitation is resolved in the connector. This is tracked under https://github.com/microsoft/coe-starter-kit/issues/2607

Why is a Power Automate License required?

A Power Automate license has always been required to run the CoE kit.

The CoE kit contains flows that run in context of Power Apps (for which a Power Apps license is sufficient), but most of the flows run standalone outside of the context of Power Apps thus a standalone license is required. Some of this may not be enforced in the product, e.g. you will be able to turn on a standalone flow if you only have a Power Apps license but it doesn't follow our license guidance, see here the Power Apps use rights only include execution of cloud flows within the app context image

Before the setup wizard, you likely just turned on the flows with your Power Apps license as the above guidance is not enforced today.

Issue upgrading to the latest version

If an upgrade from a version over 3 months ago failed: I'm afraid we cannot assist with upgrade problems of this age / complexity as there are just too many specifics and unknowns of how you got into this state. We recommend upgrading at least every 3 months, see installing updates. That is how far back we test as well.

If all you are using us for is inventory, then we recommend you start from a clean environment.

If you are using us for more than that, you may need to hire a partner to manually clean up the state of the environment. You can find some via you can find them via AppSource

Some people have cleaned themselves from this state by manually cleaning out errored references listed for example, if they are familiar enough with Power Platform.

Others have overcome it with a classic overwrite upgrade.

Clone this wiki locally