RPC Attributes - Fields Tab

Owned by Gidi Shalev
Last updated: Jun 09, 2020
4 min read

The Fields tab allows the configuration of the attributes of specific fields.

The left pane of the screen displays the fields and field parts that are available on the screen.

You can Add and Remove fields from the list, and also add a Screen Part (new window pane) and populate it with fields and values. This is valuable when organizing the logical structure of the screen, as well as adjusting the grouping of fields on the new display.

You can also convert the selected fields to a different type, using the Convert to button.

The right pane displays all the field attributes that are available for editing:

General Attributes:

  • Java Type – the field Java type
  • Field Name – the field name
  • Field Type:
    • PasswordField – use in LoginEntity to represent the Password field
    • UserField – use in LoginEntity to represent the User field
    • MessageField – use in MessageEntity to represent the field that contains the message
    • ErrorField – use in LoginEntity to represent the Login Error field
    • MenuSelectionField – use in MenuEntity to represent the field that gets the menu selection
    • General – use for all other types of fields
  • Display Name – the name of the field as it is displayed in a web application
  • Default Value – the value to be set in the field if no other value is defined
  • Expression - when selected, this field will be used as a component of a different field

Backend Attributes:

  • Row – the field’s first-row number on the screen
  • Column – the field’s first column number on the screen
  • End Row – the field’s last row number on the screen
  • End Column – the field’s last column number on the screen
  • Rectangle – select if the field value has multiple lines (End row must be greater than row).
  • Editable - select to define the field as input.
  • Label Column – location of the label on the screen for use during Design Time to position the field in the web panel
  • Fields Attribute: returns terminal data of the field
    • Value – returned field data is a value
    • Editable – returns True or False if the returned data is or is not editable
    • Color – returns the value of the text color
    • Back Color – returns the value of the background-color
  • Enable Lookup - enables value selection from a lookup window.
  • Lookup Action – select the action key that opens the lookup window assigned to this field (F4 is the default action).
  • Null Value - determine a value that will be set to Null if it appears on the screen (e.g., 0/00/00, .00 or “empty”).
  • Sample Value – sample value to appear in the field in a web application

Advanced Attributes:

  • Key – set the field as the key. This can impact several layers:
    • Use in the Java API when using the getEntity method with the entity key as input (e.g., terminalSession.getEntity (Entity.class, 123);)
    • Use as key in the REST request (e.g., http://server.com/app/entity/123)
    • When storing the entity in the cache, use the key to differentiate it from other instances of the same entity in the cache
  • Right to Left - check to reverse the value when working with right to left languages.
  • Padding - Used only in String fields:

    • Padding type: None (default) , Right , Left

    • Padding character: input text masked to one character
      If the Padding type is 'None', do not display the Padding character input box
      If the character is space (or other non-visible character) - display the label 'Space' right next to the input character

Validation Attributes:

  • Required - select when the field must receive an input
  • Regular Expression – validate the field input with a regular expression on the Client-side

Description Attributes - Add a descriptive text for a field that will be displayed on the Client-side taken from a specific place on the screen:

  • Row – the row on which the field will begin
  • Column – the column at which the field will begin
  • End Column – the column at which the field will end

Dynamic Field Attributes - The Field tab allows you also to define dynamic fields that are useful when the field’s location on the screen is dependent on the returned values (such as messages):

  • Leading Text – when defined, the system will search for this text on the screen and use it to locate the dynamic field
  • Row – the row on which the text will be displayed (the first row in the case of text that is split over multiple rows)
  • Column – the column at which the text will begin
  • End Column – the column at which the text will end
  • End Row – the row on which the field will end
  • Field Offset – the space between the Leading Text and the first character of the dynamic field value

Field Parts

Field Parts are a logical collection of related fields, and have certain attributes that are specific to them. Field parts appear in the left side, indented under the field.

RPC Part Details

  • Field Name - the name of the field
  • Class Name – the name of the class
  • Display Name – name to be displayed in the web application
  • Original Name - the name of the legacy entity
  • Direction – input, output, input/output



RPC Part List Details

  • FIeld Name - the name of the field
  • Class Name - the name of the class
  • Display Name - named to be displayed in the web application
  • Original Name - the name of the legacy entity
  • Direction - input, output, input/output
  • Count – If the Count is greater than 1, RPC actions will be enabled