Walkthrough: Implementing New Workflow Events and Responses
Introduction
Microsoft Dynamics NAV 2016 Workflows enable you to model real-life business processes like best
practices or industry-standard practices. Ensuring a customer’s credit limit
has been independently verified or requiring a two-person approval for a
significant vendor payment are both examples of these. Workflow can be thought of as the movement of
documents or tasks through a work process. Workflows in Dynamics NAV focus on three
main building blocks and almost any workflow process, short or long, is likely
to be comprised of steps related to these three blocks. They are:
- Approval, approval leaves a work task, item or document in an blocked or unapproved state until approved by a suitable person in your organization
- Notification, notifications tell users that something has happened and/or that they need to take some kind of action
- Process automation, process automation means executing a process routine and have the Dynamics NAV system calculate something or perform an action
The workflows in Dynamics NAV are represented by Workflow
Events and Responses. The smallest
workflow is the pairing of a single Event and a Response. Simple workflows could be
- When a new customer is created, email the sales person responsible for that region to alert them to the new customer
- When a purchase invoice exceeds $250, email the financial controller to alert them
More complex workflows are built of chains of events and
responses. Examples could be
- When a Purchase Invoice exceeds $250, put the purchase invoice on hold until it is approved by a manager.
- When new customers are created, block them until they have had a credit check performed.
- Once a purchase document has been approved by the accounting manager, automatically post it to the Dynamics NAV system.
Note: in all the
examples above, you can see a “when something happens, do something”
pattern. This is the “Event and
Response” model and is the simple but effective design behind Dynamics NAV
workflows.
Events and Workflow Events
Perhaps confusingly, Dynamics NAV 2016 introduces two new event
concepts. Events and Workflow events. The two are distinct but often coupled together
to build solutions. Dynamics NAV Events
allow you to write code which will be called when an event occurs – this is
called subscribing to an event. An
example could be to subscribe to the OnCreate
trigger for a table and writing code which will be called whenever a new record
is created.
Workflow Events typically use Platform Events as their
trigger, but are richer. Workflow events
are registered in the workflow engine and show up in the workflow
designer. Microsoft recommends that Workflow
events be written at a higher level of abstraction than Platform Events, for
example while OnCreateNewCustomerRecord
makes a suitable platform event, a good workflow event could be AfterOverduePaymentIsPosted.
Scenarios
Demo 1 – Create a workflow event
The scenario in this demo script is to define an event based
on the OnDelete trigger of the “Sales
Header” table and expose that event as a workflow event. This is done in the C/AL Object
Designers. This task is typically
performed by C/AL developers.
The scenario in this demo script is to define a response
which send an email to “Sales Manager”.
This is done in the C/AL Object Designers. This task is typically performed by C/AL
developers.
The scenario of this part of the demo script is to show
managing workflow events & responses from a Dynamics NAV system to build a
workflow. This task is typically
performed by super users.
To demonstrate the definition of an event you will need to
work in the C/AL editor and Object Designer.
Most of the work is done in the code editor and we will use codeunits
for our application objects.
- Open the Microsoft Dynamics NAV 2016 Development Environment.
- On the Tools menu, choose Object Designer.
- From Object Designer, create a new codeunit.
- Create a method called OnDeleteOrderCode. And Give the method a return value of Code, length 128.
- And write the code: EXIT(UPPERCASE('OnDeleteOrder'));
- Create the event itself. This will be an empty method tied to the "Sales Header" table.
- To do so, make another global method, called OnDeleteOrder.
- Open the property window for the method (view->properties) and set the Event property to Susbscriber, EventPublisherObject to Table Sales Header and EventFunction to OnAfterDeleteEvent.
- From the editor, define a local variable for the OnDeleteOrder function.
- In locals, create a variable called WorkflowManagment, subtype codeunit ‘Workflow Management’
- Add the code
MESSAGE('My Delete event is fired.');// Testing purpose
WorkflowManagement.HandleEvent(OnDeleteOrderCode,Rec);
- Create another event that will be a subscriber to the Add Events to Workflow Library event.
- To do so, make another global method, called AddEventToLibrary.
- Open the property window for the method (view->properties) and set the Event property to Susbscriber, EventPublisherObject to Codeunit ‘Workflow Event Handling” and EventFunction to OnAddEventsToLibrary.
- Create a text constant to hold the user readable string which describes the workflow event. Select view->Globals->text constants and add a new value OnDeleteTxt and set the value to ‘when a sales order is deleted’.
- Next, define a local variable in the AddEventToLibrary function for calling the WorkflowEventHandling codeunit.
- In locals, define variable WorkflowEventHandling as a codeunit of subtype ‘Workflow Event Handling’.
- Finally add the code which calls that method.
WorkflowEventHandling.AddEventToLibrary(OnDeleteOrderCode,
DATABASE::"Sales
Header",
OndeleteTxt,0,FALSE);
Note: [See
the bellow screenshot for better understanding].
The scenario in this demo script is to define a response
which send an email to “Sales Manager”. Most of the work is done in the code editor
and we will use codeunits for our application objects.
Note: you can create another codeunit also but in our Demo
I’m going to write in this codeunit only.
- Now Add one Method “RunSendEmailResponseCode” And set the return Type Code And Length 128.
- Add Code:
- Add Another method AddResponseToLibrary.
- Add another method EsecuteResponse
- See the bellow screenshot for details of these two methods property & Code
- Add another method for sending email to sales header
- See the bellow screenshot for mail sending code.
This part of the demo script shows managing workflow events
from a Dynamics NAV system. An entire
workflow is comprised of binding a Workflow Event and a Response together and
then enabling it.
Kindly let me know via comments, if you wish any clarification from my side.
In my next post i will describe how we can create own Integration Event and called it whenever the order is Released.