Text input

A text input control is employed when the user needs to provide textual information comprising letters and/or digits, either manually (via a keyboard) or with the assistance of a barcode scanner.

• Target Variable The name of the new variable where the entered text is stored.

• Prompt The label displayed above the text input field. For better readability, it's often preferable to utilize a Header text control when the user's task involves a single text input.

• Default Text The default text that will be entered when the user first encounters the control.

• Condition To Hide

  Specify the condition that must be fulfilled for the control to be hidden. If left unspecified, the control will remain visible in the user step. Note that when controls are hidden, empty variables will be generated unless default values or pre-defined data exist.

• Allow Empty Input If set to True, the user is permitted to proceed in the app without entering anything into the text field.

• Multiline If set to True, the text box will expand into a multi-line text editor allowing for line breaks.

• Force Uppercase If set to True, the content of the text input will automatically be translated into UPPERCASE before being stored in the target variable.

• Enable Text Correction If set to True, the text input will be enabled for spell-checking, word suggestions, and auto-correction, on host systems that support such features. Use this only for human language text fields (e.g., work order error descriptions).

• Trim Input Automatically If set to True, the contents of the text input will be trimmed (leading and trailing whitespace removed) before being stored in the target variable.

• Use Password Mask If set to True, the text entered will show up as bullets like in a password input field.

• Keyboard Type

  Set if the keyboard is to open as text or number or if the input value should be an e-mail or URL.

• Merge behavior

  The control behavior at reloading, see User step reloading.