Field properties

Field	Description
Field Name	Identifier for the field. The field is uniquely identified by the Vector Name and Field Name so a field name can also exist in another vector. When vectors are copied from one screen to another, data is only copied if the fields are named the same and are case sensitive.
Field Type	One of these defined field types: TextView EditText EditText Choice EditText Multi-Line EditText Date See “Field type properties” on page 45.
Vector Name	Vector field belongs to HEADER, FOOTER, SEND, RECEIVE, and DISPLAY. Vector Name and Field Name form a unique key to identify the field.
Vector Position	The sequence position of the field within the Vector. SEND and RECEIVE fields must be ordered in a way that matches what is being received and sent by the backend procedures. The socket server sends data in a delimited text string and it assumes the field order matches that of the RF screen vector sequence.
Label Text	Display text of the Label field. Select a translatable label that can be displayed.
Label Row	Row number in which the label is displayed. This field is enabled for HEADER and FOOTER vectors since they are statically defined. For SEND and DISPLAY vector types, this field is automatically determined when fields are reordered in the Dynamic Order tab and based on the Label Orientation in the tab whether it is on the same line as the input field or on the line above an input field. Label Rows are not applicable to RECEIVE fields since they are not displayed.
Label Column	Column number in which the label starts. For TelnetRF, the font is fixed-width and the columns should match the character positions. Since WebRF uses a proportional-width font, the columns are approximated by taking the screen width and dividing by 20. Label Columns are not applicable to RECEIVE fields since they are not displayed.
Static Positions	Indicator that determines whether the position is Static and not calculated for CALCFIELDPOS routine.
Input Row	Row number in which the input field is displayed. For SEND and DISPLAY vector types, this is automatically determined when fields are reordered in the Dynamic Order tab and based on the Label Orientation in the tab whether it is on the same line as the input field or on the line above an input field. Input Rows are not applicable to RECEIVE fields since they are not displayed.
Input Column	Column number in which the input field starts. For TelnetRF, the font is fixed-width and the columns should match the character positions. Since WebRF uses a proportional-width font, the columns are approximated by taking the screen width and dividing by 20. Input Columns are not applicable to RECEIVE fields since they are not displayed.
Number of Lines	Defines the number of lines a multi-line field takes up on the screen. Fields that are longer than a single line should be setup as a multi-line field.
Mask	The mask allows for validation to be performed on the contents of the field. It is used to determine the length of the field on the RF screen. It can also be used with the Force Mask check box to validate a maximum length. ???????: All printable characters @@@@@: Alpha, non-numeric #######: Integers only ***********: Alphanumeric, letters and numbers %%%%%: Floating point with decimals {date}: Date field {datetime}: Datetime format
Force Mask	Limits the data entry to no more than the specified number of symbols. Note that you can enter less but not more symbols.
Force Uppercase	This field shifts data into uppercase when it is committed by the screen.
Echo Character	This character is echoed to the screen instead of the actual value entered. For example this character is used when a password is typed into a screen and asterisks should be displayed on the screen.
Hint Text	A translatable label that is displayed in an input field to give a hint as to what the user should enter. Hint text is displayed in a light grey.
Visible Expression	This property controls whether a field is displayed to a user or not. The property can be set to 0 (zero) to hide the field or 1 to show the field. The property can also be set to an Expression that is evaluated each time the screen is displayed. See “Expressions” on page 46.
Editable Expression	This property controls whether an input field is editable by the user. The property can be set to 0 (zero) to not allow input or 1 to allow input. The property can also be set to an Expression that is evaluated each time the screen is displayed. See “Expressions” on page 46.
Required Expression	This property controls whether the user must input information before the screen can be committed. The property can be set to 1 to force user input or 0 (zero) for optional input. The property can also be set to an Expression that is evaluated each time the screen is displayed. See “Expressions” on page 46.
Initial Value	Initial value of the input field. The value of fields is not actually changed by displayed values until a screen is committed. This value can be used to change what is on the screen without affecting the underlying value of a field. Changing this value affects the underlying value of a field whether it is displayed or not.
Default Value	Default value of the displayed value of the field. See Edit State.
Edit State	Any time a screen with editable fields is drawn, this flag is used to determine how the data value stored in each field is drawn on the screen. Edit state does not change the data value of the field. For example, the edit state of initialize blanks does not mean that the data value stored for a field is going to get cleared, but that it is drawn on the screen with an empty value. Only after the RF operator navigates through all the fields and commits the screen do the values shown on the screen become the data values stored for the fields, editable fields only. These Edit State fields are valid: Initialize Blank (conditionally): The value displayed on the screen is blank if the field is editable and visible Initialize Default (conditionally): The value displayed on the screen is set to the Default Value if the field is editable and visible Repeat Previous: The value displayed on the screen is the value retained from the previous screen Initialize Default (always): The value displayed on the screen is set to the Default Value even if the field is hidden or not editable
Dynamic Default	To provide a default programmatically, select a procedure call to make and map fields to pass to the procedure call as input parameters. A single value should be returned from the procedure which is the value defaulted to the screen when it loads.
Lookup Screen	Adding a screen code activates the F2 key. When F2 is pressed, the user is navigated to that screen to lookup a single value that is returned to this screen field.
Choice Values	Choice values are the values to be entered in the field when a user picks from a Choice field. Note that these values are only used for Choice field types.
Choice Display	The Choice Displays are translatable labels to be used when a user picks from a Choice field. Note that Choice Displays are only used for Choice field types.
Choice Help	Enter a translatable label that contains the help text that the user should see in the footer when picking a value from a choice field. Note that Choice Help is only used for Choice field types.
This Field Contains	This field is used for barcode parsing. To find the Barcode Format group to use for parsing, fields on the RF screen should be identified with the data they contain. These steps are used to determine the barcode format group. When a barcode format group is found, the rest of the steps are abandoned. Only format record configured in the Barcode Configuration screen with that barcode identifier, no additional fields should be identified on the RF screen. Barcode Format Group found on the Supplier, enterprise level, that was assigned to the PO: RF screen should have the field that contains the PO number marked to contain the PO Number. Barcode Format Group found on the Owner, facility level, of that Shipment Order: RF screen should have the field that contains the Shipment Order number marked to contain the Order. Barcode Format Group found on the Ship-From, enterprise level, of the ASN: RF screen should have the field that contains the ASN number marked to contain the ASN Number. Barcode Format Group found on the Item, enterprise level, of the item: RF screen should have the fields that contain the item and owner marked to contain the Item and Owner, respectively. Barcode Format Group found on the Owner, facility level, of the item: RF screen should have the field that contains the owner marked to contain the Owner. Barcode Format Group found on the Facility, facility level, that the user is logged into, no additional fields need to be identified on the RF screen. Facility is known within the user’s session.
Returned Data Element	When the data is returned from the barcode parsing, it is copied to fields on the screen with a matching Data Element. If multiple fields on the RF screen have the same data element assigned, then the first blank field is filled in with the returned data. For example, if there are multiple License Plate fields on the screen, then the first blank field found is filled with the barcode data. If another barcode is scanned, then the next blank field is used. This process continues until all the License Plate fields are completed.
Parsing Expression	To identify this field as containing data that needs to be parsed, an expression can be entered and if evaluated to be true, the data entered is sent to the barcode parser when the user moves out of that field. This field is used for field-driven barcode parsing. It is not needed if the data has a unique identifier already.
Barcode Identifier To Add	If the parsing expression is evaluated to true and the data is going to be sent to the barcode parser, this barcode identifier is added to the front of the data string. Use this field to find the proper parsing rules in a barcode format group if the barcode does not have a symbology identifier that can be used.
Clear if Not Returned	For barcode parsing results, if this box is selected and the data element is not returned from the barcode parser, the field will be cleared.
Menu Color	This field changes the menu color on a menu screen. WebRF only
Border Color	This field changes the border color of the input field. WebRF only
Text Color	This field changes the text color for the field. WebRF only
Background Color	This field changes the background color for the field. WebRF only
Border	Enables the border on a field. WebRF only
Extensibility Name	This is the key name returned in a procedure call by the extensibility rule set. A screen with vector types (SEND/DISPLAY/RECEIVE) can be mapped with the extensibility rules. The data specified in the RECEIVE vector is also be added to the same-named DISPLAY field if the DISPLAY field is available in the SELECTOR screens.

Field Name

Identifier for the field.

The field is uniquely identified by the Vector Name and Field Name so a field name can also exist in another vector. When vectors are copied from one screen to another, data is only copied if the fields are named the same and are case sensitive.

Field Type

One of these defined field types:

TextView
EditText
EditText Choice
EditText Multi-Line
EditText Date

See “Field type properties” on page 45.

Vector Name

Vector field belongs to HEADER, FOOTER, SEND, RECEIVE, and DISPLAY. Vector Name and Field Name form a unique key to identify the field.

Vector Position

The sequence position of the field within the Vector.

SEND and RECEIVE fields must be ordered in a way that matches what is being received and sent by the backend procedures. The socket server sends data in a delimited text string and it assumes the field order matches that of the RF screen vector sequence.

Label Text

Display text of the Label field. Select a translatable label that can be displayed.

Label Row

Row number in which the label is displayed. This field is enabled for HEADER and FOOTER vectors since they are statically defined. For SEND and DISPLAY vector types, this field is automatically determined when fields are reordered in the Dynamic Order tab and based on the Label Orientation in the tab whether it is on the same line as the input field or on the line above an input field. Label Rows are not applicable to RECEIVE fields since they are not displayed.

Label Column

Column number in which the label starts. For TelnetRF, the font is fixed-width and the columns should match the character positions. Since WebRF uses a proportional-width font, the columns are approximated by taking the screen width and dividing by 20. Label Columns are not applicable to RECEIVE fields since they are not displayed.

Static Positions

Indicator that determines whether the position is Static and not calculated for CALCFIELDPOS routine.

Input Row

Row number in which the input field is displayed. For SEND and DISPLAY vector types, this is automatically determined when fields are reordered in the Dynamic Order tab and based on the Label Orientation in the tab whether it is on the same line as the input field or on the line above an input field. Input Rows are not applicable to RECEIVE fields since they are not displayed.

Input Column

Column number in which the input field starts. For TelnetRF, the font is fixed-width and the columns should match the character positions. Since WebRF uses a proportional-width font, the columns are approximated by taking the screen width and dividing by 20. Input Columns are not applicable to RECEIVE fields since they are not displayed.

Number of Lines

Defines the number of lines a multi-line field takes up on the screen. Fields that are longer than a single line should be setup as a multi-line field.

Mask

The mask allows for validation to be performed on the contents of the field. It is used to determine the length of the field on the RF screen. It can also be used with the Force Mask check box to validate a maximum length.

???????: All printable characters
@@@@@: Alpha, non-numeric
#######: Integers only
***********: Alphanumeric, letters and numbers
%%%%%: Floating point with decimals
{date}: Date field
{datetime}: Datetime format

Force Mask

Limits the data entry to no more than the specified number of symbols. Note that you can enter less but not more symbols.

Force Uppercase

This field shifts data into uppercase when it is committed by the screen.

Echo Character

This character is echoed to the screen instead of the actual value entered. For example this character is used when a password is typed into a screen and asterisks should be displayed on the screen.

Hint Text

A translatable label that is displayed in an input field to give a hint as to what the user should enter. Hint text is displayed in a light grey.

Visible Expression

This property controls whether a field is displayed to a user or not. The property can be set to 0 (zero) to hide the field or 1 to show the field.

The property can also be set to an Expression that is evaluated each time the screen is displayed. See “Expressions” on page 46.

Editable Expression

This property controls whether an input field is editable by the user. The property can be set to 0 (zero) to not allow input or 1 to allow input.

The property can also be set to an Expression that is evaluated each time the screen is displayed. See “Expressions” on page 46.

Required Expression

This property controls whether the user must input information before the screen can be committed. The property can be set to 1 to force user input or 0 (zero) for optional input.

The property can also be set to an Expression that is evaluated each time the screen is displayed. See “Expressions” on page 46.

Initial Value

Initial value of the input field.

The value of fields is not actually changed by displayed values until a screen is committed. This value can be used to change what is on the screen without affecting the underlying value of a field. Changing this value affects the underlying value of a field whether it is displayed or not.

Default Value

Default value of the displayed value of the field. See Edit State.

Edit State

Any time a screen with editable fields is drawn, this flag is used to determine how the data value stored in each field is drawn on the screen. Edit state does not change the data value of the field. For example, the edit state of initialize blanks does not mean that the data value stored for a field is going to get cleared, but that it is drawn on the screen with an empty value. Only after the RF operator navigates through all the fields and commits the screen do the values shown on the screen become the data values stored for the fields, editable fields only. These Edit State fields are valid:

Initialize Blank (conditionally): The value displayed on the screen is blank if the field is editable and visible
Initialize Default (conditionally): The value displayed on the screen is set to the Default Value if the field is editable and visible
Repeat Previous: The value displayed on the screen is the value retained from the previous screen
Initialize Default (always): The value displayed on the screen is set to the Default Value even if the field is hidden or not editable

Dynamic Default

To provide a default programmatically, select a procedure call to make and map fields to pass to the procedure call as input parameters. A single value should be returned from the procedure which is the value defaulted to the screen when it loads.

Lookup Screen

Adding a screen code activates the F2 key. When F2 is pressed, the user is navigated to that screen to lookup a single value that is returned to this screen field.

Choice Values

Choice values are the values to be entered in the field when a user picks from a Choice field. Note that these values are only used for Choice field types.

Choice Display

The Choice Displays are translatable labels to be used when a user picks from a Choice field. Note that Choice Displays are only used for Choice field types.

Choice Help

Enter a translatable label that contains the help text that the user should see in the footer when picking a value from a choice field. Note that Choice Help is only used for Choice field types.

This Field Contains

This field is used for barcode parsing. To find the Barcode Format group to use for parsing, fields on the RF screen should be identified with the data they contain.

These steps are used to determine the barcode format group. When a barcode format group is found, the rest of the steps are abandoned.

Only format record configured in the Barcode Configuration screen with that barcode identifier, no additional fields should be identified on the RF screen.

Barcode Format Group found on the Supplier, enterprise level, that was assigned to the PO: RF screen should have the field that contains the PO number marked to contain the PO Number.
Barcode Format Group found on the Owner, facility level, of that Shipment Order: RF screen should have the field that contains the Shipment Order number marked to contain the Order.
Barcode Format Group found on the Ship-From, enterprise level, of the ASN: RF screen should have the field that contains the ASN number marked to contain the ASN Number.
Barcode Format Group found on the Item, enterprise level, of the item: RF screen should have the fields that contain the item and owner marked to contain the Item and Owner, respectively.
Barcode Format Group found on the Owner, facility level, of the item: RF screen should have the field that contains the owner marked to contain the Owner.
Barcode Format Group found on the Facility, facility level, that the user is logged into, no additional fields need to be identified on the RF screen. Facility is known within the user’s session.

Returned Data Element

When the data is returned from the barcode parsing, it is copied to fields on the screen with a matching Data Element. If multiple fields on the RF screen have the same data element assigned, then the first blank field is filled in with the returned data. For example, if there are multiple License Plate fields on the screen, then the first blank field found is filled with the barcode data. If another barcode is scanned, then the next blank field is used. This process continues until all the License Plate fields are completed.

Parsing Expression

To identify this field as containing data that needs to be parsed, an expression can be entered and if evaluated to be true, the data entered is sent to the barcode parser when the user moves out of that field. This field is used for field-driven barcode parsing. It is not needed if the data has a unique identifier already.

Barcode Identifier To Add

If the parsing expression is evaluated to true and the data is going to be sent to the barcode parser, this barcode identifier is added to the front of the data string. Use this field to find the proper parsing rules in a barcode format group if the barcode does not have a symbology identifier that can be used.

Clear if Not Returned

For barcode parsing results, if this box is selected and the data element is not returned from the barcode parser, the field will be cleared.

Menu Color

This field changes the menu color on a menu screen. WebRF only

Border Color

This field changes the border color of the input field. WebRF only

Text Color

This field changes the text color for the field. WebRF only

Background Color

This field changes the background color for the field. WebRF only

Border

Enables the border on a field. WebRF only

Extensibility Name

This is the key name returned in a procedure call by the extensibility rule set. A screen with vector types (SEND/DISPLAY/RECEIVE) can be mapped with the extensibility rules. The data specified in the RECEIVE vector is also be added to the same-named DISPLAY field if the DISPLAY field is available in the SELECTOR screens.