Export & import

How to import and validate the refactor solution package

Refactor solution packages must be imported through Power Platform Solutions and validated like engineering artifacts. This guide explains the import path, connection-reference steps, activation order, and validation checks after import.

7 min readUpdated Jul 3, 2026exportsolutionsrefactor package
Quick answer
In shortUse this checklist after downloading the refactor solution package from Flow Migrator.
Most likely causeDo not import the refactor package from the legacy My flows import screen. The package is generated as a Power Platform solution because it contains solution-aware parent and child flows.
What to do nextMake the fix, generate a new package, and import the new ZIP instead of retrying the old one.

Import through Solutions

Do not import the refactor package from the legacy My flows import screen. The package is generated as a Power Platform solution because it contains solution-aware parent and child flows.

Use Power Apps or Power Automate Solutions, choose Import solution, select the ZIP, and follow the connection-reference prompts for the target environment.

  1. Open the target Power Platform environment.
  2. Go to Solutions and choose Import solution.
  3. Upload the refactor ZIP downloaded from Flow Migrator.
  4. Map or create the required connection references.
  5. Complete the import and review any warnings before activating flows.

Activate child flows before the parent

The parent flow calls generated child flows. If a child flow is inactive, missing a connection reference, or invalid, the parent can fail validation or runtime testing.

After import, open the solution, confirm the connection references, then activate the generated child flows first. Activate or test the parent flow only after the child flows are ready.

Validate context JSON handoff

The refactor package uses a MigrationContext object to pass data between parent and child flows. This is what lets extracted child flows share state without relying on source actions that no longer live in the same flow.

During UAT, validate that variables used by later child flows are populated by earlier child flows and that default values were not used where real business data is required.

  • Check trigger inputs on each child flow.
  • Review response outputs from each child flow.
  • Confirm important variables are written back to MigrationContext.
  • Pay attention to approvals, HTTP responses, SharePoint item IDs, group members, and file metadata.

Validate branch behavior, not only import success

An import success message proves the solution can be saved. It does not prove every original Nintex branch behaves correctly in the customer tenant.

Run branch-specific test items for the major category/status paths. Confirm SharePoint updates, email recipients, attachments, task outcomes, HTTP body parsing, and group-member lookups.

Review TODO and partial actions

TODO actions in the refactor solution should represent real review work, not generic boundary labels. They usually appear where the source action requires a business decision, custom connector mapping, external system validation, or document-generation strategy.

If a supported action appears as a placeholder, re-run the workflow through Analyze and confirm the action family is recognized correctly.

Related articles

Keep reading the next most relevant guides for this workflow pattern.