Purpose With RadioButton you can replace an input field with a series of radio buttons. Instead of having to enter a certain code, the user can simply click on one of the radio buttons. This will make the operation much easier for the untrained user and save time for the trained user.

Instead of a single field you can also specify up to 6 fields and values for one radio button. In this case clicking on the radio button means that each of these fields gets the corresponding value when you press the Enter button.

Please note: In addition, there is a RadioButton syntax if you work with InputScripts and internal variables; see InputAssistant Documentation RadioButton.

Example GuiXT
RadioButton (10,1) "Cash sale"      F[Order type] "CS"
RadioButton (11,1) "Internet order" F[Order type] "IO"
RadioButton (12,1) "Returns"        F[Order type] "RE"
del F[Order type]

A radio button with text "Cash sale" will appear at row 10, column 1. Clicking on the text or button is equivalent to entering the value "CS" in the field [Order type]. Similarly, when the system displays the screen with a value "CS" in the field [Order type], the radio button "Cash sale" is activated.

Format RadioButton (position) "Text next to radio button" [Input field] "Value"

RadioButton (position) "Text next to radio button" [F1] "V1" [F2] "V2" ...

Example with several fields GuiXT
RadioButton (10,50) "Foods" _ 
	F[Division] "05" F[Sales office] "0001"
RadioButton (11,50) "Cosmetics" _ 
    F[Division] "14" F[Sales office] "0002"
del F[Division]
del F[Sales office]
Tips
& Tricks
  • It is also possible to display radio buttons as well as the input field.
    This can be of value if you cannot foresee all possible values, but you know that a small subset of values is used in most cases. If the user then clicks on a radio button, the corresponding value will be substituted, but if he chooses to directly enter a value, he may do so. Should both actions be performed, the radio button choice takes precedence.
  • If the referenced field (F[Order type] in our example) contains a value which does not correspond to any radio button, no radio button will be activated. As a rule, you should not delete the reference field if you are not sure that you have covered all possible values within the radio button group.
  • Radiobuttons treat " " and "00" the same way. Capital/small letter writing is also ignored. The reason for that is that "00" is shown as " " in several SAP screens (variable between edit/show screens) and small letters are transformed into capital letters. By using option "==" in front of the value you can switch off this automatic feature, i.e.:
    GuiXT
    RadioButton (7,10) "Standard"        F[Discount] "== "
    RadioButton (7,35) "No discount"     F[Discount] "==00"
  • After an error message it might be that a certain subset of the input fields that you specified is changed to read-only by the SAP system. In this case some of your radio buttons are changed to read-only too. The exact condition is: The radio button state is changed to read-only if at least one of its fields is both read-only and its value is different from the value that you specified.
  • Tips&Tricks for beginners can be found in GuiXT Tutorial 3 Support data entry .
Components GuiXT