RKL eSolutions Blog Trends and Insights

How To Add a Custom Selector for the Screen Field

There may be times when you want to add a pop-up window to select a field for a screen. Sometimes this can be handled automatically if the field is a standard X3 object field (i.e. when selecting a product with a type of ITM from the ITMMASTER table). There may be other times where a standard look-up is not available, and some custom code is required to do the selection window. We'll show you how to add a custom selector of your choosing to the screen field.

Add Select on Screen Field

The first step is to add the appropriate code to the field on the screen in Sage X3:

  1. Go to Development > Script Dictionary > Screens
  2. Select Your Screen
  3. Select the field to have the lookup for by moving your cursor to it on the screen. The field should show with a blue background.
    Custom Selector for Screen Field #1
  4. Select a type of "Selection", and an action of GSELECT. (GSELECT is a standard action in X3 for general selection.)
    Custom Selector for Screen Field #2
  5. Two parameters will appear in the "Action Parameters" section below the Actions. Populate the two fields as described below:
    1. CODTRT — this is the SPE code (i.e. 4GL) where the custom logic will be added to select the value from a table. In this case, I am customizing the ITMMASTER screen, which is part of the ITM object, so the SPE code is SPEITM.
    2. CODZON— this is the field name you will add the lookup to. This will be used in the SPE code to direct the lookup logic.
      Custom Selector for Screen Field #3

Add the 4GL Code

Using the Eclipse editor, open the .src file. In this example, the source file is SPEITM.src. If there is already custom code, the file may already exist. Otherwise, the file will have to be created.

  1. Add the $ACTION section.
    Custom Selector for Screen Field #4
  2. Define the $OUVRE sub— this is used to open the tables that will be used in the lookup query.
    Custom Selector for Screen Field #5
  3. Define the $FIN sub— this is used to closet the tables that were opened in the OUVRE sub.
    Custom Selector for Screen Field #6
  4. Define the SEL_TABLE sub. This is the logic that will be called when the GSELECT action is initiated. Note the the "YCMPITM" matches the "CODZON" field entered on the screen. When GSELECT is called, it knows to call S_YCMPITM when the CODZON value is "YCMPITM". If multiple GSELECTS are defined for multiple fields, the CODZON will determine which select logic to use.
    Custom Selector for Screen Field #7
  5. Define the select logic. In this example, a Link statement is made to join multiple tables to include fields from the selection window. Additionally, the resulting values are filtered based on the CRITERE value defined on the screen.
    Custom Selector for Screen Field #8

View the Results

To review the results, go to the screen and select the search icon.

Custom Selector for Screen Field #9

The search window will appear as shown below. The filter values can be entered at the top to filter the results further.

Custom Selector for Screen Field #10


There may be times when you need to add a custom selector for a field on a screen or when a standard object or data type does not perform the lookup functionality automatically. With a little bit of coding, you can add logic to perform a custom selection window on your screen.



Don't hesitate to reach out and ask us any questions you may have, it's what we're here for!

Tags: Sage X3, How-To
RKL Team

Written by RKL Team

Since 2001, RKL eSolutions has helped growing companies maximize their technology resources and investment. Over the years, we have helped hundreds of small and medium sized businesses as their strategic business partner. We specialize in the needs of Entertainment, Software & SaaS, Professional Services, Manufacturing, and Non Profit organizations. Our experienced consultants have a passion for making every facet of your business successful and are intent on building a long-term relationship with every client.