bcquality/microsoft/knowledge/upgrade
Michael Dieringer 67962727f6 Fix ten focused correctness items plus sample links from Jesper's 2026-09-15 re-review
Six carried-over threads:
- api-page-least-privilege-write-access fixtures: added the mandatory
  EntityName/EntitySetName properties (AL0485).
- pages-must-not-contain-business-logic fixtures: Sales Line has no
  "Total Amount" field; replaced with the real "Line Amount" (field 103).
- test-feature-scenario-tags.good.al and test-one-when-per-test.good.al:
  CreatePriceHeader leaves a price list in Draft status, which price
  calculation ignores. Added Validate(Status, Active) + Modify before the
  sales line that depends on it. Verified Status field/enum against
  PriceListHeader.Table.al and PriceStatus.Enum.al in the BCApps clone.
- exposed-objects-must-be-in-a-permission-set.md: a published codeunit is
  a SOAP endpoint (SOAP is deprecated), not OData - Page/Query are the
  OData object types. Corrected and pointed new integrations at API
  pages/queries instead.
- al-error-handling-review.md: the log-writes-must-survive-rollback cue
  selected on Session.StartSession, which only appears in the compliant
  fix, never in the anti-pattern - the bad fixture could never be
  worklisted. Recued on the actual risk shape (log insert around a
  failed TryFunction/GetLastError* path, then raise/propagate), with
  StartSession as an explicit compliant discriminator instead.
- page-design-must-match-bc-page-type-conventions.md: the enum value is
  NavigatePage, not Navigate; noted the type list is a selected subset,
  not an exhaustive PageType catalogue (PromptDialog, ConfigurationDialog,
  UserControlHost, XmlPort also exist, out of this article's scope).

Four new correctness gaps:
- release-must-update-app-version.md: "the version is the only identity"
  was backwards - id is the app's stable identity, version identifies a
  release/code-state of it.
- defensive-vs-offensive-code-must-match-blast-radius.good.al: the "low
  blast radius" example had no else branch, so a failed Customer.Get()
  left the field at its prior/default value instead of the explicit
  chosen fallback the article claims to demonstrate. Added the else.
- bcpt-scenarios-must-be-app-specific.good.al: InitTest and both measured
  StartScenario/EndScenario sections were empty/comment-only, so the
  "app-specific" fixture measured no actual work. Filled in a real,
  self-contained header+line creation path.
- upgrade-tag-logic-must-not-nest-deeply.good.al: the flattened version
  dropped both safety conditions the bad fixture had (Discount % = 0,
  nonblank posting group), silently changing behavior instead of just
  removing nesting. Extracted the guarded update into a helper with both
  conditions preserved as early exits.

Also converted this PR's remaining plain-backtick "See sample:" sample
references (16 articles) to the READ-convention markdown-link form,
matching the fix already made on #156/#158.

Rebased onto upstream/main (conflicts in al-ui-review.md, al-style-review.md,
al-upgrade-review.md against merged upstream PRs - all additive, both
sides' worklist cues retained).
2026-09-21 22:44:17 +02:00
..
appversion-meaning-depends-on-execution-context.md Add foundational AL developer knowledge (#195) 2026-09-21 10:15:39 +02:00
breaking-changes-only-on-tables-without-data.bad.al Regenerate microsoft/knowledge from upstream BCApps instructions 2026-05-21 09:53:09 +02:00
breaking-changes-only-on-tables-without-data.good.al Regenerate microsoft/knowledge from upstream BCApps instructions 2026-05-21 09:53:09 +02:00
breaking-changes-only-on-tables-without-data.md Improve partner onboarding and documentation navigation (#174) 2026-09-09 17:31:03 +02:00
check-only-triggers-do-not-migrate-data.bad.al Add lifecycle error and privacy knowledge (#99) 2026-07-14 12:52:56 +02:00
check-only-triggers-do-not-migrate-data.good.al Add lifecycle error and privacy knowledge (#99) 2026-07-14 12:52:56 +02:00
check-only-triggers-do-not-migrate-data.md Improve partner onboarding and documentation navigation (#174) 2026-09-09 17:31:03 +02:00
datatransfer-for-bulk-init.bad.al Regenerate microsoft/knowledge from upstream BCApps instructions 2026-05-21 09:53:09 +02:00
datatransfer-for-bulk-init.good.al Regenerate microsoft/knowledge from upstream BCApps instructions 2026-05-21 09:53:09 +02:00
datatransfer-for-bulk-init.md Improve partner onboarding and documentation navigation (#174) 2026-09-09 17:31:03 +02:00
datatransfer-skips-triggers-and-subscribers.bad.al Fix lifecycle compatibility guidance (#93) 2026-07-14 11:26:16 +02:00
datatransfer-skips-triggers-and-subscribers.good.al Fix lifecycle compatibility guidance (#93) 2026-07-14 11:26:16 +02:00
datatransfer-skips-triggers-and-subscribers.md Improve partner onboarding and documentation navigation (#174) 2026-09-09 17:31:03 +02:00
do-not-block-upgrade-on-data-errors.bad.al Regenerate microsoft/knowledge from upstream BCApps instructions 2026-05-21 09:53:09 +02:00
do-not-block-upgrade-on-data-errors.good.al Complete AL review knowledge readiness (#108) 2026-07-15 10:55:25 +02:00
do-not-block-upgrade-on-data-errors.md Improve partner onboarding and documentation navigation (#174) 2026-09-09 17:31:03 +02:00
enum-values-additive-at-end.bad.al Regenerate microsoft/knowledge from upstream BCApps instructions 2026-05-21 09:53:09 +02:00
enum-values-additive-at-end.good.al Regenerate microsoft/knowledge from upstream BCApps instructions 2026-05-21 09:53:09 +02:00
enum-values-additive-at-end.md Improve partner onboarding and documentation navigation (#174) 2026-09-09 17:31:03 +02:00
first-install-dataversion-zero-check.bad.al Add lifecycle error and privacy knowledge (#99) 2026-07-14 12:52:56 +02:00
first-install-dataversion-zero-check.good.al Regenerate microsoft/knowledge from upstream BCApps instructions 2026-05-21 09:53:09 +02:00
first-install-dataversion-zero-check.md Improve partner onboarding and documentation navigation (#174) 2026-09-09 17:31:03 +02:00
guard-database-reads.bad.al Regenerate microsoft/knowledge from upstream BCApps instructions 2026-05-21 09:53:09 +02:00
guard-database-reads.good.al Regenerate microsoft/knowledge from upstream BCApps instructions 2026-05-21 09:53:09 +02:00
guard-database-reads.md Improve partner onboarding and documentation navigation (#174) 2026-09-09 17:31:03 +02:00
hybrid-migration-codeunits-not-standard-upgrade.md Regenerate microsoft/knowledge from upstream BCApps instructions 2026-05-21 09:53:09 +02:00
initvalue-does-not-update-existing-rows.bad.al Regenerate microsoft/knowledge from upstream BCApps instructions 2026-05-21 09:53:09 +02:00
initvalue-does-not-update-existing-rows.good.al Regenerate microsoft/knowledge from upstream BCApps instructions 2026-05-21 09:53:09 +02:00
initvalue-does-not-update-existing-rows.md Improve partner onboarding and documentation navigation (#174) 2026-09-09 17:31:03 +02:00
install-and-upgrade-codeunits-have-no-order.bad.al Add foundational AL developer knowledge (#195) 2026-09-21 10:15:39 +02:00
install-and-upgrade-codeunits-have-no-order.good.al Add foundational AL developer knowledge (#195) 2026-09-21 10:15:39 +02:00
install-and-upgrade-codeunits-have-no-order.md Add foundational AL developer knowledge (#195) 2026-09-21 10:15:39 +02:00
install-code-does-not-run-on-version-upgrade.bad.al Add lifecycle error and privacy knowledge (#99) 2026-07-14 12:52:56 +02:00
install-code-does-not-run-on-version-upgrade.good.al Add lifecycle error and privacy knowledge (#99) 2026-07-14 12:52:56 +02:00
install-code-does-not-run-on-version-upgrade.md Improve partner onboarding and documentation navigation (#174) 2026-09-09 17:31:03 +02:00
minimize-onvalidate-upgrade-triggers.bad.al Add lifecycle error and privacy knowledge (#99) 2026-07-14 12:52:56 +02:00
minimize-onvalidate-upgrade-triggers.good.al Add lifecycle error and privacy knowledge (#99) 2026-07-14 12:52:56 +02:00
minimize-onvalidate-upgrade-triggers.md Improve partner onboarding and documentation navigation (#174) 2026-09-09 17:31:03 +02:00
no-external-calls-in-upgrade.bad.al Regenerate microsoft/knowledge from upstream BCApps instructions 2026-05-21 09:53:09 +02:00
no-external-calls-in-upgrade.good.al Regenerate microsoft/knowledge from upstream BCApps instructions 2026-05-21 09:53:09 +02:00
no-external-calls-in-upgrade.md Improve partner onboarding and documentation navigation (#174) 2026-09-09 17:31:03 +02:00
obsolete-pending-to-removed-staging.bad.al Regenerate microsoft/knowledge from upstream BCApps instructions 2026-05-21 09:53:09 +02:00
obsolete-pending-to-removed-staging.good.al Regenerate microsoft/knowledge from upstream BCApps instructions 2026-05-21 09:53:09 +02:00
obsolete-pending-to-removed-staging.md Improve partner onboarding and documentation navigation (#174) 2026-09-09 17:31:03 +02:00
obsoletereason-need-not-restate-removal-version.md knowledge: add 3 FP-suppression guards from BC apps negative feedback 2026-07-21 09:45:09 +02:00
obsoletion-requires-reason-and-tag.bad.al Fix lifecycle compatibility guidance (#93) 2026-07-14 11:26:16 +02:00
obsoletion-requires-reason-and-tag.good.al Fix lifecycle compatibility guidance (#93) 2026-07-14 11:26:16 +02:00
obsoletion-requires-reason-and-tag.md Improve partner onboarding and documentation navigation (#174) 2026-09-09 17:31:03 +02:00
register-upgrade-tags-with-subscribers.bad.al Fix lifecycle compatibility guidance (#93) 2026-07-14 11:26:16 +02:00
register-upgrade-tags-with-subscribers.good.al Fix lifecycle compatibility guidance (#93) 2026-07-14 11:26:16 +02:00
register-upgrade-tags-with-subscribers.md Improve partner onboarding and documentation navigation (#174) 2026-09-09 17:31:03 +02:00
skip-nonessential-work-via-execution-context.bad.al Regenerate microsoft/knowledge from upstream BCApps instructions 2026-05-21 09:53:09 +02:00
skip-nonessential-work-via-execution-context.good.al Regenerate microsoft/knowledge from upstream BCApps instructions 2026-05-21 09:53:09 +02:00
skip-nonessential-work-via-execution-context.md Improve partner onboarding and documentation navigation (#174) 2026-09-09 17:31:03 +02:00
triggers-call-helpers-not-implementations.bad.al Regenerate microsoft/knowledge from upstream BCApps instructions 2026-05-21 09:53:09 +02:00
triggers-call-helpers-not-implementations.good.al Regenerate microsoft/knowledge from upstream BCApps instructions 2026-05-21 09:53:09 +02:00
triggers-call-helpers-not-implementations.md Improve partner onboarding and documentation navigation (#174) 2026-09-09 17:31:03 +02:00
unreleased-schema-change-needs-no-upgrade-path.md Add precision guards for systematic agent false-positive patterns (#112) 2026-07-17 14:17:04 +02:00
upgrade-codeunit-subtype.bad.al Fix lifecycle compatibility guidance (#93) 2026-07-14 11:26:16 +02:00
upgrade-codeunit-subtype.good.al Regenerate microsoft/knowledge from upstream BCApps instructions 2026-05-21 09:53:09 +02:00
upgrade-codeunit-subtype.md Improve partner onboarding and documentation navigation (#174) 2026-09-09 17:31:03 +02:00
upgrade-tag-logic-must-not-nest-deeply.bad.al Add 18 more community AL/BC patterns across appsource, data-modeling, error-handling, security, style, testing, ui, upgrade, and web-services 2026-09-21 22:42:49 +02:00
upgrade-tag-logic-must-not-nest-deeply.good.al Fix ten focused correctness items plus sample links from Jesper's 2026-09-15 re-review 2026-09-21 22:44:17 +02:00
upgrade-tag-logic-must-not-nest-deeply.md Fix ten focused correctness items plus sample links from Jesper's 2026-09-15 re-review 2026-09-21 22:44:17 +02:00
use-upgrade-tags-not-version-checks.bad.al Regenerate microsoft/knowledge from upstream BCApps instructions 2026-05-21 09:53:09 +02:00
use-upgrade-tags-not-version-checks.good.al Regenerate microsoft/knowledge from upstream BCApps instructions 2026-05-21 09:53:09 +02:00
use-upgrade-tags-not-version-checks.md Improve partner onboarding and documentation navigation (#174) 2026-09-09 17:31:03 +02:00