al-object-id-allocator

FBakkensen 的头像作者 FBakkensen

通过扫描.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 code 1.

Tip: Capture the result in PowerShell:

  • $nextNumber = & "<skill-folder>\scripts\Get-NextALObjectNumber.ps1" -AppPath "<AL_APP_FOLDER>" -ObjectType "page"

What it does (high level)

  1. Reads idRanges from <AppPath>\app.json
  2. Scans <AppPath>\**\*.al for existing objects of the requested type
  3. Ignores commented-out declarations
  4. Returns the smallest available number within the allowed ranges (fills gaps first)