---
id: object/codeunit/1798
type: object
title: Codeunit 1798 "Data Migration Mgt."
summary: Codeunit 1798 "Data Migration Mgt." in Base Application (System.Integration). 29 public procedures, 5 events, 4 event subscribers. Present since at least BC23, still in BC30, changed in BC24, BC27.
tier: official
language: en
tags:
  - codeunit
  - base application
versions:
  introduced: null
  last_changed: "27"
  deprecated: null
review:
  state: derived
  by: null
  at: null
  flags: []
generated:
  at: "2026-10-11T00:31:51.816Z"
  pipeline: 0.2.0
  prompts: {}
  input_hash: 3e85e7de37c78bdf2e5b284196e435e6c52cdcb81101273c2b35ab6905886a99
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/System/DataMigration/DataMigrationMgt.Codeunit.al
    title: src/Layers/W1/BaseApp/System/DataMigration/DataMigrationMgt.Codeunit.al (releases/29.x)
    date: null
    commit: ea08af5ef2d6a9b5c5af4a029288abbe2c883220
    t: null
    quote: null
links:
  learn: []
  objects: []
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
object_type: codeunit
object_id: 1798
name: Data Migration Mgt.
namespace: System.Integration
app: Base Application
extends: null
first_version: "23"
last_version: "30"
present_in:
  - "23"
  - "24"
  - "25"
  - "26"
  - "27"
  - "28"
  - "29"
  - "30"
changed_in:
  - "24"
  - "27"
source_major: "29"
obsolete: null
countries: []
ms_search_form_ids: []
counts:
  fields: 0
  procedures: 47
  events: 5
  subscribers: 4
relations:
  out: 1
  referenced_by: 0
  pages: 0
  extended_by: 0
  event_subscribers: 13
  calls: 6
  called_by: 7
  implements: 0
---

# Codeunit 1798 "Data Migration Mgt."

> Codeunit 1798 "Data Migration Mgt." in Base Application (System.Integration). 29 public procedures, 5 events, 4 event subscribers. Present since at least BC23, still in BC30, changed in BC24, BC27.

Base Application · System.Integration · BC23-30 · [source at ea08af5e](https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/System/DataMigration/DataMigrationMgt.Codeunit.al) · facts from BC29

## Properties

| Property | Value |
|---|---|
| TableNo | Job Queue Entry |

## Events published

- `OnBeforeMigrationStarted(var DataMigrationStatus: Record "Data Migration Status"; Retry: Boolean)` (integration)
  - subscribers: [Codeunit 1798 "Data Migration Mgt."](../codeunit/1798.md) OnBeforeMigrationStartedSubscriber, [Codeunit 40032 "Migration Validation"](../codeunit/40032.md) BeforeMigrationStarted
- `OnCreatePostMigrationData(var DataMigrationStatus: Record "Data Migration Status"; var DataCreationFailed: Boolean)` (integration)
  - subscribers: [Codeunit 4035 "Wizard Integration"](../codeunit/4035.md) OnCreatePostMigrationDataSubscriber, [Codeunit 47005 "SL Wizard Integration"](../codeunit/47005.md) OnCreatePostMigrationDataSubscriber
- `OnValidateMigration(var DataMigrationStatus: Record "Data Migration Status"; var DataCreationFailed: Boolean)` (integration)
  - subscribers: [Codeunit 4016 "Hybrid GP Management"](../codeunit/4016.md) StartMigrationValidation
- `OnAfterMigrationFinished(var DataMigrationStatus: Record "Data Migration Status"; WasAborted: Boolean; StartTime: DateTime; Retry: Boolean)` (integration)
  - subscribers: [Codeunit 1798 "Data Migration Mgt."](../codeunit/1798.md) OnAfterMigrationFinishedSubscriber, [Codeunit 1830 "MigrateQBO Wizard Integration"](../codeunit/1830.md) OnAfterMigrationFinishedSubscriber, [Codeunit 1914 "MigrationQB Wizard Integration"](../codeunit/1914.md) OnAfterMigrationFinishedSubscriber, [Codeunit 4035 "Wizard Integration"](../codeunit/4035.md) OnAfterMigrationFinishedSubscriber, [Codeunit 47005 "SL Wizard Integration"](../codeunit/47005.md) OnAfterMigrationFinishedSubscriber
- `OnBeforeStartMigration(var StartNewSession: Boolean; var CheckExistingData: Boolean)` (integration)
  - subscribers: [Codeunit 4016 "Hybrid GP Management"](../codeunit/4016.md) DisableNewSessionForGPCloudMigration, [Codeunit 46862 "BC14 Migration Orchestrator"](../codeunit/46862.md) DisableNewSessionForBC14CloudMigration, [Codeunit 47013 "SL Hybrid Management"](../codeunit/47013.md) DisableNewSessionForSLCloudMigration

## Event subscriptions

- OnRequestAbortSubscriber subscribes to Page "Data Migration Overview" OnRequestAbort
- OnBeforeMigrationStartedSubscriber subscribes to Codeunit "Data Migration Mgt." OnBeforeMigrationStarted
- OnAfterMigrationFinishedSubscriber subscribes to Codeunit "Data Migration Mgt." OnAfterMigrationFinished
- OnInitializingNotificationWithDefaultState subscribes to Page "My Notifications" OnInitializingNotificationWithDefaultState

## Procedures

- `RunStagingTableMigrationCodeunit(CodeunitToRun: Integer; StagingTableEntityVariant: Variant): Boolean`
- `SetStartTime(Value: DateTime)`
- `SetAbortStatus(var DataMigrationStatus: Record "Data Migration Status")`
- `StartMigration(MigrationType: Text[250]; Retry: Boolean)`
- `CheckMigrationInProgress(Retry: Boolean)`
- `GetMigrationStatus(): Integer`
- `StartDataMigrationWizardFromNotification(Notification: Notification)`
- `ShowDataMigrationRelatedGlobalNotifications()`
- `GetGlobalNotificationId(): Guid`
- `GetCustomerContactNotificationId(): Guid`
- `GetVendorContactNotificationId(): Guid`
- `GetItemListEmptyNotificationId(): Guid` (internal)
- `GetCustomerListEmptyNotificationId(): Guid` (internal)
- `GetVendorListEmptyNotificationId(): Guid` (internal)
- `ShowDataMigrationOverviewFromNotification(Notification: Notification)`
- `IsMigrationInProgress(): Boolean`
- `ShowMoreInfoPage(Notification: Notification)`
- `CheckForEntitiesToBePosted(): Boolean`
- `DestTableHasAnyTransactions(var DataMigrationStatus: Record "Data Migration Status"; var JournalBatchName: Code[10]): Boolean`
- `ShowHelpTopicPage(Notification: Notification)`
- `GetDataMigrationHelpTopicURL(): Text`
- `DisableDataMigrationRelatedGlobalNotifications(Notification: Notification)`
- `InsertDefaultCustomerContactNotification(Enabled: Boolean)`
- `InsertDefaultVendorContactNotification(Enabled: Boolean)`
- `InsertDefaultCustomerListEmptyNotification(Enabled: Boolean)`
- `InsertDefaultVendorListEmptyNotification(Enabled: Boolean)`
- `InsertDefaultItemListEmptyNotification(Enabled: Boolean)`
- `UpdateMigrationStatus(var DataMigrationStatus: Record "Data Migration Status")`
- `CheckIfMigrationIsCompleted(CurrentDataMigrationStatus: Record "Data Migration Status")`

Plus 9 local procedures.

## Triggers

OnRun

## Relations

- runs on [Table 472 "Job Queue Entry"](../table/472.md)

## Calls

From the extracted call graph of BC29 (graphify-al on the snapshot checkout): calls whose target is known from a declared type or an `Object::"Name"` argument. Interface dispatch and calls through events are not counted, so the list is not complete.

- [Codeunit 6100 "Data Migration Facade"](../codeunit/6100.md) (6 calls: `CheckIfMigrationIsCompleted → OnMigrationCompleted`, `DestTableHasAnyTransactions → OnFindBatchForAccountTransactions`, `DestTableHasAnyTransactions → OnFindBatchForCustomerTransactions`, …)
- [Codeunit 6101 "Data Migration Status Facade"](../codeunit/6101.md) (4 calls: `HandleEntityMigration → IncrementMigratedRecordCount`, `HandleEntityMigration → UpdateLineStatus`, `ProcessBatch → IncrementMigratedRecordCount`, …)
- [Codeunit 1812 "Data Migration Del G/L Account"](../codeunit/1812.md) (1 call: `OnRun → (object)`)
- [Page 1798 "Data Migration About"](../page/1798.md) (1 call: `ShowMoreInfoPage → (object)`)
- [Page 1799 "Data Migration Overview"](../page/1799.md) (1 call: `ShowDataMigrationOverviewFromNotification → (object)`)
- [Page 1808 "Data Migration Wizard"](../page/1808.md) (1 call: `StartDataMigrationWizardFromNotification → (object)`)

## Called by

- [Codeunit 1802 "Data Migration Notifier"](../codeunit/1802.md) (15 calls: `CheckCustVendNotificationIdEnabled → GetCustomerContactNotificationId`, `CheckCustVendNotificationIdEnabled → GetVendorContactNotificationId`, `RemoveCustomerContactNotification → GetCustomerContactNotificationId`, …)
- [Page 1795 "Data Migration Overview Part"](../page/1795.md) (3 calls: `OnAfterGetRecord → DestTableHasAnyTransactions`, `OnAfterGetRecord → UpdateMigrationStatus`, `ShowRefreshNotification → IsMigrationInProgress`)
- [Page 1799 "Data Migration Overview"](../page/1799.md) (3 calls: `OnAfterGetRecord → DestTableHasAnyTransactions`, `OnAfterGetRecord → UpdateMigrationStatus`, `ShowRefreshNotification → IsMigrationInProgress`)
- [Codeunit 1430 "Role Center Notification Mgt."](../codeunit/1430.md) (1 call: `ShowNotifications → ShowDataMigrationRelatedGlobalNotifications`)
- [Codeunit 6100 "Data Migration Facade"](../codeunit/6100.md) (1 call: `StartMigration → StartMigration`)
- [Page 1808 "Data Migration Wizard"](../page/1808.md) (1 call: `OnOpenPage → CheckMigrationInProgress`)
- [Table 1799 "Data Migration Status"](../table/1799.md) (1 call: `OnModify → CheckIfMigrationIsCompleted`)

## Across versions

- Present in: BC23-30
- Changed (declaration) in: BC24, BC27

Source: AL metadata extracted from the code (names, ids, signatures, properties); no code bodies (D10).

## Ask your agent

Procedure bodies are not stored here (D10). The call sections above are our own, per object, from the BC29 call graph. For a procedure body or the calls of one procedure, ask bc-code-atlas (external, by Stefan Maron, MIT; default corpus w1-28), which the bc-observatory plugin connects: `bcatlas_resolve_node(object_type: "codeunit", object_name: "Data Migration Mgt.")`, then `bcatlas_get_procedure_body` or `bcatlas_get_neighbors` on the returned id.