Study guide

5.2 Menus, Menu Items & Navigation

Microsoft Dynamics 365: Finance and Operations Apps Developer Associate MB-500

Track your progress as you read

Finished sections get a check mark.

1 Chapter 1: Cloud & Ecosystem Architecture

1.1 Cloud vs On-Premises Architecture & Deployment Typologies 1.2 Microsoft Ecosystem Integration & Extensibility Boundaries 1.3 Lifecycle Services (LCS) & Implementation Portal

2 Chapter 2: ALM, Environments & Unified Developer Experience

2.1 Package Deployment & Servicing 2.2 Unified Developer Experience (UDE) & Power Platform Admin Center 2.3 Environment Management & Governance

3 Chapter 3: Visual Studio Development & Metadata

3.1 Visual Studio Extension Models & Packages 3.2 Application Explorer & Element Designers 3.3 Database Synchronization & Visual Studio Debugging

4 Chapter 4: Azure DevOps Version Control & CI/CD

4.1 Version Control Architecture: TFVC vs Git in F&O 4.2 Branching, Merging & Conflict Resolution 4.3 CI/CD Build Pipelines & Artifact Generation

5 Chapter 5: UI Elements: Forms, Menus & Labels

5.1 Form Design & Form Patterns 5.2 Menus, Menu Items & Navigation 5.3 Label Files & Localization

6 Chapter 6: Data Model: Tables & Relational Design

6.1 Table Design & Extension 6.2 Views, Queries & Maps 6.3 Data Entity Design & Modeling

7 Chapter 7: Classes, Attributes & AOT Modifiers

7.1 Class Architecture & Access Modifiers 7.2 Attributes & Reflection 7.3 Event Handlers & Pre/Post Method Events

8 Chapter 8: X++ Core Programming & CRUD Operations

8.1 X++ Syntax, Control Flow & Global Functions 8.2 Data Manipulation & CRUD Logic 8.3 Best Practice Rules & Compiler Diagnostics

9 Chapter 9: Advanced OOP, Chain of Command & Extensibility

9.1 OOP Principles & QueryBuilder Class 9.2 Chain of Command (CoC) Implementation 9.3 Extensibility Patterns & Non-Breaking Changes 9.4 Event Handler Classes & Delegate Architecture 9.5 Variable Scoping, Declaration Placement & Object Lifetime

10 Chapter 10: F&O Frameworks & SysTest Unit Testing

10.1 SysOperation Framework Architecture 10.2 Workflow Framework & SysExtensionSerializer 10.3 SysTest Framework & Test Explorer

11 Chapter 11: Reporting Architecture & SSRS Reports

11.1 Reporting Architecture & Datastores 11.2 Report Data Providers & Contracts 11.3 SSRS Report Design, Deployment & Security 11.4 Determining When to Use a Specific Reporting Tool or Platform

12 Chapter 12: Business Intelligence, Workspaces & Electronic Reporting

12.1 Electronic Reporting (ER) Framework 12.2 Power BI Integration & Analytical Workspaces 12.3 Workspaces, Tiles, Lists & KPIs 12.4 Excel Integration & Office App

13 Chapter 13: Integration Patterns & Service Endpoints

13.1 Integration Pattern Evaluation & API Selection 13.2 Custom Services & SOAP/REST Endpoints 13.3 Consuming External Services & REST/SOAP APIs

14 Chapter 14: Data Management Framework (DMF) & Batch Processing

14.1 DMF Concepts, Projects & Sequencing 14.2 Entity Change Tracking & Recurring Integrations 14.3 Composite Entities & Batch OData API 14.4 Monitoring Entity Status, Availability & Job Execution

15 Chapter 15: Power Platform, Business Events & Azure Integrations

15.1 Dual-Write & Virtual Entities 15.2 Business Events Framework 15.3 Azure Key Vault Integration & Secure Storage

16 Chapter 16: Role-Based Security & Extensible Data Security

16.1 Role-Based Security Architecture 16.2 Extensible Data Security (XDS) Policies 16.3 Security Enforcement & Best Practices

17 Chapter 17: Performance Optimization & Data Access Patterns

17.1 Table & Form Caching Mechanisms 17.2 Temporary Tables & Set-Based Operations 17.3 Query Tuning, Indexes & Concurrency 17.4 Diagnostics: Trace Parser, Async & Sandbox Frameworks 17.5 Tuning Variable Scope, Buffer Lifetime & Memory Pressure

5.2 Menus, Menu Items & Navigation

Key Takeaways Explain This Topic AI

Menu items in Dynamics 365 are categorized into three distinct functional types: Display (launches interactive forms), Output (triggers SSRS reports and document generation), and Action (executes business logic classes, batch jobs, and posting routines).

Menu items represent the fundamental Entry Points for role-based security; security privileges grant permissions (Read, Update, Create, Correct, Delete) to entry points, which automatically govern access to the underlying form, report, or class.

The NeedsRecord property controls runtime button availability: setting NeedsRecord = Yes ensures the menu item is enabled only when a valid record buffer is actively selected in the active form data source.

Menu item properties such as ConfigurationKey and CountryRegionCodes enforce declarative system-level filtering, hiding menu items from the navigation pane and ActionPanes if a feature key is disabled or if the current legal entity address is outside the specified ISO country codes.

Navigation in Dynamics 365 is extended by creating menu extensions (such as MainMenu.Extension or module menus like AccountsReceivable.Extension), allowing developers to insert custom submenus and menu item references into standard groups without overlayering.

Last updated: September 2026

5.2 Menus, Menu Items & Navigation

Quick Answer: Dynamics 365 Finance and Operations abstracts user navigation, command execution, and security through Menu Items . There are three specialized types of menu items: Display (opens forms for interactive viewing and editing), Output (launches SSRS reports, Electronic Reporting formats, or report controllers), and Action (executes X++ classes, batch jobs, or transaction posting logic). Menu items define critical runtime properties including Object , ObjectType , Parameters , ConfigurationKey , CountryRegionCodes , and NeedsRecord . In the security architecture, menu items serve as the Entry Points within Security Privileges . Users cannot interact with a form, report, or class unless they are assigned a security role granting access to the corresponding menu item entry point.

1. The Dynamics 365 Navigation Framework

The web client navigation framework provides unified access to all functional modules, workspaces, and setup areas across the ERP application.

Primary Navigation Components

Navigation Pane (Left Drawer): Hosts high-level navigation categories:

Workspaces: Curated, role-specific landing pages displaying tiles, lists, and links.

Modules: Complete alphabetical catalog of functional areas (e.g., Accounts payable, General ledger, Warehouse management).

Favorites: Personal pinned shortcuts configured by individual users.

Recent: Chronological history of recently visited forms and workspaces.

Navigation Search (Alt+G): Global search bar located in the top navigation ribbon. Users search for forms or workspaces by typing terms (e.g., "All sales orders"). The search engine indexes labels and descriptions of all menu items flagged with WebSearchResult = Yes .

Direct URL Navigation (Deep Linking): Forms can be launched directly using URL query parameters: https://<environment>.operations.dynamics.com/?cmp=USMF&mi=CustTable

cmp : The target Legal Entity context (Company ID, e.g., USMF ).

mi : The target Menu Item name (e.g., CustTable ), not the physical form name.

2. Menu Item Architecture & Types

A Menu Item is an AOT pointer that decouples the visual navigation trigger (buttons, links, menu nodes) from the target object being executed. This indirection ensures that security, parameter passing, and regional filtering are managed in one centralized metadata definition. Navigation Trigger (Navigation Pane / ActionPane Button / Search Alt+G)

  • │
  • └── Menu Item Reference (Display, Output, or Action)
  • │
  • ├── Security Layer: Entry Point on Security Privilege (AccessLevel: Read..Delete)
  • ├── Environment Filter: ConfigurationKey & CountryRegionCodes
  • └── Execution Layer: Constructs Args object -> Launches Target Object
  • The Three Menu Item Types

Feature Display Menu Item ( AxMenuItemDisplay ) Output Menu Item ( AxMenuItemOutput ) Action Menu Item ( AxMenuItemAction )

Primary Role Opens interactive user interface forms. Executes reports, printing engines, and inquiry documents. Executes transactional business logic, batch jobs, and calculations.

Allowed ObjectType Form Report , Class Class

Target Examples CustTable , SalesTable , InventItemId CustAccountStatementExt , SalesInvoiceReport SalesFormLetter_Invoice , InventClosing

Underlying Class Base FormRun SrsReportRunController , ERFormatMappingRun SysOperationServiceController , RunBaseBatch

Default Security Intent View, edit, create, or delete records in UI. Generate and view formatted operational reports. Execute state-changing operations or background tasks.

3. Key Properties of Menu Items

Menu item properties control runtime behavior, environment filtering, and data passing:

1. Object and ObjectType

Object : Specifies the exact AOT name of the target artifact (e.g., CustTable for a form, SalesInvoiceController for a class).

ObjectType : Dictates the target artifact category ( Form for Display; Report or Class for Output; Class for Action).

2. Parameters & Enum Parameters

Parameters : A literal string passed to the target object via _args.parm() . Often used when a single generic form handles multiple operational modes (e.g., passing "Vendor" vs "Customer" to a shared address inquiry form).

EnumTypeParameter & EnumParameter : Passes a strongly-typed enumeration value via _args.parmEnumType() and _args.parmEnum() . For example, opening a sales order list filtered specifically to open orders by setting EnumTypeParameter = SalesStatus and EnumParameter = Backorder .

3. NeedsRecord

When set to Yes , the button or link referencing this menu item is automatically disabled in the UI unless an active record row is selected in the calling grid or form data source.

Prevents runtime null-pointer exceptions when user actions depend on a specific record context (such as recalculating a discount for an active sales line).

4. MultiSelect

Controls whether the menu item can be executed when multiple rows are highlighted in a grid.

If set to No , selecting multiple rows in the client disables the button.

If set to Yes , the calling form packages the selected records into the _args object using FormDataSource.getFirst(1) and FormDataSource.getNext() .

5. ConfigurationKey

Associates the menu item with a system license or feature configuration key (e.g., Asset , Retail , PublicSector ).

If the configuration key is disabled in License Configuration , the menu item is completely stripped from the UI and cannot be accessed by any user, including System Administrators.

6. CountryRegionCodes

A comma-separated list of ISO 3166-1 alpha-2 country codes (e.g., US, CA, MX , or DE, AT ).

At runtime, the client compares these codes against the primary address country of the active Legal Entity (Company) .

If the active company's country does not match, the menu item is hidden from the navigation pane and ActionPanes.

7. WebSearchResult

A boolean ( Yes / No ) indicating whether the menu item appears in the global Navigation Search (Alt+G) dropdown.

Set to No for secondary child buttons, dialog helpers, or sub-processes to avoid cluttering search results.

4. Menu Extensions: Extending Navigation Without Overlayering

Standard menus in Dynamics 365 cannot be overlayered. Developers extend the navigation structure by creating Menu Extensions .

Extending MainMenu and Module Menus

MainMenu Extension ( MainMenu.Extension ): Used to add entirely new top-level functional modules to the Navigation Pane drawer.

Module Menu Extensions (e.g., AccountsReceivable.Extension , ProcurementAndSourcingMenu.Extension ):

Standard module menus organize navigation into four standard submenus: Common , Inquiries , Reports , and Setup .

Developers add references to custom Display, Output, or Action menu items directly into these existing submenus.

Developers can also create new custom submenus within the module menu.

Positioning in Menu Extensions

When adding a menu item reference or submenu via extension, developers define its visual placement using the Position property:

First / Last : Places the item at the start or end of the group.

After: <TargetMenuItem> : Inserts the item immediately following a specified standard menu item.

Before: <TargetMenuItem> : Inserts the item immediately preceding a specified standard menu item.

Important

Menu Extension Limitation: You cannot remove or delete standard menu items from an existing menu via extensions. You can only add new menu items, create new submenus, and organize custom navigation nodes.

5. Security Linkage: Menu Items as Entry Points

Dynamics 365 Finance and Operations enforces a strict Role-Based Security Architecture (RBAC) : Security Role (Job function, e.g., Accounts Receivable Clerk)

  • │
  • └── Security Duty (Business process task, e.g., Maintain customer master data)
  • │
  • └── Security Privilege (Granular action, e.g., Edit customer records)
  • │
  • └── Entry Point (Direct pointer to a Menu Item)
  • └── AccessLevel: Read | Update | Create | Correct | Delete
  • Entry Points in Security Privileges

Under a Security Privilege , developers add an Entry Point node.

The Entry Point has an ObjectType property ( MenuItemDisplay , MenuItemOutput , or MenuItemAction ) and an ObjectName property referencing the menu item.

AccessLevel Property: Dictates the maximum permission granted to the underlying object:

NoAccess : Explicitly denies access.

Read : User can view data; forms render in read-only mode, fields cannot be modified, and New/Delete buttons are hidden.

Update : User can view and edit existing records, but cannot create new records or delete records.

Create : User can view, edit, and create new records, but cannot delete records.

Correct : Used primarily in temporal/dated tables to modify past historical records.

Delete : Complete operational permissions (view, edit, insert, and delete).

Permission Cascading

When a user accesses a form via a Display menu item entry point granted with Read access, the runtime security kernel automatically cascades Read access down to all form data sources and child controls. Unless explicit form control permissions override this behavior, developers do not need to secure individual form fields manually.

  • 6. Scenario Walk-Through: Creating an Action Menu Item with Parameterized Security
  • Business Scenario

Contoso Manufacturing requires a command button on the All Sales Orders form that triggers an asynchronous credit re-evaluation process for the selected sales order. The button must only be active when a sales order row is highlighted. In addition, only users assigned to the Credit Specialist role should have permission to execute the action.

Implementation Steps

Develop Service Controller Class:

Create class ContosoSalesCreditEvalController extending SysOperationServiceController .

Implement static method main(Args _args) that inspects _args.record() for an active SalesTable buffer.

Create Action Menu Item:

In Visual Studio, add a new Action Menu Item named ContosoSalesCreditEvalAction .

Set properties:

  • Object = ContosoSalesCreditEvalController
  • ObjectType = Class
  • Label = @ContosoLabels:EvaluateCreditTitle
  • NeedsRecord = Yes (Crucial: ensures button is disabled if no order row is selected)
  • MultiSelect = No

Insert Button into Form ActionPane:

Create a form extension for SalesTable ( SalesTable.ContosoExt ).

Locate ActionPane > ActionPaneTabManage > ButtonGroupCredit .

Add a MenuFunctionButton referencing ContosoSalesCreditEvalAction .

Create Security Privilege & Entry Point:

Create Security Privilege ContosoSalesCreditEvalPrivilege .

Add an Entry Point named ContosoSalesCreditEvalAction with ObjectType = MenuItemAction .

Set AccessLevel = Update (permits executing business logic).

Link to Security Duty:

Extend standard duty CustCreditManagementMaintain and add ContosoSalesCreditEvalPrivilege .

7. Real-World Exam Traps: Menus, Menu Items & Navigation

Warning

Exam Trap 1: Using the Wrong Menu Item Type for Classes or Reports A recurring MB-500 exam scenario presents a requirement to run an SSRS report from a button and asks which menu item to create. Selecting a Display menu item is incorrect. Running SSRS reports or report controller classes strictly requires an Output menu item. Running batch jobs or operational classes requires an Action menu item.

Warning

Exam Trap 2: Forgetting NeedsRecord = Yes Leads to Null Buffer Errors When an ActionPane button executes logic dependent on the current row buffer (e.g., salesTable = _args.record() ), failing to set NeedsRecord = Yes allows users to click the button when the grid is empty or during form load, triggering runtime null reference exceptions in X++.

Warning

Exam Trap 3: Confusing Configuration Keys with User Security If a menu item is missing for a user who possesses the System Administrator role, candidates often mistakenly assume a security role or privilege issue. System Administrators bypass all security roles and duties. If a menu item is invisible even to a System Administrator, the cause is an inactive ConfigurationKey or a mismatch in CountryRegionCodes .

Warning

Exam Trap 4: Direct Form Assignment in Security Privileges In modern Dynamics 365 Finance and Operations, forms and classes cannot be assigned directly as entry points on security privileges. Entry points must point to Menu Items . The menu item acts as the indispensable security gatekeeper.

Loading diagram... Menu Items, Navigation Framework, and Role-Based Security Pipeline