Contents tagged with Acumatica

  • How to modify PXIntList dynamically in Acumatica

    Hello everybody,

    today I want to leave a short code sample on how to modify PXIntList or dropdown list in Acumatica. Below goes code sample of it:

    protected virtual void _(Events.RowSelected<CROpportunity> e)


        if (e.Row == null)


        var opportunityExtension = e.Row.GetExtension<CROpportunityExt>();

        if (opportunityExtension.UsrProduct == 0)


            var listInts = new List<int>();

            var listStrings = new List<String>();




            listStrings.Add("String 1");

            listStrings.Add("String 2");

            listStrings.Add("String 3");

             … more

  • Creating the new Company, set settings for it from snapshot

    Hello everybody,today I want share with you, how you can create new Company and set it settings.

    For creating new company, we should go to "Tenants" screen:

    Notice, that in old vercions of acumatica instead the "Tenants" was the "Companies":

    Let create new company, and give it name "Exotic Places":

    When process of creation is finished, we'll automatically be logged out:


    To fix this, let's copy the settings from existing company to our. First of all let us sign out from "Exotic Places" and sign in to "Company". Then open "Tenants", chose the "Company" and click to "Create Snapshot" button:

    We get a warning message, but it possible easily deal with it, only go … more

  • Warning: you are not in maintenance mode

    Hello everybody,

    today I want to make a post about new security feature of acumatica, which guard you from creating corrupted data. Suppose you are System Administrator and want to make snapshot for being able use it to set settings to new company, which you just created. However, some user might use it too, and this may cause the creation of bad records. For this reason, in latest versions of Acumatica (from 2017 R2), when you try to create snapshot, you'll recieve an warning message: 

    Warning message informs, that you should switching the maintenance mode, so do it, as shown below, by click "SCHEDULE LOCKOUT":


    Now you able, without any risk, create snapshot:

    On the end, … more

  • FBQL brackets

    Hello everybody,

    today I want to speak about one very interesting feature of FBQL, which I don't know if exists in BQL. Function Brackets!

    Take a look on following code sample:

    var bracketsDemo = SelectFrom<SOOrder>.InnerJoin<SOLine>.On<SOLine.orderNbr.IsEqual<SOOrder.orderNbr>>.InnerJoin<SOShipLine>








    Or<SOShipLine. … more

  • Master-Detail relationship in Acumatica

    Hello everybody,

    today I want to make a post about Master-Detail relationship between DAC classes in Acumatica. Maybe you already familiar with C# and SQL and know this theme.  But how acomplish this in  Acumatica? Lets consider. 

    Suppose that we have table in our database with students. In another table we store detail data about them. First table has name "Student", second - "StudentDetail".

    First of all, let we set up master-detail relationship between the Student and StudentDetail data access classes. For this we need to add PXDBDefault attribute to the StudentDetail.FirstName and for StudentDetail.LastName fields:

    #region FirstName

           public abstract class firstName :  … more

  • Adding report page to customization

    Hello everybody,

    today I want to make post on how to add your report page (.rpx) to customization, so than you will be able to use it in another progect.

    For this purpose open customization window as showed below and click "Reports" button:

    Then click on plus and select report you want to change:

    The name of your report page you can find, when run report from acumatica page in browser:

    If you will follow those steps, you'll be able to add report to customization:

    But this works only if your report is available in database.

    Suppose your report is saved only in file, in ReportsDefault folder of your site. Then you should save it also to database.

    For achieving … more

  • How to pass data into processing method with help of lambda expression

    Hello everybody,

    today I want to leave a short note on how to pass some additional parameters into Processing method of processing page with help of lambda expression. Syntax is pretty simple:

    public class SSShipmentDateResetter : PXGraph<SSShipmentDateResetter>


    public PXFilter<ShipmentFilter> ShipmentFilter;

    public PXFilteredProcessing<SOShipment, ShipmentFilter> ShipmentsForProcessing;

    public SSShipmentDateResetter()


    var shipmentFilter = ShipmentFilter.Current;

    ShipmentsForProcessing.SetProcessDelegate(shipments =>


    ResetDate(shipmentFilter, shipments);



    public static void ResetDate(ShipmentFilter filter,  List<SOShipment> shipments)

    { … more

  • How to work with unbounded DAC in Acumatica

    Hi everybody,

    today I want to leave a short note on how to deal with Unbounded DAC classes in Acumatica. Unbounded in other words means DACs that doesn't have dirrect persising target in database.

    For Unbounded DAC classes to work like this, two steps are needed:

    Add attribue [PXVirtualDAC] to PXSelect or PXSelect.....

    Add attribute PXVirtual over your DAC class declaration

    With those two details you'll have complete independence of your classes from Database. more

  • How to restore snapshot of Acumatica

    Hello everybody,

    today I want to leave a post on how to restore Acumatica snapshots with help of Acumatica Wizard.

    Before creating snapshot you may need to switch Acumatica to maintenance mode. Below are the steps for achieveing it:

    1. Go to System --> Management --> Apply Updates, click on the button "Schedule Lockout" and specify the reason for lockout 2. Don't forget to remove the lockout after you'll restore Snapshot.

    Steps are the following:

    1. Create a snapshot of the tenant you wish to back up

    2. Export that snapshot (I recoment  xml format).

    3. In the folder where the corresponding Acumatica Wizard is installed (usually c:\program files\Acumatica ERP\), find the folder … more

  • How to enable some control in Acumatica

    Hello everybody,

    today I want to leave a short note for the following situation:

    Imagine that you need to enable some control in Acumatica ( for example Mark for PO ) on page Sales orders ( SO301000 ).

    As usually for enabling control there are two ways:


    Automation steps.

    Recently I found third option, when neither 1 nor 2 did work. After spending some time I found third option: Cache has property AllowUpdate. After I've set it to true, I was able to modify lines in Document details. 

    In your code it may look like this:

    protected void SOLine_RowSelected(PXCache cache, PXRowSelectedEventArgs e, PXRowSelected del)


            if (del != null)

                  del(cache, e) … more

  • New syntax of SetVisibility method in Acumatica

    Hello everybody,

    today I want to write a few words about changes of PXUIFieldAttribute.SetVisibility method. 

    In the past, if you wanted to turn on some column, you could write in RowSelected event something like this:

              PXUIFieldAttribute.SetVisibility<APRegister.finPeriodID>(Documents.Cache, null, true);

    If you want to turn it off, then this:

    PXUIFieldAttribute.SetVisibility<APRegister.finPeriodID>(Documents.Cache, null, false);

    But for quite a long time ( even in 2017 version ), Acumatica team introduced PXUIVisibility enum. In code it looks like this:


    public enum PXUIVisibility


      Undefined = 0,

      Invisible = 1,

      Visible = 3,

      SelectorVisible = 7,

       … more

  • How to change all emails in Acumatica

    Hello everybody,

    today I want to leave a post on how to change all emails, which are contained in Acumatica. For this purpose you may use script below:

    UPDATE contact SET    email = email + '.ts' UPDATE socontact SET    email = email + '.ts' UPDATE apcontact SET    email = email + '.ts' UPDATE pocontact SET    email = email + '.ts' UPDATE crcontact SET    email = email + '.ts' UPDATE arcontact SET    email = email + '.ts' UPDATE fscontact SET    email = email + '.ts' UPDATE crcasecontacts SET    email = email + '.ts' UPDATE crcontact SET    email = email + '.ts' UPDATE pmcontact SET    email = email + '.ts' 

    If you wonder, what can be the usage of such SQL, consider following … more

  • Required of BQL in FBQL of Acumatica

    Hello everybody,

    today I want to describe how analogue to Required works in Acumatica Framework.

    For example, in the past ( before 2019 R1 ) you may read something from Acumatica with help of Required:

    var contact = PXSelect<Contact, Where<Contact.displayName, IsNotNull, And<Contact.displayName,  Contains<Required<Contact.displayName>>>>>.SelectWindowed(graph, startIdx, 1, ' ').First();

    Now, you can use @P.AsString, as shown on code sample below:

    var contact = SelectFrom<Contact>.Where<Contact.displayName.IsNotNull.And<Contact.displayName. Contains<@P.AsString>>>.View.SelectWindowed(graph, startIdx, 1, ' ').First();


    Also take a note, that … more

  • Different methods of PXInstanceHelper class in Acumatica

    Hello everybody,

    today I want to document one important class in Acumatica: PXInstanceHelper.

    I have found it long time ago, but finally time arrived to show how it works and what features it has. So, PXInstanceHelper include such methods:

    Method AppDataFolder.

    In code it looks like this:

    var result = PXInstanceHelper.AppDataFolder;

    Screenshot of it's execution may give you additional hint of what it does:

    This method returns physical path to folder App_Data inside of Acumatica instance. As you can see from the screenshot, on my dev machine App_Data folder lives at

    C:\Program Files\AcumaticaERP\InstanceHelperDB\App_Data

    2. Method CurrentCompany.

    In code looks like this: … more

  • How to use F-BQL view instead of PXSelect

    Hello everybody,

    today I want to leave a short note on how to use F-BQL version of PXSelect in Acumatica.

    In past it was common to have this line of code in your graph:

    public PXSelect<Student1> Students;

    In new F-BQL introduced new construction, SeleftFrom. Proper way of using it is this:

    public SelectFrom<Student2>.View Students;

    Take notice of suffix .View. Without that suffix you'll not get proper F-BQL view. And Acuminator will give you this warning:

    So if to summarize, don't forget to add suffix .View


  • How to download DAC schema browser

    Hello everybody,

    here is just short post on how to download DAC Schema browser which I recently opensourced.

    You'll need two steps:

    Navigate in your browser to link

    Click on Star as displayed on screenshot (this is optional step):

           4. Right mouse click

           5. Save customization wherever you wish

           6. Publish on your local instance

    That particular file is intended for Acumatica version 2019 R1 build 0122, but it should work on higher versions as well. Later on I'll add lower versions as well. more

  • How to get list of all Acumatica tables

    Hello everybody,

    today I want to share single line of code, which I found recently while digging Acumatica source code with reflector. Sometime you may need to know if there is some or antoher Acumatica table available. For example if you create some customization plugin. How to find out if there is some table? You can use following line of code for this purpose:

    using PX.Api.Soap.Screen;


    var acumaticaTables = ServiceManager.Tables;

    Variable acumaticaTables will have a list of Acumatica tables.


  • Configuration Error for Acumatica T100 training

    Hello everybody,

    once upon a time Acumatica requires for certified developers to pass over certification again. 

    As obedient person I decided to install T100 sample application over Acumatica Framework Configuration ( don't mix with Acumatica ERP Configuration ). Then I navigated to just installed application, and here is what I've seen:

    Server Error in '/T100a' Application.

    Configuration Error

    Description: An error occurred during the processing of a configuration file required to service this request. Please review the specific error details below and modify your configuration file appropriately. Parser Error Message: The connection string name is missing for the … more

  • How to call action Cancel in Acumatica

    Hello everybody,

    Today I want to leave a short notice on how to call Cancel button of Acumatica from inside C# code:


    That is it, Clear method is binded to button Cancel in Acumatica. Besides that Clear method will reload current data record from database and rolls back changes of Cache objects. more

  • PXUIRequired attribute usage in Acumatica

    Hello everybody,

    today I want to say a bit more about usage of attribute PXUIRequired as previous article on my blog wasn't very easy to follow by some of my readers.

    Take a look on presented code sample:

    public class sOOrderType : Constant<string>


    public const string SOOrderType = "SO";

    public sOOrderType() : base(SOOrderType)




    public class SOOrderExt : PXCacheExtension<SOOrder>


    [PXMergeAttributes(Method = MergeMethod.Append)]


    [PXUIRequired(typeof(Where<SOOrder.orderType, Equal<sOOrderType>>))]

    public virtual string CustomerOrderNbr { get; set; }


    As you can see, besides attribute PXUIRequired it has declaration of constant value "SO". … more