Académique Documents
Professionnel Documents
Culture Documents
____________________________________________________
Short text
Output of a simple list (single-line)
Functionality
The function module outputs an internal table with whatever structure in the form of a formatted single- oder
multi-line list.
Process:
Passing an internal table with the set of information to be output
Notes
All interactions performed on the list refer directly to the internal output table. Sorting the list, for
example, also involves a resorting of the internal output table passed (since it was passed by
reference).
An important factor determining the usability of the tool or of various generic functions (totals,
subtotals) is the expected amount of data to be displayed.
The application is responsible for critically testing this aspect and consider it when it comes to
decision-making.
Parameter
I_INTERFACE_CHECK
I_BYPASSING_BUFFER
I_BUFFER_ACTIVE
I_CALLBACK_PROGRAM
I_CALLBACK_PF_STATUS_SET
I_CALLBACK_USER_COMMAND
I_CALLBACK_TOP_OF_PAGE
I_CALLBACK_HTML_TOP_OF_PAGE
I_CALLBACK_HTML_END_OF_LIST
I_STRUCTURE_NAME
I_BACKGROUND_ID
I_GRID_TITLE
I_GRID_SETTINGS
IS_LAYOUT
IT_FIELDCAT
IT_EXCLUDING
IT_SPECIAL_GROUPS
IT_SORT
IT_FILTER
IS_SEL_HIDE
I_DEFAULT
I_SAVE
IS_VARIANT
IT_EVENTS
IT_EVENT_EXIT
IS_PRINT
IS_REPREP_ID
I_SCREEN_START_COLUMN
I_SCREEN_START_LINE
I_SCREEN_END_COLUMN
I_SCREEN_END_LINE
IT_ALV_GRAPHICS
IT_ADD_FIELDCAT
IT_HYPERLINK
E_EXIT_CAUSED_BY_CALLER
ES_EXIT_CAUSED_BY_USER
T_OUTTAB
Exceptions
PROGRAM_ERROR
Function group
SLVC_FULLSCREEN
I_INTERFACE_CHECK
Description
So that the performance of the list output is not reduced due to interface consistency checks, these checks
are performed in a special call mode.
If this parameter is set to 'X', interface consistency is checked when the function module is called and an
error log is displayed.
You should only set this parameter for testing purposes during the development process (for example, for
debugging).
You can also perform the interface check on the result list by entering function code &SOS.
THIS PARAMETER IS CURRENTLY NOT SUPPORTED IN FULLSCREEN MODE! As a workaround, go to
the print preview from within the list and enter function code &SOS there.
Default
SPACE
I_CALLBACK_PROGRAM
Caution: Never pass SY-REPID directly at the interface. If field SY-REPID contains the desired program
name, you must absolutely assign this name to an auxiliary variable and pass this variable to the interface.
I_CALLBACK_PF_STATUS_SET
Default
If no EXIT routine is specified, the ALV sets a status that corresponds to status STANDARD of function
group SALV.
I_CALLBACK_USER_COMMAND
The EXIT routine is called whenever a function unknown to the ALV is triggered or if the routine call
before/after the execution of a standard function code has been defined by interface parameter
IT_EVENT_EXIT.
See also the documentation on parameter IT_EVENT_EXIT.
The function code and the current cursor position are then passed on to the calling program through the
EXIT routine.
If the user has selected multiple rows by selecting checkboxes, the output table field designated as the
checkbox contains the current state of the checkbox in the list.
I_CALLBACK_TOP_OF_PAGE
I_STRUCTURE_NAME
Description
If the internal output table is defined through an ABAP Dictionary structure (INCLUDE STRUCTURE struct
or LIKE struct), you can automatically set up the field catalog by passing the structure name.
The field catalog is then internally set up for this structure as follows:
All fields are on the list (NO_OUT = SPACE) except fields of data type CLNT.
The key fields of the Dictionary structure are adopted in the field catalog as key fields.
References to unit fields stored in the Dictionary are adopted provided that the reference fields are
contained in the structure.
If you additionally pass a field catalog as parameter, the structure information is merged with this
field catalog.
For more information on how to set up the field catalog automatically, see the documentation on function
module REUSE_ALV_FIELDCATALOG_MERGE.
Return ->
Internal output table structure name
I_BACKGROUND_ID
Object ID of wallpaper
Description
You can use this parameter to pass a wallpaper for the output in Top-of-Page.
Caution: Since wallpaper-based formatting does not ensure a standards-based display of the page area in
the new design, you should only use this parameter in exceptional cases.
I_GRID_TITLE
Control title
Description
Specifies the title of the control. This text is displayed above the grid.
Return ->
Control title
I_GRID_SETTINGS
Grid settings
Description
If Top-of-Page or End-of-List are output online, these areas are displayed in a splitter above or below the list.
Using I_GRID_SETTINGS you can reduce the default size to 0%. To do this, you use two fields:
COLL_TOP_P: Sets Top-of-Page to 0%
COLL_END_L: Sets End-of-List to 0%
IS_LAYOUT
Display options
Exceptions
Totals
Interaction
Detail screen
Color
Other
no_sumchoice
Example:
If sender RKTFGS15 has a receiver assignment for Report Writer report group 7KOI with function
code class '3' (SAP setting), this receiver report group is called through the report/report interface
at function code 'BEB3'. The selections passed to the report/report interface are the report
selections and the key information of the selected row.
For more information on the report/report interface, see the documentation on function group
'RSTI'.
Detail screen
detail_initial_lines
Color
info_fieldname
Default
In many cases, the default layout settings can be kept so that you frequently do not need to pass this
structure with modified flags.
Note:
All other fields not specified here explicitly are not relevant for use with REUSE_ALV_GRID_DISPLAY or are
not released.
Return ->
List layout specifications
IT_SPECIAL_GROUPS
Sort order
fieldname
expa
Prequisite:
IT_SORT-SUBTOT = 'X', that is, the sort criterion is also the subtotals criterion.
If no complete breakdown but only a breakdown to totals level n that can be further expanded by
the user should be displayed when the list is output for the first time, you must set the indicator for
the totals level criterion of level n.
Return ->
Sort criteria for first list display
I_SAVE
Value Range
Defined display variants (such as delivered display variants) can be selected for presentation
regardless of this indicator. However, changes cannot be saved.
'X' = Standard save mode
Default
SPACE
Return ->
Variants can be saved
IS_VARIANT
Variant information
Description
This structure is only relevant if display variants are to be saved and/or read.
Variant information including the name of the list variant that is used to output the list.
To allow display variants to be read within the ALV, you must specify the acess path using fields REPORT
(required field), HANDLE (optional field) and/or LOG_GROUP (optional field).
If you also want to allow display variants to be saved, you must additionally fill parameter I_SAVE
accordingly.
The handle (HANDLE), if, for example, multiple lists with different structures and data are called in
a program (I_CALLBACK_PROGRAM).
The handle is a CHAR(4) field that must be uniquely defined and describes the assignment of the
call to the current structure of the internal output table.
Example:
Depending on the user interaction, several types of lists can be output in program x.
The user should be able to define display variants for each type of list.
You provide this function to the user by assigning a HANDLE to each list. If variants for the program
and the handle are saved, the handle must not be modified any more.
The logical group, if, for example, the same list is created with different settings through various
transactions (LOG_GROUP).
The logical group is a CHAR(4) that must be uniquely defined and specifies the assignment.
Example:
Program x is called through transactions T1 and T2. Depending on the transaction code, the fields
available to the user through the field catalog differ in their assignment to different logical groups.
If variants for the program and the logical group are saved, the logical group must not be modified
any more.
The user name, if user-specific variants are saved (USERNAME).
You do not have to fill this parameter manually since the variant name is unique.
The variant name (VARIANT).
You only have to fill this parameter if this structure is to be used to read a concrete variant and the
list is to be output with this variant.
Value Range
To call a list with a variant, you must specify the above fields.
Default
If the structure is initial, but saving is active (I_SAVE is not initial), then IS_VARIANT-REPORT =
I_CALLBACK_PROGRAM is set.
For a possible entries help for variants, function module REUSE_ALV_VARIANT_F4 is available.
Return ->
Variant information
IT_EVENTS
Description
This table is used to notify the ALV of all events that are processed by means of a CALLBACK through the
caller.
You can initialize the table containing the possible events for each list type using function module
REUSE_ALV_EVENTS_GET .
Using function module REUSE_ALV_EVENT_NAMES_GET , you can display the name of the constants of
type pool SLIS that represent each event. To do this, you use the single test function. Only events that have
a form routine name assigned to them are processed.
Event End-of-page is always processed within the ALV and passed through to the user by
means of the callback mechanism only. This is also true if the caller, based on a user
interaction, for example, processes a details list (such as a dialog box with additional
information on the selected list line displayed by the ALV) not formatted by the ALV.
In this case, End-of-page must not be formatted by the ALV like the basic list, but must
entirely be handled by the caller. Event End-of-page is nevertheless located in the ALV. If
the ALV recognizes that an End-of-page event is processed which is not triggered by an
ALV output, the form routine specified in FOREIGN_END_OF_PAGE is accessed.
IT_EVENTS-FORM
Name of the form routine that is to be executed in the calling program for the corresponding event.
Return ->
Table of events to perform
IS_PRINT
Print information
Description
Control parameters relevant for printing
PRINT
Value range: 0, n
n = Number of lines output in the footer by the user during printout at END_OF_PAGE in the
corresponding callback event.
NO_PRINT_LISTINFOS
Return ->
Print information