Profile extension object

  • Article

APPLIES TO: Business Central 2024 release wave 2 and later.

The profile extension object in Business Central allows you to customize existing user profiles. The profile extension object allows you to override properties from the target profile such as the role center page or the profile caption, and allows you to define additional page customization objects to apply to the profile.

Note

Page customizations only apply to the Role Center they're specified for. In order to see them, in Business Central under My Settings, Role Center change to the specific Role Center that a page customization is defined for.

Note

Extension objects can have a name with a maximum length of 30 characters.

Note

The property allowDebugging, which is a setting under resourceExposurePolicy doesn't apply to page customizations. Page customizations defined in an extension with allowDebugging set to false can still be copied through Use Designer. For more information, see Resource exposure policy setting.

Snippet support

Typing the shortcut tprofileextension creates the basic layout for a profile extension object when using the AL Language extension for Microsoft Dynamics 365 Business Central in Visual Studio Code.

Tip

Use Ctrl+Space to trigger IntelliSense and get assistance on code completion, parameter info, quick info, and member lists. For more information about snippets, see Syntax and snippets.

Profile extension example

The following profile extension object example extends the Business Manager profile by replacing its description and its role center page. It also adds the customization MyCustomization to the list of customizations applied for the Business Manager profile. The customization modifies the layout of the Customer List to make the Name field invisible using the modify method. For more information, see Profile Properties.

profileextension MyProfileExt extends "Business Manager"
{ 
    ProfileDescription = 'A detailed description of who is this profile for, why/how to use it (etc)'; 
    RoleCenter = MyNewRoleCenter;
    Customizations = MyCustomization;
} 

pagecustomization MyCustomization customizes "Customer List"
{
    layout
    {
        modify(Name)
        {
            Visible = false;
        }
    }
}

AL development environment
Developing extensions
Pages overview
Profile object Page customization object