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

Conclusion

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.

 

Questions?

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
Denise Hartman

Written by Denise Hartman

Denise has a B.S. in Business Administration from Millersville University, and an M.B.A. from Loyola University of Maryland and has been working at RKL eSolutions as a Sage Enterprise Management Engineer since 2007. Her main focus is on integrations between third party systems and Sage Enterprise Management. In her free time she enjoys spending time with her husband and adult twin daughters, who are both accountants.