PowerAppAdvisorClient 1.0.0

Motivation

In the moment of implementing existing Powershell module Microsoft.PowerApps.Checker.PowerShell does not implement client credential flow. This library implements client credential flow. It calls powerapps checker web api - https://docs.microsoft.com/en-us/power-platform/alm/checker-api/overview

For teams who are in need of automation CI/CD pipeline introducing static analysis of powerapp / dynamics 365 solution is great benefit. It quickly identifies problematic patterns and prevent introducing to solution legacy patterns or deprecated API etc.

What it does

Library allows to call PowerApps Checker Web Api and make static analysis of power app solution including Dynamics 365 solution. Implements OAuth client credential flow. It is possible to use client secret or client certificate.

What is needed

1. Registered app in portal azure
2. App should have assigned either
   • Dynamics CRM /user_impersonation and assigned system administrator role in environment
   • or PowerApps-Adivsor/Analysis.All

Example usage

string tenantId = "123456b6-1234-1234-1234-123456789abc"; // tenant id
string clientId = "12345678-1234-5678-1234-123456789abc"; // application id for registered app in portal azure
string redrictUri = "http://localhost" // registered redirect uri for app in portal azure

//using secret
var client =  DefaultClientFactory.Instance.Create(
            new ClientSettings()
            {
                TenantId = tenantId,
                ClientId = clientId,
                Scopes = new [] { "https://api.advisor.powerapps.com//.default" },
                RedirectUri = redrictUri,
                Secret = "somesecret",
                
            });
//using certificate
X509Certificate2 certificate = ... // load certificate from store or file

client =  DefaultClientFactory.Instance.Create(
            new ClientSettings()
            {
                TenantId = tenantId,
                ClientId = clientId,
                Scopes = new [] { "https://api.advisor.powerapps.com//.default" },
                RedirectUri = redrictUri,
                Certificate = certificate,
                
            });

//load zipped managed solution
string fullPathToManagedSolution = "C:\\directory\solution_managed.zip";

byte[] managedSolution = null;

using(var fs = File.Open(fullPathToManagedSolution,FileMode.Open)){
    using(var ms = new MemoryStream()){
        fs.CopyTo(ms);
        ms.Position=0L;
        managedSolution = ms.ToArray();
    }
}

//calling powerapps checker web api
//initialize correlationId
Guid correlationID = Guid.NewGuid();

var uploadReqResponse = await client.UploadSolution(managedSolution,"<solutionName>",tenantId, correlationId);

var analysisInvokationResult = await client.InvokeAnalysis(uploadReqResponse,tenantId,correlationId);

//in the loop
var analysisStatus = await client.CheckAnalysis(tenantId,correlationId);

do
{
    analysisStatus = await client.CheckAnalysis(tenantId, correlationId, default); 

} while ( analysisStatus.Progress!=100 );