Tag 040 - Radio Buttons
Simplify supports a Radio Buttons Message. The Request displays a screen with up to 100 radio buttons and up to three lines of text. The customer can select one radio button. A field in the Request (Required) determines whether the Enter key is accepted when no radio button is selected.
One field in the Radio Buttons Response (ActionButton) will indicate whether Enter or Cancel was pressed. If the customer presses the Enter key, another field (Data) indicates the radio button selected by the customer (if any).
Field 5001 Format
Request
| Field Name | Length | Description |
|---|---|---|
| TTT | 3 | Tag (always = 040) |
| 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 | Var. | Title 1 |
| FS | 1 | Field separator (Hex 1C) |
| Title2 | Var. | text/field separator for Title 2 |
| FS | 1 | |
| Title3 | Var. | text/field separator for Title 3 |
| FS | 1 | |
| Choice1 | Var. | Choice 1 |
| FS | 1 | Field separator (Hex 1C) |
| Choice2 | Var. | button text/field separator for Choice 2 |
| FS | 1 | |
| Choice3 | Var. | button text/field separator for Choice 3 |
| FS | 1 | |
| Choice4 | Var. | button text/field separator for Choice 4 |
| FS | 1 | |
| Choice5 | Var. | button text/field separator for Choice 5 |
| FS | 1 | |
| Choice6 | Var. | button text/field separator for Choice 6 |
| FS | 1 | |
| (etc.) | (etc.) | |
| Choice100 | Var. | Choice 100 |
Response
| Field Name | Length | Description |
|---|---|---|
| TTT | 3 | Tag (always = 040) |
| LLL | 3 | Length of the following data |
| ActionButton | 3 | If field 11 Completion Code = 000 (success), returns code for key pressed by customer:
|
| FS | 1 | Field separator (Hex 1C) |
| Data | Var. | If ActionButton = 777 (Enter), returns selected item using index of 1 to nn(= number of selections). |
Sample Message
Request
The following request tells Simplify to display the screen shown below:
| API Field #, Value | Description |
|---|---|
| 0001,36 | Transaction Type |
| 0011,xxx.. | User Data. See Simplify-Controlled Field Definitions. |
| 5001,[see value below] | Non-Financial Data
|
5001,0402061FSSelect from one of the optionsFSFSFSChoice 1901234567890123456789012345678901234567890FSChoice 2FSChoice 3FSChoice 4FSChoice 5FSChoice 6FSChoice 7FSChoice 8FSChoice 9FSChoice 10FSChoice 11FSChoice 12FSChoice 13
Response
| API Field #, Value | Description |
|---|---|
| 0001,36 | Transaction Type |
| 0011,xxx.. | User Data. See Simplify-Controlled Field Definitions. |
| 5001,040006777FS100 | Non-Financial Data
|
| 5002,80378002 | Device serial number (if present) |