Tag 050 - Check Boxes

Simplify supports a Check Boxes Message. The Request displays a screen with up to 100 check boxes and up to three lines of text. The customer can select one or more check boxes. A field in the Request (Required) determines whether the Enter key is accepted when no check box is selected. With the exception of the Tag value, the format of this request is identical to that for Tag 040.

One field in the Check Boxes Response (ActionButton) will indicate whether Enter or Cancel was pressed. If Enter was pressed, another field (Data) will indicate the check box(es) selected by the customer (if any).

Field 5001 Format

Request

Field NameLengthDescription
TTT3Tag (always = 050)
LLL3Length of the following data
Required1Data is required when ENTER is pressed (0=No, 1=Yes)
FS1Field separator (Hex 1C)
Title1Var.Title 1
FS1Field separator (Hex 1C)
Title2Var.text/field separator for Title 2
FS1
Title3Var.text/field separator for Title 3
FS1
Choice1Var.Choice 1
Field separator (Hex 1C)
FS1
Choice2Var.button text/field separator for Choice 2
FS1
Choice3Var.button text/field separator for Choice 3
FS1
Choice4Var.button text/field separator for Choice 4
FS1
Choice5Var.button text/field separator for Choice 5
FS1
Choice6Var.button text/field separator for Choice 6
FS1
.
Choice100Var.Choice 100

Response

Field NameLengthDescription
TTT3Tag (always = 050)
LLL3Length of the following data
ActionButton3If field 11 Completion Code = 000 (success), returns code for key pressed by customer:
777=Enter (green) key
888=Cancel (red) key
FS1Field separator (Hex 1C)
DataVar.If ActionButton = 777 (Enter), returns selected check boxes (if any).
Each check box is represented as either 0 (not selected) or 1 (selected).

Sample Message

Request

The following request tells Simplify to display the screen shown below:

API Field #, ValueDescription
0001,36Transaction Type
0011,14125050000User Data. See Field 11 (User Data).
5001,[see value below]Non-Financial Data
    050=Tag
    194=Length of data
    1= Data required when ENTER pressed
    Multiple selections=Title1
    Choice 190123456789(etc.)=Descriptor for check box 1 (etc.)

5001,0501941FSMultiple selectionsFSFSFSChoice 1901234567890123456789012345678901234567890FSChoice 2FSChoice 3FSChoice 4FSChoice 5FSChoice 6FSChoice 7FSChoice 8FSChoice 9FSChoice 10FSChoice 11FSChoice 12FSChoice 13

sample screen with seven check boxes

Response

API Field #, ValueDescription
0001,36Transaction Type
0011,14125050000?V102.18B01803User Data. See Field 11 (User Data).
5001,050017777FS10101000000000Non-Financial Data
    050=Tag
    017=Length of data
    777=Enter key pressed
    1010100000000=Check boxes 1, 3 and 5 selected