---
id: change/bcquality/175
type: change
title: "#175 9 AL/BC patterns: document distribution, price calculation & barcode extensibility"
summary: Nine new AL/BC patterns document best practices for document distribution, report selections, price calculation extensibility, barcode usage, and posting-cascade field mirroring, with verified examples from Business Central source.
tier: official
language: en
tags:
  - feature
  - main
system: development
review:
  state: reviewed
  by: opus
  at: "2026-10-08T02:03:11.036Z"
  flags: []
generated:
  at: "2026-10-08T01:26:53.141Z"
  pipeline: 0.2.0
  prompts:
    extract-change: 1
  input_hash: fd599197788ff4c11d01d98fb809f4eb4b6d6095
evidence:
  - kind: code
    url: https://github.com/microsoft/BCQuality/pull/175
    title: "microsoft/BCQuality#175: 9 AL/BC patterns: document distribution, price calculation & barcode extensibility"
    date: "2026-09-30"
    commit: fd599197788ff4c11d01d98fb809f4eb4b6d6095
    t: null
    quote: Nine rules about Business Central's document distribution architecture and posting-cascade/pricing extensibility, verified against BCApps source and Microsoft Learn
links:
  learn: []
  objects: []
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
  changes: []
number: 175
repo: microsoft/BCQuality
source_id: bcquality-prs
url: https://github.com/microsoft/BCQuality/pull/175
kind: pr
base_branch: main
major: null
merged_at: "2026-09-30T11:22:39Z"
author: MichaelDieringer
author_type: User
community_contribution: false
labels: []
change_class: code
change_kind: feature
behavior_change: false
breaking: false
files:
  count: 30
  additions: 1644
  deletions: 6
  al: 28
apps: []
objects_touched: []
objects_unjoined:
  - path: microsoft/knowledge/data-modeling/activate-new-price-calculation-handler-via-onfindsupportedsetup.bad.al
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/activate-new-price-calculation-handler-via-onfindsupportedsetup.good.al
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/activate-new-price-calculation-handler-via-onfindsupportedsetup.md
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/custom-document-dispatch-must-not-bypass-report-selections.bad.al
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/custom-document-dispatch-must-not-bypass-report-selections.good.al
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/custom-document-dispatch-must-not-bypass-report-selections.md
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/document-print-and-email-actions-call-report-selections-directly.bad.al
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/document-print-and-email-actions-call-report-selections-directly.good.al
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/document-print-and-email-actions-call-report-selections-directly.md
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/extend-find-entries-navigate-for-new-document-types.bad.al
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/extend-find-entries-navigate-for-new-document-types.good.al
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/extend-find-entries-navigate-for-new-document-types.md
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/extend-price-source-type-must-sync-document-subset-enum.bad.al
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/extend-price-source-type-must-sync-document-subset-enum.good.al
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/extend-price-source-type-must-sync-document-subset-enum.md
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/extend-report-selection-usage-for-new-document-types.bad.al
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/extend-report-selection-usage-for-new-document-types.good.al
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/extend-report-selection-usage-for-new-document-types.md
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/new-price-source-must-add-candidate-and-trigger-recalculation.bad.al
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/new-price-source-must-add-candidate-and-trigger-recalculation.good.al
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/new-price-source-must-add-candidate-and-trigger-recalculation.md
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/report-barcodes-must-use-barcode-module-and-production-font-name.bad.al
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/report-barcodes-must-use-barcode-module-and-production-font-name.good.al
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/report-barcodes-must-use-barcode-module-and-production-font-name.md
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/transferfields-mirrored-fields-must-match-type-and-length.bad.al
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/transferfields-mirrored-fields-must-match-type-and-length.good.al
    status: added
    reason: not-in-snapshot
  - path: microsoft/knowledge/data-modeling/transferfields-mirrored-fields-must-match-type-and-length.md
    status: added
    reason: not-in-snapshot
  - path: microsoft/skills/review/al-data-modeling-review.md
    status: modified
    reason: not-in-snapshot
obsoletions: []
backports: []
fixes_issues: []
work_items: []
systems:
  - development
quote: Nine rules about Business Central's document distribution architecture and posting-cascade/pricing extensibility, verified against BCApps source and Microsoft Learn
joined_against:
  major: null
  commit: null
---

# #175 9 AL/BC patterns: document distribution, price calculation & barcode extensibility

> Nine new AL/BC patterns document best practices for document distribution, report selections, price calculation extensibility, barcode usage, and posting-cascade field mirroring, with verified examples from Business Central source.

[Pull request](https://github.com/microsoft/BCQuality/pull/175) · merged into `main` on 2026-09-30 by MichaelDieringer · 30 files (+1644 -6), 28 AL · feature · tier official · reviewed (checked by Opus)

## What changed

- Adds nine knowledge articles, each with bad and good AL examples
- Covers document distribution: Report Selections usage, Print and Email actions, and Find Entries (Navigate) extensions
- Covers pricing extensibility: price calculation handlers, price source types and custom price sources
- Covers TransferFields field mirroring in posting cascades and barcode generation through the Barcode module
- Updates the data-modeling review skill so these topics are in scope, and adds evaluation fixtures

## AL objects touched

- `microsoft/knowledge/data-modeling/activate-new-price-calculation-handler-via-onfindsupportedsetup.bad.al`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/activate-new-price-calculation-handler-via-onfindsupportedsetup.good.al`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/activate-new-price-calculation-handler-via-onfindsupportedsetup.md`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/custom-document-dispatch-must-not-bypass-report-selections.bad.al`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/custom-document-dispatch-must-not-bypass-report-selections.good.al`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/custom-document-dispatch-must-not-bypass-report-selections.md`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/document-print-and-email-actions-call-report-selections-directly.bad.al`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/document-print-and-email-actions-call-report-selections-directly.good.al`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/document-print-and-email-actions-call-report-selections-directly.md`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/extend-find-entries-navigate-for-new-document-types.bad.al`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/extend-find-entries-navigate-for-new-document-types.good.al`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/extend-find-entries-navigate-for-new-document-types.md`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/extend-price-source-type-must-sync-document-subset-enum.bad.al`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/extend-price-source-type-must-sync-document-subset-enum.good.al`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/extend-price-source-type-must-sync-document-subset-enum.md`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/extend-report-selection-usage-for-new-document-types.bad.al`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/extend-report-selection-usage-for-new-document-types.good.al`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/extend-report-selection-usage-for-new-document-types.md`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/new-price-source-must-add-candidate-and-trigger-recalculation.bad.al`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/new-price-source-must-add-candidate-and-trigger-recalculation.good.al`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/new-price-source-must-add-candidate-and-trigger-recalculation.md`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/report-barcodes-must-use-barcode-module-and-production-font-name.bad.al`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/report-barcodes-must-use-barcode-module-and-production-font-name.good.al`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/report-barcodes-must-use-barcode-module-and-production-font-name.md`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/transferfields-mirrored-fields-must-match-type-and-length.bad.al`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/transferfields-mirrored-fields-must-match-type-and-length.good.al`: added, not in the BC? snapshot yet
- `microsoft/knowledge/data-modeling/transferfields-mirrored-fields-must-match-type-and-length.md`: added, not in the BC? snapshot yet
- `microsoft/skills/review/al-data-modeling-review.md`: modified, not in the BC? snapshot

## Context

- Systems: development
- From the description: "Nine rules about Business Central's document distribution architecture and posting-cascade/pricing extensibility, verified against BCApps source and Microsoft Learn"

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