Prompts

This section provides information about the fields used to configure prompts.

Prompt lines provide a way of capturing information at the POS terminal that is required to complete a transaction, or to execute a specific function during a transaction. Prompts are gathered into data forms which are triggered by POS functions. When triggered, they require some manner of intervention by the cashier before the transaction can continue or be completed. This intervention can be in the form of a response entered at the POS terminal, or the selection of a function or option. After a prompt is defined, it becomes accessible as an option for data form configuration in the Prompts list screen that lists all prompts in the system.

Note Note

ASCII Unicode can be entered using the /u_ _ _ _format for each character, where _ _ _ _ represents hex digits. For more information about formatting, Common Document Formatting Properties.

End of the note.

Information about your new prompt line includes the following:

General
Screen Element	Description
Prompt Line	The prompt words that you want to display to the cashier that is in the prompt area of the POS terminal, such as `Price`
User Instruction	Information on how to complete the prompt that is displayed in the instruction window of the POS terminal. For example, to clarify what the cashier must do at the Price prompt, enter `Enter a Price`
Confirmation Prompt	Confirms the data in a prompt with a predefined prompt, such as signature verification
Confirmation Response	Approves the prompt when the cashier selects a response
Failed Confirmation Action	Indicates confirmation failure. You can select from these options:Retry or Cancel function
Remote Display Form	Displays the name of the form in a single line on a remote form display device when the cashier types the name in the form
Display Receipt On Remote Display Form	Displays the receipt as a form on a remote display device
Data Type	Specifies the type of information, such as customer name and address information, transaction line data, and so on. The cashier can select an option from well-known and custom data types

Note Note

All data captured at a POS prompt is identified by data type and stored in the TLog, together with the rest of the information for that transaction.

End of the note.

For a complete list and description of all available predefined data types, see the Known Data Types section in the Technical Reference Guide.

Prompts
Screen Element	Description
Data Type Code	The data type code when the cashier selects a response
Use As Data Filler Key	Indicates that the prompt is a key to lookup for further data
Data Filler Timeout	A time-out value for the data filler key, is in seconds
If Pre-Populated	Enables some control over the response when an action is selected, automatically generated, or if the known type field has provided a response. The cashier can select from one of the following: Allow Modify, View Only, or No display
Prompt Only Once Per Transaction	Enables the prompt to appear only once during a transaction. The prompt is not displayed again later in the same transaction because the information that is gathered here the first time is reused
Access Attribute	Specifies if the data is viewable and modifiable
Default Value	The text or day that is displayed as an initial prompt value. You can select from these options from the text entry selection: User Defined, or Current Day

You can define the format for the data to be captured as follows:

Input Mask
Screen Element	Description
Minimum Length	The minimum length of the expected prompt response. For example, when a minimum value of one character is specified in this field, the cashier must enter something at the POS terminal. A value of zero in the minimum length field indicates that a response is optional Warning Text The warning text that you want to display when the Minimum Length requirement fails Note You can also specify a literal, defined in the `literal.properties` file. The literal is then translated into the text that you want to display. End of the note.
Skip Minimum Length Test On Empty Data	Ignores the minimum length until there is at least one character
Maximum Length	The maximum length of the required response to the prompt with a specified value
Format	The input format for the expected prompt response when you select a format
Regular Expression	The input format according to regular expression language
Hide Entry	Masks the characters being entered
Decimal Places	The position of an implied decimal place meant to represent a numeric value for the entered number. This parameter is used for prompts applied to an `HTML` page only and is required for order management when filling in the data form in the browser
Force Case	Forces data entry to either lowercase or uppercase when a prompt is activated at the POS terminal, and when you select the desired force case option
Date/ Time Separator	Specifies the separator character (that is, `/`) for date and time formats when the cashier enters a separator value
Strip Leading Zeros	Removes the zero characters from the beginning of entered text before any further processing
Capture Formatted Data	Sends the date and time prompt values to the server in a formatted string (instead of data with no formatting)
Minimum Value	The value and number of decimal places for numeric captured data when the cashier enters the format of the decimal value. For example, if you want the minimum value for a credit note amount to be 0.05, enter that amount in the Minimum Value field
Source Device	The device that produces the prompt response with the appropriate data source. You can select more than one device, from the following: Keyboard, Scanner, MSR, Menu, MICR, Remote Form, Signature Capture, or Scale. The POS terminal does not accept data from an unspecified device

You can define any validation rules that you want to apply to the captured data as follows:

Validation
Screen Element	Description
Validation Rule	Validates the prompt response after it is received
Choice List ID	Configures the prompt to be filled in from items in a choice list when the cashier selects a preferred choice list. If you want a prompt to be filled in only by a choice list, select Menu as the only source device

Parameters to retrieve data types and content based on prompts.

Derived Data
Screen Element	Description
Data Type	The pre-defined data type. For example, you can select from these options: address, account ID, bank number, and so on
Derivation Rule	A pre-defined rule that specifies how to obtain a new data type from original data
Function Authorization	When enabled, includes the data type in the generic function authorization request