Attributes

The FIELD element has the following attributes:

Table 1. Attributes of the FIELD Element
Attribute Name	Required	Default	Description
`LABEL`	No		A reference to an externalized string that should be used as the associated label for this field. The `LABEL` attribute is mandatory when a `CONNECT` element exists, that contains a `TARGET`.
`LABEL_ABBREVIATION`	No		A reference to an externalized string containing the associated label abbreviation text for this field. This label abbreviation is placed only on table headers in a `LIST`.
`DESCRIPTION`	No		A reference to an externalized string that is displayed below the label text.
`ALT_TEXT`	No		A reference to an externalized string that is used as the alternate text for the field. This is only applicable when the field has a target connection, i.e. it is an input field. If this attribute is added to a mandatory input field, the text "Mandatory" will be appended to the externalized string. If this attribute is not specified the `LABEL` is used. Browsers supported by the Cúram application display alternate text when the mouse is hovered over the input control.
`WIDTH`	No		Specifies the width of the field value within its cluster or list cell.
`WIDTH_UNITS`	No	`PERCENT`	The units in which the width is interpreted. This can be `PERCENT` to indicate the percentage of the space available to the field, or `CHARS` to indicate the number of visible characters the field should accommodate.
`HEIGHT`	No	`1`	For input fields that resolve to a text input control, this specifies the number of visible lines of text that the control will display. For input fields that resolve to a selection list, this specifies the number of entries that are initially displayed. i.e. a scrollable selection list is displayed instead of a drop-down selection list.
`ALIGNMENT`	No	`DEFAULT`	Defines the horizontal alignment of the field value. Can be set to `LEFT`, `RIGHT`, `CENTER`, or `DEFAULT`. The value `DEFAULT` corresponds to the CSS class `default` in curam_common.css. Currently the default is to be left aligned. In a `CLUSTER`, only input fields are aligned. In a `LIST`, all fields are aligned.
`USE_DEFAULT`	No	`true`	If set to `true` (the default) and the field has no `SOURCE` connection, then if a sensible default value for the field can be determined automatically, it will be displayed. For example, numeric fields will display a zero, string fields will be empty, date fields will default to the current date, etc.
`USE_BLANK`	No	`false`	If the field source is a code-table based property, or a server interface list property, it will be displayed in a list. If this attribute is set to `true`, an extra blank value will be added to the top of the list.
`CONTROL`	No	`DEFAULT`	The `CONTROL` attribute can take one of a number of values: `DEFAULT` : the field behaves in the standard fashion. `SUMMARY`, `DYNAMIC`, `DYNAMIC_FULL_TREE` and `FAILURE` : these settings only apply to rules fields. See Rules Trees for further details. `SKIP` : indicates that the field is only present to occupy space in a `CLUSTER` to balance the layout. No label or value will be displayed. The label background will still be presented, however. `TRANSFER_LIST` : Enables a list on a page to be displayed as a transfer list widget. This mode is only applicable and supported for list controls with multiple selection capability. `CT_HIERARCHY_HORIZONTAL` displays a list as a horizontal code table hierarchy. `CT_HIERARCHY_VERTICAL` displays a list as a vertical code table hierarchy. Consult the Cúram Server Developers Guide for more information on code table hierarchies.
`CONFIG`	No		Identifies configuration details for this `FIELD` instance. This attribute can only be used in conjunction with a `FIELD` whose `CONTROL` attribute is for a widget that supports configuration. For example, if the `CONTROL` attribute is `DYNAMIC` for a `FIELD` of the RESULT_TEXT domain then the `CONFIG` attribute should match an `ID` on a `config` element in the RulesDecisionConfig.xml file. See Dynamic Rules View for further details on configuration. `CT_DISPLAY_LABELS` : Displays labels for each code table in a code table hierarchy. See the `CONTROL` attribute in FIELD for further information regarding code table hierarchies.
`INITIAL_FOCUS`	No	`false`	A `FIELD` element whose `INITIAL_FOCUS` attribute is set to `true` will get focus when the page is displayed. In other words, the cursor will be placed in that field ready for data entry. If no `FIELD` requests the initial focus, the cursor will be placed in the first input field on the page. It is not allowed to have more than one `FIELD` with the `INITIAL_FOCUS` attribute set to `true` specified on a page.
`PROMPT`	No	`false`	The setting of this attribute will allow for prompt to appear in the text field if the text field is blank. On focus, the prompt will disappear to allow for data entry.