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). Not supported on the iPP.
Check Boxes Request Format
Field 5001
| Field Name | Length | Description |
|---|---|---|
| TTT | 3 | Tag (always = 050) |
| LLL | 3 | Length of the following data |
| Required | 1 | Data is required when ENTER is pressed (0=No, 1=Yes) |
| FS | 1 | Field separator (Hex 1C) |
| Title1 | 0-48 | Title 1 |
| FS | 1 | Field separator (Hex 1C) |
| Title2 | 0-48 | text for Title 2 |
| FS | 1 | Field separator (Hex 1C) |
| Title3 | 0-48 | text for Title 3 |
| FS | 1 | Field separator (Hex 1C) |
| Choice1 | 0-40 | Choice 1 Field separator (Hex 1C) |
| FS | 1 | Field separator (Hex 1C) |
| Choice2 | 0-40 | button text for Choice 2 |
| FS | 1 | Field separator (Hex 1C) |
| Choice3 | 0-40 | button text for Choice 3 |
| FS | 1 | Field separator (Hex 1C) |
| Choice4 | 0-40 | button text for Choice 4 |
| FS | 1 | Field separator (Hex 1C) |
| Choice5 | 0-40 | button text for Choice 5 |
| FS | 1 | Field separator (Hex 1C) |
| Choice6 | 0-40 | button text for Choice 6 |
| FS | 1 | Field separator (Hex 1C) |
| … | . | … |
| Choice100 | 0-40 | Choice 100 |
Check Boxes Response Format
Field 5001
| Field Name | Length | Description |
|---|---|---|
| TTT | 3 | Tag (always = 050) |
| LLL | 3 | Length of the following data |
| ActionButton | 3 | If field 11 Completion Code = 000 (success), returns code for key pressed by customer: 777=Enter (green) key 888=Cancel (red) key |
| FS | 1 | Field separator (Hex 1C) |
| Data | var | 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 (Check Boxes)
Request
The following request tells Simplify to display the screen shown below:
| API Field #, Value | Description |
|---|---|
| 0001,36 | Transaction Type |
| 0011,14125050000 | User Data |
| 5001,[see value below] | Non-Financial Data
|
5001,0501941FSMultiple selectionsFSFSFSChoice
1901234567890123456789012345678901234567890FSChoice 2FSChoice 3FSChoice 4FSChoice
5FSChoice 6FSChoice 7FSChoice 8FSChoice 9FSChoice 10FSChoice 11FSChoice 12FSChoice 13
Response
| API Field #, Value | Description |
|---|---|
| 0001,36 | Transaction Type |
| 0011,14125050000?V102.18B01803 | User Data |
| 5001,050017777FS10101000000000 | Non-Financial Data
|