---
title: "Codeunit 104061 Upgrade User Groups, extension points 29"
author: "JOP-AL"
url: https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/points/
object: https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/
app: "Base Application"
major: 29
source: https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/
checked: 2026-11-20
changed: 2026-10-05
subject: "Microsoft Dynamics 365 Business Central"
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/"
---

# Codeunit 104061 Upgrade User Groups, extension points 29

JOP-AL, https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/points/

7 procedures and triggers with a step in src/Layers/W1/BaseApp/System/UserGroups/Transition/UpgradeUserGroups.Codeunit.al, in source order, read from the text, not from a run.

## OnUpgradePerDatabase

[Line 13](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L13), trigger.

- [19](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L19) calls [Codeunit 6060 Hybrid Deployment](https://jonas-paprotka.de/ref/codeunit/6060-hybrid-deployment/) `VerifyCanStartUpgrade`
- [23](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L23) calls `IsUserGroupObsoleteStateRemoved`
- [26](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L26) calls [Codeunit 9999 Upgrade Tag](https://jonas-paprotka.de/ref/codeunit/9999-upgrade-tag/) `HasUpgradeTag`
- [26](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L26) calls [Codeunit 9998 Upgrade Tag Definitions](https://jonas-paprotka.de/ref/codeunit/9998-upgrade-tag-definitions/) `GetUserGroupsMigrationUpgradeTag`
- [29](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L29) calls `RunUpgrade`
- [31](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L31) calls [Codeunit 9999 Upgrade Tag](https://jonas-paprotka.de/ref/codeunit/9999-upgrade-tag/) `SetUpgradeTag`
- [31](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L31) calls [Codeunit 9998 Upgrade Tag Definitions](https://jonas-paprotka.de/ref/codeunit/9998-upgrade-tag-definitions/) `GetUserGroupsMigrationUpgradeTag`

## RunUpgrade

[Line 44](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L44), internal.

- [52](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L52) raises `OnBeforeUpgradeUserGroups`
- [54](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L54) calls [Codeunit 104042 Upgrade Permission Sets](https://jonas-paprotka.de/ref/codeunit/104042-upgrade-permission-sets/) `RunUpgrade`
- [55](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L55) calls [Codeunit 104060 Upgrade App ID Permissions](https://jonas-paprotka.de/ref/codeunit/104060-upgrade-app-id-permissions/) `RunUpgrade`
- [56](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L56) calls [Codeunit 104030 Upgrade Plan Permissions](https://jonas-paprotka.de/ref/codeunit/104030-upgrade-plan-permissions/) `RunUpgrade`
- [59](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L59) calls `MigrateUserGroups`

## MigrateUserGroups

[Line 62](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L62), internal.

- [64](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L64) calls `CreateTenantPermissionSetsForSelectedGroups`
- [65](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L65) calls `TransferDefaultPermissionsPerPlan`
- [67](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L67) raises `OnMigrateUserGroups`

## CreateTenantPermissionSetsForSelectedGroups

[Line 70](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L70), local.

- [83](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L83) calls `CreateNewTenantPermissionSet`
- [85](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L85) calls `CreateTenantPermissionSetRelation`
- [88](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L88) calls [Codeunit 104030 Upgrade Plan Permissions](https://jonas-paprotka.de/ref/codeunit/104030-upgrade-plan-permissions/) `ReplaceUserGroupPermissionSets`

## CreateNewTenantPermissionSet

[Line 92](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L92), local.

- [116](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L116) writes [Table 2000000165 Tenant Permission Set](https://jonas-paprotka.de/ref/table/2000000165-tenant-permission-set/) Insert

## CreateTenantPermissionSetRelation

[Line 120](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L120), local.

- [132](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L132) writes [Table 2000000253 Tenant Permission Set Rel.](https://jonas-paprotka.de/ref/table/2000000253-tenant-permission-set-rel/) Insert

## TransferDefaultPermissionsPerPlan

[Line 135](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L135), local.

- [146](https://jonas-paprotka.de/ref/codeunit/104061-upgrade-user-groups/source/#L146) calls [Codeunit 9825 Plan Configuration](https://jonas-paprotka.de/ref/codeunit/9825-plan-configuration/) `AddDefaultPermissionSetToPlan`

## Source

AL source 29: https://github.com/microsoft/BCApps, MIT, releases/29.x at 4303e5e584d3aa5d9e98cbc615525a5396ad6ed7.

JOP-AL, 2026-11-20.
