mirror of
https://github.com/microsoft/BCQuality.git
synced 2026-08-06 17:36:53 +01:00
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.
This commit is contained in:
parent
d6ac005173
commit
afb1fa2883
53 changed files with 1288 additions and 0 deletions
|
|
@ -0,0 +1,16 @@
|
|||
// Only one flat permission set — no composition, no read-only role.
|
||||
// Adding a new table means updating this one set and hoping nothing was missed.
|
||||
permissionset 2045222 "CMFRT GD Geodynamics"
|
||||
{
|
||||
Assignable = true;
|
||||
Caption = 'CMFRT GD Geodynamics';
|
||||
Permissions =
|
||||
table "CMFRT GD POI" = X,
|
||||
tabledata "CMFRT GD POI" = RIMD,
|
||||
table "CMFRT GD Setup" = X,
|
||||
tabledata "CMFRT GD Setup" = RIMD,
|
||||
page "CMFRT GD POI" = X,
|
||||
page "CMFRT GD Setup" = X,
|
||||
codeunit "CMFRT GD IGeodynamics" = X,
|
||||
codeunit "CMFRT GD IGeodynamics Impl" = X;
|
||||
}
|
||||
|
|
@ -0,0 +1,35 @@
|
|||
// Step 1: Objects set — owns all AL objects with execute access.
|
||||
permissionset 2045222 "CMFRT GD Objects"
|
||||
{
|
||||
Assignable = true;
|
||||
Caption = 'CMFRT GD Geodynamics - Objects';
|
||||
Permissions =
|
||||
table "CMFRT GD POI" = X,
|
||||
table "CMFRT GD Setup" = X,
|
||||
page "CMFRT GD POI" = X,
|
||||
page "CMFRT GD Setup" = X,
|
||||
codeunit "CMFRT GD IGeodynamics" = X,
|
||||
codeunit "CMFRT GD IGeodynamics Impl" = X;
|
||||
}
|
||||
|
||||
// Step 2: Read set — inherits object access, adds tabledata read.
|
||||
permissionset 2045221 "CMFRT GD Read"
|
||||
{
|
||||
Assignable = true;
|
||||
Caption = 'CMFRT GD Geodynamics - Read';
|
||||
IncludedPermissionSets = "CMFRT GD Objects";
|
||||
Permissions =
|
||||
tabledata "CMFRT GD POI" = R,
|
||||
tabledata "CMFRT GD Setup" = R;
|
||||
}
|
||||
|
||||
// Step 3: Edit set — inherits Read, adds insert/modify/delete.
|
||||
permissionset 2045226 "CMFRT GD Edit"
|
||||
{
|
||||
Assignable = true;
|
||||
Caption = 'CMFRT GD Geodynamics - Edit';
|
||||
IncludedPermissionSets = "CMFRT GD Read";
|
||||
Permissions =
|
||||
tabledata "CMFRT GD POI" = IMD,
|
||||
tabledata "CMFRT GD Setup" = IMD;
|
||||
}
|
||||
|
|
@ -0,0 +1,26 @@
|
|||
---
|
||||
bc-version: [all]
|
||||
domain: security
|
||||
keywords: [permissionset, permission-set, objects, read, edit, assignable, included-permission-sets, authorization]
|
||||
technologies: [al]
|
||||
countries: [w1]
|
||||
application-area: [all]
|
||||
---
|
||||
|
||||
# CMFRT three-permission-set pattern
|
||||
|
||||
## Description
|
||||
|
||||
Every CMFRT functional module must ship exactly three permission set objects: an Objects set, a Read set, and an Edit set. The Objects set lists every AL object the module owns — tables, pages, codeunits, reports, interfaces — with `X` (execute) access. The Read set includes the Objects set via `IncludedPermissionSets` and grants `tabledata = R` on each table. The Edit set includes the Read set and grants `tabledata = IMD` on each writable table. All three sets have `Assignable = true`. Names follow the pattern `"CMFRT <ABBR> Objects"`, `"CMFRT <ABBR> Read"`, and `"CMFRT <ABBR> Edit"`.
|
||||
|
||||
## Best Practice
|
||||
|
||||
Define the sets in the strict composition chain Objects ← Read ← Edit so that object access is declared once and inherited. When a new table is added to the module, update the Objects set and the tabledata entries in Read and Edit — there is no risk of the object access drifting between roles because the chain is the single source of truth for it.
|
||||
|
||||
See sample: `cmfrt-three-permissionset-pattern.good.al`.
|
||||
|
||||
## Anti Pattern
|
||||
|
||||
Shipping fewer than three permission sets, omitting `IncludedPermissionSets` and enumerating the same object list in each set by hand, or granting `RIMD` access in a flat set that cannot be composed. Flat role sets that enumerate objects independently drift apart when tables are added or removed, and the resulting authorization gap is invisible until a user reports an access error in production.
|
||||
|
||||
See sample: `cmfrt-three-permissionset-pattern.bad.al`.
|
||||
Loading…
Add table
Add a link
Reference in a new issue