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 and Dynamics NAV using the UsageCategory setting.


AL tools functionality is supported in Dynamics 365 Business Central and Dynamics NAV, but in some cases, there are limitations. These limitations are marked clearly in the specific topic.

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 and Dynamics NAV.

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 70050088 SimpleCustomerCard 
    PageType = Card; 
    SourceTable = Customer; 
    UsageCategory = Documents;  
    AccessByPermission = page SimpleCustomerCard = X;
    ApplicationArea = All;
                field("No.";"No.") {} 
                field(Name;Name) {} 
                field(Address;Address) {} 

Optional accessibility settings

You can add a page or a report to Search. Additionally, control the accessibility 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