If you've been developing in Dynamics 365 Finance and Operations for a while, chances are you've either worked with or heard about the SysOperation framework. It’s one of those powerful—but often underutilized—features that can drastically improve the way you handle batch processing, background operations, and complex business logic.
In today’s post, I want to walk through how to properly build a batch job using the SysOperation framework, including UI parameter dialogs and execution logic. This is not just another “hello world” example — this is about designing scalable, maintainable, and professional-grade batch processes.
Why SysOperation, Not RunBase?
For those coming from older AX versions, RunBaseBatch might feel more familiar. But in D365 F&O, SysOperation is the standard — and for good reason:
| Benefit | Why It Matters |
|---|---|
| Separation of concerns | Cleanly splits data, UI, and business logic |
| Better testing | Each part is independently testable |
| Supports service-oriented architecture | Aligns with modern enterprise design |
| Declarative metadata | Leverages attributes for easier setup |
Real-World Use Case
Let’s say we want to build a batch job that automatically deactivates vendors who haven’t had any transactions in the past 18 months.
This isn’t just a one-time script — it should run on a schedule, allow user input, and log its execution.
Step-by-Step Implementation
1) Define the Data Contract
The contract defines parameters that the user can set in the UI:
[DataContractAttribute]
class DeactivateVendorsContract
{
TransDate cutoffDate;
[DataMemberAttribute("Cutoff Date"), SysOperationLabel(literalStr("Deactivate vendors who haven’t transacted since"))]
public TransDate parmCutoffDate(TransDate _cutoffDate = cutoffDate)
{
cutoffDate = _cutoffDate;
return cutoffDate;
}
}2) Write the Business Logic (Service Class)
Here’s where the actual deactivation logic lives:
class DeactivateVendorsService
{
public void processVendors(DeactivateVendorsContract contract)
{
VendTable vendTable;
while select forUpdate vendTable
where vendTable.Active == NoYes::Yes
{
if (!VendorHasRecentTransactions::hasActivitySince(vendTable.AccountNum, contract.parmCutoffDate()))
{
vendTable.Active = NoYes::No;
vendTable.update();
}
}
}
}3) Create the Controller Class
The controller connects the dots and supports scheduling:
class DeactivateVendorsController extends SysOperationServiceController
{
public static void main(Args _args)
{
DeactivateVendorsController controller = new DeactivateVendorsController();
controller.parmClassName(classStr(DeactivateVendorsService));
controller.parmMethodName(methodStr(DeactivateVendorsService, processVendors));
controller.parmDialogCaption("Vendor Deactivation Job");
controller.startOperation();
}
}Scheduling the Batch Job
Once everything is in place:
-
Navigate to System administration > Inquiries > Batch jobs.
-
Schedule the job via the controller’s
main()method. -
Set recurrence, alerts, and logging preferences.
Now you have a robust, enterprise-ready job that runs cleanly in the background — with full visibility and traceability.
Good practices to follow :
-
Always add meaningful labels in the DataContract so users aren’t guessing what each field means.
-
Separate query logic (e.g., checking for transactions) into a reusable class like
VendorHasRecentTransactions. -
Use logging via
SysOperationProgressor custom logging tables to capture success/failure counts. -
Consider adding batch group and task dependencies for large-scale production use.
Conclusion
The SysOperation framework isn’t just another way to run a batch job — it’s a foundation for writing clean, scalable operations that fit neatly into D365’s architecture. Once you get comfortable with it, you’ll never look back at RunBase.
Whether you’re processing millions of rows or just sending a daily summary email, using SysOperation the right way will help you deliver professional-grade solutions that your team — and your future self — will thank you for.
That's all for now. Please let us know your questions or feedback in comments section !!!!
