---
id: change/bcquality/142
type: change
title: "#142 Add AL-focused AppSource validation guidance"
summary: Six community AppSource knowledge articles with paired good and bad AL samples now cover profile objects, invariant date literals, page extension action placement, UI calls in web-service paths, UsageCategory on searchable entry points, and time-zone offsets. The AppSource review skill routes AL signals to them.
tier: official
language: en
tags:
  - feature
  - main
system: development
review:
  state: reviewed
  by: opus
  at: "2026-10-08T02:05:28.329Z"
  flags: []
generated:
  at: "2026-10-08T01:26:53.141Z"
  pipeline: 0.2.0
  prompts:
    extract-change: 1
  input_hash: 45ac371e7a8252f2ce7176060a640ea9506b320c
evidence:
  - kind: code
    url: https://github.com/microsoft/BCQuality/pull/142
    title: "microsoft/BCQuality#142: Add AL-focused AppSource validation guidance"
    date: "2026-09-14"
    commit: 45ac371e7a8252f2ce7176060a640ea9506b320c
    t: null
    quote: add seven community AppSource knowledge articles with paired good and bad AL samples
links:
  learn: []
  objects: []
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
  changes: []
number: 142
repo: microsoft/BCQuality
source_id: bcquality-prs
url: https://github.com/microsoft/BCQuality/pull/142
kind: pr
base_branch: main
major: null
merged_at: "2026-09-14T10:42:46Z"
author: demiliani
author_type: User
community_contribution: false
labels: []
change_class: code
change_kind: feature
behavior_change: false
breaking: false
files:
  count: 19
  additions: 322
  deletions: 4
  al: 19
apps: []
objects_touched: []
objects_unjoined:
  - path: community/knowledge/appsource/define-profiles-as-al-objects.bad.al
    status: added
    reason: not-in-snapshot
  - path: community/knowledge/appsource/define-profiles-as-al-objects.good.al
    status: added
    reason: not-in-snapshot
  - path: community/knowledge/appsource/define-profiles-as-al-objects.md
    status: added
    reason: not-in-snapshot
  - path: community/knowledge/appsource/do-not-hard-code-time-zone-offsets.bad.al
    status: added
    reason: not-in-snapshot
  - path: community/knowledge/appsource/do-not-hard-code-time-zone-offsets.good.al
    status: added
    reason: not-in-snapshot
  - path: community/knowledge/appsource/do-not-hard-code-time-zone-offsets.md
    status: added
    reason: not-in-snapshot
  - path: community/knowledge/appsource/keep-web-service-paths-free-of-ui-calls.bad.al
    status: added
    reason: not-in-snapshot
  - path: community/knowledge/appsource/keep-web-service-paths-free-of-ui-calls.good.al
    status: added
    reason: not-in-snapshot
  - path: community/knowledge/appsource/keep-web-service-paths-free-of-ui-calls.md
    status: added
    reason: not-in-snapshot
  - path: community/knowledge/appsource/place-page-extension-actions-with-addfirst-or-addlast.bad.al
    status: added
    reason: not-in-snapshot
  - path: community/knowledge/appsource/place-page-extension-actions-with-addfirst-or-addlast.good.al
    status: added
    reason: not-in-snapshot
  - path: community/knowledge/appsource/place-page-extension-actions-with-addfirst-or-addlast.md
    status: added
    reason: not-in-snapshot
  - path: community/knowledge/appsource/set-usagecategory-on-searchable-entry-points.bad.al
    status: added
    reason: not-in-snapshot
  - path: community/knowledge/appsource/set-usagecategory-on-searchable-entry-points.good.al
    status: added
    reason: not-in-snapshot
  - path: community/knowledge/appsource/set-usagecategory-on-searchable-entry-points.md
    status: added
    reason: not-in-snapshot
  - path: community/knowledge/appsource/use-invariant-date-literals.bad.al
    status: added
    reason: not-in-snapshot
  - path: community/knowledge/appsource/use-invariant-date-literals.good.al
    status: added
    reason: not-in-snapshot
  - path: community/knowledge/appsource/use-invariant-date-literals.md
    status: added
    reason: not-in-snapshot
  - path: microsoft/skills/review/al-appsource-review.md
    status: modified
    reason: not-in-snapshot
obsoletions: []
backports: []
fixes_issues: []
work_items: []
systems:
  - development
quote: add seven community AppSource knowledge articles with paired good and bad AL samples
joined_against:
  major: null
  commit: null
---

# #142 Add AL-focused AppSource validation guidance

> Six community AppSource knowledge articles with paired good and bad AL samples now cover profile objects, invariant date literals, page extension action placement, UI calls in web-service paths, UsageCategory on searchable entry points, and time-zone offsets. The AppSource review skill routes AL signals to them.

[Pull request](https://github.com/microsoft/BCQuality/pull/142) · merged into `main` on 2026-09-14 by demiliani · 19 files (+322 -4), 19 AL · feature · tier official · reviewed (checked by Opus)

## What changed

- Adds six AppSource articles, each with good and bad AL examples
- Covers profiles as AL objects, invariant date literals, addfirst/addlast action placement, web-service UI calls, UsageCategory, and time-zone offsets
- Updates the AppSource review skill to point concrete AL signals at the new guidance
- Avoids duplicating privacy, style, security, and upgrade domain rules

## AL objects touched

- `community/knowledge/appsource/define-profiles-as-al-objects.bad.al`: added, not in the BC? snapshot yet
- `community/knowledge/appsource/define-profiles-as-al-objects.good.al`: added, not in the BC? snapshot yet
- `community/knowledge/appsource/define-profiles-as-al-objects.md`: added, not in the BC? snapshot yet
- `community/knowledge/appsource/do-not-hard-code-time-zone-offsets.bad.al`: added, not in the BC? snapshot yet
- `community/knowledge/appsource/do-not-hard-code-time-zone-offsets.good.al`: added, not in the BC? snapshot yet
- `community/knowledge/appsource/do-not-hard-code-time-zone-offsets.md`: added, not in the BC? snapshot yet
- `community/knowledge/appsource/keep-web-service-paths-free-of-ui-calls.bad.al`: added, not in the BC? snapshot yet
- `community/knowledge/appsource/keep-web-service-paths-free-of-ui-calls.good.al`: added, not in the BC? snapshot yet
- `community/knowledge/appsource/keep-web-service-paths-free-of-ui-calls.md`: added, not in the BC? snapshot yet
- `community/knowledge/appsource/place-page-extension-actions-with-addfirst-or-addlast.bad.al`: added, not in the BC? snapshot yet
- `community/knowledge/appsource/place-page-extension-actions-with-addfirst-or-addlast.good.al`: added, not in the BC? snapshot yet
- `community/knowledge/appsource/place-page-extension-actions-with-addfirst-or-addlast.md`: added, not in the BC? snapshot yet
- `community/knowledge/appsource/set-usagecategory-on-searchable-entry-points.bad.al`: added, not in the BC? snapshot yet
- `community/knowledge/appsource/set-usagecategory-on-searchable-entry-points.good.al`: added, not in the BC? snapshot yet
- `community/knowledge/appsource/set-usagecategory-on-searchable-entry-points.md`: added, not in the BC? snapshot yet
- `community/knowledge/appsource/use-invariant-date-literals.bad.al`: added, not in the BC? snapshot yet
- `community/knowledge/appsource/use-invariant-date-literals.good.al`: added, not in the BC? snapshot yet
- `community/knowledge/appsource/use-invariant-date-literals.md`: added, not in the BC? snapshot yet
- `microsoft/skills/review/al-appsource-review.md`: modified, not in the BC? snapshot

## Context

- Systems: development
- From the description: "add seven community AppSource knowledge articles with paired good and bad AL samples"

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).