Scenario:
The VendDocumentLineType class has several subclasses that handle specific types of vendor document lines. We want to change a behaviour for invoice lines and implement new logic for Purchase Unit field defaulting.
Solution using overlaying:
Overlay VendDocumentLineType_Invoice class and override determineDefaultPurchUnit method.
Solution without overlaying:
1) Create class derived from VendDocumentLineType_Invoice:
[Form]
/// <summary>
/// The <c>VendDocumentLineType_Invoice_Sample</c> class is used for validation and applying default values to invoice lines.
/// </summary>
class VendDocumentLineType_Sample extends VendDocumentLineType_Invoice
{
}
2) Override determineDefaultPurchUnit method:
protected PurchUnit determineDefaultPurchUnit()
{
// implement new behaviour
return VendParameters::find().DefaultPurchUnit_Sample;
}
3) Create post event handler for VendDocumentLineType constructor to replace VendDocumentLineType_Invoice with new implementation:
/// <summary>
/// Handles events raised by <c>VendDocumentLineType</c> class.
/// </summary>
public static class VendDocumentLineTypeEventHandler_Sample
{
/// <summary>
/// Post event handler for VendDocumentLineType.createFromTable(...)
/// </summary>
/// <param name="_args"></param>
[PostHandlerFor(classStr(VendDocumentLineType), staticMethodStr(VendDocumentLineType, createFromTable))]
public static void VendDocumentLineType_Post_createFromTable(XppPrePostArgs _args)
{
// get params from args
VendDocumentLineMap vendDocumentLineMap = _args.getArg(identifierStr(_vendDocumentLineMap));
PurchLine purchLine = _args.getArg(identifierStr(_purchLine));
PurchParmUpdate purchParmUpdate = _args.getArg(identifierStr(_purchParmUpdate));
// construct and init new object
VendDocumentLineType strategy = VendDocumentLineType_Invoice_Sample::createFromTable(vendDocumentLineMap, purchLine, purchParmUpdate);
// replace return value only if new strategy is created; otherwise use standard
if (strategy)
{
// replace return value with new implementation
_args.setReturnValue(strategy);
}
}
}
4) Implement methods that will instantiate and initialize VendDocumentLineType_Invoice_Sample class:
/// <summary>
/// Constructs a new instance of a <c>VendDocumentLineType_Invoice_Sample</c> class derivative.
/// </summary>
/// <param name="_vendDocumentLineMap">
/// A <c>VendDocumentLineMap</c> record.
/// </param>
/// <param name="_purchLine">
/// A <c>PurchLine</c> table record that is used when you apply the default values; optional.
/// </param>
/// <param name="_purchParmUpdate">
/// A <c>PurchParmUpdate</c> table record that is used when you apply the default values; optional.
/// </param>
/// <returns>
/// A <c>VendDocumentLineType_Invoice_Sample</c> class.
/// </returns>
public static VendDocumentLineType_Invoice_Sample createFromTable(VendDocumentLineMap _vendDocumentLineMap, PurchLine _purchLine = null, PurchParmUpdate _purchParmUpdate = null)
{
VendDocumentLineType_Invoice_Sample strategy;
// VendDocumentLineType_Invoice is created only for this 2 types
if (_vendDocumentLineMap.Ordering == DocumentStatus::Invoice ||
_vendDocumentLineMap.Ordering == DocumentStatus::ApproveJournal)
{
strategy = new VendDocumentLineType_Invoice_Sample();
strategy.init(_vendDocumentLineMap, _purchLine, _purchParmUpdate);
}
return strategy;
}
public void init(VendDocumentLineMap _vendDocumentLineMap, PurchLine _purchLine, PurchParmUpdate _purchParmUpdate)
{
// code copied from VendDocumentLineType::createFromTable to init new instance
this.vendDocumentLineMap(_vendDocumentLineMap);
this.purchLine(_purchLine);
this.physicalStrategy(VendDocumentLineTypePhysical::createFromTable(this, _vendDocumentLineMap));
this.purchParmUpdate(_purchParmUpdate);
}
You can apply this approach to any class hierarchy in AX that has construct method (like SalesLineType, PurchLineType, etc.) when you need to override methods in derived class to implement new behaviour.
