How to add custom business logic to Acumatica framework's Actions?

Question

I added a custom field to SOShipment and I want to set its value when the CreateShipment action is invoked on Order Entry or through Process Orders screens. How do I do that

Answer 1

Create a graph extension for SOOrderEntry and add an Action method like this :

using PX.Data;
using System.Collections;

namespace PX.Objects.SO
{

    public class SOOrderEntry_Extension : PXGraphExtension
    {
        public PXAction action;
        [PXUIField(DisplayName = "Actions", MapEnableRights = PXCacheRights.Select)]
        [PXButton]
        protected virtual IEnumerable Action(PXAdapter adapter,
            [PXInt]
            [PXIntList(new int[] { 1, 2, 3, 4, 5 }, new string[] { "Create Shipment", "Apply Assignment Rules", "Create Invoice", "Post Invoice to IN", "Create Purchase Order" })]
            int? actionID,
            [PXDate]
            DateTime? shipDate,
            [PXSelector(typeof(INSite.siteCD))]         
            string siteCD,
            [SOOperation.List]
            string operation,
            [PXString()]
            string ActionName)
        {
            //actionID = 1 means the CreateShipment action was the one invoked
            if (actionID == 1)
            {
                PXGraph.InstanceCreated.AddHandler((graph) =>
                {
                    graph.RowInserting.AddHandler((sender, e) =>
                    {
                        //Custom logic goes here
                        var shipment = (SOShipment)e.Row;
                        var shipmentExt = PXCache.GetExtension(shipment);
                        if (Base.Document.Current != null && shipmentExt != null)
                        {
                            shipmentExt.UsrPriority = Base.Document.Current.Priority;
                        }
                    });
                });
            }

            //calls the basic action that was invoked
            return Base.action.Press(adapter);
        }
    }
}

When any of SOOrderEntry's actions is run (even through the Process Orders screen), this method is invoked. We verify that the action really is CreateShipment with the actionID == 1 and add events handler for SOShipmentEntry graph creation and SOShipment RowInserting. Our custom logic is added inside the RowInserting event.