Retain permissions during cloud migration

By default, once you set up cloud migration, the migration engine removes all permission sets assigned to existing online users, except users with the SUPER permission set, and reassigns users the Intelligent Cloud permission set. This change is done to prevent users, other than SUPER users, from making any data modifications.

However, you might want some users to keep their original permissions, for various reasons. For example, you want them to continue working on your data while it's being replicated, or you want to use service-to-service apps that require specific permissions.

If you want users to keep their permissions during cloud migration, you have the following options:

Option 1: Use the Cloud Migration Management page in the client

1. Sign in to Business Central online.

2. Search for and open the Cloud Migration Management page.

3. In the action bar, select ... (Show the rest) > More options > Actions > Enable/Disable Removing Permissions from Users.

   • If the message Setting for Keeping user permissions was set to: Yes. appears, then permission sets remain. Select OK.
   • If the message Setting for Keeping user permissions was set to: No. appears, then users' permission sets are removed and replaced by the Intelligent Cloud permission set. Select OK and repeat this step to change to Yes.

Option 2: Use a custom extension

Create and install a per-tenant extension that includes the following code:

[EventSubscriber(ObjectType::Codeunit, Codeunit::"Hybrid Deployment", 'OnBeforeResetUsersToIntelligentCloudPermissions', '', false, false)] 

local procedure HandleBeforeResetUsersToIntelligentCloudPermissions(var Handled: Boolean) 
begin 
    Handled := true; 
end 

Next steps

Run data migration setup.

See also

Dynamics GP migration to Business Central online: End-to-end overview
Compare work in Dynamics GP to Business Central
FAQ about migrating to Business Central online from on-premises solutions