| # Form Fields (ttadv3501s000) Use this session to view the form fields. A form field can either be a table field or a non-table field. An example of a table field is tiitm001.item, where tiitm001 is the table and item is a field in that table. The form field domain is automatically filled in the current session based on the table field data. You can define a non-table field. To do this, you must have defined it in the program script that is linked to the session for which the form is used. This program variable must be defined with the keyword extern in the program script. The data type of the variable must be equal to the data type defined in the form. Field Name Specifies the name (code) of the form field. A form field can either be a table field or a non-table field. An example of a table field is tiitm001.item, where tiitm001 is the table, and item is a field in that table. The form field domain is automatically filled in the current session based on the table field data. You can also define a non-table field. To do this, you must have defined it in the program script that is linked to the session for which the form is used. This program variable must be defined with the keyword extern in the program script. The data type of the variable must be equal to the data type defined in the form. Element When the form field is part of an array, this field shows the element number. Domain The package code of the domain. Domain Specifies the domain code of the form field. When the form field is a table field, this field is taken from the table definitions and cannot be modified by the user. Domain Specifies the description of the domain. Domain Type Specifies the type of the domain. Field Type Specifies the type of the form field. Field Label1 Specifies the label(s) of the form field description. If you fill in a label description, it replaces the form field description. You must use labels instead of field descriptions, because the labels are translated. You can choose the related label on the form. You cannot modify this field, if the form field is table field and the form field description is the description of the table field. Enter the label code that you want to link to the form field. Field Descr. Specifies the description of the form field. Mandatory Input If this check box is selected, the input on this field is mandatory. If the field has the data type byte, integer, long, float, or double, mandatory input means that the value of the field must not be equal to 0. Mandatory input is an addition to the domain definition of the field. It has a higher priority than that defined at the range of the domain. The range message of the domain is given by the system, if a user leaves a field empty when input is mandatory. Example Field : Employee number (data type long)
Range | Mandatory input | Allowed range on the field
--- | --- | ---
$$ IN [0, 999999] | no | 0 - 999999
$$ IN [0, 999999] | yes | 1 - 999999
$$ IN [1, 999999] | no | 0 - 999999
$$ IN [1, 999999] | yes | 1 - 999999
Note You can only select or clear the Mandatory input check box for non-table fields. For table fields, the mandatory input is specified in the Table Fields (ttadv4122s000) session. Multi-Occurrence If this check box is selected, the form field is a multi-occurrence field. This field can only be filled when the form type is 2 or 3. Echo Field If this check box is selected, the value of the field must be shown on the form. If this check box is cleared, the value of the field is not shown on the form. This can be a useful option for accepting a password. Minimum Input Length specifies the minimum number of characters expected as input on the form field. According to Domain If this check box is selected, the number of digits before the decimal sign is linked to the domain definition. This is the case if the form field has the database type double or float. If the form field has another database type, the maximum display length is linked to the domain definition. According to Domain Specifies the maximum number of digits before the decimal sign if the form field is a float, or double. If the form field is of a different database type this field indicates the maximum display length of the field. According to Domain If this check box is selected, the number of digits after the decimal sign is linked to the domain definition. This is the case if the form field has database type double, or float. If the form field has database type, string this field indicates whether the maximum input length is linked to the domain definition. According to Domain Specifies the number of digits after the decimal sign if the form field is a float or double. If the form field is of database type, string this field indicates the maximum input length of the field. This length can be greater than the display length. According to Domain If this check box is selected, the display format is linked to the display format of the domain definition. This is the case if the next field will be filled with the display format of the domain. You cannot modify the display format. According to Domain According to Domain Zoom Specifies whether a session or a menu can be activated from this field. Zoom To Specifies the code of the session or menu that can be activated from the form field. Zoom Return Field Specifies the name of the field in the zoom process, whose value is returned to the field in the main process. Startpos.Str. When the form field is of type string, this field indicates the start position of the string in the form field (at display or input). Lang/Gen.Unit Exp. Specifies the language code. A date field can contain an expression. For example, with externally declared strings in the program script that defines the language for which the date must be displayed. If the form field is of type float or double a currency can be displayed on the field with the display format: %A<currency format>. This field can contain an expression that defines the currency code for which the amount is displayed. For example, US$. Example Your program script contains a statement: extern string curr(3) curr = US$ In the form field the Lang/Curr. Expr field can be filled in with curr. Note You can only access this field if the form field is of the type float, double, or date. Initial Value If this check box is selected, the form field has a default value. You can enter the default value in the next field. Type 1, 2, and 3 forms: The default value is shown only when a new record is added (insert mode). Type 4 forms: The default value is shown when you the user modifies the field, when the field is still empty, or by using the function SET.FIELDS.DEFAULT in your program script. Inp./Ref Expres. specifies the input condition that determines the condition for which input on the field is allowed. Examples: tiitm001.kitm <> tiitm.generic Input is only allowed if the value of the field tiitm001.kitm is unequal to tiitm.generic. price > 0 Input is only allowed when the value of the variable price is greater than 1 Input allowed 0 Input not allowed All functionality described in the section on expr.compile in the LN Programmer's Guide can be used. If the field is from a table other than the main table, and a reference exists between the tables, the reference field or path can be given. This is useful if the main table refers twice to the reference table. For example, if a production table refers twice to the item table and an item code is displayed it is not clear for which production table field the item must be displayed. In this field the field of the production table in question can be specified. If the reference path takes more than one step, the table fields can be specified separated by commas or colons. Example 1) tdsls000.item1 (reference field) 2) tdsls000.item2, tiitm001.item (reference path) Note Variables used on these fields must be declared with the keyword EXTERN in the program script. You can fill in attr.input with the value false, in the before.input section of the field in your program script. This changes the field to a display field. It overrules the input expression. Ch.without <CR> The characters specified here are accepted as single characters, without pressing the <Return> key. To define a control character, use the sign ^ followed by the character. Example <CTRL>[A] must be defined as [^A]. A no wait character does not affect the value of the field. The ASCII value of the entered character is put in the variable "in.ret". For example: <CTRL>[A] as a no wait character will fill in the variable in.ret with the value 1. You can use the variable in.ret in the on.input section of the field, to do any special action. Message Specifies the code of the message that is displayed on the bottom line of the screen when the cursor is on this field. Tech.Documentation If this check box is selected, technical documentation is available. |