---
id: change/bcapps/12167
type: change
title: "#12167 Track QuickBooks migration usage consistently"
summary: QuickBooks migration now consistently tracks usage by adding an uptake telemetry event and backfilling historical migrations with completed status during upgrade.
tier: official
language: en
tags:
  - feature
  - main
  - bc30
  - codeunit migrateqbo wizard integration
  - codeunit migrationqb dashboard mgt
  - codeunit migrationqb upgrade
system: development
review:
  state: reviewed
  by: opus
  at: "2026-10-08T02:02:43.571Z"
  flags: []
generated:
  at: "2026-10-08T01:26:53.141Z"
  pipeline: 0.2.0
  prompts:
    extract-change: 1
  input_hash: 21fcd2d35c42dc8f0f72186e8dfc7a0b0a915df0
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/pull/12167
    title: "microsoft/BCApps#12167: Track QuickBooks migration usage consistently"
    date: "2026-10-02"
    commit: 21fcd2d35c42dc8f0f72186e8dfc7a0b0a915df0
    t: null
    quote: null
links:
  learn: []
  objects:
    - object/codeunit/1830
    - object/codeunit/1915
    - object/codeunit/1831
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
  changes: []
number: 12167
repo: microsoft/BCApps
source_id: bcapps-prs
url: https://github.com/microsoft/BCApps/pull/12167
kind: pr
base_branch: main
major: "30"
merged_at: "2026-10-02T13:02:24Z"
author: nikolakukrika
author_type: User
community_contribution: false
labels:
  - "AL: Apps (W1)"
  - "Team: Integrations"
change_class: code
change_kind: feature
behavior_change: true
breaking: false
files:
  count: 3
  additions: 91
  deletions: 21
  al: 3
apps:
  - QBMigration
objects_touched:
  - key: codeunit/1830
    page: codeunit/1830
    type: codeunit
    id: 1830
    name: MigrateQBO Wizard Integration
    app: QBMigration
    status: modified
  - key: codeunit/1915
    page: codeunit/1915
    type: codeunit
    id: 1915
    name: MigrationQB Dashboard Mgt
    app: QBMigration
    status: modified
  - key: codeunit/1831
    page: codeunit/1831
    type: codeunit
    id: 1831
    name: MigrationQB Upgrade
    app: QBMigration
    status: modified
objects_unjoined: []
obsoletions: []
backports: []
fixes_issues:
  - 12166
  - 12184
work_items: []
systems:
  - development
quote: null
joined_against:
  major: "30"
  commit: ecbc028c25dbe83b61313bc566e6c1d41184bb1c
---

# #12167 Track QuickBooks migration usage consistently

> QuickBooks migration now consistently tracks usage by adding an uptake telemetry event and backfilling historical migrations with completed status during upgrade.

[Pull request](https://github.com/microsoft/BCApps/pull/12167) · merged into `main` (BC30) on 2026-10-02 by nikolakukrika · 3 files (+91 -21), 3 AL · feature · tier official · reviewed (checked by Opus)

## What changed

- Centralized existing completion telemetry emission for QuickBooks Online migrations
- Added new feature uptake telemetry event (0000JMQ) alongside existing completion event (0000JMR)
- One-time upgrade backfill detects and reports migrations completed before telemetry was introduced
- Existing Product = QuickBooks Online dimension preserved for backward compatibility
- Guarded by upgrade tag to ensure telemetry emits once per company
- Behaviour changes for users or extensions.

## AL objects touched

- [Codeunit 1830 "MigrateQBO Wizard Integration"](../../objects/codeunit/1830.md), QBMigration: modified
- [Codeunit 1915 "MigrationQB Dashboard Mgt"](../../objects/codeunit/1915.md), QBMigration: modified
- [Codeunit 1831 "MigrationQB Upgrade"](../../objects/codeunit/1831.md), QBMigration: modified

## Context

- Fixes: [#12166 [Bug]: Track QuickBooks migration usage consistently](https://github.com/microsoft/BCApps/issues/12166) (closed), [#12184 Implement QuickBooks migration uptake telemetry](https://github.com/microsoft/BCApps/issues/12184) (closed)
- Labels: AL: Apps (W1), Team: Integrations
- Systems: development

Source: metadata of a merged pull request in microsoft/BCApps (bcapps): title, labels, changed paths and counts, with a summary in our words. No source text and no description beyond one short quote (D10, D61).