Microsoft/bcquality
1
0
Fork 0
mirror of https://github.com/microsoft/BCQuality.git synced 2026-08-06 09:26:52 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions
bcquality/custom/knowledge/naming/cmfrt-caption-prefix.md
BeytullahCengiz88 afb1fa2883 Add CMFRT naming conventions, object ID ranges, and patterns documentation 
- Introduced guidelines for using the "CMFRT" prefix in object names, fields, and procedures to avoid naming collisions and ensure clarity.
- Established rules for object ID ranges to prevent conflicts with other extensions and maintain historical integrity.
- Documented best practices and anti-patterns for various coding patterns, including case statements, interface injection, label usage, and validation methods.
- Implemented a standards review skill to evaluate AL source changes against CMFRT company standards, ensuring compliance with naming, permissions, and architectural patterns.
2026-07-14 14:09:04 +02:00

1.5 KiB
Raw Blame History

bc-version domain keywords technologies countries application-area
all
naming
caption
prefix
enum-value
field-caption
tooltip
table-level
page-override
translation
al
w1
all

CMFRT caption prefix and table-level captions

Description

Captions in a CMFRT extension follow the same prefix rule as names: every field caption and every enum value caption carries the CMFRT <ABBR> prefix — for example Caption = 'CMFRT AQ FS Journal Template Name' on a field and Caption = 'CMFRT AQ Pending' on an enum value. Captions and tooltips are defined once, on the table field (or enum value), never overridden on pages. Pages inherit the table-level Caption and ToolTip, so the text is maintained in one place and every page showing the field stays consistent.

Best Practice

Set Caption with the full CMFRT <ABBR> prefix and ToolTip on the table field definition. On pages, declare only ApplicationArea for the field — no Caption, no ToolTip. Give every enum value a prefixed caption matching its prefixed value name.

See sample: cmfrt-caption-prefix.good.al.

Anti Pattern

An unprefixed caption (Caption = 'Pending', Caption = 'FS Journal Template Name'), or a page field that repeats or overrides the table-level Caption/ToolTip. Unprefixed captions are indistinguishable from base-application text for users and translators, and duplicated page-level text drifts from the table definition the first time either copy is edited.

See sample: cmfrt-caption-prefix.bad.al.