Secure String Input

SecureApp-SecureString-Input.pngSecureApp-SecureString-Input.png

The Secure Text Input Web Control collects information from a user kept in a secure source. The client-side code cannot access this data. To retrieve the data, you must use the Secure Value Retrieval Data Operation and pass the SecureKey. The Secure Text Input is ideal for collecting sensitive user information like Social Security Numbers or Credit Card Information. Using this control prevents the front-end environment from having access to the value the user has entered.

General

Control Properties

Placeholder Text

Expects type text.

Text to be displayed in the text input until the user enters the box.

Aria Label

Expects type text.

Defines a value to the aria-label of the control for accessibility. For more information see here.

Advanced Control Properties

Maximum Length

Expects type number.

Determines the maximum number of characters that the input will allow.

Expiration Duration

Expects type number.

Determines for how long the secure string will be available. Options are:

  • Day(s)
  • Hour(s)
  • Day(s)

๐Ÿ“˜

Maximum configurable duration is 7 days.

Input Mode

Determines the mode of the keyboard for a mobile device.

  • text - (default) allows all text from a standard keyboard.
  • decimal - allows for numbers with decimals to be entered.
  • numeric- allows for numbers to be entered.
  • tel- for inputting telephone numbers.
  • search- for search inputs, the enter button the keyboard will change to "search"
  • email - for email addresses
  • URL - for entering a web URL.

Format

Determines how the text will be rendered. For example, selecting the date format and dd/mm/yyyy will cause the input to format a data as "04/04/2044."

Delimiter

Separates input values. When a user enters this character or sequence of characters, into the secure input, it will be ignored.

Prefix

Expects type string.

Sets a value that is displayed as a placeholder and is affixed to the beginning of the value. This value is stored as part of the input the user enters by default.

No Immediate Prefix

If checked, the prefix will not be a part of the input until the user enters a character into the input.

Raw Value Trim Prefix

If checked, the prefix will be trimmed from the value stored in the secure string output.

Right Icon

Displays the icon at the right of the input. Default is password-visibility. If another icon is chosen, the user won't be able to toggle between hidden and shown visibility.

AutoComplete

Determines the autocomplete mode for the input. Check out MDN for more details on what options are available.

Data Binding

Selected

Expects type text.

By default, a Variable of type Text is generated at the Web Page level to store the data from the input. Users can also edit the Data Binding property and create their own Variables.

Style and Layout

This control has styles for the following states:

Default - When first rendered without state
Focused - when the Checkbox is focused
Disabled - When the Checkbox is disabled

Check Common style properties of web controls for further details on how to style this Web Control.

Actions

On Blur

Triggers when the user leaves the input field. That is, when changing the focus from the field to some other part of the application.

Value Changed

Triggers when a character is added or removed from the Secure Text Input. Because the Secure String does not have a control value binding property, the event.value will contain the information needed to retrieve the text entered.

In order to retrieve the secureValueKey, set a variable on the Value Change action to

event.value

On Enter

Triggers when the user hits the enter or submit button at the end of the input.

Advanced

State

Is Visible

Expects type boolean.

If TRUE the control will be visible. If FALSE the control will not be displayed. If the field is empty, the control will be visible.

Is Disabled

Expects type boolean.

If TRUE the control will be disabled and the user will not be able to interact with the control. If FALSE the button will be enabled. If the field is empty, the control will be enabled.

Example

Insert a Secure Text Input. Map theย event.value to an activity variable. The Secure String Input can now collect a password to log into an app.

SecureApp-SecureString-Input.pngSecureApp-SecureString-Input.png