al-object-id-allocator
通过扫描.al文件和app.json中的idRanges,使用捆绑的PowerShell脚本分配下一个可用的Business Central AL对象ID/编号。在创建新表/页面/代码单元/扩展时,需要空闲对象编号时使用。
📖 中文导读:通过扫描.al文件和app.json中的idRanges,使用捆绑的PowerShell脚本分配下一个可用的Business Central AL对象ID/编号。在创建新表/页面/代码单元/扩展时,需要空闲对象编号时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: al-object-id-allocator description: Allocate the next available Business Central AL object ID/number by scanning .al files and idRanges in app.json using the bundled PowerShell script. Use when creating new tables/pages/codeunits/extensions and you need a free object number.
AL Object ID Allocator
Allocate the next available AL object number using scripts/Get-NextALObjectNumber.ps1.
Usage
pwsh -File "<skill-folder>\scripts\Get-NextALObjectNumber.ps1" -AppPath "<AL_APP_FOLDER>" -ObjectType "<type>"
Common patterns:
pwsh -File ".\.claude\skills\al-object-id-allocator\scripts\Get-NextALObjectNumber.ps1" -AppPath ".\app" -ObjectType "table"pwsh -File ".\.claude\skills\al-object-id-allocator\scripts\Get-NextALObjectNumber.ps1" -AppPath ".\test" -ObjectType "codeunit"
Supported object types
table, page, codeunit, report, query, xmlport, enum, interface, controladdin, pageextension, tableextension, enumextension, reportextension, permissionset, entitlement, profile, pagecustomization
Output and errors
- On success, the script writes a single integer (the allocated number) to stdout and exits with code
0. - On error, it writes
ERROR-XXX: <message>to stderr and exits with code1.
Tip: Capture the result in PowerShell:
$nextNumber = & "<skill-folder>\scripts\Get-NextALObjectNumber.ps1" -AppPath "<AL_APP_FOLDER>" -ObjectType "page"
What it does (high level)
- Reads
idRangesfrom<AppPath>\app.json - Scans
<AppPath>\**\*.alfor existing objects of the requested type - Ignores commented-out declarations
- Returns the smallest available number within the allowed ranges (fills gaps first)