microsoft / coe-starter-kit

Other
754 stars 225 forks source link

[CoE starter kit - ENHANCEMENT] Reporting on usages of deprecated actions #981

Open filcole opened 3 years ago

filcole commented 3 years ago

Is your feature request related to a problem? Please describe. As the connector ecosystem has expanded it is inevitable that some actions within connectors will be deprecated. Some connectors are deprecated totally. The connector-reference on docs can show the deprecated connectors, but there is no way to get this information cleanly. When deprecated actions are continue to be used flows/canvasapps/powerfx may stop working unexpectedly.

Describe the solution you'd like It would be great if the COE starter kit could report instances where deprecated actions are utilised, either in Power Automate Cloud Flows or Canvas Apps.

Describe alternatives you've considered I think the powershell tooling will need to be expanded to show the connectors that are being used by the actions. I have a crawled list of all connectors and actions available I'd like to share to facilitate this functionality. This is related to https://github.com/microsoft/coe-starter-kit/issues/985, which aims to scan solutions during the build pipeline.

Additional context Currently, there is reporting on the flow actions that are used, but it only reports on the OperationId and does not provide the connector.

manuelap-msft commented 3 years ago

Great idea, we will investigate what's possible there today.

We use https://docs.microsoft.com/en-us/connectors/powerappsforappmakers/#get-connectors today to get a list of all connectors in the platform, and we use https://docs.microsoft.com/en-us/connectors/flowmanagement/#list-flows-as-admin to get flows and their action details. For canvas apps, we are unable to get actions used today as that's not returned in the Power Apps for Admins connector. And I'm not sure if either of what we use today returns the deprecated status of an action, so likely before we can work on this, the management connectors of the platform need to get enhanced.

filcole commented 3 years ago

Hi @manuelap-msft, I have built a list of deprecated actions based on the connector-reference, see https://connectorstatus.com and https://www.philcole.org/post/connector-check/

I was attempting to incorporate it into the CoE and submit it for review. However, I have noticed that the https://docs.microsoft.com/en-us/connectors/flowmanagement/#list-flows-as-admin action is only returning the OperationId and not the connector that it's associated with. Sometimes the same operationId is shared by multiple connectors (e.g. GetItem), so until the connector is provided by list-flows-as-admin I do not think it's reliably possible to report on deprecated actions used within flows.

I have logged this issue as #1191