How to create a Radio Button in SAP ABAP Selection Screen: Step-by-Step Guide

When creating user-friendly SAP programs, one the most crucial UI elements you'll have to work on can be found in that of the radio button within SAP ABAP. When you're developing a simple report or an elaborate display of selections, radio buttons let users to make one choice from a variety of choices easily and quickly.

In this comprehensive step-by-step guide that will teach you all necessary to be aware of about: From how to define the radio button inside SAP ABAP and beyond, to grouping the buttons, defaulting them, hiding them and applying them to real-world examples of code. At the end of this guide, you'll be competent to create complete radio button screens in ABAP without hesitation.

1. What is the radio Button within SAP ABAP?

The radio button within SAP ABAP is a screen selection element that lets the user pick only one option out of an already defined group of mutually exclusive choices. If one radio button within the group is selected, all other radio buttons within the same group are subsequently removed.

Radio buttons within ABAP are defined with the PARAMETERS statement and an RADIOBUTTON Group as an additional. They are displayed on the screen of selection as toggle inputs in circular form that are familiar to all SAP user.

They are generally used when:

• The user has to select a method of processing (e.g. Make, Edit, or Display)
• You'd like to manage the logic of your program based on user's preferences
• A single mutually exclusive alternatives is appropriate at the time.

2. What is the right time to use radio Buttons on the Selection Screen?

Before you dive deep into code it's helpful to know what radio buttons are best option in comparison to dropdowns, checkboxes, or lists.

Make use of a radio button when:

• There are between 2 and five mutually exclusive options
• The exact same option must be picked
• The options are clearly visible side-by-side or stacked to make it easy to compare

Don't use the radio button if:

• Multiple selections are possible (use boxes instead of checkboxes)
• The options list is lengthy and constantly changing (use a dropdown or select-option)
• The selection isn't mandatory — radio buttons require a single selection

3. Radio Button Syntax in SAP ABAP

Radio button syntax in SAP ABAP. Radio button syntax used in SAP ABAP utilizes the PARAMETERS keyword, which is paired together with the RADIOBUTTON GROUP clause. The basic syntax is as follows:

PARAMETERS that are parameter names RADIOBUTTON GROUP grp_name. [DEFAULT 'X'] [USER-COMMAND cmd].

The most important parts that comprise the syntax:

• PARAMETERS -- defines the radio button to be screen parameters
• parameter_name — the name of the variable that contains its value ('X' if it is selected or space if it is not)
• RADIOBUTTON GROUP — assigns this button to a designated group
• grp_name is a four-character label for the group; each button of that same group can be mutually exclusive
• DEFAULT "X" -- indicates this button as being selected by default
• User-Command - triggers an PAI (Process After Input) event when the button is clicked

4. How do I Declare Radio Button in SAP ABAP

The declaration of radio buttons in SAP ABP is easy. Each option is declared as a distinct PARAMETERS statement and then assign these to the exact same group.

Here is the fundamental declaration model:

PARAMETERS: Create rb_create RADIOBUTTON GROUP RBG1 DEFAULT 'X' and change RADIOBUTTON GROUP RBG1, and rb_display RADIOBUTTON GROUP RBG1.

What does this mean:

• Three radio buttons are designated that are: Create, Change and Display.
• The three are all part of the group rbg1 which makes them mutually exclusive
• Rb_create is the default option (marked by DEFAULT 'X')
• At the time of running at the time of execution, only one of the three contain the value 'X' while the other three will be empty

5. Radio Button in SAP ABAP Selection Screen -- Step-by-Step Example

Let's take a look at a complete radio button SAP ABAP selecting screen implementation starting from beginning to end.

Step 1 Define the block of selection screen

SCREEN SELECTION BEGINNING BLOCK b1 With FRAME TEXT-001 as the title.
PARAMETERS: Rb_all TYPE C RADIOBUTTON GROUP, rg1 DEFAULT 'X', rb_open type c RADIOBUTTON GROUP Rg1, rb_close TYPE RADIOBUTTON GROUP Rg1.
SCREEN FOR SELECTION END OF BLOCK b1.

Step 2: Create descriptive labels using text on the screen.

To display relevant labels beside every radio button, specify those in the text elements (transaction SE38 Goto Text Elements -- Selection Texts):

• RB_ALL - All Orders
• RB_OPEN Open Orders Only For Open Orders Only
• RB_CLOSE -- For Closed orders only

Step 3: Read the radio button in START OF SELECTION

START-OF-SELECTION.
If rb_all = 'X'. Write 'Fetching each order...'.
ELSEIF the rb_open value is 'X'. Write 'Fetching open orders only...'.
ELSEIF the rb_close value is 'X'. Write 'Fetching close orders, only...'.
ENDIF.

How does it work:

• The radio button that is selected has the value 'X'
• The buttons that are not selected hold an empty space
• The block that checks the IF-ELSEIF block determines the active option and then executes the appropriate logic

6. Radio Button Group in SAP ABAP

A the radio button group of SAP's ABP can be described as the method that creates radio buttons that are mutually exclusive. Every radio button that has the same name with a group is linked. Clicking one will automatically de-select the other.

Rules for groups of radio buttons:

• The name of the group may be as long as 4 characters long
• Every button within a group must be identified with exactly the same RADIOBUTTON Group name.
• You can have several groups on the same screen. Buttons from different groups are separate from each other.
• Each group should be equipped with one button that has the DEFAULT 'X' to guarantee an already-selected state

Example -- Two distinct radio button groups that are displayed on the same screen:

SCREEN SELECTION BEGINNING BLOCK 1 with a FRAME TEXT-001 for the title.
" Group 1 Processing Mode
PARAMETERS: Rb_crt RADIOBUTTON Grp1 GROUP DEFAULT 'X', Rb_chg RADIOBUTTON Grp1 GROUP, the rb_dsp RADIOBUTTON Group grp1.
The SELECTION-SCREEN at the end of each block is.
SCREEN SELECTION BEGINNING OF BLOCK b2 with FRAME TITLE TEXT-002.
" Group 2 Output Format
Parameters such as rb_pdf RADIOBUTTON Group grp2 DEFAULT 'X', Rb_excel RADIOBUTTON GROUP grp2, Rb_email RADIOBUTTON Group grp2.
SCREEN TO END BLOCK.

In this case, choosing the rb_crt group is not a factor in the selection of rb_pdf The two groups are completely separate.

7. Configuring the Default Radio Button in SAP ABAP

Every radio button group has to be pre-selected to ensure that there is no selection when the screen loads for the first time. Select the default 'X' to select the parameters you want to pre-selected.

PARAMETERS: Rb_daily RADIOBUTTON GROUP rpt1 DEFAULT 'X', " Pre-selected rb_weekly RADIOBUTTON GROUP rpt1, Rb_monthly RADIOBUTTON GROUP RPT1.

It is important to note that One button in each group should be marked with the DEFAULT 'X'. If you apply it to multiple buttons within one group SAP applies it only to the one that was declared last which could cause unanticipated behaviors.

8. How to disable the The Radio Button inside SAP ABAP

There are instances when you're required to conceal the radio button within SAP ABAP automatically such as, for instance dependent on the person's role, authorization or prior choice.

This is accomplished by using this LOP AT SCREEN structure within the AT SELECTION-SCREEN output event.

Exemple -- Block the radio button 'Delete' for users who are not administrators:

A SELECTION-SCREEN OUTPUT.
LOOP at SCREEN.
If screen-name = 'RB_DELETE'.
screen-active = 0. " 0 = hidden, 1 = visible
MODIFY SCREEN.
ENDIF.
ENDLOOP.

It can also be made invisible and not selectable:

At the time of selecting, you will be able to output.
LOOP at SCREEN.
IF screen-name = 'RB_DELETE' OR screen-name = 'RB_DELETE_T'. " _T = text label
screen-active = 0.
MODIFY SCREEN.
ENDIF.
ENDLOOP.

To show/hide in a condition in response to an authorization check:

Data: lv_auth TYPE C.
AT SELECTION-SCREEN Output.
Z_CUSTOM AUTHORITY-CHECK ID 'ACTVT' FIELD '06'.
If sy-subrc > zero.
LOOP at SCREEN.
If screen-name = 'RB_DELETE'.
screen-active = 0.
MODIFY SCREEN.
ENDIF.
ENDLOOP.
ENDIF.

9. Utilizing Radio Buttons with AT SELECTION-SCREEN Event

One great feature for radio buttons their capability to trigger instant screen reactions whenever the user presses one without pressing the button to execute. This is accomplished by with the user command.

First step: add the USER-COMMAND in the declaration of radio buttons

PARAMETERS: Rb_simple RADIOBUTTON GROUP Md1 DEFAULT 'X' USER-COMMAND sel. advanced RADIOBUTTON GROUP md1 USER COMMAND SEL.

Second step: Perform the command using AT SELECTION-SCREEN

AT SELECTION-SCREEN.
CASE Sy-Ucomm.
If SEL is used,.
If rb_advanced is 'X'.
" Display more fields automatically
LOOP at SCREEN.
If screen-name = 'P_FILTER'.
screen-active = 1.
MODIFY SCREEN.
ENDIF.
ENDLOOP.
ELSE.
LOOP at SCREEN.
If screen-name = 'P_FILTER'.
screen-active = 0.
MODIFY SCREEN.
ENDIF.
ENDLOOP.
ENDIF.
ENDCASE.

This pattern allows you to create dynamic screens that when you click one of the radio buttons instantly displays the other field — it is a method that is extensively used by professionals in ABAP development.

10. Radio Button in SAP ABAP Example -- Real-World Scenario

This is an entire, real-world radio button from the SAP ABAP example — an example report that pulls sales orders based upon a user-selected processing mode.

REPORT z_radio_button_demo.
*----------------------------------------------------------------------*
* Selection Screen
*----------------------------------------------------------------------*
SELECTION-SCREEN BEGIN OF BLOCK b1 WITH FRAME TITLE TEXT-001.
PARAMETERS: rb_hdr type C RADIOBUTTON Group sg1 DEFAULT 'X', " The Header is the only item in rb_item type C RADIOBUTTON GROUP Sg1, " Header + Items both rb_both Types c RADIOBUTTON Group sg1. " Full detail
SELECTION-SCREEN END OF BLOCK b1.
SCREEN SELECTION BEGINNING OF BLOCK b2 WITH FRAME TEXT-002.
SELECT-OPTIONS: so_vbeln FOR vbak-vbeln.
The SELECTION-SCREEN at the end of block b2.
*----------------------------------------------------------------------*
* Main Processing
*----------------------------------------------------------------------*
START-OF-SELECTION.
If rb_hdr is 'X'.
" Fetch header data, only
SELECT Vbeln, Erdat, Auart FROM vbak AND INSERT INTO TABLE @DATA(lt_header) Where vbeln IS @so_vbeln.
LOOP at lt_header and then in DATA(ls_hdr).
WRITE: / ls_hdr-vbeln, ls_hdr-erdat, ls_hdr-auart.
ENDLOOP.
ELSEIF the rb_item is 'X'.
" Fetch header + items
SELECT vbak~vbeln, vbak~erdat, vbap~posnr, vbap~matnr FROM vbak INNER JOIN vbap ON vbak~vbeln = vbap~vbeln INTO TABLE @DATA(lt_items) WHERE vbak~vbeln IN @so_vbeln.
LOOP at the lt_items in DATA(ls_item).
WRITE: / ls_item-vbeln, ls_item-posnr, ls_item-matnr.
ENDLOOP.
ELSEIF that rb_both = 'X'.
Write: 'Fetching all details including prices...'.
" Include full detail logic here
ENDIF.

This example illustrates a clear and maintainable method of using radio buttons for controlling the program flow in the real SAP report.

11. Common Mistakes and Strategies to Avoid Making Them

Even experienced developers can encounter problems in the use of radio buttons. Here are some of the most frequently encountered problems:

• Forgetting the default 'X' When there isn't a default for a button and the screen for selecting appears with nothing selected. Set a default value to one button for each group.
• The use of an identical group's names across different options This makes all the buttons mutually exclusive, even though they shouldn't. Make use of separate group names to create distinct groupings that are logical.
• not hiding the text when concealing the button The text and the button are two separate elements on screen. To hide both, use the LOOP AT SCREEN to prevent orphaned labels appearing on screen.
• Verifying the values of radio buttons prior to START-OF-SELECTION — Radio button parameters can be only set if the user has confirmed the selection screen. Don't look them up in the beginning to determine processing logic.
• The declaration of more than one default 'X' within the same group — Only the first declared default will be in effect. Limit one default per group.

12. Best Methods to Use radio Buttons for SAP ABAP

Use these guidelines to write simple, easy to maintain radio button codes within SAP ABAP:

• Make sure to arrange radio buttons visually by using the SELECTION-SCREEN RIGHT BEGINNING of BLOCK with frame and a title
• Make sure to use meaningful group names of 4 characters that are reflective of the intent (e.g., MODE, OUTP, DATE)
• Always make sure to set one DEFAULT 'X' for each group to ensure that the screen does not load with an indeterminate state
• Make use of the command "USER-COMMAND" to trigger the screen to respond instantly to the user's input
• Limit the number of choices in each category between 2 to 5 — any more than that will be difficult to comprehend.
• Make selections with text through SE38 Text Elements for the radio button parameters to make sure that the labels are legible
• In the event of hiding radio buttons make sure to conceal both the field and the text element that is associated with it by using the LOOP at SCREEN
• Verify the radio button logic the AT SCREEN SELECTION instead of START-OF-SELECTION to allow for error handling that is early

13. Frequently Answered Questions