README.md

Powerapps-Helper VSCode Extension

The Power Apps Helper VSCode Extension help you to download & upload Solutions and PowerApps from your PowerApp Environment. Furthermore, the extension uses Power Platform Cli from Microsoft to extract as Canvas Apps downloaded in msapp (Archive) format well as to pack the extracted source code into msapp format for the upload.

Features

The added view "Power Apps Environments" provides information about your Power Apps Environments.

• List of "Power Apps Environments"
  • "Solutions" contains the Crm solutions of related environment.
    • "Canvas Apps" contains Canvas Apps included in related solution
    • "Flows" contains modern Workflows included in related solution
    • "Connectors" contains Connectors included in related solution
  • "Canvas Apps" contains all Crm Canvas Apps of the environment
  • "Flows" contains all Crm modern Workflows of the environment
  • "Connectors" contains all Connectors of the environment
  • "Power Apps" of the environment. Note: These Power Apps are not part of solutions or Crm.
    • "Power App Versions" of the environment. Note: These Power Apps are not part of solutions or Crm.
  • "Power Apps APIs" of the environment. Note: These are your Custom APIs from related Power Apps environment.

Commands

• Command "Power Apps: Download and Unpack Solution", which download and extract the solution into "source folder"
• Command "Power Apps: Pack Solution", which creates a Solution-Zip ready for import in the "output folder"
• Command "Power Apps: Pack and Upload Solution", which import the solution into a Crm Environment
• Command "Power Apps: Download and Unpack Power App" extract the Downloaded App in the folder <SourceFolder>/CanvasApps/<PowerAppName>_msapp_src
• Command "Publish Customizations" publish the changes of a Solution, CanvasApp, Connector, Workflow in the related Crm Environment

The extension adds the PowerApps View to VSCode, which gets a list of your PowerApps Environments from PowerApps API

Use the PowerApps-Language-Tooling to Downloaded and Unpack Solutions to your local project:

You can PowerApps-Language-Tooling as well to Downloaded and Unpack a PowerApp to your local project. This makes sense, when you want to add manual a Canvas App to your solution.

As result you get your PowerApp sources as follows:

Requirements

This extension uses the PowerApps API to excess your PowerApps Environment:

1. PowerApps for App Makers - Get Apps to provide PowerApp information to the VSCode Extension PowerApps Tree
2. PowerApps for App Makers - Get App Versions to provide PowerApp Version information to the VSCode Extension PowerApps Tree

Furthermore, it uses the PowerApps-Language-Tooling to extract the PowerApp from msapp (Archive) format into YAML. Read more about this on: Source code files for Canvas apps

Finally, Azure Account VS-Code extension is required to acquire a Bearer Token for the PowerApps API requests.

Power Apps

The PowerApps are provided by PowerApps API: https://api.powerapps.com/providers/Microsoft.PowerApps/apps/?api-version=2020-07-01

A documentation can be found at:

PowerApps for App Makers - Get Apps

Power App Versions

The PowerApp Versions are provided by PowerApps API: https://api.powerapps.com/providers/Microsoft.PowerApps/apps/{app}/versions?api-version=2020-07-01

A documentation can be found at:

PowerApps for App Makers - Get App Versions

Power Apps APIs

The Power Apps APIs are provided by Power Apps for Makers API: https://api.powerapps.com/providers/Microsoft.PowerApps/apis/{connector}?$filter=environment eq '{environmentName}'&api-version=2020-07-01

A documentation can be found at:

PowerApps for App Makers - Get Connectors

Extension Settings

This extension contributes the following settings:

• mme2k-powerapps-helper.PowerPlatformCli: Microsoft Power Platform Cli to pack and unpack Canvas Apps.\n\nDownload: Power Platform Cli.
• mme2k-powerapps-helper.CoreToolsSolutionPackager: Path to the Microsoft CrmSdk CoreTools Solution-Packer binary (SolutionPacker.exe) tool to pack and unpack solutions.
• mme2k-powerapps-helper.SourceFolder: Source Code Folder to extract the PowerApp
• mme2k-powerapps-helper.OutputFolder: Output Folder for the packed PowerApp
• mme2k-powerapps-helper.MaxVisibleVersions: Count of shown PowerApp versions
• mme2k-powerapps-helper.CacheAPIConnectionSecrets: Cache secrets for API Connections (OAuth Settings, ...)
• mme2k-powerapps-helper.APIConnectionSettings: API Connection Settings (OAuth Settings, ...)
• mme2k-powerapps-helper.UseCrmSolutionPacker: Use the CrmSdk CoreTools Solution-Packer tool for solution packing and unpacking
• mme2k-powerapps-helper.SolutionFolderName: Define the root folder structure for solutions. These vars can be used: <SourceFolder>, <SolutionName>

API Connection Settings (OAuth Settings, ...)

Uses this setting to avoid a reentering of ClientId and/or TenantId for each Custom Connectors in a new Crm-Environment. You can specify the used ClientId and/or TenantId for "Update OAuth Settings" for Custom Connectors by:

{
   "mme2k-powerapps-helper.APIConnectionSettings": {
        // Environment name where the setting is used
        "Default-525232c0-41a9-4573-9484-8b571b4691c2": {
            // "Xrm-ConnectorId.Authentication": ... "3a4b7fd3-f303-4269-b1ac-91ec8ef15a06.oauth.aad"
            //   or
            // "Authentication" ... "oauth.aad"
            "oauth.aad": {
                "clientId": "10996272-a6ac-425f-933f-17ae3f5f6724", // overrule the clientId
                "tenantId": "abce06a2-ff58-48b6-9ca0-ca4d8608f2d6"  // overrule the tenantId, when tenantId != common
            }
        }
  }
}

Note: Use the tooltips of Environment and Custom Connector to get the needed information for the setting.

Known Issues

• Only Download of Published PowerApps possible (Versions Download Url run into an Authentication Issue)
• no Upload of packed PowerApp, because there is no API

Release Notes

The extension is currently in development.

Change Log