The properties of the Input widget are:

Property

Description

Optionality

Default value

Obs.

Name

Name of the widget used in the screen scope.

Optional

When the widget is implicitly created by dragging an attribute or entity into an Edit Record, this property will be set by default to <entity_name>_<attribute_name>, for example Customer_Address.

In any other case it's empty by default.

Although optional, only named widgets are available in the scope of the web screen or web block. Only then can you use their runtime properties.

 

See rules for naming elements.

Variable

 

Variable that holds the end-user selection. This variable can be loaded with a default value set in the Preparation action.

You can type the name of the variable, use the Select Variable window, or select one of the variables displayed.

Mandatory

 

The data types that can be used are:

Text, Email, PhoneNumber, Integer, Long Integer, Decimal, Currency, DateTime, Date or Time.

 

The Date and DateTime types must follow the configurable format specified in the environment console for all the applications. When changing the format, re-publish the modules for the change to take effect.

 

The default format is yyyy-mm-dd (e.g. 2006-03-15)

Validation Parent

Allows you to bind an Input widget to a specific Edit Record widget.

You can select the Edit Record from a drop-down list of the Edit Record widgets currently placed in the screen or screen block.

Optional

When the Input widget is directly dragged into, for example, the EditRecord1 widget, or implicitly created by dragging an attribute or entity into EditRecord1, this property will be set by default to EditRecord1.

In any other case it's empty by default.

Use this property when you want to validate an Input widget together with the other inputs of, say, EditRecord1. This is achieved by setting the property Parent Edit Record of the Button or Link widget that triggers the validation to EditRecord1 as well.

 

Specifying this property will place the Input widget inside the Edit Record widget in the screen's Scope Tree.

Mandatory

Boolean expression that allows you to specify whether the end-user must provide a value to the variable associated with this widget.

You can directly type the values true or false, select a variable that handles this (if the variable is not of type Boolean, an error message is presented and the eSpace is not valid), or use the Expression editor.

Mandatory

When the Input widget is created by dragging an attribute or entity into an Edit Record, this property will be set accordingly with the attribute's Is Mandatory property.

In any other case it's False by default.

If this property is True, the Mandatory class is added to the  <input> HTML tag that corresponds to this widget. Learn more about how widgets are translated into HTML tags.

Null Value

Value assigned to the variable when the end-user either does not specify any value or types a value incompatible with the Variable data type.

Optional

 

 

You should use this property when you want to use a null value different from the one provided by Service Studio.

 

In some situations, the null values provided by default do not match your needs. This property allows you to customize the value used when the end-user leaves this input widget empty.

 

If this property is not specified, the default value for the data types is used.

Max. Length

Maximum number of characters that the input accepts.

Optional

When the Input widget is created by dragging an attribute or entity into an Edit Record, this property will be set accordingly with the attribute's Length property.

If no specified, the end-user can input an unlimited number of characters.

 

Width

Indicates the width of the widget. You can change the width by editing this property or by resizing it using the Grid in the Content Canvas.

Optional

3 col

The value of this property can be in columns, pixels, points, or percentage.

Text Lines

Height of the widget in lines.

Optional

1

If you want to have multiple lines, this value must be greater than 1.

Margin Left

Indicates the width of the left margin of the widget.

This value can be automatically set by the Grid.

Optional

Auto

The value of this property can be in pixels, points, or percentage.

 

If not defined and the widget style defines a margin-left then this margin is applied to the widget.

Margin Top

Indicates the height of the top margin of the widget.

This value can be automatically set by the Grid.

Optional

Auto

The value of this property can be in pixels or points.

 

If Auto is selected and the widget style defines a margin-top then this margin is applied to the widget.

Style

Drop-down list with the styles that can be applied to the input.

Optional

 

Learn more About Style Sheets.

 

Double-click on the property and the Style Sheet Editor is opened with the current style already selected.

Visible

When this property is false, the HTML page, generated at runtime, does not include the HTML tag that corresponds to this widget.

Mandatory

True

You can directly type the values true or false, select a variable that handles this (if the variable is not of type Boolean, an error message is presented and the module is not valid), or use the Expression editor.

Enabled

Allows you to specify whether the end-user can edit the value of the variable associated with this widget. When this property is set to false, the end-user can see and select, but not change, the value of the variable.

 

You can directly type the values true or false, select a variable that handles this (if the variable is not of type Boolean, an error message is presented and the module is not valid), or use the Expression editor.

Mandatory

True

You should not set this property to false for an input that is mandatory.

If this property is false, the readonly attribute is added to the <input> HTML tag that corresponds to this widget. Learn more about how widgets are translated into HTML tags.

Type

The type of input element for HTML5. It allows a better input control and extra functionality:

 

Text: the input allows any text;

Number: the input is used for numeric values;

 

Email: the input is used for email addresses;

 

Search: the input is used for search.

 

The way this property is used varies from browser to browser.

 

Text

 

Prompt

This is a grayed out text displayed inside the input widget with instructions or examples of what is expected to be typed in.

 

Once the end-user starts typing this prompt text disappears.

Optional

 

 

On Change

Grouped properties in the context of changing the value of the widget.

Property Description Optionality Default value

Obs.

Destination

A list of possible screen actions created for the current screen is displayed sorted by name. Simply choose one of them.

Optional

 

The screen action will be called using Ajax. Learn more about rich web screens using Ajax.

Destination Arguments

The list of arguments that corresponds to the input parameters of the screen action. The values of the parameters must be of the same type as the input parameters.

NA

NA

The argument is mandatory or optional, if the parameter in the destination screen is respectively mandatory or optional.

Extended Properties

Additional properties for attributes and/or events that implement specific behaviors of your widget.

Property Description Optionality Default value

Obs.

Name

Name of the attribute that the HTML element can accept as specified in the HTML language reference.

NA

 

This property is added to the <input> HTML tag that corresponds to this widget.

Learn more about Extending Properties and how widgets are translated into HTML tags.

Value

The value for the attribute.

NA

 

This property is added to the <input> HTML tag that corresponds to this widget.

Learn more about Extending Properties and how widgets are translated into HTML tags.

See Also

About Input Widget | Input Widget Runtime Properties