---
title: "Codeunit 4589 SOA Upgrade, extension points 29"
author: "JOP-AL"
url: https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/points/
object: https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/
app: "Sales Order Agent"
major: 29
source: https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/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 4589 SOA Upgrade, extension points 29

JOP-AL, https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/points/

16 procedures and triggers with a step in src/Apps/W1/SalesOrderAgent/app/src/Integration/SOAUpgrade.Codeunit.al, in source order, read from the text, not from a run.

## OnUpgradePerDatabase

[Line 31](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L31), trigger.

- [33](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L33) calls `RegisterCapability`
- [34](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L34) calls `AddBillingTypeToCapability`

## OnUpgradePerCompany

[Line 37](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L37), trigger.

- [39](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L39) calls `AlwaysUpdateAgentInstructionsOnUpgrade`
- [40](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L40) calls `AddDailyEmailLimit`
- [41](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L41) calls `UpgradeUserSecurityIDField`
- [42](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L42) calls `SetMarkEmailAsRead`
- [43](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L43) calls `UpgradeOwnerUserSecurityID`
- [44](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L44) calls `UpgradeAgentIdentity`
- [45](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L45) calls `ResetReplyAttempts`
- [47](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L47) calls `UpgradeSOAKPIToPerAgent`

## AlwaysUpdateAgentInstructionsOnUpgrade

[Line 54](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L54), local.

- [62](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L62) calls [Codeunit 457 Environment Information](https://jonas-paprotka.de/ref/codeunit/457-environment-information/) `IsSaaSInfrastructure`
- [77](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L77) calls [Codeunit 4400 SOA Setup](https://jonas-paprotka.de/ref/codeunit/4400-soa-setup/) `MustTreatAgentAsArchived`
- [79](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L79) writes [Table 4325 SOA Setup](https://jonas-paprotka.de/ref/table/4325-soa-setup/) Insert
- [80](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L80) calls `TryUpdateAgentInstructions`
- [82](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L82) writes [Table 4325 SOA Setup](https://jonas-paprotka.de/ref/table/4325-soa-setup/) DeleteAll

## TryUpdateAgentInstructions

[Line 88](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L88), local.

- [92](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L92) calls [Codeunit 4400 SOA Setup](https://jonas-paprotka.de/ref/codeunit/4400-soa-setup/) `UpdateInstructions`
- [96](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L96) writes [Table 4325 SOA Setup](https://jonas-paprotka.de/ref/table/4325-soa-setup/) Modify

## RegisterCapability

[Line 100](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L100), local.

- [104](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L104) calls [Codeunit 9999 Upgrade Tag](https://jonas-paprotka.de/ref/codeunit/9999-upgrade-tag/) `HasUpgradeTag`
- [104](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L104) calls `GetRegisterSalesOrderAgentCapabilityTag`
- [105](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L105) calls [Codeunit 4587 SOA Impl](https://jonas-paprotka.de/ref/codeunit/4587-soa-impl/) `RegisterCapability`
- [107](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L107) calls [Codeunit 9999 Upgrade Tag](https://jonas-paprotka.de/ref/codeunit/9999-upgrade-tag/) `SetUpgradeTag`
- [107](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L107) calls `GetRegisterSalesOrderAgentCapabilityTag`

## AddBillingTypeToCapability

[Line 111](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L111), local.

- [118](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L118) calls [Codeunit 9999 Upgrade Tag](https://jonas-paprotka.de/ref/codeunit/9999-upgrade-tag/) `HasUpgradeTag`
- [118](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L118) calls `GetAddBillingTypeToSOACapabilityTag`
- [119](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L119) calls [Codeunit 457 Environment Information](https://jonas-paprotka.de/ref/codeunit/457-environment-information/) `IsSaaSInfrastructure`
- [120](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L120) calls [Codeunit 7773 Copilot Capability](https://jonas-paprotka.de/ref/codeunit/7773-copilot-capability/) `IsCapabilityRegistered`
- [121](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L121) calls [Codeunit 7773 Copilot Capability](https://jonas-paprotka.de/ref/codeunit/7773-copilot-capability/) `ModifyCapability`
- [123](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L123) calls [Codeunit 9999 Upgrade Tag](https://jonas-paprotka.de/ref/codeunit/9999-upgrade-tag/) `SetUpgradeTag`
- [123](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L123) calls `GetAddBillingTypeToSOACapabilityTag`

## UpgradeUserSecurityIDField

[Line 127](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L127), local.

- [133](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L133) calls [Codeunit 9999 Upgrade Tag](https://jonas-paprotka.de/ref/codeunit/9999-upgrade-tag/) `HasUpgradeTag`
- [133](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L133) calls `GetUserSecurityIDUpgradeTag`
- [139](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L139) calls [Codeunit 9999 Upgrade Tag](https://jonas-paprotka.de/ref/codeunit/9999-upgrade-tag/) `SetUpgradeTag`
- [139](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L139) calls `GetUserSecurityIDUpgradeTag`

## AddDailyEmailLimit

[Line 142](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L142), local.

- [147](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L147) calls [Codeunit 9999 Upgrade Tag](https://jonas-paprotka.de/ref/codeunit/9999-upgrade-tag/) `HasUpgradeTag`
- [147](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L147) calls `GetSetDailyEmailLimitTag`
- [151](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L151) calls [Table 4325 SOA Setup](https://jonas-paprotka.de/ref/table/4325-soa-setup/) `GetDefaultMessageLimit`
- [152](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L152) writes [Table 4325 SOA Setup](https://jonas-paprotka.de/ref/table/4325-soa-setup/) Modify
- [155](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L155) calls [Codeunit 9999 Upgrade Tag](https://jonas-paprotka.de/ref/codeunit/9999-upgrade-tag/) `SetUpgradeTag`
- [155](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L155) calls `GetSetDailyEmailLimitTag`

## SetMarkEmailAsRead

[Line 159](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L159), local.

- [164](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L164) calls [Codeunit 9999 Upgrade Tag](https://jonas-paprotka.de/ref/codeunit/9999-upgrade-tag/) `HasUpgradeTag`
- [164](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L164) calls `GetSetMarkEmailAsReadTag`
- [169](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L169) writes [Table 4325 SOA Setup](https://jonas-paprotka.de/ref/table/4325-soa-setup/) Modify
- [172](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L172) calls [Codeunit 9999 Upgrade Tag](https://jonas-paprotka.de/ref/codeunit/9999-upgrade-tag/) `SetUpgradeTag`
- [172](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L172) calls `GetSetMarkEmailAsReadTag`

## UpgradeAgentIdentity

[Line 176](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L176), local.

- [184](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L184) calls [Codeunit 9999 Upgrade Tag](https://jonas-paprotka.de/ref/codeunit/9999-upgrade-tag/) `HasUpgradeTag`
- [184](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L184) calls `GetAgentIdentityTag`
- [198](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L198) calls [Codeunit 4400 SOA Setup](https://jonas-paprotka.de/ref/codeunit/4400-soa-setup/) `MustTreatAgentAsArchived`
- [202](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L202) calls [Codeunit 4400 SOA Setup](https://jonas-paprotka.de/ref/codeunit/4400-soa-setup/) `GetSOAUserDisplayName`
- [207](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L207) calls [Codeunit 4400 SOA Setup](https://jonas-paprotka.de/ref/codeunit/4400-soa-setup/) `GetInitials`
- [212](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L212) writes [Table 4325 SOA Setup](https://jonas-paprotka.de/ref/table/4325-soa-setup/) Modify
- [216](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L216) calls [Codeunit 9999 Upgrade Tag](https://jonas-paprotka.de/ref/codeunit/9999-upgrade-tag/) `SetUpgradeTag`
- [216](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L216) calls `GetAgentIdentityTag`

## UpgradeOwnerUserSecurityID

[Line 219](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L219), local.

- [225](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L225) calls [Codeunit 9999 Upgrade Tag](https://jonas-paprotka.de/ref/codeunit/9999-upgrade-tag/) `HasUpgradeTag`
- [225](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L225) calls `GetOwnerUserSecurityIDTag`
- [237](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L237) writes [Table 4325 SOA Setup](https://jonas-paprotka.de/ref/table/4325-soa-setup/) Modify
- [240](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L240) calls [Codeunit 9999 Upgrade Tag](https://jonas-paprotka.de/ref/codeunit/9999-upgrade-tag/) `SetUpgradeTag`
- [240](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L240) calls `GetOwnerUserSecurityIDTag`

## UpgradeSOAKPIToPerAgent

[Line 244](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L244), local.

- [254](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L254) calls [Codeunit 9999 Upgrade Tag](https://jonas-paprotka.de/ref/codeunit/9999-upgrade-tag/) `HasUpgradeTag`
- [254](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L254) calls `GetSOAKPIPerAgentTag`
- [258](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L258) calls [Codeunit 9999 Upgrade Tag](https://jonas-paprotka.de/ref/codeunit/9999-upgrade-tag/) `SetUpgradeTag`
- [258](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L258) calls `GetSOAKPIPerAgentTag`
- [265](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L265) calls [Codeunit 4400 SOA Setup](https://jonas-paprotka.de/ref/codeunit/4400-soa-setup/) `FindFirstNonArchivedSetup`
- [276](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L276) calls `MergeSOAKPIIntoSummary`
- [280](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L280) calls `MergeSOAKPIIntoSummary`
- [286](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L286) writes [Table 4593 SOA KPI](https://jonas-paprotka.de/ref/table/4593-soa-kpi/) DeleteAll
- [288](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L288) calls [Codeunit 9999 Upgrade Tag](https://jonas-paprotka.de/ref/codeunit/9999-upgrade-tag/) `SetUpgradeTag`
- [288](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L288) calls `GetSOAKPIPerAgentTag`

## MergeSOAKPIIntoSummary

[Line 291](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L291), local.

- [293](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L293) calls [Table 4596 SOA KPI Summary](https://jonas-paprotka.de/ref/table/4596-soa-kpi-summary/) `GetSafe`
- [303](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L303) writes [Table 4596 SOA KPI Summary](https://jonas-paprotka.de/ref/table/4596-soa-kpi-summary/) Modify

## ResetReplyAttempts

[Line 310](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L310), local.

- [315](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L315) calls [Codeunit 9999 Upgrade Tag](https://jonas-paprotka.de/ref/codeunit/9999-upgrade-tag/) `HasUpgradeTag`
- [315](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L315) calls `GetResetReplyAttemptsTag`
- [318](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L318) writes [Table 4589 SOA Reply Attempt](https://jonas-paprotka.de/ref/table/4589-soa-reply-attempt/) DeleteAll
- [320](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L320) calls [Codeunit 9999 Upgrade Tag](https://jonas-paprotka.de/ref/codeunit/9999-upgrade-tag/) `SetUpgradeTag`
- [320](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L320) calls `GetResetReplyAttemptsTag`

## RegisterPerDatabaseUpgradeTags

[Line 371](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L371), local.

- [373](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L373) calls `GetAddBillingTypeToSOACapabilityTag`

## RegisterPerCompanyUpgradeTags

[Line 377](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L377), local.

- [379](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L379) calls `GetSetDailyEmailLimitTag`
- [380](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L380) calls `GetSetMarkEmailAsReadTag`
- [381](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L381) calls `GetOwnerUserSecurityIDTag`
- [382](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L382) calls `GetAgentIdentityTag`
- [383](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L383) calls `GetResetReplyAttemptsTag`
- [385](https://jonas-paprotka.de/ref/codeunit/4589-soa-upgrade/source/#L385) calls `GetSOAKPIPerAgentTag`

## Source

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

JOP-AL, 2026-11-20.
