Two sessions

Two showings

Ensuring Compliance and Quality in the
Fast-Changing Automotive Manufacturing Sector

88% Reduction of production
issues in as little as
12 months
How Can We Help?
< All Topics
Print

What are the Textbox Widget Properties

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.

Properties

Click on the Text Box placed on the middle screen (Revolution device) to display the Properties in the right pane. 

Input Type

Input Type default value is Plain Text. Use the Input Type property in the right pane to allow specific input while filling out the workflow. For example, if you want to add a text box to your workflow for a phone number, you set the Input Type to ‘Phone.’ Note—Input Type options include Plain Text, Email, Numeric, Decimal, Address, Phone, etc.

Multiline

The multiline default value is No. Use the Multiline property in the right pane to allow input in the textbox to be constrained to one line or contain more than one line. For Example, if you Input Type selected is ‘Address’ in your workflow, you may use the ‘Multiline’ set to Yes as addresses contain more than one line. Note—Multiline options include No and Yes. 

Minimum Length & Maximum Length

The minimum Length default value is 0. The maximum Length (optional) default value is 1000. Use Minimum Length and 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). 

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. 

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.

Widget Layout

The widget Layout default value is Two Line. 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. 

Repopulate Value

Repopulate Value default 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. 

Choices

Choices (Default) is optional and default value is Empty. Use the Choices property and enter each choice on an individual line. The text field displays choice options to be selected as the input. Example—Don’t Know: 999, Refused: 998 displays the choices for selection as Don’t Know or Refused. The text field populates with 999 (Don’t Know) or 998 (Refused) based on choice selection. 

Workflow Script (On Value Edit)

A callback function, which is defined in the workflow script for that workflow, can be indicated in this property. The function gets triggered for every character change in the value of the text field, while the value is being edited in the app. This property helps validate or update the workflow values immediately as the text value is being updated.

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, Validity Conditions. Common properties appear at the bottom of the right pane labeled Common.

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.

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. 

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

Required

Required default value is No. Use the Required property to set 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.

Unique

Unique default 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.

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. 

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. 

Hidden

Hidden default 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.

Value Display Mode

Value Display Mode default value is Editable. Use the Value Display Mode to make the field editable or read-only on Workflow. Value Display Mode options are Edit and Read Only. 

Default Help Mode 

Default Help Mode default value is Collapse. 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.

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.’ 

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.”

Next What are the Choice List Widget Properties
Table of Contents