How to Place Custom Code Using Events in Microsoft Dynamics NAV 2016
With every modification to Microsoft Dynamics NAV we are faced with the tough question, where should I place this new code? Do we place it directly on the page? The action on the page? The table the page references? Or a code unit? This may seem like a minuscule decision but if your company repeatedly makes the wrong decision, you will accumulate a tremendous amount of technical debt. This causes upgrades and future modifications to substantially increase in time, difficulty and overall cost.
Avoiding altering base NAV functionality will make your upgrades faster and less painful. Microsoft has helped developers with this by introducing events in NAV 2016. Events utilize a hooking pattern that allows developers to add their modifications without touching base NAV code.
In this example, we are going to set up an Event to run after we release a sales order.
- Create a custom code unit to store your events.
- Create your function and set the property Event to Subscriber
- Publisher: Allows you to create a new Event. Objects comes with stock events, however, if you need to create custom events you would set your function to Publisher.
- Subscriber: Is called when Events are triggered.
- For this example, after a sales order is successfully released, our code in this newly created Event Subscriber will run.
Setting a function to Subscribe to an Event
- Set the Event to Subscriber
- Set the EventPublisherObject to Codeunit 414, Release Sales Document
- Set the EventFunction to OnAfterReleaseSalesDoc
This message will appear, click Yes. This will change your event subscriber function parameters for you.
You can now add custom code to your new Event Subscriber function.
Here you can see our Event Subscriber running after you click release.
Going back to our original question, where should we place custom modification code? We recommend placing customizations in custom code units utilizing events to avoid making modifications in base NAV code. This will minimize your company’s technical debt and allow for more cost-efficient upgrades and future modifications.
If you are a Dynamics NAV user and have more questions, contact the team at Stoneridge Software for additional help.