Close this search box.
Close this search box.
Close this search box.

Adding Usr prefix to the existing users’ fields in Acumatica ERP

We are starting a new series for ERP Acumatica developers. This article is perfect starting point for beginners, demystifying the fundamentals of Acumatica customization.   

Creating Custom Fields

A standout feature of Acumatica ERP is the ability to create personalized fields, enhancing the system’s standard database tables. Here, we’ll guide you through the seamless process of scripting in the Settings interface to create and integrate these special fields.

Database scripts Add Custom Column to Table


As you venture into adding custom fields, the crucial PXCacheExtension integration in the output DAC class comes into play, allowing the fields to interact proficiently. Achieving this sets the stage for developers to fully utilize the personalized fields, fostering the ability to:

  1. Store new vital data in the database
  2. Exhibit database information on the user interface
  3. Utilize field data for API requests or log response data from specific API requests
  4. Develop versatile business logic for individual tasks


computer science

Adhering to naming conventions is vital. All custom fields must begin with a “Usr” prefix in both the database and the abstract class, aligning with the ISV software certification prerequisites. This practice not only maintains system coherence but also safeguards your software solution’s functionality and data during system upgrades. Explore more on this in the “Acumatica ISV Software Certification Guidelines“.

Meeting the Requirements

Here’s a word of caution: failing to adhere to certain guidelines can cause significant issues during system upgrades, including the deletion of user fields. This not only disrupts the functionality of your software solution but also results in data loss in specific fields. As an example, consider this coding snippet:

public abstract class usrFieldName: BqlType <IBqlBool, bool>.Field<usrFieldName> {}.

At a first glance, things might seem straightforward. However, complications arise when existing projects have user fields without the prescribed ‘Usr’ prefix. This could be due to a number of reasons, including insufficient attention to the requirements during development or the incorporation of specific functionalities at the expansion stage.

Correcting this apparent simple error is rather intricate, primarily because data associated with these fields is already housed in the existing database without the ‘Usr’ prefix. But don’t fret, as we’re here to guide you on how to successfully amend this issue. By following the steps outlined below, both your code and settings will align perfectly with the requirements for creating and using special fields. Here’s the action plan:


  1. Database Adjustment: Initiate by creating new fields in the database, identical to the existing ones but now with the ‘Usr’ prefix.
  2. Data Migration: Ensure a seamless transfer of data from the old fields to the newly minted ones. Subsequently, remove the old fields to streamline the database.
  3. Class Field Configuration: Adjust the fields of the class into PXCacheExtension to sync with the initial DAC class properly.
  4. Website Page Update: Finally, remove fields that lack the necessary prefix from the website pages and substitute them with the newly created equivalents, this time boasting the ‘Usr’ prefix.

Let’s explore each step in detail, providing you with a roadmap for a smooth transition to a more efficient and streamlined system 

At this point, I want to share with you one of the ways of how to successfully correct this flaw. Following the steps described below, the code itself and the settings will thoroughly comply with the requirements on creating and using special fields. To begin with, we will identify and form a plan of the work and changes which will have to take place:

In the images provided below you can find a more detailed description of these steps.

Step 1: A Glimpse into the Settings Window

Begin by navigating to the Settings window to create fields equivalent to the existing ones. 

Creating equivalent fields

Utilize the customization settings interface to craft your own fields seamlessly, as illustrated below:

go to the settings on the screen Customization Projects (SM204505), then go to the menu option Database scripts Add Custom Column to Table. In the dialogue window, insert all the necessary parameters equivalent to the fields without the prefix.

Inserting parameters of fields

Step 2: Handling Data Transfer and Old Fields

Now, let’s get our hands a bit dirty with some SQL scripting. To facilitate a smooth transition, you’ll need to write SQL scripts to transfer data from the old fields to the new ones, followed by the removal of the old fields.

Deleting old fields

Adding new SQL script:


Here’s a flexible SQL script template that can be adapted for various field alterations:


IF NOT EXISTS (SELECT * FROM information_schema.COLUMNS WHERE TABLE_NAME = ‘table_name_in_DB’ AND COLUMN_NAME = ‘UsrFieldName’)
ALTER TABLE table_name_in_DB ADD UsrFieldName bit NULL;
IF EXISTS (SELECT * FROM information_schema.COLUMNS WHERE TABLE_NAME = ‘table_name_in_DB’ AND COLUMN_NAME = ‘UsrFieldName’)
IF EXISTS (SELECT * FROM information_schema.COLUMNS WHERE TABLE_NAME = ‘table_name_in_DB’ AND COLUMN_NAME = ‘FieldName’)
exec(‘UPDATE table_name_in_DB SET UsrFieldName = FieldName’);
IF EXISTS (SELECT * FROM information_schema.COLUMNS WHERE TABLE_NAME = ‘table_name_in_DB’ AND COLUMN_NAME = ‘UsrFieldName’)
ALTER TABLE table_name_in_DB DROP COLUMN FieldName;

This script performs a series of checks and operations to ensure that data is transferred correctly without duplication, followed by the removal of the old fields.

SQL script

Step 3: Setting Field Classes in DAC Correctly

Next, let’s focus on setting the field classes in the DAC correctly. For those using a code approach, align the field class in PXCacheExtension with the initial DAC class. Here’s a snippet to guide you:

public abstract class usrTrackHours: BqlType <IBqlBool, bool>.Field<usrTrackHours> {};

Remember to scrutinize your code thoroughly to identify and update all instances where the specific field is utilized.

For those preferring a project interface setting, navigate to the Customization Projects (SM204505) page, select the DATA ACCESS > Add New Record menu option, and input the necessary parameters for the new field – don’t forget the ‘Usr’ prefix (  UsrFieldName, for example)

The below image illustrates how to add a new record to access data and setting parameters:

New record to access data

As well as setting the necessary parameters for the users’ project interface field settings:

User interface parameters

Then we will consider deletion of the fields without the necessary prefix and changing them into the fields with Usr prefix.

Editing XML project in the project setting:

Editing XML project

Next we will look at saving XML project in the project setting. To do so, it will be convenient to open Customization Projects (SM204505) page, then go to the menu option File Edit Project XML and replace the necessary fields in the window with XML code.

To do so, change:<Prop Key = “DataField” Value = “FieldName” />into<Prop Key = “DataField” Value = “UsrFieldName” />

Save to database

Step 4: Updating the Website Pages

Lastly, it’s time to clean up your website pages. Remove the fields lacking the ‘Usr’ prefix and replace them with their new equivalents.

Once you’ve made all the necessary adjustments, save your changes to the database. Remember to publish your customization project to apply all the changes you’ve made.

Following the completion of these adjustments, ensure to save your progress to the database. Before wrapping up, publish your customization project to enact all the alterations you’ve orchestrated, heralding a new era of streamlined and standardized operations in your Acumatica ERP system.

Remember to always have a backup of your database to prevent any loss of data during this transition.

And Last, but Not Least!

Thank you for following along, and here’s to a more efficient and optimized Acumatica ERP system! 

We’ve visually documented the entire process for your convenience, guiding you step-by-step from the initiation of field creation to the final publishing of your customized project.  The journey to mastering Acumatica customization starts with a solid foundation.

 Stay tuned for more insights and guided walk-throughs in our series. Our goal is to make your Acumatica customization journey as smooth as possible.

Happy coding!

Need Expert Assistance? Choose Sprinterra Customization Services!

Taking the first steps in customizing your Acumatica ERP system can be a complex process, but you don’t have to do it alone!

Sprinterra’s Customization Services are here to facilitate a seamless transition, making sure that every detail aligns perfectly with your business goals.

Whether you’re looking to optimize existing functionalities or develop new, groundbreaking features, our seasoned experts are ready to assist you every step of the way. With Sprinterra by your side, you’re not just meeting requirements; you’re exceeding expectations.

🔹 Embark on a Hassle-Free Customization Journey with Sprinterra Today!

Let’s explore how we can make YOUR Acumatica customization project a resounding success – a dynamic, flexible, and robust ERP system, tailored to your unique business needs.

Get in Touch with Sprinterra

Subscribe To Our Newsletter

Get the latest insights on exponential technologies delivered straight to you