Skip to main content

Step 5: Run Migration

Now SimplePerm does the actual work: reads profile permissions, builds the permission sets, and deploys them to your org.

Before You Click Run​

You'll see a summary of what's about to be created: how many profiles, which permission types, and the resulting permission set names. Give it a final look, then click Run Migration.

Watching the Progress​

Once it starts, progress stages light up as each phase completes:

  1. Retrieving profile metadata -- SimplePerm reads the selected profiles using SOQL queries and the Metadata API
  2. Parsing permissions -- The raw metadata is parsed into a structured format
  3. Building permission sets -- Permission set metadata is assembled from the parsed data
  4. Deploying to org -- The new permission sets are created in your org via the Metadata API
  5. Verifying deployment -- SimplePerm confirms the permission sets were deployed correctly

Each stage gets a checkmark when it finishes.

How Long Does It Take?​

A single-profile migration typically finishes in 10 to 30 seconds. Profiles with lots of field or object permissions may take a bit longer. Multiple profiles are processed together in a single batch.

note

Don't close the wizard while the migration is running. You'll lose the real-time progress view. (You can always check the outcome later from the History tab.)

What Happens Behind the Scenes​

SimplePerm uses a two-phase execution model to stay within Salesforce governor limits:

  • Phase 1 (Callout Phase): All SOQL queries and Metadata API calls run first. No database writes.
  • Phase 2 (DML Phase): After callouts finish, SimplePerm writes migration project records, logs, and status updates.

This avoids the "callout after DML" restriction that Salesforce enforces in Apex transactions.

Moving Forward​

When all stages finish, the wizard advances to the results step automatically.

Step 6: View Results →