Validate dialog input in the Business Operation Framework

A number of good community articles have been written on the new Business Operation Framework (BOF) in Microsoft Dynamics AX 2012, for example these series:

• From RunBase to SysOperation: Business Operation Framework
• From RunBase to SysOperation: Business Operation Framework (Cont'd)
• AX 2012: SysOperation introduction

And then there is of course MSDN.

However the documentation from Microsoft in this area currently is not yet comprehensive, so here is my first article on a small area of the framework.

If you need to validate the input of the dialog for a data contract, you need to add code to the data contract. Your data contract must implement the SysOperationValidatable interface:

[DataContractAttribute]
public class BOFDataContractA implements SysOperationValidatable
{
    int     parmIntProperty;
    str     parmStrProperty;
}

And you need to add the validate method of the interface:

public boolean validate()
{
    if (this.parmIntProperty() <= 25)
    {
        return checkFailed("The number must be higher than 25");
    }
    return true;
}