Initializing help system before first use

vdl-field

Represents an input field in a form. The input type is derived from the data type of the entity but can be overridden via the "type" attribute. Validation is performed on initialization and on value change and the input is highlighted with a red border when validation fails.

Example

<vdl-form>
  <vdl-field entity="MY_BOOLEAN"></vdl-field>
</vdl-form>

Attributes

checked-value For checkboxes, the value to use to indicate it should be checked.
enabled A boolean expression or a string ("true"/"false") which indicates whether the field is enabled. accepts expression
entity Model entity to bind to. Either this or the "parameter" attribute must be specified.
indices The index tuple to use if the entity bound to this field is an array. accepts expression
inline Whether to use inline layout for the field.
label Custom label for the input. If not specified then the entity alias or parameter name will be used. accepts expression
label-size The number of column units for the label.
options An expression that results in an array of values to use for the select options or a map object of values (in the form [{value: 'underlying_value', label: 'Display Text'}]) to display text. This will transform the input into a select box. requires expression
options-include-empty Allow a string entity to be cleared or an array element to be removed using the select input. Setting this to true will add a blank item to the top of the select list. Can only be used on a string entity, an array entity or a parameter. Cannot be used on a radio input type.
options-set Name of a set entity from the model to use for select options. This will transform the input into a select box.
parameter Model parameter to bind to. Either this or the "entity" attribute must be specified.
post-save An expression or a function, which is executed after a successful save.It can return a boolean or a promise, which can then resolved or rejected. If a promise is rejected, it will display an error with a rejection message.
Variable Type Description
oldValue string The old value before save
newValue string The saved value
entityName string The name of the entity modified
indices Array.<(string|boolean|number)> Data for the index columns of the row
requires expression
pre-save An expression or a function, which is used to determine whether to save or not new value. Can return a truthy value or a Promise, which can be resolved with a truthy value or can be rejected with an error message and error name
Variable Type Description
oldValue string The old value before save
newValue string The new value to save
entityName string The name of the entity to be modified
indices Array.<(string|boolean|number)> Data for the index columns of the row
requires expression
pre-save-error-message A string or an expression, which is used to display an error message, when pre-save fails. If pre-save returns a rejected promise, it will use rejection message instead accepts expression
scenario Scenario id/index of this field accepts expression
size The number of column units for the input element.
type Specify an alternative HTML input type, for example: radio, textarea, range
unchecked-value For checkboxes, the value to use to indicate it should be unchecked.
Parent Topic VDL 4.6 Reference

© 2001-2020 Fair Isaac Corporation. All rights reserved. This documentation is the property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except solely for internal evaluation purposes to determine whether to purchase a license to the software described in this documentation, or as otherwise set forth in a written software license agreement between you and FICO (or a FICO affiliate). Use of this documentation and the software described in it must conform strictly to the foregoing permitted uses, and no other use is permitted.