Extending AL objects

Path: Development > Extensibility > Extending AL objects · tier official · system development · narrative reviewed (checked by Opus)

Overview

This section explains the AL extension objects used to customize Business Central. Each page covers one kind of object: page extensions, table extensions, report extensions, extensible enums with enumextension, and permission set extensions. Further pages cover event types and extending application areas.

Start with the object type you want to change. Page extension, table extension and report extension describe syntax and what can be added, such as controls, actions, fields, keys, triggers, data items and layouts. Event types is the place to learn how to publish, raise and subscribe to events when behavior must change through code. Extensible enums and permission set extensions cover adding enum values and adding permissions to existing sets. Extending Application Areas covers how to show or hide functionality for different experience tiers.

Key points

• Page extensions add or change layout controls and actions with addfirst, addlast, addafter, addbefore, modify, and the move keywords (movefirst, movelast, moveafter, movebefore).
• Table extensions add fields, define keys and write trigger code without changing the base table.
• Report extensions add columns, data items, triggers, request page elements and multiple report layouts.
• Extensible enums use the Extensible property and the enumextension object so other extensions can add values. Display order follows declaration.
• Permission set extensions add permissions to existing sets, and the permissions are assigned automatically when the extension is installed.
• Event types include business events, integration events, global events, and database and page trigger events. The page explains how to publish, raise and subscribe to them.
• Application areas are extended by adding fields to the Application Area Setup table and subscribing to the OnGetExperienceAppArea and OnValidateApplicationAreas events.

Learn pages

• Event types: Business Central supports different types of events including BusinessEvent, IntegrationEvent, Global, and trigger events.
• Extending Application Areas: Learn about extending application areas in Business Central.
• Extensible Enums: Overview of the enumeration type and the concept of extending them.
• Page extension object: Extend page objects with page extension objects in AL for Business Central.
• Permission Set Extension Object: Description of the permission set extension object in AL for Business Central.
• Report extension object: The report extension object in AL for Business Central allows you to create an extension of an existing report.
• Table extension object: This article describes the table extension object in AL for Business Central.

Videos, posts and code changes

Linked by a Haiku matcher with a grounding quote from the item’s summary (link/topics.ts); machine-generated.

• #10067 [Quality Management] Enable Bin code selection for transfer disposition in workflow response (code change): “Bin code selection is now available for transfer disposition in workflow responses”
• #10352 [Master]-Bug 646964: Withholding Tax Prod. Posting Group is missing o… (code change): “New page extension adds the withholding tax product posting group”
• #10370 [Master]-Bug 647018: Withholding tax for Employees and GL Accounts (code change): “WHT product posting group is inherited from the G/L balance account”
• #10382 [Expense Agent] Fix administrative recall history access (code change): “Recalls by someone other than the submitter are logged as BC User activity”
• #10438 [Master] - Bug 647272: [Expense Agent] Unwanted caption in expense report FactBox (code change): “Expense Report FactBox caption changed to Expense Report”
• #9217 [Extensibility][SubscriptionBilling]: Make IsLineAttachedToBillingLine accessible from external apps in Sales Line and Purchase Line (code change): “IsLineAttachedToBillingLine procedure visibility changed from internal to public”
• Business Central 29.0: Major Change to Table Extensions and SQL Storage. (community post): “table extension fields are stored in the database”
• Business Central 29.0: Major Change to Table Extensions & SQL. (video): “table extensions; sql storage model; database performance; indexes”

Source: Microsoft Learn (CC BY 4.0). Descriptions are Learn’s own.