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).

Not supported on the iPP.

Radio Buttons Request Format

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 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
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

Radio Buttons Response Format

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:
777=Enter (green) key
888=Cancel (red) key
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 (Radio Buttons)

Request

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

API Field #, Value Description
0001,36 Transaction Type
0011,14125040000 User Data
5001,[see value below] Non-Financial Data
    040=Tag
    206=Length of data
    1= Data required when ENTER pressed
    Select from one of the options=Title1
    Choice 1901234567890(etc.)=Descriptor for radio button 1 (etc.)

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,14125040000?V102.18B01803 User Data
5001,040006777FS100 Non-Financial Data
    040=Tag
    006=Length of data
    777=Enter key pressed
    10=Radio button (Choice) 10 pressed