The AL developer environment is evolving with frequent updates. To stay up to date on the latest information and announcements, follow us on the Dynamics NAV Team Blog.

Adding Pages and Reports to Search

AL provides navigational support for pages and reports in the client. You enable a page or report to be available through Search in Dynamics 365 Business Central using the UsageCategory setting.

When you create a Page or a Report, you add the UsageCategory Property. If the UsageCategory is set to None, or if you do not specify UsageCategory, the page or report will not show up when you use the Search functionality in Dynamics 365 Business Central.

UsageCategory property values

The values for the UsageCategory property are listed below:

  • None
  • Lists
  • Tasks
  • ReportsAndAnalysis
  • Documents
  • History
  • Administration


The following example creates a SimpleCustomerCard page and sets a UsageCategory property to the page, so that the SimpleCustomerCard page is enabled in Search.

page 50210 SimpleCustomerCard 
    PageType = Card; 
    SourceTable = Customer; 
    UsageCategory = Documents;  
    AccessByPermission = page SimpleCustomerCard = X;
    ApplicationArea = All;
                field("No.";"No.") {} 
                field(Name;Name) {} 
                field(Address;Address) {} 

Optional settings

You can add a page or a report to Search. Additionally, control the access of an object by providing Read, Insert, Modify, Delete, and Execute (RIMDX) permissions by adding the AccessByPermission property. Likewise, control the application area access on the specified object by adding the ApplicationArea Property.

The AccessByPermission property and ApplicationArea property are the optional settings, which can be applied with the UsageCategory property. These settings are used to set restrictions on an object when you enable the Search functionality.

See Also

Adding Menus to the Navigation Pane
MenuSuite Properties
Page Object
Report Object
AL Development Environment