How Can We Help?
< All Topics
Print

What are the Textbox Widget Properties

What is a Text Box Widget

If you want your workflow to contain text, drag (left pane) the Text Box widget to the middle pane and drop it. Use the Text Box widget in your workflow for plain text, address, phone number, e-mail address, description, numeric, etc. Workflows can contain more than one Text Box widget.

What are Text Box Properties?


1. Multiline

The default toggle value for multiline is set to “No.” You can utilize the Multiline property in the right pane to determine whether input in the textbox should be restricted to a single line or can encompass multiple lines. For instance, if the chosen Input Type is ‘Address’ in your workflow, it is advisable to set ‘Multiline’ to ‘Yes’ since addresses typically consist of more than one line. It is important to note that the Multiline options are limited to ‘No’ and ‘Yes.’

Tooltip: Enable this option to allow multiple lines of text in the field, creating a text area instead of a single-line input.

 

2. Minimum Length

The minimum Length default value is 0. Use the Minimum Length property to set the character limit of the Text Box. Note: It is not required to specify both minimum and maximum conditions together. For example, the character limit for input type Address can be between a minimum of 10 and a maximum of 100. You can set the Maximum Length to 100 only (leaving the minimum at 0). 

Tooltip: Specify the minimum number of characters required for the input in this field.

 

 

3. Maximum Length

The maximum Length (optional) default value is 1000. Use the Maximum Length property to set the character limit of the Text Box. Note: It is not required to specify both minimum and maximum conditions together. For example, the character limit for input type Address can be between a minimum of 10 and a maximum of 100. You can set the Maximum Length to 100 only (leaving the minimum at 0). 

Tooltip: Define the maximum character limit for the input. Leave it optional if there’s no specific restriction.

 

 

4. Case

Case (optional) default value is Empty. Use the Case property to convert your text input to a specified format if required. For example, if you want input text to be converted to capitals select Case “Capital” from the drop-down list. Note: Case options include Capital, Small, or Title. 

Tooltip: Set the text case, such as uppercase, lowercase, or title case. Leave it optional for default case usage.

 

 

 

5. Default Text

Default Text (optional) default value is Empty. Use the Default Text property to add default text for a particular placeholder of the text box. For example, Input Type is set to Email. Set the Default Text “@gmail.com”. This saves time for the user—they add the initial part as @gmail.com already exists in the field.

Tooltip: Provide default text that appears in the field, guiding users on the expected input.

 

 

 

6. 1-Line Layout

The widget 1-Line Layout default toggle value is No. Use the Widget Layout property to set to name (label) and value to a single line or two lines. Example—Two Line layout displays the widget name (label) on one line and the value (to be filled in) on a second line. The one-Line layout displays the widget name (label) and the value to be filled in on a single line. 

Tooltip: Opt for a single-line layout for the field, limiting input to one line of text.

 

 

7. Repopulate Value

Repopulate Value default toggle value is No. Use the Repopulate Value property to automatically repopulate (ditto) the previously submitted value. Example—Yes will remember the previously entered value and automatically populate the field every time a new Workflow is opened for data collection (user can manually change and this will become the new repopulate value); No will display the field blank every time a new Workflow is opened for data collection. 

Tooltip: Enable this option to automatically fill the field with its previous value, aiding in data retention and user experience.

 

 

Textbox Widget Common Properties

Many widgets have common properties. Examples are Label, Font Size, Place Holder, Required, Unique, Unique Identifier, On Value Change, Hidden, Value Display Mode, Default Help Mode, Increase Indent By, Visibility Conditions, and Validity Conditions. Common properties appear at the bottom of the right pane labeled Common.

1. Label (Default)

Label default value is the name of the widget; i.e. Textbox. Select the Textbox widget. The right pane (Common) displays Label (Default)—Textbox. Click on Textbox and delete value. Type new value; i.e. AUDITOR. The Label value will display AUDITOR on the Workflow Revolution device and in the right pane Label. Optional—click on Textbox label on Revolution device and edit the Label.

Tooltip: This field represents the default label or name for the corresponding item. Enter the text that you want to display as the label.

 

 

 

 

2. Font Size

Font Size default value is Medium. Use the Font Size property to set the font size. Example—use the drop down list property to set font size to Small. Font size small will display textbox label, text instructions (Tap here to enter), and the input value small. Note—Font Size options include Small, Medium (default) and Large. 

Tooltip: Specify the size of the font used for the field.

 

 

 

 

 

3. Place Holder

Place Holder default value for text box is ‘Tap here to enter’. The instruction tells the user to tap here to bring up the keypad to enter data. Place Holder property allows the user to customize their placeholder. Example—Click here to enter data

Tooltip: Provide a placeholder text that appears in the field to guide users on the expected input. This field is optional.

 

 

 

 

 

4. Required

The Required default toggle value is Yes. Use the Required property to toggle to Yes (required) or No (not required). Example—Text Box with Input Type Address may be required and a Text Box with Input Type Phone may not be required (mandatory) when completing the Workflow. Note—A Required field(s) will display a red asterisk (*) on the Workflow Input field on device.

Tooltip: Toggle this field if user input is mandatory. Users won’t be able to proceed unless they fill in this field.

 

 

 

 

5. Unique

Unique default toggle value is No. Use the Unique property to indicate if only unique values are to be accepted by the user for this field. When submitting the workflow having a unique field, if any previous submission exists with the same value for the unique field, the data submission is prevented with “Data sync failed” message and includes Input Label and Value that already exists. Example—Data sync failed. The FIRST NAME in DENISE already exists.  CANCEL and RETRY are your options. Click CANCEL. Select Draft data and click in duplicate field and edit the value. The record can be resubmitted with a new (unique) value.

Tooltip: Toggle yes to this option if the field’s content must be distinct and not repeated among entries.

 

 

 

6. Unique Identifier

Unique Identifier property is for reference purposes only. The user does NOT need to do anything with this property. Every field requires a Unique Identifier. This defaults to the widget name; i.e., Textbox, Textbox 2, Choice List, Choice List 2, etc. No two unique identifies will be the same. 

Example—If you have created field ‘Address’ and setting a visibility condition to say the ‘Address’ field will be visible only if you have entered the ‘Phone Number’. If there are two fields that say ‘Phone Number’—it will be difficult to set a visibility condition since both the fields have the same name. Both these fields ‘Phone Number’ will have different unique identifiers. You can check the Unique Identifier and then set the condition accordingly. 

Tooltip: Indicate if this field serves as a unique identifier, ensuring each entry is distinct and easily identifiable.

 

 

 

7. Auto Advance

Auto Advance default toggle value is No. If Auto Advance is toggled to Yes, after inputting a value for this widget, you will automatically be focused on the next Widget.

Tooltip: Enable this feature to automatically shift focus to the next field after entering a value in this one.

 

 

 

 

 

8. Custom ID

Custom ID default toggle value is No. This is application specific ID for using in form scripts and reporting.

Tooltip: Specify a unique identification code for this field, commonly used in scripting or backend processes.

 

 

 

 

 

9. On Value Change

On Value Change default value is Empty. Use the On Value Change property to set up the callback function for change in the field’s value. The function must be defined in the Workflow Script for the Workflow. 

Tooltip: Define actions or scripts triggered when the value in this field is modified.

 

 

 

 

 

10. Hidden

Hidden default toggle value is No. Use the Hidden property to make the field hidden from the end user in the Workflow. Example—this feature can be used when a fields value is getting set from a source other than user input, such as by a default value, by repopulating the field or from the Workflow Script. Hidden options are No (default) or Yes.

Tooltip: Hide this field from view during data entry to streamline the user interface.

 

 

 

 

 

11. Read-Only

Read-Only default toggle value is No. Use the Read-Only to make the field editable or read-only on Workflow. 

Tooltip: Make the field’s value uneditable, allowing it to be viewed but not modified.

 

 

 

 

 

 

12. Help Expanded 

Help Expanded default toggle value is No. Hover over and click on the blue question mark icon of the selected widget; i.e. Textbox in the middle pane. Help Content dialog displays. Type in Help Content; i.e., Red asterisk displays when a field is required. Click Save—upper right corner to save and close Help Content dialog. Example—shown below.

Revolution device will display an informational icon when Help Content is available.  On the Revolution device, press the informational icon to display Help Content. Press OK to close the Help Content dialog. Example—shown below.

      On the Revolution device, press the informational icon to display Help Content. Press OK to close the Help Content dialog. Example—shown below.

13. Increase Indent by

Increase Indent by default value is 0. Enter count by which you want the widget’s indent increased.

Tooltip: Specify the number by which you want to increase the field’s indentation, enhancing visual organization and structure.

 

 

 

 

 

14. Validity Conditions

Validity Conditions default value is condition not specified. Validity Condition is the property used to specify a visibility condition. If you apply a visibility condition, it implies that the field will only be visible if it satisfies the condition you have set.  Visibility condition can be set by specifying the condition – you can do that by clicking ‘condition not specified.’ 

 

 

 

15. Visibility Conditions

Visibility Condition in the property for the text box is used to specify a condition. If you apply any visibility condition, it implies that the text box will only be visible if it satisfies the condition that you have set. Visibility condition can be set by specifying the condition – you can do that by clicking ‘condition not specified.’ For example, you might create a text box ‘Describe Your Last Job’, which will be only visible if the user enters ‘Yes’ in the earlier field ‘Have you got job experience?’ Otherwise, it would be invalid and show an error message.

Add a new Visibility Condition:

Set up the condition by selecting the fields and their expected values to make the current field visible: 

 Set up the condition by selecting the fields and their expected values to make the current field visible:

Validations can help you control the type of input during the filling of a workflow by the user. You can also customize an error message that you want to display by typing the message in ‘Validity Error Message.’ This message will be displayed when the validity condition does not match with the given input. You can write an error message that could be “This field is for experienced people only.”

Table of Contents