Field Properties

General

Use this tab to specify the form field's general data.

Note: You can only change a domain for a non-table field.

Field Type

The form field type.

This table shows the available options:


Option	Description
Label	The field is only used as a label on the form.
Display	Normal display field, input not allowed.
Input	Normal input field.
Display on Demand	Display is only possible on this form field if the LN 4GL function `display <field name>` is used in the program script.
Workflow Status Field	Special field type reserved for the ION Workflow integration. This type of field can only be generated through the Workflow Status Field command on the Insert menu. You cannot add such a field manually.

Input on a form field also depends on the input expression. A form field can be a temporary display field if attr.input is set to false in the before.input section of the field in your UI script.

Field Name

The name of the form field. You can use a table field or a non-table field. The domain and data type of the table field are automatically filled for a table field. A non-table field can only be used if it is defined in the UI script of the session for which the form is created. The program variable must be defined with the keyword extern. The domain of the variable must be equal to the domain defined in the form. A domain and its data type are not automatically filled for a non-table field. If you use a field without a domain, you can specify label.only.

Element

If the specified field is an array, it specifies the element number of the table field., Use the Multi Currency check box on the Miscellaneous tab to indicate that the field is a multi currency field. Do not specify -1 in the Element field as an element number to indicate that the field is a multi currency field.

Domain

The domain. You can select the domain manually, or zoom to the Browse domains dialog to make a selection.

Note: You cannot modify the domain of table fields.

Segmented

If this check box is selected, the field is a segmented field. A segmented field is logically divided into chunks called segments. This check box is read-only.

Initial Form Field Value

If the Form Field check box is selected, you can define an initial value in the field next to the Form Field check box for a new record. If the Form Field check box is cleared, the initial value of the table field is used. If the Form Field check box is cleared, and the field is not a table field, the value of the previous record is used if the end user creates a new record in the session.

Mandatory Input

If this check box is selected, input on this form field is mandatory at runtime.

Note:

If the data type of the form field is byte, integer, long, or float, the value of the field at runtime must not be 0, even if in the domain 0 is defined as a legal character.
If the table field is already mandatory, this check box is selected and cannot be cleared.

Linked Form Command

The form command that is linked to the field. This field shows the code of the object it executes. If no form command is linked to the field, the field is empty.

Field Sequence Number

The sequence number of the field. This is the number that is used when linking a form command to the field. Besides, the sequence number also determines the tab order.

UUID

The Universally Unique Identifier (UUID) of the field. The UUID uniquely identifies the field on the form and is used by the session personalization functionality in Web UI.

The UUID is generated automatically and cannot be changed.

Note: This field is only displayed if you use Enterprise Server 8.5.1 or later.

Label

Use this tab to specify the form field's label data.

If the appropriate check boxes are selected in the Session Properties, Group Properties, and Field Properties dialog boxes, the form field is displayed in a details session or an overview session.

If the field is an option set, the descriptions of the enumerates are used in the details session. On the overview session the field is displayed as a listbox.

Label

The label code. You can insert a label manually, or zoom to the Browse labels dialog.

Details

Position

The position of the label in relation to the field in the details session. This table shows the available options:


Option	Description
Before (right aligned)	The label and field are placed side by side. The label is right aligned.
Before	The label and field are placed side-by-side. The label is left aligned.
Above	You can only select this option for label-only fields. The label is positioned with the controls of other fields in the group.

Length

The length of the label in a details session or an overview session. The length of the label is used as a selection criterion. A label is selected within the reserved length. If no such label is found, the shortest possible label that is longer than the reserved length is selected. If the label's length is 0, the label is not displayed in a details session.

Height

The height of the label in a details session or in an overview session. If no label is found with the specified number of lines, a label with additional lines is used.

Overview

Link Label Length to Field Length: If this check box is selected, the length of the label is linked to the length of the form field in a grid.
Length: The length of the label in the grid of an overview session.
Note: The length of the label is used as a selection criterion. A label is selected within the reserved length. If no such label is found, the shortest possible label that is longer than the reserved length is selected. If the label's length is 0, the label is not displayed in the grid of an overview session. If the label's length is smaller than the width of the column, the column's width is used to select a label.
Height: The height of the label in the grid of an overview session.

Note: The height of the label is used as a selection criterion for a label. If no label is found with the specified number of lines, a label with additional lines is used.

Position

Use this tab to specify the form field's position on the form.

If the appropriate check boxes are selected in the Session Properties, Group Properties, and Field Properties dialog boxes, the form field is displayed in a details session or an overview session.

Details Session

If this check box is selected, the form field is displayed in the details session at runtime.

Overview Session

If this check box is selected, the form field is displayed in an overview session at runtime.

Note: A dependent child field can be removed at runtime without removing its parent field. For example, as a result of authorization limitations.

Allowed in Grid

If this check box is selected, the form field can be displayed in the grid. If this check box is cleared, the form field is not displayed in the grid.

View Field

If this check box is selected, the current form field is a view field displayed above the grid when an overview session is started. If the Dependent on Parent Field check box is selected, the View Field property is not relevant, because its value is the same as the value of its parent field. So a dependent field is displayed in the view, when its parent also is displayed in the view; otherwise the dependent field is displayed in the grid, when the overview session is started.

Occurrence Independent

Select this check box if the value of the current form field is not dependent on the actual occurrence. This only applies for view fields that are not part of the main table and are specified as a view field in the session editor.

Dependent on Parent Field

If this check box is selected, the current form field is dependent on another field. That other field can be a parent field or, if the parent is not a field, the field above the current form field. If the other field is displayed, the current form field is displayed behind or below the field, depending on the relation between the two fields.

Note: You can remove a dependent child field at runtime without removing its parent field. For example, as a result of authorization limitations.

Child Fields Behind

If this check box is selected, the child field is displayed immediately behind its parent field.

Note: If the child field is not positioned immediately behind the current field, the child field is aligned with other child fields in groups with the same alignment.

Behind Enum constant

If the parent of the current form field is an option set, specify the radio button behind which the field must appear.

Note: Do not use structures of more than one row behind an option set.

Hidden (Details)

If this check box is selected, the form field is invisible in the details session at runtime.

Users can make the field visible through the Personalize Form command.

Administrators can centrally maintain these personalizations through the Session Personalizations (ttadv9100m000) session.

Hidden (Overview)

If this check box is selected, the form field is invisible in an overview session at runtime.

Users can make the field visible through the Personalize Form command.

Administrators can centrally maintain these personalizations through the Session Personalizations (ttadv9100m000) session.

Display

Use this tab to specify form field's display data.

Minimum Input Length

The minimum number of characters that must be used for input on the form field.

Display Height

You can specify a display height in this field if the field has a domain of type text.

Data Alignment

Type or select the alignment of the data within a non-grid-field. In the grid, for numeric fields the field alignment is linked to the domain. The alignment of date fields is always linked to the display format. Other types of fields are always linked to the domain.

Maximum Input Length

The maximum number of characters that must be used for input on the form field.

According to Domain: If this check box is selected, the value is linked to the domain. To specify another value, clear this check box and specify a value in the field.

Maximum Display Length

The maximum number of characters that can be displayed in the form field.

According to Domain: If this check box is selected, the value is linked to the domain. To specify another value, clear this check box and specify a value in the field.

Display Format

You can specify a display format in this field.

According to Domain: If this check box is selected, the value is linked to the domain. To specify another value, clear this check box and specify a value in the field.

Miscellaneous

Use this tab to specify the form field's miscellaneous data.

Input/Reference Expression

The input condition or reference expression of the form field.

Input condition: The input condition determines the condition for which input on the input field is allowed. For example, if the input condition is price > 0, the input is only allowed if the value of the price variable is greater than 0.

Reference expression: The reference field or reference path can be used if a table field from a table other than the main table is used. This can be used if the main table refers twice to a reference table.

Examples:

tdsls000.item1 (reference field)
tdsls000.item2, tiitm001.item (reference path)

Note:

Declare the variables that are used on these fields with the keyword extern in the UI script.
You can also set attr.input to false in the before.input section of the field in your UI script.
The input changes the field into a display field and it overrules the input expression.

Language/Generic Unit Expression

This field has two functions:

If the data type of the form field is Date or String, the field can contain an expression that defines the language for which the date must be displayed.
If the form field has a display format %A <currency format> and the data type Double or Float, a currency can be displayed on the form field. This field can contain an expression that defines the currency code for which the amount is displayed.

Note: This field can only be used if the data type of the form field is Float, Double, Date, or UTC.

Start Position String

The start position of the string in the form field. You can only specify a start position for a form field with the String data type.

Message

The message code that is displayed on the bottom line of the dialog box. You can insert the message code manually, or zoom to the Browse messages dialog to make a selection

Echo Field

If this check box is selected, the value of the form field is displayed on the form.

Synchronized Field

If this check box is selected, the current form field's input on the client is synchronized with the server. Typically, in page mode, the client interacts with the server for each page to reduce network transactions. If necessary, you can use this option to ensure that the client interacts with the server for this field instead of waiting for the page's end.

Multiple Currency Field

If this check box is selected, you can use the form field for more than one currency, such as US$ or Euro. As a result, the element number is set to -1.

Zoom

Use this tab to specify the form field's zoom data.

Zoom

Specifies if the form field is a zoom field and, if so, where it zooms to.

These options are available:

No
Session
Menu

Zoom To

The menu or session code that can be activated from this form field. You can specify a menu or session manually, or zoom to the Browse menus dialog or to the Browse sessions dialog to make a selection.

If this field is filled with a session code, in Web UI auto-complete is enabled on the form field.

If the zoom functionality has been scripted, we recommend that you leave this field blank.

If auto-complete does not make much sense, because it will show a lot of entries that are actually not valid in the specific situation, you can switch auto-complete off for the form field by using the fields.autocomplete function.

Return Field

The name of the table field in the zoom process whose value is returned to the form field in the main process. You can specify a table field manually, or zoom to the Browse Table Fields dialog to make a selection.

Start Index of Zoom Session

If the current form field zooms to a session, you can specify in this field the index with which the zoom session starts.

Description Field

If a table field has a reference to another table, you can specify in this field which field from the reference table must be used as a search description. For example, for a form field that shows an item code, the user would like to type (part of) the description of that item instead of the code. In this field, you can specify the table field that contains that description.

In Web UI auto-complete also shows the description in the suggestion list. The look-up returns items that match by description, besides the ones that match by code.

Note: This option is only valid for (multibyte)string fields.

Appearance

Use this tab to specify how the form fields with data type Enumerate or String are displayed on the form.

Note: The data in this dialog box only applies to form fields that have a domain of data type Enumerate or String.

Enumerate

Check Box: If this option is selected, the form field with data type Enumerate is displayed as a check box. You can select this option if there are only two enumerate values in the domain of this field.
Constant value for 'Yes': If the form field is displayed as a check box, specify the value that represents the checked value.
List Box: If this option is selected, the form field with data type Enumerate is displayed as a list box.
Option Set: If this option is selected, the form field with data type Enumerate is displayed as an option set.
Automatic enable and disable children: If this check box is selected, and the parent field is an option set, the child fields of the parent field are automatically enabled and disabled when the option is selected or cleared.

String

Normal String

If this option is selected, the form field with data type String is displayed as a normal field.

List box

If this option is selected, the form field with data type String is displayed as a drop-down list box.

Combo box

If this option is selected, the form field with data type String is displayed as a drop-down combo box.

URL Area

If this option is selected, the form field with data type String is displayed as an embedded URL Area. The URL itself is defined by the 4GL application script and can be dynamically based on business functionality.

Note:

The URL area option is available for the form field type Display.
The URL area cannot be part of a grid. Within an Overview session the URL area is part of the view area, analogous to an Image field.
The display width and height of the URL area field must be defined to set the runtime dimensions. Default width: 40, height: 5.
To show the URL area on the form, you can use the get.bi.server.location() 4GL function to load the URL. For details, see the Infor ES Programmers Guide (Infor Customer Portal KB2924522).
Minimal requirements:
- Application VRC TIV level 2020
- LN UI version 11.2.2

Long

A form field with data type Long can be displayed as a normal field or as a color field. In a color field, users can select a color from a pre-configured palette.

Normal: If this option is selected, the form field is displayed as a normal field.
Color Field: If this option is selected, the form field is displayed as a color field. The selected color and its hex code are displayed in the trigger area.
Color Field (swatch only): If this option is selected, the form field is displayed as a color field. The selected color is displayed in the trigger area.

Duration (Days and Time)

If this option is selected, the form field is displayed as a time duration field, consisting of both a days and a time segment.

Note: This field is displayed if you use Enterprise Server 10.5.2 or later.

Duration (Time Only)

If this option is selected, the form field is displayed as a time duration field, consisting of only a time segment.

Note: This field is displayed if you use Enterprise Server 10.5.2 or later.