Tag 040 - Radio Buttons
Simplify supports a Radio Buttons Message. The Request displays a screen with radio buttons, up to three lines of text (Title fields). and an optional row of up to four virtual buttons on the bottom of the screen. The maximum number of characters in all radio button descriptors combined is 2034. The customer can select one radio button and/or one virtual button. A field in the Request (Required) determines whether the Enter key or a virtual button is accepted when no radio button is selected.
Title fields should be used in order, starting with Title1. If this is insufficient, Title2 should be used for the additional text, and if necessary Title3.
A virtual button will only be displayed/active if data is entered in the descriptor field (ButtonNDesc) for the button (N = E through H, from left to right). The field separator for each button descriptor must be present even if the field is null. Note that pressing the Enter key is not required after pressing a virtual button.
The following details are device-specific:
MX 915 – The maximum length of each radio button descriptor (Choice field) is 45. The maximum length of each Title field is 38. The maximum length of each virtual button descriptor is 9. The maximum number of radio buttons displayed on the screen is 9 if only Title1 is used and there are no virtual buttons. This maximum is reduced to 8 if Title2 is used and to 7 if all three Title fields are used. If any virtual buttons are present, these limits are reduced by 1.
MX 925 – The maximum length of each radio button descriptor (Choice field) is 47. The maximum length of each Title field is 40. The maximum length of each virtual button descriptor is 12. If there are no virtual buttons, the maximum number of radio buttons displayed on the screen is 9. If any virtual buttons are present, this maximum is reduced to 8.
One field in the Radio Buttons Response (ActionButton) will indicate whether Enter, Cancel or a virtual button was pressed. Another field (Data) indicates the radio button selected by the customer (if any). Note that the four virtual button positions on the bottom of the screen (positions E through H) return values of 5, 6, 7 and 8 (from left to right) in the Response.
Radio Buttons Message Format
Request
Field 5001
| Field Name | Length | Description |
|---|---|---|
| TTT | 3 | Tag (always = 040) |
| LLL | 3 | Length of the following data |
| Required | 1 | Data is required when ENTER or a virtual button is pressed (0=No, 1=Yes) |
| Title1 | 0-38 (MX915) 0-40 (MX925) | Title 1 |
| FS | 1 | Field separator (Hex 1C) |
| Title2 | 0-38 (MX915) 0-40 (MX925) | Title 2 |
| FS | 1 | Field separator (Hex 1C) |
| Title3 | 0-38 (MX915) 0-40 (MX925) | Title 3 |
| FS | 1 | Field separator (Hex 1C) |
| ButtonEDesc | 0-8 | Descriptor for first button position (from left) on bottom (E) |
| FS | 1 | Field separator (Hex 1C) |
| ButtonFDesc | 0-8 | Descriptor for second button position on bottom (F) |
| FS | 1 | Field separator (Hex 1C) |
| ButtonGDesc | 0-8 | Descriptor for third button position on bottom (G) |
| FS | 1 | Field separator (Hex 1C) |
| ButtonHDesc | 0-8 | Descriptor for fourth button position on bottom (H) |
| FS | 1 | Field separator (Hex 1C) |
| Choice1 | 0-45 (MX915) 0-47 (MX925) | radio button Text for Choice 1 |
| FS | 1 | Field Separator (Hex 1C) |
| Choice2 | 0-45 (MX915) 0-47 (MX925) | radio button Text for Choice 2 |
| FS | 1 | Field Separator (Hex 1C) |
| Choice3 | 0-45 (MX915) 0-47 (MX925) | radio button Text for Choice 3 |
| FS | 1 | Field Separator (Hex 1C) |
| Choice4 | 0-45 (MX915) 0-47 (MX925) | radio button Text for Choice 4 |
| FS | 1 | Field Separator (Hex 1C) |
| Choice5 | 0-45 (MX915) 0-47 (MX925) | radio button Text for Choice 5 |
| FS | 1 | Field Separator (Hex 1C) |
| … | … | … |
| ChoiceMax | 0-45 (MX915) 0-47 (MX925) | radio button text for last Choice |
Response
Field 5001
| 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: 5=Button E 6=Button F 7=Button G 8=Button H 777=Enter (green) key 888=Cancel (red) key |
| FS | 1 | Field separator (Hex 1C) |
| Data | var | If ActionButton = 777 (Enter) or 5, 6, 7 or 8 (virtual button), returns selected item using index of 1 to nn(= number of selections). |
Sample Radio Buttons Message
Request
The following request tells Simplify to display the screen shown below:
| API Field #, Value | Description |
|---|---|
| 0001,36 | Transaction Type |
| 0011,14125040000 | User Data. See Appendix F for the use of this field. |
| 5001,[see value below] | Non-Financial Data
|
5001,0401471FSSelect from one of the optionsFSFSFSButtonEFSButtonFFSButtonGFSButtonHFSChoice 1FSChoice 2FSChoice 3FSChoice 4FSChoice 5FSChoice 6FSChoice 7FSChoice 8FSChoice 9
Response
| API Field #, Value | Description |
|---|---|
| 0001,36 | Transaction Type |
| 0011,14125040000?V142.18.65_2.18.1 | User Data. See Appendix F for the use of this field. |
| 5001,040005777FS5 | Non-Financial Data
|