Post a custom field to VendTrans/CustTrans through journal

Posted: December 24, 2013 in Dynamics AX 2012, Finance

Here is the scenario

  1. You have added a custom field to your Customer/Vendor transactions table.
  2. You want to capture this field during the posting of a Customer/Vendor transaction from General Journal and post it to CustTrans/VendTrans.

How do you go about this?

It is not that complicated really, we just need to know what happens during the posting process. Let us assume we want to add a new field called VGRWeBelieve (type Enum NoYes) to VendTrans.

  1. First we need to capture the fields on journal lines. So we need to add the same field to the table LedgerJournalTrans.
  2. Next we need to expose this new field on the journal lines form. If you are modifying the General Journal then you would modify the form LedgerJournalTransDaily.
  3. Next we need to move it from LedgerJournalTrans to the voucher that posts the lines to VendTrans.
  4. This is done in the class VendVoucher.
  5. The method newVendVoucherJournal of VendVoucher allows us to pull data from LedgerJournalTrans to VendVoucher.
  6. VendVoucher extends CustVendVoucher so let us add the field VGRWeBelieve (and the parmVGRWeBelieve method) to the class CustVendVoucher.
  7. And then basically populate this field in newVendVoucherJournal method.
  8. Now that we have the data in a class property, we then need to transfer this to VendTrans record.
  9. VendTrans record is created in the method CustVendVoucher.initCustVendTrans.
  10. CustVendVoucher class basically transfers all local class field data to a map called CustVendTrans. This map is common to both CustTrans and VendTrans. Since our custom field only exists on VendTrans table, we also need to add it to CustVendTrans map and map it only under VendTrans to the corresponding VendTrans custom field.
  11. Now we are ready to assign the parmVGRWeBelieve property of CustVendVoucher to CustVendTrans.VGRWeBelieve in the method initCustVendTrans. Here we need to be a bit careful. Since this method is called for both CustTrans and VendTrans (basically customer and vendor account types) we have to only assign it if CustVendTrans is of type VendTrans. We can find that out by using the following condition if(custVendTrans.TabelId == tableNum(VendTrans)) then assign.

Code changes

Type Name Changes
Table VendTrans New field VGRWeBelieve
Table LedgerJournalTrans New field VGRWeBelieve
Form LedgerJournalTransDaily Add the field VGRWeBelieve to the form at appropriate location
Map CustVendTrans Add a new field called VGRWeBelieve

Create a mapping under VendTrans node between this field and the field added on vendTrans

Class CustVendVoucher Add the new field vgrWeBelieve to class declaration

Add a new parm method as follows
public VGRWeBelieve parmVGRWeBelieve(VGRWeBelieve _vgrWeBelieve = vgrWeBelieve)
{
vgrWeBelieve = _vgrWeBelieve;
return vgrWeBelieve;
}

Modify method initCustVendTrans and add the following code to it
If(custVendTrans.TableId == tableNum(VendTrans))
{
custVendTrans.VGRWeBelieve = vgrWeBelieve;
}

Class VendVoucher Modify the method newVendVoucherJournal and add the following code to it.
vendVoucher.parmVGRWeBelieve(_ledgerJournalTrans.VGRWeBelieve)
Comments
  1. Jefferson says:

    Nice post.

    I have a situation where I need to create a new field called refProjId in VendTrans, the related field is in PurchLine, the class CustVendVoucher works for me?

    ** I get the field from purchline with a method that read all lines of a same purchId and returns what i want…

  2. shyam says:

    Nice post,, continue to good work

Leave a comment