mikebroadway71 / FlowPowerAppsMigrator

Converts SharePoint Data sources for the MS Flow and PowerApps to a new tenant of your choice.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

SharePoint Online Windows Version

Flow & Power Apps Migrator

Have you ever tried moving canvas apps or cloud flows across Microsoft 365 tenants or sites? This is a common task when deploying apps and flows to production. Apps and flows have to be exported, imported and SharePoint actions manually updated. These manual updates are error-prone and labor intensive. Flow & Power Apps Migrator automatically converts exported flows and apps to be compatible with the target environment.

Flow & Power Apps Migrator also helps you migrate SharePoint lists that are used as a dependency for your Apps and Flows. There is an interactive UI form that lets you do just that.

Finally, the Flow & Power Apps Migrator converts SharePoint List Forms customized with Power Apps.

Watch a Demo

Prerequisites

Migratable artifacts

Artifact Support
Standalone Canvas Power Apps
Customized SharePoint List Forms Canvas apps ⚠️ As of March 2022 this feature no longer works. Working on a fix
Canvas Power Apps that trigger Flows ✔ (flows are also migrated)
Standalone Cloud Flows
Standalone Desktop Flows
Standalone Model-driven apps N/A (not tested)
Solutions containing multiple canvas apps and flows
SharePoint Lists
SharePoint Libraries
Modern JSON List customizations
SharePoint data
Content Types ✔ (migrated automatically)
Lookup fields
Datasources located in a single site
Datasources located in multiple sites and subsites

Convert flows, apps and solutions

Export flows, apps and solutions

Export all of your flows:

Export all of your apps:

2. Place exported flows, apps and solutions in the src folder

3. Run Migrate-Packages.bat

The scripts will iterate through all ZIP files inside the \src directory and convert them to be compatible with the new Microsoft 365 tenant or site.

  • Run Migrate-Packages.bat script

  • Enter source site URL and target site URL:
  • Keep MIGRATE_LISTS property set to True if you want to migrate SharePoint lists and libraries.

image

  • Select lists and libraries to migrate

image

  • Sit back and wait for the lists and libraries to be migrated and the conversion process to finish.

4. Navigate to the \dist folder and collect converted flows, apps and solutions

5. Import converted flows, apps and solutions

Now go ahead and import your flows and apps to the destination tenant. All SharePoint actions are now be converted and point to the new location.

Power Apps data sources are all converted

Flow actions are also converted

How it works

Flow & Power Apps Migrator finds all unique IDs pointing to the source SharePoint site and replaces them with the destination IDs. resourceMapping.csv contains the mapping of these IDs.

Limitations

  • Does not support macOS and Linux.
  • Only SharePoint data sources are updated.

Preparing a deployment package for your Clients and Partners

Prepare-Deployment-Package-for-Client.bat script prepares a deployment package that you can share with your Clients or Partners.

On your end

  • Run Prepare-Deployment-Package-for-Client.bat

image

  • Export your Solutions, Power Apps and Flows and save them to the package\src directory

image

  • Send the package directory to your Client or Partner.

image

On the Client's side

  • If not already exsists, create a SharePoint Online site. It will contain SharePoint Lists and Libraries that Power Apps/Flows require.
  • Open the package directory.
  • Run Convert-Packages.bat script.
  • Provide target site URL.
  • Navigate to the dist folder and deploy converted solutions, apps and flows that will be compatible with the target environment.
  • Import all solutions, flows and apps from the dist directory.

Note: Convert-Packages.bat will:

  • Deploy SharePoint lists and libraries (if you chose to do package them)
  • Convert Apps and Flows from src and saves them to 'dist'.

image

Latest Updates

3.5 Version

New features

  • Added an ability to migrate content types and columns. These will be automatically migrated if your lists have any custom content types.

Known issues

  • SharePoint list forms customized with Power Apps are no longer migrated by this tool. There is an issue I am still working on.

3.4 Version

  • Fixed a major bug preventing export-importing for the lists and libraries.

3.3 Version

  • Made console output more clear.

3.1 Version

  • Fixed a bug that corrupted solution zip files during the conversion process. It made it impossible to import solutions.

3.0 Version - Major update

New features added:

  • Migrate-Packages.bat script now migrates SharePoint lists and libraries that your Apps and Flow depend on.
  • Added Prepare-Deployment-Package-for-Client.bat script that lets you prepare a deployment package that you can share with your Clients or Partners. Running this script will generate a package directory that you can then send to your Clients and Partners. Distribution of your apps and flows is now easier than ever.

2.1 Version

New feature added:

  • added support for solution migration. Thanks to Mark Doria for helping with this feature.

About

Converts SharePoint Data sources for the MS Flow and PowerApps to a new tenant of your choice.

License:MIT License


Languages

Language:PowerShell 99.6%Language:Batchfile 0.4%