{"title":"Codeunit 104061 Upgrade User Groups, extension points 29","url":"https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/points/","author":"JOP-AL","license":"Metadata from Microsoft's symbol packages. AL source MIT, Copyright (c) Microsoft Corporation. Selection and wording © 2026 JOP-AL. https://jonas-paprotka.de/licenses/","subject":"Microsoft Dynamics 365 Business Central","checked":"2026-11-20","changed":"2026-10-05","object":{"type":"codeunit","id":104061,"name":"Upgrade User Groups","app":"Base Application","url":"https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/"},"major":29,"source":{"url":"https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/","path":"src/Layers/W1/BaseApp/System/UserGroups/Transition/UpgradeUserGroups.Codeunit.al","commit":"4303e5e584d3aa5d9e98cbc615525a5396ad6ed7","lines":"a line is <source url>#L<line>"},"steps":{"event":"[line, \"event\", name, handled]: raises an event of this object; handled 1 when it has an IsHandled parameter","call":"[line, \"call\", name, arguments]: calls a procedure of this object","ext":"[line, \"ext\", type, id, name, arguments]: calls a procedure of another object, through a variable declared with that type","write":"[line, \"write\", table id, method, 1 when called with true]: Insert, Modify, ModifyAll, Delete, DeleteAll or Rename","validate":"[line, \"validate\", table id, field name]","run":"[line, \"run\", type, id]: Codeunit.Run, Page.Run, Report.Run and their kin"},"objects":{"codeunit:6060":{"name":"Hybrid Deployment","url":"https://jonas-paprotka.de/ref/codeunit/6060-hybrid-deployment/"},"codeunit:9999":{"name":"Upgrade Tag","url":"https://jonas-paprotka.de/ref/codeunit/9999-upgrade-tag/"},"codeunit:9998":{"name":"Upgrade Tag Definitions","url":"https://jonas-paprotka.de/ref/codeunit/9998-upgrade-tag-definitions/"},"codeunit:104042":{"name":"Upgrade Permission Sets","url":"https://jonas-paprotka.de/ref/codeunit/104042-upgrade-permission-sets/"},"codeunit:104060":{"name":"Upgrade App ID Permissions","url":"https://jonas-paprotka.de/ref/codeunit/104060-upgrade-app-id-permissions/"},"codeunit:104030":{"name":"Upgrade Plan Permissions","url":"https://jonas-paprotka.de/ref/codeunit/104030-upgrade-plan-permissions/"},"table:2000000165":{"name":"Tenant Permission Set","url":"https://jonas-paprotka.de/ref/table/2000000165-tenant-permission-set/"},"table:2000000253":{"name":"Tenant Permission Set Rel.","url":"https://jonas-paprotka.de/ref/table/2000000253-tenant-permission-set-rel/"},"codeunit:9825":{"name":"Plan Configuration","url":"https://jonas-paprotka.de/ref/codeunit/9825-plan-configuration/"}},"procs":[{"name":"OnUpgradePerDatabase","line":13,"kind":"trigger","steps":[[19,"ext","codeunit",6060,"VerifyCanStartUpgrade",0],[23,"call","IsUserGroupObsoleteStateRemoved",0],[26,"ext","codeunit",9999,"HasUpgradeTag",1],[26,"ext","codeunit",9998,"GetUserGroupsMigrationUpgradeTag",0],[29,"call","RunUpgrade",0],[31,"ext","codeunit",9999,"SetUpgradeTag",1],[31,"ext","codeunit",9998,"GetUserGroupsMigrationUpgradeTag",0]]},{"name":"RunUpgrade","line":44,"kind":"procedure","access":"internal","params":0,"steps":[[52,"event","OnBeforeUpgradeUserGroups",0],[54,"ext","codeunit",104042,"RunUpgrade",0],[55,"ext","codeunit",104060,"RunUpgrade",0],[56,"ext","codeunit",104030,"RunUpgrade",0],[59,"call","MigrateUserGroups",1]]},{"name":"MigrateUserGroups","line":62,"kind":"procedure","access":"internal","params":1,"steps":[[64,"call","CreateTenantPermissionSetsForSelectedGroups",1],[65,"call","TransferDefaultPermissionsPerPlan",0],[67,"event","OnMigrateUserGroups",0]]},{"name":"CreateTenantPermissionSetsForSelectedGroups","line":70,"kind":"procedure","access":"local","params":1,"steps":[[83,"call","CreateNewTenantPermissionSet",2],[85,"call","CreateTenantPermissionSetRelation",5],[88,"ext","codeunit",104030,"ReplaceUserGroupPermissionSets",3]]},{"name":"CreateNewTenantPermissionSet","line":92,"kind":"procedure","access":"local","params":2,"steps":[[116,"write",2000000165,"Insert"]]},{"name":"CreateTenantPermissionSetRelation","line":120,"kind":"procedure","access":"local","params":5,"steps":[[132,"write",2000000253,"Insert"]]},{"name":"TransferDefaultPermissionsPerPlan","line":135,"kind":"procedure","access":"local","params":0,"steps":[[146,"ext","codeunit",9825,"AddDefaultPermissionSetToPlan",4]]}]}