SAP FREE_SELECTIONS_INIT Function Module for Initialize dynamic selection: Declare permitted tables ...

Search SAP Function Modules

FREE_SELECTIONS_INIT is a standard free selections init SAP function module available within SAP R/3 or S/4 Hana systems, depending on your version and release level. It is used for Initialize dynamic selection: Declare permitted tables ... processing and below is the pattern details for this FM, showing its interface including any import and export parameters, exceptions etc. there is also a full "cut and paste" ABAP pattern code example, along with implementation ABAP coding, documentation and contribution comments specific to this or related objects.

See here to view full function module documentation and code listing for free selections init FM, simply by entering the name FREE_SELECTIONS_INIT into the relevant SAP transaction such as SE37 or SE38.

Function Group: SSEL
Program Name: SAPLSSEL
Main Program: SAPLSSEL
Appliation area: S
Release date: 26-Feb-1998
Mode(Normal, Remote etc): Normal Function Module
Update:

Function FREE_SELECTIONS_INIT pattern details

In-order to call this FM within your sap programs, simply using the below ABAP pattern details to trigger the function call...or see the full ABAP code listing at the end of this article. You can simply cut and paste this code into your ABAP progrom as it is, including variable declarations.

CALL FUNCTION 'FREE_SELECTIONS_INIT'"Initialize dynamic selection: Declare permitted tables ...
  EXPORTING
*  KIND = 'T' "Type of field list
*  EXPRESSIONS =  "Initial selections
*  FIELD_RANGES_INT =  "Initial Selections in Form of Ranges Tables
*  FIELD_GROUPS_KEY =  "Selection view key
*  RESTRICTION =  "Option restrictions of individual selections
*  ALV =  "Internal Use
*  CURR_QUAN_PROG = SY-CPROG "Program for fetching currency reference
*  CURR_QUAN_RELATION =  "Assignment quantity field -> currency key field.

 IMPORTING
   SELECTION_ID =  "Identification for FREE_SELECTIONS_DIALOG
   WHERE_CLAUSES =  "Selections in form of WHERE clauses
   EXPRESSIONS =  "Initial selections
   FIELD_RANGES =  "Selections in form of RANGES tables
   NUMBER_OF_ACTIVE_FIELDS =  "Number of fields with selections

TABLES
*  TABLES_TAB =  "Desired tables
*  ALV_QINFO =  "Internal Field
*  TABFIELDS_NOT_DISPLAY =  "Child T: Hide Fields
*  FIELDS_TAB =  "Preselect fields
*  FIELD_DESC =  "Description of non-Dictionary fields
*  FIELD_TEXTS =  "Own selection texts
*  EVENTS =  "Events for which control is required
*  EVENT_FIELDS =  "Fields for field-specific events
*  FIELDS_NOT_SELECTED =  "Kind F: Fields not initially selected
*  NO_INT_CHECK =  "Fields for which the interval check is to be deactivated

EXCEPTIONS
   FIELDS_INCOMPLETE = 1    INCONSISTENT_AREA = 10    KIND_F_NO_FIELDS_LEFT = 11    KIND_F_NO_FIELDS = 12    TOO_MANY_FIELDS = 13    DUP_FIELD = 14    FIELD_NO_TYPE = 15    FIELD_ILL_TYPE = 16    DUP_EVENT_FIELD = 17    NODE_NOT_IN_LDB = 18    AREA_NO_FIELD = 19    FIELDS_NO_JOIN = 2    FIELD_NOT_FOUND = 3    NO_TABLES = 4    TABLE_NOT_FOUND = 5    EXPRESSION_NOT_SUPPORTED = 6    INCORRECT_EXPRESSION = 7    ILLEGAL_KIND = 8    AREA_NOT_FOUND = 9 

.

IMPORTING Parameters details for FREE_SELECTIONS_INIT

KIND - Type of field list

Data type:
Default: 'T'
Optional: Yes
Call by Reference: No ( called with pass by value option)

EXPRESSIONS - Initial selections

Data type: RSDS_TEXPR
Optional: Yes
Call by Reference: No ( called with pass by value option)

FIELD_RANGES_INT - Initial Selections in Form of Ranges Tables

Data type: RSDS_TRANGE
Optional: Yes
Call by Reference: No ( called with pass by value option)

FIELD_GROUPS_KEY - Selection view key

Data type: RSDSQCAT
Optional: Yes
Call by Reference: No ( called with pass by value option)

RESTRICTION - Option restrictions of individual selections

Data type: SSCR_RESTRICT_DS
Optional: Yes
Call by Reference: No ( called with pass by value option)

ALV - Internal Use

Data type:
Optional: Yes
Call by Reference: No ( called with pass by value option)

CURR_QUAN_PROG - Program for fetching currency reference

Data type: SY-REPID
Default: SY-CPROG
Optional: Yes
Call by Reference: No ( called with pass by value option)

CURR_QUAN_RELATION - Assignment quantity field -> currency key field.

Data type: SSCR_CURR_QUAN_T
Optional: Yes
Call by Reference: No ( called with pass by value option)

EXPORTING Parameters details for FREE_SELECTIONS_INIT

SELECTION_ID - Identification for FREE_SELECTIONS_DIALOG

Data type: RSDYNSEL-SELID
Optional: No
Call by Reference: No ( called with pass by value option)

WHERE_CLAUSES - Selections in form of WHERE clauses

Data type: RSDS_TWHERE
Optional: No
Call by Reference: No ( called with pass by value option)

EXPRESSIONS - Initial selections

Data type: RSDS_TEXPR
Optional: No
Call by Reference: No ( called with pass by value option)

FIELD_RANGES - Selections in form of RANGES tables

Data type: RSDS_TRANGE
Optional: No
Call by Reference: No ( called with pass by value option)

NUMBER_OF_ACTIVE_FIELDS - Number of fields with selections

Data type: SY-TFILL
Optional: No
Call by Reference: No ( called with pass by value option)

TABLES Parameters details for FREE_SELECTIONS_INIT

TABLES_TAB - Desired tables

Data type: RSDSTABS
Optional: Yes
Call by Reference: No ( called with pass by value option)

ALV_QINFO - Internal Field

Data type: LVC_S_QINF
Optional: Yes
Call by Reference: Yes

TABFIELDS_NOT_DISPLAY - Child T: Hide Fields

Data type: RSDSFIELDS
Optional: Yes
Call by Reference: Yes

FIELDS_TAB - Preselect fields

Data type: RSDSFIELDS
Optional: Yes
Call by Reference: No ( called with pass by value option)

FIELD_DESC - Description of non-Dictionary fields

Data type: FLDCONVERT
Optional: Yes
Call by Reference: No ( called with pass by value option)

FIELD_TEXTS - Own selection texts

Data type: RSDSTEXTS
Optional: Yes
Call by Reference: No ( called with pass by value option)

EVENTS - Events for which control is required

Data type: RSDSEVENTS
Optional: Yes
Call by Reference: No ( called with pass by value option)

EVENT_FIELDS - Fields for field-specific events

Data type: RSDSEVFLDS
Optional: Yes
Call by Reference: No ( called with pass by value option)

FIELDS_NOT_SELECTED - Kind F: Fields not initially selected

Data type: RSDSFIELDS
Optional: Yes
Call by Reference: No ( called with pass by value option)

NO_INT_CHECK - Fields for which the interval check is to be deactivated

Data type: RSDSTABS
Optional: Yes
Call by Reference: Yes

EXCEPTIONS details

FIELDS_INCOMPLETE - Only PRIM_FNAME filled

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

INCONSISTENT_AREA - Inconsistent selection view

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

KIND_F_NO_FIELDS_LEFT - KIND = F, but no field left after cleanup

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

KIND_F_NO_FIELDS - KIND = F, but no field passed

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

TOO_MANY_FIELDS - Too many entries in FIELDS_TAB

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

DUP_FIELD - Field doubles in FIELDS_TAB

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

FIELD_NO_TYPE - No field type in the field description

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

FIELD_ILL_TYPE - Non-allowed field type

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

DUP_EVENT_FIELD - Field doubled in EVENT_FIELDS

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

NODE_NOT_IN_LDB - Node not part of logical database

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

AREA_NO_FIELD - Selection view has no fields

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

FIELDS_NO_JOIN - Field assignment without join

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

FIELD_NOT_FOUND - Dictionary field not found

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

NO_TABLES - Table P_TABLES is empty

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

TABLE_NOT_FOUND - A table from P_TABLES was not found

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

EXPRESSION_NOT_SUPPORTED - Expression not (yet) supported

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

INCORRECT_EXPRESSION - Incorrect logical expression

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

ILLEGAL_KIND - KIND not equal to T,G,F or: G without P_RSDSQCAT

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

AREA_NOT_FOUND - Invalid key FIELD_GROUPS_KEY

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

Copy and paste ABAP code example for FREE_SELECTIONS_INIT Function Module

The ABAP code below is a full code listing to execute function module POPUP_TO_CONFIRM including all data declarations. The code uses the original data declarations rather than the latest in-line data DECLARATION SYNTAX but I have included an ABAP code snippet at the end to show how declarations would look using the newer method of declaring data variables on the fly. This will allow you to compare and fully understand the new inline method. Please note some of the newer syntax such as the @DATA is not available until a later 4.70 service pack (SP8), which i why i have stuck to the origianl for this example.

ABAP code using 7.40 inline data declarations to call FM FREE_SELECTIONS_INIT

The below ABAP code uses the newer in-line data declarations. This allows you to see the coding differences/benefits of the later inline syntax. Please note some of the newer syntax below, such as the @DATA is not available until 4.70 EHP 8.

Search for further information about these or an SAP related objects