Visit Boris website Item Type - Text box entry of list item
From Add Item in Template Maintenance select the Text box entry of list item button shown here.

From Add Item in Template Maintenance select the Text box entry of list item button shown here.

Text box entry of list item allows the same choices of answer as a drop down list, but requires the user to type the response in rather then selecting from a list. An indicator icon initially shows as a red cross but when a valid entry has been typed in it will change to a green tick/check. This item is a useful alternative to a drop down list when there are many similar list entries and you want to ensure that the user is choosing the correct one.

 

Additional information associated with a list entry can be shown once a valid entry has been specified. For instance, if the user was entering a vehicle registration number then the vehicle make and model could be shown as confirmation. Or if they were entering a part number then the part description, manufacturer and unit type could be shown.

Unable to show how a Text box entry of list might look on a device.

Unable to show how a Text box entry of list might look on a device.

Main

Main screen for creating/amending a Text box entry of list item
Main screen for creating/amending a Text box entry of list item

Main screen for creating/amending a Text box entry of list item

*Question This is the text “label” that is specifying the information that needs to be entered or the question to be answered. Although this is not necessarily a question in all cases, Question is used as the general term to cover the text shown next to an input field. The text should be as short as possible whilst still being self-explanatory. Over-long questions take up a lot of space on PDA screens with their restricted size, so try and make them concise. This text should be an aid to help guide the user through the screen. Any more explanatory text can be made available as “Auditor’s notes” or “Full question text”.
Mandatory

Tick this box if the question is mandatory and leave it blank if it is optional.  This will depend on whether the answer to this question is critical to the data that is being collected, such as signature to confirm customer acceptance.

List name Select the name of the list that will supply the choices for the text entry. This list is created via in Setup and Maintenance.
Default value

Enter a value that will be inserted without the user doing anything e.g. '0' (zero) for quantity in a supplies list so that only significant entries need to be entered.

Formatting

Formatting options for a Text box entry of list item.
Formatting options that can be applied to a Text box entry of list item .

Formatting options that can be applied to a Text box entry of list item .

Full screen width?

This option is usually used in conjunction with multi-line text boxes, giving the user a full-width long text box in which to enter information. This value overrides any formatting set for the section.

Advanced

Advanced features of a Text box entry of list item.
Advanced features that can be applied to a Text box entry of list item.

Advanced features that can be applied to a Text box entry of list item.

'Attribute' name for customer-specific list

Use this option for cases where the list to be displayed depends on the customer. In such cases each customer will be configured with the name of “its” list. The list name is held as a customer “attribute” and it is this attribute name which should be entered here.

You may wish to have a different list to choose from depending on which customer the form is being completed for. For example, rather than having a list of all possible sub-contractors who work for a customer you may decide to have multiple lists, each containing just the sub-contractors for a given customer. Hence instead of one list called "Sub-contractors" you would have lists called "Sub-contractors for Customer A", "Sub-contractors for Customer B" etc. Then in the customer setup you would choose which sub-contractors list applies to that customer. This information would be held as an "attribute" of the customer.

On your template you may then have an item called "Sub-contractor" and you would specify the name of the attribute in this field in order to have the customer's own list of sub-contractors to appear as options.

Note that attributes can only be created by support staff.

'Attribute' name for location-specific list

Use this option for cases where the list to be displayed depends on the location. In such cases each location will be configured with the name of “its” list. The list name is held as a location “attribute” and it is this attribute name which should be entered here.

You may wish to have a different list to choose from depending on which location the form is being completed for. For example, suppose that you did work for some hospitals. Rather than having a list of all possible ward names you may decide to have multiple lists, each containing the wards for a given hospital. Hence instead of one list called "Wards" you would have lists called "Wards for Hospital A", "Wards for Hospital B" etc. Then in the location setup you would choose which ward list applies to that location/hospital. This information would be held as an "attribute" of the location.

On your template you may then have an item called "Ward" and you would specify the name of the attribute in this field in order to have the hospital's own list of wards to appear as options.

Note that attributes can only be created by support staff.

Item 'unique name' of parent in cascading list

Specify the unique name of the item which this list is dependent on.

Dependent lists can be set up to 'cascade' from one to another depending on which enttry has been chosen in its parent list.

A simple example of this would be vehicle. Suppose on your form you wished to select a vehicle model. One option would be to create a list called "Vehicle models" and populate this with every possible model of vehicle. This would involve a large range of choices and would be difficult for the end user to use. To make things easier you could create a whole set of lists: firstly "Vehicle manufacturers". This would contain Ford, VW and so on. Then you could have a second list, "Models - Ford" and this would contain all of the different models for that manufacturer. In the same way you'd also have "Models - VW" etc. Within the template you'd have two drop-down lists: Manufacturer (associated with "Vehicle manufacturers") and Model (associated with a list which depends on the answer to "Manufacturer"). In this case the Models item has a "parent" item which is the Manufacturers item.

Cascades can go through any number of levels that you want. Most lists don't have any cascades, some more complex ones could have two or three levels.

Search information for drop-down (advanced)

            

Here you can specify the information that's shown when a search is performed. For example, you could display both a product name and product description.

Auditor's notes

If you wish to offer the end-user guidance and direction on how to answer a question then use the Auditor’s notes field. This allows you to input any necessary text expanding on the basic question. For the end-user, the auditor’s notes are available via the “right click” option on the device – tap and hold the stylus on the question text.

Full question (for report)

The question text mentioned above should be framed in such a way as to indicate to the user the information that needs to be input. However, when this information is output on a report via the web site or a PDF additional wording may well be required. Use this field to phrase the original question in a way suitable for the report.

Cross Reference

This field is output on reports to cross-reference the information with any relevant legislation etc.

Don't keep previous result when part of a document lifecycle

Tick this box if you DO NOT wish data collected in this template item to be copied to any jobs created directly from the original form.  This is useful for a repeated task (such as booking in/out a rental item or repeated delivery) where the data remains the same but a sign-off is required so this box may be ticked for Date, Surname and Signature.  Please note that if a transformation option is applied to the newly created job, this setting may be over-ruled.

Show all choices on report

If you wish to have the capability of entering more than one “answer” to a question then you can use this field. If it is checked/ticked then a button will be displayed allowing further responses to be input. The text shown on this button can be specified (see below).
If the number of possible responses is unpredictable then this option is useful. However, it is often simpler to create, say, 3 pre-set items in which the user can enter their data.

Allow multiple results for this field?

If you wish to have the capability of entering more than one “answer” to a question then you can use this field. If it is checked/ticked then a button will be displayed allowing further responses to be input. The text shown on this button can be specified (see below).
If the number of possible responses is unpredictable then this option is useful. However, it is often simpler to create, say, 3 pre-set items in which the user can enter their data.

Text on button for adding additional results

This option is used in conjunction with “Allow multiple results for this field” and specifies the text shown on the button (for example, “Add response” or “Another value").

*Unique name

The unique name must be entered for each item and is a mandatory field. The name is used internally and so is not generally of importance. A default value is generated by the system automatically. You may wish to override this value to have a “nicer” name if the field concerned is part of a calculation or if you are exporting the data to another system.

Display conditions (advanced)

Display conditions for a Text box entry of list item.
Display conditions that can be applied to a Text box entry of list item.

Display conditions that can be applied to a Text box entry of list item.

Only show when the following condition is true (1) Enter a conditional statement that affects whether the input item is displayed on the device such as whether a previous answer has been yes or no.
Only show when the following condition is true (2) Enter a conditional statement that affects whether the input item is displayed on the device such as whether a previous answer has been yes or no.
Record results when section isn't displayed Tick this box if you wish results to be recorded when section isn't displayed.
See Also

 

 


Parts copyright 2014 Boris Software Ltd. Parts copyright 2014 Firetronic Software Ltd. Parts copyright 1998-2014 Cadence Computing Ltd. All Rights Reserved.

Menus, prompts, fields and options are from a typical installation - some items may not appear as shown. Please contact Boris support for information on additional features.