Scribd
Upload
608 views4 pages

Free Selections Dialog

This document describes the FREE_SELECTIONS_DIALOG function module in ABAP, which displays a dialog screen for users to enter dynamic selection criteria for database queries. The function module returns the selection criteria in different formats that can be passed to database queries. An example demonstrates how to initialize selections with FREE_SELECTIONS_INIT, display the selection dialog with FREE_SELECTIONS_DIALOG, and use the returned selection criteria in a database SELECT statement.

Uploaded by

eswarscribd
Copyright
© Attribution Non-Commercial (BY-NC)
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as DOCX, PDF, TXT or read online on Scribd
608 views4 pages

Free Selections Dialog

This document describes the FREE_SELECTIONS_DIALOG function module in ABAP, which displays a dialog screen for users to enter dynamic selection criteria for database queries. The function module returns the selection criteria in different formats that can be passed to database queries. An example demonstrates how to initialize selections with FREE_SELECTIONS_INIT, display the selection dialog with FREE_SELECTIONS_DIALOG, and use the returned selection criteria in a database SELECT statement.

Uploaded by

eswarscribd
Copyright
© Attribution Non-Commercial (BY-NC)
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as DOCX, PDF, TXT or read online on Scribd
You are on page 1/ 4

FU FREE_SELECTIONS_DIALOG ____________________________________________________ Short Text

Dialog for entering dynamic selection conditions

Functionality
Dialog for entering dynamic selections. The simplest procedure is where a selection screen appears when you call the function module. If you enter your selections and press Copy, the function module returns the selections to the caller in three different forms. The essential input parameter (SELECTION_ID) is the selection ID returned by the previous call to FREE_SELECTIONS_INIT. It is used to identify this special set of dynamic selections so that, during a transaction, you can manage several sets of dynamic selections that can be redisplayed one after the other for maintenance. The second input parameter TITLE can contain the selection screen title. The third input parameter STATUS can include the number of a GUI status for the selection screen (see documentation of the parameter "STATUS"). If a field selection is made when you call FREE_SELECTIONS_INIT or following an earlier call to FREE_SELECTIONS_DIALOG, you immediately see the selection screen for entering the selections for the chosen fields. From here, you can then make a new selection - as long as this is defined by this selection ID. If no fields are selected, you first see the field selection screen and can then branch to the selection screen. The function module returns 5 objects (if desired): 1. A table of the chosen fields (FIELDS_TAB). 2. The entered selections in the form of logical expressions (export parameter EXPRESSIONS, type RSDS_TEXPR ==> type pool RSDS). You can save this form and pass it to the function module FREE_SELECTIONS_INIT again later, so that the old selections are displayed at once when you call FREE_SELECTIONS_DIALOG. 3. The same in the form of WHERE clauses that can be passed directly to a SAP SELECT statement (export parameter WHERE_CLAUSES, type RSDS_TWHERE ==> type pool RSDS). 4. The same in the form of RANGES tables that can be passed directly to a SAP SELECT statement (IN operator) (export parameter FIELD_RANGES, type RSDS_TRANGE ==> type pool RSDS) 5. The number of fields for which you can actually enter selections (this can be smaller than the number of entries in FIELDS_TAB).

Example The field string QCAT (structure RSDSQCAT) contains the key of a selection view: ORIGIN: 'CUS' (customer) DBNA: empty (no logical database used) NAME: CHARLY

... TABLES: ABCD, XYZW. TYPE-POOLS RSDS. DATA TEXPR TYPE RSDS_TEXPR. DATA TWHERE TYPE RSDS_TWHERE. DATA TRANGE TYPE RSDS_TRANGE. DATA DS_CLAUSES TYPE RSDS_WHERE. DATA BEGIN OF TABS OCCURS 10. INCLUDE STRUCTURE RSDSTABS. DATA END OF TABS. DATA BEGIN OF FIELDS OCCURS 10. INCLUDE STRUCTURE RSDSFIELDS. DATA END OF FIELDS. DATA SELID LIKE RSDYNSEL-SELID. DATA ACTNUM LIKE SY-TFILL. DATA TITLE LIKE SY-TITLE VALUE 'My title'. ... (Fill tables TABS and FIELDS, ... e.g. TABS should contain the tables ABCD and XYZW, ... FIELDS the fields ABCD-F1, ABCD-F2 and XYZW-F0) CALL FUNCTION 'FREE_SELECTIONS_INIT' EXPORTING EXPRESSIONS = TEXPR. KIND = 'G' FIELD_GROUPS_KEY = QCAT IMPORTING SELECTION_ID = SELID EXPRESSIONS = TEXPR WHERE_CLAUSES = TWHERE FIELD_RANGES = TRANGE NUMBER_OF_ACTIVE_FIELDS = ACTNUM TABLES TABLES_TAB = TABS FIELDS_TAB = FIELDS EXCEPTIONS FIELDS_INCOMPLETE = 01 FIELDS_NO_JOIN = 02 FIELD_NOT_FOUND = 03 NO_TABLES = 04 TABLE_NOT_FOUND = 05 EXPRESSION_NOT_SUPPORTED = 06 INCORRECT_EXPRESSION = 07 ILLEGAL_KIND = 08 AREA_NOT_FOUND = 09 INCONSISTENT_AREA = 10 KIND_F_NO_FIELDS_LEFT = 11 KIND_F_NO_FIELDS = 12 TOO_MANY_FIELDS = 13.

IF SY-SUBRC = 0. CALL FUNCTION 'FREE_SELECTIONS_DIALOG' EXPORTING SELECTION_ID = SELID TITLE = TITLE IMPORTING WHERE_CLAUSES = TWHERE EXPRESSIONS = TEXPR FIELD_RANGES = TRANGE NUMBER_OF_ACTIVE_FIELDS = ACTNUM TABLES FIELDS_TAB = FIELDS EXCEPTIONS INTERNAL_ERROR = 01 NO_ACTION = 02 NO_FIELDS_SELECTED = 03 NO_TABLES_SELECTED = 04 SELID_NOT_FOUND = 05. IF SY-SUBRC = 0. CLEAR DS_CLAUSES. MOVE 'ABCD' TO DS_CLAUSES-TABLENAME. READ TABLE TWHERE WITH KEY DS_CLAUSES-TABLENAME INTO DS_CLAUSES. SELECT * FROM ABCD WHERE ... AND (DS_CLAUSES-WHERE_TAB). ... ENDIF. ENDIF. The selection ID returned by the function module FREE_SELECTIONS_INIT is thus passed to the function module FREE_SELECTIONS_DIALOG. Since FREE_SELECTIONS_INIT has already received a table with selected fields, FREE_SELECTIONS_DIALOG branches immediately to the selection screen for the fields ABCD-F1, ABCD-F2 and XYZW-F0. Now the user can enter the selections, make a new field selection etc. The result is returned and can then, for example, be passed (in the form of TWHERE) to a SELECT statement. Here, the line of TWHERE belonging to the table ABCD (for example) is read into the object DS_CLAUSES (type RSDS_WHERE = line type of RSDS_TWHERE) and the table DS_CLAUSES-WHERE_TAB (which contains the actual WHERE clause) is passed on to the SELECT statement.

Parameters
SELECTION_ID TITLE FRAME_TEXT STATUS AS_WINDOW START_ROW START_COL NO_INTERVALS JUST_DISPLAY PFKEY

ALV TREE_VISIBLE DIAG_TEXT_1 DIAG_TEXT_2 WARNING_TITLE AS_SUBSCREEN NO_FRAME WHERE_CLAUSES EXPRESSIONS FIELD_RANGES NUMBER_OF_ACTIVE_FIELDS FIELDS_TAB FCODE_TAB FIELDS_NOT_SELECTED

Exceptions
INTERNAL_ERROR NO_ACTION SELID_NOT_FOUND ILLEGAL_STATUS

Function Group
SSEL

You might also like