Download as doc, pdf, or txt
Download as doc, pdf, or txt
You are on page 1of 41

DOCUMENTAZIONE ALV (4.

6 C)

REUSE_ALV_LIST_DISPLAY
(documentazione ufficiale release 4.6C)
Output a simple list (single line or several lines)

Functionality
This module outputs an internal table with any structure as a formatted one-line or multiple-line list.
Principle:
 Pass an internal table with the set of output information
 Pass a structure with general list layout details
 Pass a field catalog as an internal table
The field catalog describes the fields to be output in the list.

Notes
 All actions on the list refer directly to the internal output table, e.g. sorting the list also sorts the passed internal
output table (passed by reference).
 An important consideration for the use of the tools and certain generic functions (totals, subtotals) is the expected
amount of data to be displayed.
The application must take this consideration into account.

Parameter

I_INTERFACE_CHECK

I_BYPASSING_BUFFER

I_BUFFER_ACTIVE

I_CALLBACK_PROGRAM

I_CALLBACK_PF_STATUS_SET

I_CALLBACK_USER_COMMAND

I_STRUCTURE_NAME

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

E_EXIT_CAUSED_BY_CALLER

ES_EXIT_CAUSED_BY_USER

T_OUTTAB

I_INTERFACE_CHECK Interface consistency check log output


To avoid overloading list output with interface consistency checks, they are only made
in an extra call mode. f this parameter is ' X', the consistency of the interface is checked
when the function module is called, and an error log is output. This parameter should
only be set for development test purposes (e.g. in debugging). The interface check can
also be made on the results list by entering the function code &SOS.

Function Module REUSE_ALV_LIST_DISPLAY Pag. 1 di 41


DOCUMENTAZIONE ALV (4.6 C)

Default: SPACE

I_BYPASSING_BUFFER

I_BUFFER_ACTIVE

I_CALLBACK_PROGRAM Name of the calling program


Program which calls the function module and contains the exit routines. It must be a
Report, Function group, Module pool or Form routine pool (not an Include).
Note: Never pass SY-REPID directly in the interface. If the desired program name is in
SY-REPID, it must be assigned to an intermediate variable which is then passed to the
interface.
I_CALLBACK_PF_STATUS_SET Set EXIT routine to status
Passing an EXIT routine tells the ALV that the caller wants to set his or her own user
status. In this case, the default ALV status is not set. The form routine interface must be
defined as follows:
FORM set_pf_status USING rt_extab TYPE slis_t_extab
The table RT_EXTAB contains those function codes that are hidden on the standard
interface. If the caller wants to use his or her own interface (to offer other functions on
the list or transfer existing functionality, for example), it is recommended that he or she
copy the standard status STANDARD from function group SALV and make the
appropriate changes. Standard ALV function codes always begin with ' &'. Please
consult the documentation on the I_CALLBACK_USER_COMMAND parameter as well.
If, however, the user chooses to use his or her own interface that contains the standard
interface's function codes, the function codes from the excluding table passed must also
be taken into consideration. This means that the user status should always be set as
follows:
SET PF-STATUS usrstatus EXCLUDING rt_extab.
Excluding table rt_extab can be appended to include those application functions that are
to be deactivated. The system calls this routine whenever the standard interface is set
using SET PF-STATUS.
Default: If no exit routine is entered, then the ALV sets a status that corresponds to the
STANDARD status of function group SALV.

I_CALLBACK_USER_COMMAN EXIT routine for command handling


D
Passing an EXIT routine tells ALV that the application wants to react to certain
function codes itself. These are general function codes which ALV does not recognize
(not ALV standard functions) and which were defined and set by an application status.
See also the documentation of the parameter I_CALLBACK_PF_STATUS_SET.
The interface of the specified form routine must be defined as follows:
FORM user_command USING r_ucomm LIKE sy-ucomm
rs_selfield TYPE slis_selfield.
The parameter R_UCOMM contains the function code called.
The structure RS_SELFIELD contains the following information:
 Tabname : internal output table name
 Tabindex : internal output table index
 Fieldname : field name of cursor position
 sel_tab_field : cell name of cursor position (internal ALV table name field)
 endsum : cursor is on the final total row
 sumindex : if > 0, the cursor is on a subtotal row
 value: field value on the list
 refresh : (exporting) list is to be refreshed
 col_stable : (exporting) keep column positions in refresh

Function Module REUSE_ALV_LIST_DISPLAY Pag. 2 di 41


DOCUMENTAZIONE ALV (4.6 C)

 row_stable : (exporting) keep row positions in refresh


 exit : (exporting) leave list (and ALV)
 before_action : jump before performing standard action
 after_action : jump after performing standard action, before creating list
 ignore_multi : internal use
The exit routine always runs when a function code occurs which ALV does not
recognize, or a jump before or after a standard function code is defined by the interface
parameter IT_EVENT_EXIT. See also the documentation of the parameter
IT_EVENT_EXIT. The function code and current cursor position information are passed
to the calling program via the exit routine. If several lines are selected by marking
checkboxes, the output table checkbox field contains the current status of the checkbox
in the list.

I_STRUCTURE_NAME Internal output table structure name


If the internal output table is defined via an ABAP/4 Dictionary structure ( INCLUDE
STRUCTURE struct or LIKE struct ), the field catalog can be built-up automatically by
passing the structure name.
The field catalog is internally built up for this structure as follows:
 All fields are in the list (NO_OUT = SPACE) except fields of data type CLNT.
 The key fields of the Dictionary structure are also key fields in the field catalog.
 Dictionary references to unit fields are copied if the reference fields are in the
structure.
 If a field catalog is also passed as parameter, the structure information is combined
with this field catalog.
For further information about the automatic build-up of the field catalog, see the
documentation of the function module REUSE_ALV_FIELDCATALOG_MERGE .
IS_LAYOUT List layout specifications
Output list description structure. The parameters are described under the following
headers:
 Display options
 Exceptions
 Totals
 Interaction
 Detail screen
 Display variants (only for hierarchical-sequential lists)
 Color
 Other
Note the section 'Default'.
Display options
 Colwidth_optimize
value set: SPACE, 'X'
'X' = optimzes the column width so that all contents are displayed completely.
 No_colhead
value set: SPACE, 'X'
'X' = column headers are not output
 Zebra
value set: SPACE, 'X'
'X' = striped pattern (e.g. for wide lists)
 no_vline
value set: SPACE, 'X'
not relevant for: hierarchical-sequential lists and multiple-line lists.
'X' = columns separated by SPACE
 no_min_linesize
value set: SPACE, 'X'
not relevant for block lists
'X' = line size depends on list width

Function Module REUSE_ALV_LIST_DISPLAY Pag. 3 di 41


DOCUMENTAZIONE ALV (4.6 C)

' ' = line size is set to 80 or MIN_LINESIZE (if > 0) .


 min_linesize
value set: 0, 10 - 250
minimum width of the list (to change default of 80). If the list is wider, the format
uses the list width (maximum 250 or MAX_LINESIZE (if > 0).
prerequisite: no_min_linesize = ' '.
 max_linesize
value set: 0, 80 - 1020
maximum list width (to change the default of 250) interactively-definable
maximum list width setting. Caution: wide lists are difficult to read and to print.
Exceptions
 lights_fieldname
value set: SPACE, internal output table field name
internal output table field containing the codes of exceptions to be output.
Output table field code:
'1' = red traffic light
'2' = yellow traffic light
'3' = green traffic light
 lights_tabname
value set: SPACE, internal output table name
Only relevant for hierarchichal-sequential lists.
Name of the internal output table which contains the field in the parameter
LIGHTS_FIELDNAME .
If LIGHTS_FIELDNAME is not empty, this field must also be filled for hierarchical-
sequential lists.
 lights_rollname
value set: SPACE, data element name
The documentation of this data element is displayed when you call F1 help for an
exception column.
 lights_condense
value set: SPACE, 'X'
'X' = the 'maximum' exception of the items in the subtotal is output at subtotal
level.
Ex.: if a list record is output with 'red traffic light', each subtotal which includes
this record is also output with 'red traffic light'.
Totals
 no_sumchoice
value set: SPACE, 'X'
'X' = fields which are to be summed, passed by the calling program ( FIELDCAT-
DO_SUM = 'X'). The user should not be able to change this value interactively.
 no_totalline
value set: SPACE, 'X'
'X' = no total record is to be output. Subtotals can still be calculated and output.
The fields in the subtotals are flagged DO_SUM = 'X' in the field list.
 no_subchoice
value set: SPACE, 'X'
'X' = value whose change triggers subtotals, provided by the calling program. The
user should not be able to change this value interactively. See also the
documentation of the IMPORTING parameter IT_SORT.
 no_subtotals
value set: SPACE, 'X'
'X' = no subtotals.
 Totals_only
value set: SPACE, 'X'
'X' = only total records are output.
An interactive breakdown of simple and hierarchical-sequential lists is possible.
Prerequisite: the IMPORTING parameter IT_SORT contains the sort criteria and
subtotal flags. See also the documentation of the IMPORTING parameter IT_SORT.
 totals_text

Function Module REUSE_ALV_LIST_DISPLAY Pag. 4 di 41


DOCUMENTAZIONE ALV (4.6 C)

value set: SPACE, string(max. 60)


' ' = the first column in the total record contains an appropriate number of ' *'s to
indicate the total by default. If the first column is wide enough, the string ' Total ' is
output after the asterisks.
'string ' = the string passed is output after the total indicated by ' *', if the column is
wide enough.
 subtotals_text
value set: SPACE, string(max. 60)
' ' = in the first column of subtotal records, the subtotal is indicated by an
appropriate number of '*' by default. If the first column is not a subtotal criterion,
the string 'Total ' is output after the asterisks, if the column is wide enough.
'string ' = the string passed is output after the subtotal indicated by ' *', if the column
is wide enough and the first column is not a subtotal criterion. If it is a subtotal
criterion, its value is repeated after the total, if the column is wide enough.
 numc_sum
value set: SPACE, 'X'
' ' = by default NUMC fields cannot be totalled
'X' = NUMC fields can be totalled. If this flag is set, the total can be controlled via
the FIELDCAT-NO_SUM parameter per NUMC column.
Interaction
 box_fieldname
value set: SPACE, internal output table field name
if the list has checkboxes at the start of records (for selecting several records), this
parameter contains the internal output table field name indicated by the checkbox
selection column. The field is a checkbox at the start of list records without a list
header.
 box_tabname
value set: SPACE, internal output table name
Only relevant for hierarchical-sequential lists. Name of the internal output table
which contains the field in the parameter BOX_FIELDNAME. If BOX_FIELDNAME
is not empty, this field must also be filled for hierarchical-sequential lists.
 no_input
value set: SPACE, 'X'
'X' = all ready-for-input fields in a list are displayed as not ready-for-input.
(record selection checkboxes and fields which can be made ready-for-input via the
field list parameter FIELDCAT-INPUT = 'X')
 expand_fieldname
value set: SPACE, internal header table field name
Only relevant for hierarchical-sequential lists
if hierarchical-sequential list items are to be expandable and collapsable, the
internal header table must contain an additional CHAR(1) field which contains the
expansion status of the header entry. The name of this field must be assigned to the
parameter IS_LAYOUT-EXPAND_FIELDNAME . The initial value of the field in the
header table is that the items are not displayed and the folder symbol
SYM_PLUS_FOLDER appears in the list before the header entry. If the field contains
'X' for a header entry, the items for this header appear, and the folder symbol
SYM_MINUS_FOLDER appears on the list before the header entry. The user can
show or hide the items by clicking on the folder symbol (hotspot). If the items for a
header entry are only to be read by the calling program and passed to ALV when a
header has been expanded interactively, this can be controlled via the CALLBACK
event 'ITEM_DATA_EXPAND'.
See also the documentation of the parameter IT_EVENTS.
 f2code
value set: SPACE, function code
meaning in the ALV standard interface:
To assign an ALV standard function code to double-click ( F2), assign the function
code to this parameter.
Ex.: to assign the ALV standard function ' Detail ' ('&ETA') to F2.
 LAYOUT-F2CODE = '&ETA'

Function Module REUSE_ALV_LIST_DISPLAY Pag. 5 di 41


DOCUMENTAZIONE ALV (4.6 C)

Effect in 'user interface':


Case 1: the ALV standard function code for F2 '&IC1' is left in the copied
application interface, but F2 is to have a function which is not under F2 in the
interface (ALV standard function or application function). Pass this function code
to ALV in the parameter F2CODE.
Case 2: The ALV standard function code for F2 '&IC1' was deleted from the
application interface and replaced by another function code (ALV standard
function or application function). Pass this function code to ALV in the parameter
F2CODE. This is the prerequisite for column selection in this case.
 Confirmation_prompt
value set: SPACE, 'X'
'X' = if one of the functions ' Back(F03) ', 'Exit(F15) ' or 'Cancel(F12) ' occurs, a
confirmation prompt appears.
 key_hotspot
value set: SPACE, 'X'
The columns defined in the field catalog as key fields ( FIELDCAT-KEY = 'X') are
output as hotspots, i.e. clicking on a key column (highlighted in color in the list)
calls the function under F2.
 Reprep
value set: SPACE, 'X'
'X' = activate Report/Report interface:
prerequisite: application system ( Report RKKBRSTI exists). List module is a
possible sender in the Report/Report interface logic (poss. Initialization of the
interface...). The calling report/module pool... of type RT=Report in
I_CALLBACK_PROGRAM is passed to the Report/Report interface as sender report.
If the sender report is assigned to receiver reports in the table TRSTI, the function
code BEBx is active (x = function code class).
Example: If Report Writer report group 7KOI with function code class ' 3' (SAP
setting) is assigned as a receiver for the sender RKTFGS15, this receiver report
group is called by function code ' BEB3' via the Re/Re interface. The report
restrictions and the key information of the selected records are passed to the Re/Re
interface as selection criteria. For further information about the Report/Report
interface see the documentation of the function group ' RSTI'.
 Group_buttons
value set: SPACE, 'X'
not relevant for block lists (output of several lists consecutively)
Prerequisite: Group output fields via FIELDCAT-SP_GROUP in the field list, and
pass the group name to the list module in the interface parameter
IT_SPECIAL_GROUPS.
Further information: See the documentation of the IMPORTING parameter
IT_SPECIAL_GROUPS and the field catalog parameter FIELDCAT-SP_GROUP of the
IMPORTING parameter IT_FIELDCAT.
' ' = if the prerequisite is fulfilled, but the parameter is not set, the function code
'&OL0' calls the display variant popup in which you can show the visible fields in
the field list by their groups. All fields in the field list are visible by default. The
user can go to the group views in the popup.
The fields can be classified into any number of logical groups ( 1:n).
'X' = a maximum of five logical groups can be formed. The display variant popup
for each of these groups can be called by its own function in the interface. The
fields in the field list belong to this group. The ALV standard interface contains
pushbuttons for the first three groups (the first three entries in the internal table
IT_SPECIAL_GROUPS). The group text passed in IT_SPECIAL_GROUPS is displayed
as pushbutton text. The display variant popup for the fourth and fifth groups can be
called via the right-hand mouse key function selection. When the display variant
popup for a field group is called, that group is selected, but the user can change the
group view in the popup.
The function codes &OLx (x=1,2,3,4,5) call the display variant popups for the
respective group. There are pushbuttons for the function codes &OL1, &OL2 and

Function Module REUSE_ALV_LIST_DISPLAY Pag. 6 di 41


DOCUMENTAZIONE ALV (4.6 C)

&OL3 in the ALV standard interface (function group KKBL status STANDARD).
The functions &OL4 and &OL5 only have function keys.
A group 'All fields' is added by the System when grouping logic is used (= the
above prerequisite is satisfied), regardless of the setting of this parameter.
 no_keyfix
value set: SPACE, 'X'
Not relevant for block lists (output of several lists consecutively)
' ' = the key columns defined in the field catalog by FIELDCAT-KEY = 'X' are fixed
in the list output. These columns do not scroll horizontally. The item table key
columns are fixed in hierarchical-sequential lists. The header table key fields are
not considered here.
'X' = key columns not fixed
The user can change these general settings interactively. To fix a column by default
which is not a key column, set the parameter to ' X' and control it via the field list.
See the documentation of the field list parameter FIELDCAT-FIX_COLUMN of the
IMPORTING parameter IT_FIELDCAT.
 get_selinfos
value set: SPACE, 'X'
If the calling program is a report with an ABAP/4 selection screen, setting this
parameter makes ALV read the selection screen again. If the selections are read
successfully, a pushbutton, via which the user can call a popup which lists the
report selections in a simple form, becomes active on the results list output by
ALV. The contents of this popup are printed, if the interface IS_PRINT structure
parameter NO_PRINT_SELINFOS is not set. You can ensure that they are printed on
a separate page by setting the parameter IS_PRINT-NO_COVERPAGE. For more
information about printed output, see the documentation of the parameter
IS_PRINT.
 group_change_edit
value set: SPACE, 'X'
'X' = the user can enter a format option for each sort criterion in the sort/subtotal
popup, for the list format when this value changes (e.g. new page or undeline). For
further information about sorting see the documentation of the parameter IT_SORT.
Detail screen
 detail_popup
value set: SPACE, 'X'
' ' = list record detail display in full-screen mode, with top-of-page.
'X' = list record detail display in popup (without top-of-page).
 detail_initial_lines
value set: SPACE, 'X'
' ' = only fields whose contents are not initial are output in the detail view.
'X' = initial field contents are also output in detail.
 Detail_titlebar
Value set: SPACE, string (max.30)
' ' = 'Detail: Display' is output as the title of the detail window.
'string' = the string passed is output as the title of the detail window.
Display variants (only relevant for hierarchical-sequential lists)
 Header_text
value set: SPACE, CHAR(20)
only relevant for hierarchical-sequential lists. You can toggle between display field
and field list views via pushbuttons in the display variant definition popup for
hierarchical-sequential lists. The views refer to the hierarchy level of the fields.
This is technically a toggle between the header table and item table fields.
' ' = the header table field pushbutton text is 'Header' by default.
CHAR(20) = header table field pushbutton text.
 Item_text
Value set: SPACE, CHAR(20)
Only relevant for hierarchical-sequential lists
You can toggle the view between the display fields and the field list via
pushbuttons in the display variant definition popup for hierarchical-sequential lists.

Function Module REUSE_ALV_LIST_DISPLAY Pag. 7 di 41


DOCUMENTAZIONE ALV (4.6 C)

The views refer to the hierarchy level of the fields. This is technically a toggle
between the header table and item table fields.
' ' = the pushbutton text for the item table fields is 'Item' by default.
CHAR(20) = item table field pushbutton text.
 item_default
value set: SPACE, 'X'
only relevant for hierarchical-sequential lists
' ' = the header table fields are displayed by default in the display variant definition
popup. The user can switch to the item table fields interactively.
'X' = the item table fields are displayed by default in the display variant Definition
Popup. The user can switch to the header table fields interactively.
Color
 info_fieldname
value set: SPACE, internal output table field name
A whole list record can be colored individually using a color code in a column of
the internal output table for the record. Assign the name of the field containing the
color code to this parameter.
The internal output table field must be of type CHAR(3).
The code must have the following syntax:
'Cxy': C = color (all codes must start with ' C')
X = color number (' 1'-'9')
y = bold ('0' = off, '1' = on)
Note: the color of the key columns is not affected. Key columns can be colored at
record or cell level using the complex coloring which is described in the next
parameter COLTAB_FIELDNAME.
To color columns, see the documentation of the field catalog parameter FIELDCAT-
EMPHASIZE of the IMPORTING parameter IT_FIELDCAT.
 coltab_fieldname
value set: SPACE, internal output table field name
Cells can be colored individually using a color code which is contained in a column
of the internal output table for the record containing the cell.
Assign the name of the field to this parameter.
The internal output table field must be of type SLIS_T_SPECIALCOL_ALV.
Principle: the color code field is entered for the record containing the cells to be
colored. The field contains an internal table with the above structure, containing the
field names of the cells to be colored and the color code. The cell coordinates are
determined by the record position containing the color code and the column
information in the color table.
The record structure of the internal color table of type SLIS_T_SPECIALCOL_ALV
is as follows:
Color table- FIELDNAME = field name of the cell to be colored
Color table- COLOR-COL = color number (1 - 9)
Color table- COLOR-INT = bold (0 = off, 1 = on)
Color table- COLOR-INV = inverse (0 = off, 1 = on)
Color table- NOKEYCOL = ignore key coloring (' X' = yes, ' ' = no)
If the parameter color table- FIELDNAME is not filled, the coloring applies to all
fields, so the entire record is colored.
Others
 list_append
value set: SPACE, 'X'
only relevant for block lists which are not output with the REUSE_ALV_BLOCK_...
modules. It is only useful to output block-lists without specifying the above
modules if the number of list blocks exceeds, or may exceed, the maximum number
specified in the block module documentation. These operations are not possible for
user-defined block lists.
Principle: to output a list of n blocks
Call the function module for the list type for the first block.
The caller must enter the maximum list width of the n blocks in the parameter

Function Module REUSE_ALV_LIST_DISPLAY Pag. 8 di 41


DOCUMENTAZIONE ALV (4.6 C)

LAYOUT-MIN_LINESIZE in the first call. The event table IT_EVENTS of the event
END_OF_LIST must contain the associated form routine name (see also the
documentation of the interface parameter IT_EVENTS). The parameter LAYOUT-
LIST_APPEND must be initial. After the first list has been output, the form routine
specified in the event END_OF_LIST is called by Callback. The remaining n-1
blocks are then output by calling the function module for the list type. The
parameter LAYOUT-LIST_APPEND must be set = 'X' for these n-1 calls. The event
table IT_EVENTS should not contain the event END_OF_LIST or at least be assigned
to a different form routine name from the first call.
Default
The default layout settings can often be retained, so that you do not have to pass this
structure with changed flags.

IT_FIELDCAT Field catalog with field descriptions


Field catalog containing descriptions of the list output fields (usually a subset of the
internal output table fields). A field catalog is required for every ALV list output. The
field catalog for the output table is built-up in the caller's coding. The build-up can be
completely or partially automated by calling the REUSE_ALV_FIELDCATALOG_MERGE
module (See also documentation of this function module ).
The minimal field catalog is documented under 'default'. The caller can use the other
optional parameters to assign output attributes to a field which differ from the default.
A field catalog need not be built-up and passed explicitly only under the following
conditions:
 The internal table to be output has the same structure as a Data Dictionary structure
which is referred to in the internal table declaration using LIKE or INCLUDE
STRUCTURE.
 All fields in this structure are to be output
 The structure name is passed to ALV in the parameter I_STRUCTURE_NAME.
See also the documentation of the IMPORTING parameter I_STRUCTURE_NAME.
Positioning
 row_pos (row position)
value set: 0, 1 - 3
Only relevant if the list output is to be multi-line (two or three lines) by default.
A multi-line list can also be defined by the user interactively if the default list is
one-line.
The parameter specifies the relative output line of the column in a multi-line list.
 col_pos (column position)
value set: 0, 1 - 60
only relevant when the default relative column positions differ from the field
catalog field sequence.
The parameter specifies the relative column position of the field in the list output.
The column order can be changed interactively by the user. If this parameter is
initial for all field catalog entries, columns appear in the field catalog field
sequence.
Identification
 fieldname (field name)
value set: internal output table field name (required parameter)
Name of the internal output table field which is described by this field catalog entry
 tabname (internal output table)
value set: SPACE, internal output table name
This parameter is used in 'manual' field catalog build-up only for hierarchical-
sequential lists.
Name of the internal output table which contains the field FIELDCAT-FIELDNAME.
Data Dictionary reference
 ref_fieldname (reference field name)
value set: SPACE, Data Dictionary field name
Name of the Data Dictionary field referred to. This parameter is only used when

Function Module REUSE_ALV_LIST_DISPLAY Pag. 9 di 41


DOCUMENTAZIONE ALV (4.6 C)

the internal output table field described by the current field catalog entry has a
reference to the Data Dictionary (not a program field), and the field name in the
internal output table is different from the name of the field in the Data Dictionary.
If the field names are identical, naming the Data Dictionary structure or table in the
FIELDCAT-REF_TABNAME parameter is sufficient.
 ref_tabname (reference table/structure field name)
value set: SPACE, name of a Data Dictionary structure or table structure or table
name of the referred Data Dictionary field. This parameter is only used when the
internal output table field described by the current field catalog entry has a Data
Dictionary reference (not a program field).
Reference to fields with currency/measurement unit
Each internal output table sum or quantity field whose decimal places are to be
formatted appropriately for the unit in the list must follow the convention:
 the field is of data type QUAN or CURR (internal type P)
(the field must really have this physical data type. Overwriting the physical
data type with the parameter FIELDCAT-DATATYPE has no effect)
 There is a field in the internal output table which contains the associated unit.
 There is also an entry in the field catalog for the unit field.
(If the unit is not to appear as a column in the list, and cannot be interactively
displayed as a column, e.g. because it is always unambiguous and is therefore
explicitly output by the caller in the list header, the field catalog units field
entry can take the parameter FIELDCAT-TECH = 'X'.
The association of a value field to a unit affects the output as follows:
 appropriate decimal places display for the unit
 an initialized field with a link to a non-initial unit is output as ' 0' for the unit (if
FIELDCAT-NO_ZERO is initial ). When this field is summed, this unit affects
whether the units are homogeneous.
 an initialized field with a link to an initial unit is output as SPACE. When this
field is summed, the unit SPACE does not affect the homogeneity of the units.
 When non-initial fields with an initial unit are summed, the unit SPACE is
considered to be a unit.
Link to currency unit
 cfieldname (currency unit field name)
value set: SPACE, output table field name
Only relevant for amount columns with associated unit.
Name of the internal output table field containing the currency unit associated with
the amount field FIELDCAT-FIELDNAME.
The field in FIELDCAT-CFIELDNAME must have its own field catalog entry.
 ctabname (internal currency unit field output table)
value set: SPACE, output table field name
only relevant for hierarchical-sequential lists
Name of the internal output table containing the FIELDCAT-CFIELDNAME field.
Link to measurement unit
 qfieldname (measurement unit field name)
value set: SPACE, output table field name
only relevant for quantity columns with unit link.
Name of the internal output table field containing the measurement unit associated
with the quantity field FIELDCAT-FIELDNAME. The field in FIELDCAT-
QFIELDNAME must have its own field catalog entry.
 Qtabname (internal measurement unit field output table)
value set: SPACE, output table field name
only relevant for hierarchical-sequential lists
Name of the internal output table containing the FIELDCAT-QFIELDNAME field.
Column output options
 Outputlen (column width)
value set: 0 (initial ), n
For fields with a Data Dictionary link this parameter can be left initial.
For fields without a Data Dictionary link (program field) the parameter must be

Function Module REUSE_ALV_LIST_DISPLAY Pag. 10 di 41


DOCUMENTAZIONE ALV (4.6 C)

given the value of the desired field list output length (column width).
initial = column width is the output length of the referred Data Dictionary field
(domain).
n = column width is n characters
 Key (key column)
value set: SPACE, 'X'
'X' = kex field (key field output in color)
Key fields can not be interactively hidden. Parameter FIELDCAT-NO_OUT must be
left initial. For exceptions see the documentation of the FIELDCAT-KEY_SEL
parameter.
 key_sel (hideable key column)
value set: SPACE, 'X'
only relevant when FIELDCAT-KEY = 'X'
Key field which can be hidden interactively. The key column sequence cannot be
changed interactively by the user. The output is controlled by the FIELDCAT-
NO_OUT parameter analogously to non-key fields.
 no_out (field in field list)
value set: SPACE, 'X'
'X' = field is not displayed in the current list.
The user can interactively choose the field for output from the field list. The user
can display the contents of these fields at line level using the 'Detail' function. See
also the 'Detail screen' documentation of the parameter IS_LAYOUT.
 tech (technical field)
value set: SPACE, 'X'
'X' = technical field
Field cannot be output in the list and cannot be displayed interactively. Field can
only be used in the field catalog (not in IT_SORT, ...).
 emphasize (highlight columns in color)
value set: SPACE, 'X' or 'Cxyz' (x:'1'-'9'; y,z: '0'=off '1'=on)
'X' = column is colored with the default column highlight color.
'Cxyz' = column is colored with a coded color:
C = Color (coding must begin with ' C')
X = color number (' 1'-'9')
y = bold ('0' = off, '1' = on)
z = inverse (' 0' = off, '1' = on)
 hotspot (column as hotspot)
value set: SPACE, 'X'
'X' = column cells are output as hotspots
 fix_column (fix column)
value set: SPACE, 'X'
Not relevant for block lists (output of several lists consecutively)
'X' = column fixed (does not scroll horizontally)
All columns to be fixed must have this flag, starting from the left. If a column
without this flag is output, only the columns to the left of this column are fixed.
The user can change the column fixing interactively. See also the documentation of
the Layout parameter IS_LAYOUT-NO_KEYFIX of the IMPORTING parameter
IS_LAYOUT.
 do_sum (sum over column)
value set: SPACE, 'X'
'X' = a sum is to be calculated over this internal output table field.
This function can also be called by the user interactively.
 no_sum (sums forbidden)
value set: SPACE, 'X'
'X' = no sum can be calculated over this field, although the data type of the field
would allow summing.
 Input (column ready for input)
Function not available
Format column contents
 Icon

Function Module REUSE_ALV_LIST_DISPLAY Pag. 11 di 41


DOCUMENTAZIONE ALV (4.6 C)

Value set: SPACE, 'X'


'X' = column contents to be output as an icon.
The caller must consider the printability of icons.
 Symbol
value set: SPACE, 'X'
'X' = column contents are to be output as a symbol.
The internal output table column must be a valid symbol character. The caller must
consider the printability of symbols. Symbols can usually be printed, but may not
always be output correctly, depending on the printer configuration.
 just (justification)
value set: SPACE, 'R', 'L', 'C'
Only relevant for fields of data type CHAR or NUMC
' ' = default justification for this data type
'R' = right-justified output
'L' = left-justified output
'C' = centered output
The justification of the column header always follows the justification of the
columns. Independent justification of the column header is not possible.
 Lzero (leading zeros)
value set: SPACE, 'X'
Only relevant for fields of data type NUMC
ALV outputs NUMC fields right-justified without leading zeros by default.
'X' = output with leading zeros
Note: If a NUMC field is output left-justified or centered by FIELDCAT-JUST,
leading zeros are output. If the output of leading zeros is suppressed by a Data
Dictionary reference ALPHA conversion exit, the output is always left-justified.
 no_sign (no +/- sign)
value set: SPACE, 'X'
Only relevant for value fields
'X' = value output without +/ sign
 no_zero (suppress zeros)
value set: SPACE, 'X'
Only relevant for value fields
'X' = suppress zeros
 edit_mask (field formatting)
value set: SPACE, template
template = see documentation of WRITE formatting option
USING EDIT MASK template: The output conversion conv can be made by
template = '== conv'.
Texts
The following text parameters should be specified for program fields without a Data
Dictionary reference.
The texts are taken from the Data Dictionary for fields with a Data Dictionary
reference. If this is not desired, the text parameters can also be specified. The Data
Dictionary texts are then ignored.
If the user changes the column width interactively, the column header text with the
appropriate length is always used.
The interactive function 'Optimize column width' takes account of both the field
contents and the column headers:
if all field contents are shorter than the shortest column header, the column width
depends on the column header.
The 'long field label' is also used in display variant definition, sort, etc. popups.
 seltext_l (long field label)
 seltext_m (medium field label)
 seltext_s (short field label)
 reptext_ddic (header)
analogous to the Data element maintenance 'Header'
The specified text is not necessarily output in the list, an optimum among all texts
is sought.

Function Module REUSE_ALV_LIST_DISPLAY Pag. 12 di 41


DOCUMENTAZIONE ALV (4.6 C)

 ddictxt (specify text)


value set: SPACE, 'L', 'M', 'S'
You can specify with values 'L', 'M', and 'S', the keyword that should always be
used as column header. If the column width changes, no attempt is made in this
case to find an appropriate header for the new output width.
Parameters for program fields without Data Dictionary reference
see also 'Text' parameters
 datatype (data type)
value set: SPACE, Data Dictionary data type (CHAR, NUMC,...)
Only relevant for fields without Data Dictionary reference
Program field data type
 ddic_outputlen (external output length)
value set: 0 (initial ), n
Only relevant for fields without Data Dictionary reference whose output is
nevertheless to be modified by a conversion exit.
Prerequisites:
 FIELDCAT-EDIT_MASK = '==conv'
see also the documentation of the parameter FIELDCAT-EDIT_MASK
 FIELDCAT-INTLEN = n
see also the documentation of the parameter FIELDCAT-INTLEN
n = external format field output length
The column width FIELDCAT-OUTPUTLEN need not be the same as the external
format output length (FIELDCAT-DDIC_OUTPUTLEN ).
 Intlen (internal output length)
value set: 0 (initial ), n
Only relevant for fields without Data Dictionary reference whose output is
nevertheless to be modified by a conversion exit.
Prerequisites:
 FIELDCAT-EDIT_MASK = '==conv'
see also the documentation of the parameter FIELDCAT-EDIT_MASK
 FIELDCAT-DDIC_OUTPUTLEN = n
see also the documentation of the parameter FIELDCAT-DDIC_OUTPUTLEN
n = internal format field output length
 rollname (data element)
value set: SPACE, Data Dictionary data element name
F1 help can be provided for a program field without a Data Dictionary reference, or
F1 help which differs from the Data Dictionary help can be provided for a field
with a Data Dictionary reference, using this parameter. When F1 help is called for
this field, the documentation of the specified data element is displayed. If the
FIELDCAT-ROLLNAME is initial for fields with a Data Dictionary reference, the
documentation of the data element of the referred Data Dictionary field is output.
Others
 sp_group (field group key)
value set: SPACE, CHAR(1)
Field group key.
Keys are assigned to group names in the IT_SPECIAL_GROUPS parameter (see also
the documentation of the parameter IT_SPECIAL_GROUPS).
When such an assignment is made in the field catalog and in IT_SPECIAL_GROUPS,
the fields are grouped correspondingly in the display variant popup.
 reprep (Report/Report interface selection criterion)
value set: SPACE, 'X'
Prerequisites:
 The system contains the Report/Report interface (function group RSTI, table
TRSTI)
 Parameter LAYOUT-REPREP = 'X' (see also the documentation of the parameter
LAYOUT-REPREP of the IMPORTING parameter IS_LAYOUT)
'X' = When the Report/Report interface is called, the value of this field is passed in
the selected interface start record as a selection criterion.

Function Module REUSE_ALV_LIST_DISPLAY Pag. 13 di 41


DOCUMENTAZIONE ALV (4.6 C)

Default
 The following entries are usually sufficient for internal table fields with a reference
to a field defined in the Data Dictionary :
 Fieldname
 ref_tabname
Notes:
ALV gets the remaining information from the Data Dictionary. If no relative column
position (COL_POS) is specified, the fields are output in the list in the order in which
they were added to the field catalog. REF_FIELDNAME need only be specifid when the
name of the internal table field differs from the name of the referred Data Dictionary
field. Information which is explicitly entered in the field catalog is not overwritten by
information from the Data Dictionary.
Priority rule:
Entries in the field catalog have priority over differing entries in the Data Dictionary.
 The following entries are usually sufficient for internal table fields without a
reference to the Data Dictionary (program fields):
 fieldname
 outputlen
 datatype
 seltext_s
 seltext_m
 seltext_l
Notes:
F1 help can be provided for program fields by assigning a data element to the parameter
ROLLNAME. If the parameters SELTEXT_S, SELTEXT_M , SELTEXT_L, and
REPTEXT_DDIC contain appropriate field labels, the program field column headers are
also adjusted appropriately when the column width changes.

IT_EXCLUDING Table of inactive function codes


The optional IMPORTING parameter IT_EXCLUDING is an internal table. It is only
needed if the caller uses the list tool standard interface but wants to deactivate interface
functions which he or she does not need.
In this case the function codes of these standard functions are entered in the table.
IT_SPECIAL_GROUPS Grouping fields for column selection
If fields have been grouped in the field catalog by a shared value of the parameter
SP_GROUP, the technical key of the group ( FIELDCAT-SP_GROUP) is assigned to the
field group text in this internal table. See also the documentation of the field catalog
parameter FIELDCAT-SP_GROUP of the IMPORTING parameter IT_FIELDCAT
and the Layout parameter LAYOUT-GROUP_BUTTONS of the IMPORTING parameter
IS_LAYOUT.
IT_SORT Sort criteria for first list display
The caller specifies the sorting and/or subtotalling of the basic list in the internal table
IT_SORT.
This internal table has the following fields:
 spos
Sort sequence
 fieldname
Internal output table field name
 tabname
Only relevant for hierarchical-sequential lists. Name of the internal output table
 up
'X' = sort in ascending order
 down
'X' = sort in descending order

Function Module REUSE_ALV_LIST_DISPLAY Pag. 14 di 41


DOCUMENTAZIONE ALV (4.6 C)

 subtot
'X' = subtotal at group value change
 group
'* ' = new page at group value change
'UL' = underline at group value change
The formatting options are constants of the domain SLIS_CTRLS. See also the
documentation of GROUP_CHANGE_EDIT of the interface structure IS_LAYOUT for
more information about group value change formatting.
 Comp (INTERNAL USE ONLY)
 Expa
Prerequisite:
IT_SORT-SUBTOT = 'X', i.e. sort criterion is also subtotal criterion
If the first list output is only to be expanded to total level n, and can then be further
expanded interactively by the user, the flag should be set at the total level criterion
for level n
IT_FILTER Filter criteria for first list output
Filter criteria table
Filter criteria which result, e.g. from explicitly loading an initial display variant, can be
passed to list output in this parameter. This table should never be built-up 'manually'.
IS_SEL_HIDE Selection information modification
Only relevant when the layout parameter LAYOUT-GET_SELINFOS of the IMPORTING
structure IS_LAYOUT is set. Complex type for modifying the information displayed in
the selection info popup:
 mode: 'R' = only the entries passed in the internal table IS_SEL_HIDE-T_ENTRIES
are output in the popup. Selection info which the list tool read in the selection
screen (when called by a report with a selection screen) are replaced by the values
passed.
mode: 'S' = the selection info which the list tool read in the selection screen of the
calling report are modified by the entries in the table IS_SEL_HIDE-T_ENTRIES.
 t_entries : Selection info table
 t_entries-mode : 'A' = output the selection info for the current table record
additionally in the info popup.
t_entries-mode : 'D' = do not output select option or SELNAME parameter selection
info in the popup.
 t_entries-selname : (only used in t_entries-mode = 'D') Name of the select option or
parameter.
The following table fields are only used in t_entries-mode = 'A'. They contain the
selection information to be added.
 t_entries-field : DDIC field name of the field for which selection
information is to be output.
 t_entries-table : DDIC table names of t_entries-field.
 t_entries-stext : Field name in info popup. If t_entries-field and t_entries-table have
been ntered, this text is taken from DDIC.
 t_entries-valuf : Selection condition 'from' value (external format)
 t_entries-valut : Selection condition 'to' value (external format)
 t_entries-sign0: (I)nclusive (E)xclusive
 t_entries-optio : All values of the select options Option field allowed.
The remaining fields are used internally and are not relevant for the caller.
I_DEFAULT Initial variant active/inactive logic
Initial variant logic active/inactive.
Prerequisite:
 The parameter IS_VARIANT has the appropriate value.
 See also the documentation of the IMPORTING parameter IS_VARIANT.
Value Range
SPACE = no initial variant can be defined

Function Module REUSE_ALV_LIST_DISPLAY Pag. 15 di 41


DOCUMENTAZIONE ALV (4.6 C)

'X' = initial variant can be defined


Default: SPACE
I_SAVE Variants can be saved
Controls the storage mode
Prerequisite:
 The IS_VARIANT parameter has the appropriate value.
 See also the documentation of the IMPORTING parameter IS_VARIANT.
Value Range
 ' ' = display variants cannot be saved
Defined display variants (e.g. delivered display variants) can be selected for
presentation independently of this flag.
Changes can not be saved.
 'X' = standard save
Display variants can be saved as standard display variants.
User-specific saving is not possible.
 'U' = only user-specific saving
The user can only save display variants user-specifically
 'A' = standard and user-specific saving
The user can save a display variant user-specifically and as standard display
variant. The user chooses in the display variant save popup.
Default: SPACE
IS_VARIANT Variant information
This structure is only relevant if display variants are to be saved and/or read.
Variant information including the name of the list output variant.
The access path must be specified in the fields REPORT (required field), HANDLE
(optional) and/or LOG_GROUP (optional) to allow ALV to read display variants. If
display variants are also to be saved, the parameter I_SAVE must also be entered. See
also the documentation of the IMPORTING parameter I_SAVE.
A variant is identified uniquely by:
 the program to which it is assigned ( REPORT)
 the handle if, e.g. several lists with various structures and data are called ( HANDLE)
in a program (I_CALLBACK_PROGRAM)
The handle is a unique user-assigned CHAR(4) field, which assigns the call to the
current internal output table structure.
Example:
Various lists can be output in program x, depending on a user action. Display
variants are to be able to be defined for each of these lists. This functionality is
guaranteed by assigning a HANDLE for each list. If variants are saved for this
program and handle, the handle must not change.
 the logical group if, e.g. the same list is made with different settings ( LOG_GROUP)
via different transactions
The logical group is a unique user-assigned CHAR(4) field which determines the
assignment.
Example:
The program x is called via the transactions T1 and T2. The field catalog fields
offered to the user vary depending on the transaction code by assignment to logical
groups.
If variants are saved for the program and logical group, the logical group must not
change.
 the user name, if variants are saved user-specifically ( USERNAME)
This parameter is never entered manually as the variant name is unique.
 the variant name (VARIANT).
This parameter is only to be entered if a particular variant is to be read and the list
is to be output with this variant via this structure.

Function Module REUSE_ALV_LIST_DISPLAY Pag. 16 di 41


DOCUMENTAZIONE ALV (4.6 C)

Value Range: The above fields must be specified to be able to call a list with a variant.
Default: If the structure is initial but saving is active ( I_SAVE is not initial),
IS_VARIANT-REPORT is set to I_CALLBACK_PROGRAM. The function module
REUSE_ALV_VARIANT_F4 provides variant possible entry help.
IT_EVENTS Table of events to perform
This table tells ALV which events are processed by the caller by CALLBACK. The table
of possible events per list type can be initialized using the module
REUSE_ALV_EVENTS_GET.
You can display the names of the constants in the type pools SLIS which represent the
individual events using the individual test function in the function module
REUSE_ALV_EVENT_NAMES_GET. Only events with a form routine name are
processed.
The table structure contains the fields:
 IT_EVENTS-NAME
Name of the Callback event.
Possible Callback events:
 Action
USER_COMMAND USING R_UCOMM LIKE SY-UCOMM
RS_SELFIELD TYPE SLIS_SELFIELD
Process actions on the list
As this is a frequently-used Callback event, the form routine can also be passed
directly in the interface in the IMPORTING parameter
I_CALLBACK_USER_COMMAND .
PF_STATUS_SET USING RT_EXTAB TYPE SLIS_T_EXTAB
If a user list status is to be set, it must be done in the form routine assigned to
this event. The ALV function codes, which must not be active, are in the
Parameter RT_EXTAB. This table must be passed with the SET PF-STATUS
command (with inactive user function codes as well, if necessary).
The STANDARD status of the function group SALV should be used as a
template for a user-specific status.
As this is a frequently-used Callback event, its form routine can also be passed
directly in the interface in the IMPORTING parameter
I_CALLBACK_PF_STATUS_SET.
ITEM_DATA_EXPAND USING RS_SELFIELD TYPE SLIS_SELFIELD
RFLG_ALL TYPE C
Only relevant for hierarchical-sequential lists using the layout parameter
IS_LAYOUT-EXPAND_FIELDNAME of the structure IS_LAYOUT.
Exit for passing item entries ( ITEM table) for a header record which was
expanded interactively by the user.
RS_SELFIELD-TABINDEX contains the header table index for which the item
entries are to be put in the global item output table ( T_OUTTAB_SLAVE). The
Callback is only called if ALV has no items for a header which is to be
expanded.
RFLG_ALL is passed with ' X' if the user shows all items. The application must
ensure that entries are not repeated in the item table.
RS_SELFIELD is initial in this case.
CALLER_EXIT USING RS_DATA
Is called at the beginning of the function module to make special settings. It is
not usually used.
 List processing events
IMPORTANT: The application Callback routine must not manipulate the
internal output table and/or its header record. This restriction applies to all
Callbacks which are called in the list output and run under the 'List processing
events'.
 TOP_OF_LIST no USING parameter
Information output at the start of the list
 END_OF_LIST no USING parameter

Function Module REUSE_ALV_LIST_DISPLAY Pag. 17 di 41


DOCUMENTAZIONE ALV (4.6 C)

Information output at the end of the list


 TOP_OF_PAGE no USING parameter
Equivalent to the list processing TOP-OF-PAGE event
 END_OF_PAGE no USING parameter
Not available for hierarchical-sequential lists. Information output at the
end of a page. This is only called for printing.
 TOP_OF_COVERPAGE no USING parameter
The selection information and list status are output together (if they exist)
on a separate page by default. See also the documentation of the
parameters:
 IS_PRINT-NO_COVERPAGE
 IS_PRINT-NO_PRINT_SELINFOS
 IS_PRINT-NO_PRINT_LISTINFOS
 IS_LAYOUT-GET_SELINFOS
The user can format the header area of the 'cover page' himself or herself
by specifying a Callback routine for this event.
 END_OF_COVERPAGE no USING parameter
Analogously to TOP_OF_COVERPAGE the user can add other information
to the information output by ALV (selection information, list status) at this
event.
 FOREIGN_TOP_OF_PAGE no USING parameter
The Top-of-page event is always processed in ALV and is only passed to
the caller via the Callback mechanism. This is still the case if the caller,
e.g. by a user action, processes a branch list which was not formatted by
ALV (e.g. a popup with additional information about the list record
selected and displayed by ALV).
In this case, top-of-page cannot be formatted by ALV analogously to the
basic list, it must be handled completely by the caller. The event top-of-
page still occurs in ALV. When ALV notices a top-of-page which was not
caused by an ALV output, the form routine in FOREIGN_TOP_OF_PAGE is
called.
 FOREIGN_END_OF_PAGE no USING parameter
The event end-of-page is always processed in ALV and only passed to the
caller via callback. This is still the case, e.g. when the caller processes a
details list which was not formatted by ALV (e.g. a popup with further
information about selected list records which were displayed by ALV).
In this case, end-of-page cannot be formatted by ALV analogously to the
basic list, it must be handled completely by the caller. The event end-of-
page still occurs in ALV. When ALV notices an end-of-page that was not
caused by an ALV output, the form routine in FOREIGN_END_OF_PAGE is
called.
 BEFORE_LINE_OUTPUT USING RS_LINEINFO TYPE SLIS_LINEINFO
Output information before each output line. Should only be used in
justified cases because it costs a lot of performance.
 AFTER_LINE_OUTPUT USING RS_LINEINFO TYPE SLIS_LINEINFO
Output information after each output line. Should only be used in justified
cases because it costs a lot of performance.
 Internal use only
 LIST_MODIFY USING R_TABNAME TYPE SLIS_TABNAME
 R_INDEX LIKE SY-TABIX
 R_INDEX_ITEM LIKE SY-TABIX
 R_INDEX_SUM LIKE SY-TABIX
 IT_EVENTS-FORM
Name of the form routine which should be called in the calling program at the
event.
IT_EVENT_EXIT Standard fcode exit requests table
Table for passing ALV standard function codes, to return control to the user before
and/or after execution with the callback event USER_COMMAND. See also the

Function Module REUSE_ALV_LIST_DISPLAY Pag. 18 di 41


DOCUMENTAZIONE ALV (4.6 C)

documentation of the IMPORTING parameter I_CALLBACK_USER_COMMAND. This


table should only be passed when the application wants to react to the execution of
standard functions. This could, e.g. be to check the authorization for a standard function
or to select data depending on the current display variant.
The table fields are as follows:
 Ucomm
Standard function code which is also passed in the callback event
USER_COMMAND.
Example: ucomm = '&OL0' means that the application also gets control at the
display variant definition function code.
 Before
'X' = the application gets control before ALV executes the function.
 After
'X' = the application gets control after ALV has executed the function, but before
the list is output.
Example: ucomm = '&OL0' and after = 'X' .
The application gets control after the user has left the display variant definition popup.
In the function code processing form routine which is passed to ALV in the
I_CALLBACK_USER_COMMAND parameter, the application can now get the field
catalog which may have been modified by the user, using the module
REUSE_ALV_LIST_LAYOUT_INFO_GET , and then reselect the data for the new output
fieldes in the internal output table, if necessary.
If the application sets the SELFIELD-REFRESH flag (USER_COMMAND form routine
interface reference parameter) after the selection, the list is output again. Output fields
added by the user and reselected data now appear.
IS_PRINT Print information
Print control parameter
 PRINT
value set: SPACE, 'X'
'X' = the list is to be printed and not displayed on the screen. Other settings can be
made in the print parameter screen.
 NO_PRINT_SELINFOS
Value set: SPACE, 'X'
'X' = do not print selection info (see LAYOUT-GET_SELINFOS)
 NO_COVERPAGE
value set: SPACE, 'X'
'X' = do not print selection information and list status on a separate page.
 NO_NEW_PAGE
value set: SPACE, 'X'
For internal use only
 RESERVE_LINES
value set: 0, n
Not relevant for hierarchical-sequential lists and block lists.
n = number of lines to be printed by the user in the footer area in the Callback at
the event END_OF_PAGE.
 NO_PRINT_LISTINFOS
value set: SPACE, 'X'
'X' = Do not print list status (sort, subtotal and filter information).
 NO_CHANGE_PRINT_PARAMS
value set: SPACE, 'X'
SPACE = (default) The output format (number of columns) is dynamically adjusted
to the list width (max. 255).
'X' = The current print parameters are used. If the list is wider, the output width is
not dynamically adjusted.
IS_REPREP_ID

I_SCREEN_START_COLUMN Coordinates for list in dialog box

Function Module REUSE_ALV_LIST_DISPLAY Pag. 19 di 41


DOCUMENTAZIONE ALV (4.6 C)

Only to be used if the list is output in a popup.


x coordinate of the top left-hand corner of the popup.
I_SCREEN_START_LINE Coordinates for list in dialog box
Only used if the list is output in a popup.
y coordinate of the top left-hand corner of the popup.
I_SCREEN_END_COLUMN Coordinates for list in dialog box
Only used if the list is output in a popup.
x coordinate of the bottom right-hand corner of the popup.
I_SCREEN_END_LINE Coordinates for list in dialog box
Only used if the list is output in a popup.
y coordinate of the bottom right-hand corner of the popup.
E_EXIT_CAUSED_BY_CALLER Delete list in CALLBACK_USER_COMMAND
Parameter which states whether the caller left the list ( SELFIELD-EXIT = 'X') in
CALLBACK USER_COMMAND
ES_EXIT_CAUSED_BY_USER How the user left the list
If one of the ALV standard function codes for 'Back', 'Cancel' or 'Exit' occurs, the
current list is discarded and the ALV function module ends. In this case the exporting
structure ES_EXIT_CAUSED_BY_USER contains one of the following flags:
 ES_EXIT_CAUSED_BY_USER-BACK = 'X' 'Back' occurred
 ES_EXIT_CAUSED_BY_USER-CANCEL = 'X' 'Cancel ' occurred
 ES_EXIT_CAUSED_BY_USER-EXIT = 'X' 'Exit' occurred
The function which occured determines the further navigation in the application.
T_OUTTAB Table with data to be displayed
Internal table with any structure containing the data to be output in list form. This table
can contain more fields than are relevant for the list output (display fields and field list).
Only the fields named in field catalog and the layout structure are used for the list
output. Other internal table fields are ignored. The value of the field FIELDCAT-
NO_OUT in the field catalog determines whether a field is output directly in the list, or
whether this field is initially put in the field list. The user can interactively move fields
between this field list and the output field list to display or hide them. If the internal
table is defined in the calling program without a header, no F1 help is possible in the
list.

Exceptions
PROGRAM_ERROR Program errors - Exception type
If the exception is not handled by the calling program, the following applies:
(X) an error message is sent.
( ) a termination message is sent.
( ) a runtime error occurs.

Function group
SALV ABAP List Viewer
Central list presentation tool with generic functionality
Scenarios which illustrate the use of the modules will be documented here.
 Scenario 1
To create a list which requires no application-specific interactions. The generic
ALV functionality is sufficient.
The data are in an internal table. The internal table is defined with reference to a
Data Dictionary structure or table:
 Scenario 2

Function Module REUSE_ALV_LIST_DISPLAY Pag. 20 di 41


DOCUMENTAZIONE ALV (4.6 C)

Save display variants active


 Scenario 3
Data selection by the application by changing the display variant.
Requirement
An important consideration for the use of the tool or various generic functions (totals,
subtotals) is the expected amount of data to be displayed.
The application must take this into account.
Demo reports:
 Simple lists
 BALVSD01
 BALVSD02 (simplest call)
 BALVSD03
 Hierarchical-sequential lists
 BALVHD01

Function Module REUSE_ALV_LIST_DISPLAY Pag. 21 di 41


DOCUMENTAZIONE ALV (4.6 C)

REUSE_ALV_EVENTS_GET
(documentazione ufficiale release 4.6C)
Returns table of possible events for a list type
This table can be passed to the ALV display module with the form name.

Parameter
 I_LIST_TYPE List type (0,1,2,3)

Value Range for call:


0= simple list REUSE_ALV_LIST_DISPLAY
1= hierarchic-sequential list REUSE_ALV_HIERSEQ_LIST_DISPLAY
2= simple block list REUSE_ALV_BLOCK_LIST_APPEND
3= hierarchic-sequential block list REUSE_ALV_BLOCK_LIST_HS_APPEND
Default: 0

 ET_EVENTS Table of events to perform


The event table is returned with all possible CALLBACK events for the specified list
type (column 'NAME').
For events to be processed by Callback, their ' FORM' field must be filled. If the field is
initialized, the event is ignored. The entry can be read from the event table, the field
'FORM' filled and the entry modified using constants from the type pool SALV.
The function module REUSE_ALV_EVENT_NAMES_GET gets the names of these
constants (call in test mode). For more info, see parameter IT_EVENTS on function
module REUSE_ALV_LIST_DISPLAY documentation.

Exceptions
 LIST_TYPE_WRONG

Function group
(vedi alle pagine precedenti, nella documentazione del function module
SALV
REUSE_ALV_EVENTS_GET )

Function Module REUSE_ALV_LIST_DISPLAY Pag. 22 di 41


DOCUMENTAZIONE ALV (4.6 C)

REUSE_ALV_EVENT_NAMES_GET
(documentazione ufficiale release 4.6C)
Returns table of constant names of possible events for a list type
This module shows the SLIS type pool constant names for the list type in test mode. The events in the calling programs
should only be accessed using these constants.

Parameter
 I_LIST_TYPE List type (0,1,2,3)

Value Range
for call:
0 = simple list REUSE_ALV_LIST_DISPLAY
1 = hierarchic-sequential list REUSE_ALV_HIERSEQ_LIST_DISPLAY
2 = simple block list REUSE_ALV_BLOCK_LIST_APPEND
3 = hierarchic-sequential block list REUSE_ALV_BLOCK_LIST_HS_APPEND
Default: 0

 T_EVENT_NAMES

Exceptions
 LIST_TYPE_WRONG

Function group
SALV (vedi alle pagine precedenti, nella documentazione del function module
REUSE_ALV_EVENTS_GET )

Function Module REUSE_ALV_POPUP_TO_SELECT


Pag. 23 di 41
DOCUMENTAZIONE ALV (4.6 C)

REUSE_ALV_FIELDCATALOG_MERGE
(documentazione ufficiale release 4.6C)
Create field catalog from dictionary structure or internal table
Supports the creation of the field catalog for the ALV function modules based either on a structure or table defined in the
ABAP Data Dictionary, or a program-internal table.
The program-internal table must either be in a TOP Include or its Include must be specified explicitly in the interface.
The variant based on a program-internal table should only be used for rapid prototyping since the following restrictions
apply:
 Performance is affected since the code of the table definition must always be read and interpreted at runtime.
 Dictionary references are only considered if the keywords LIKE or INCLUDE STRUCTURE (not TYPE) are used.
If the field catalog contains more than 90 fields, the first 90 fields are output in the list by default whereas the remaining
fields are only available in the field selection.
If the field catalog is passed with values, they are merged with the 'automatically' found information.

Parameter
 I_PROGRAM_NAME Internal table declaration program
Program from which the function module is called and which contains the exit
routines. The program should always be a Report, Function group, Module pool or
Form routine pool (not an Include). The specification of a structure is preferable to
data declaration in an Include for reasons of performance.
 I_INTERNAL_TABNAME Output table name
Name of the internal output table in the CALLBACK_PROGRAM. An ABAP DDIC
structure is preferable to a data object in a CALLBACK program Include.
 I_STRUCTURE_NAME Structure name (structure, table, view)
See parameter I_STRUCTURE_NAME on function module
REUSE_ALV_LIST_DISPLAY documentation.
 I_CLIENT_NEVER_DISPLAY Hide client fields
Client field handling in the structure passed.

Value Range: 'X', SPACE


SPACE: client fields (type CLNT) in the structure passed are flagged as technical (
no screen output) in the field catalog.
 I_INCLNAME Data declaration include name
If the list output structure data declaration is not in the assigned TOP Include, the
Include name can be specified here if no structure is specified.
 I_BYPASSING_BUFFER
 I_BUFFER_ACTIVE

 CT_FIELDCAT Field catalog with field descriptions


See parameter IT_FIELDCAT on function module REUSE_ALV_LIST_DISPLAY
documentation.

Exceptions
 INCONSISTENT_INTERFACE
 PROGRAM_ERROR

Function group
SALV (vedi alle pagine precedenti, nella documentazione del function module

Function Module REUSE_ALV_POPUP_TO_SELECT


Pag. 24 di 41
DOCUMENTAZIONE ALV (4.6 C)

REUSE_ALV_EVENTS_GET )

Function Module REUSE_ALV_POPUP_TO_SELECT


Pag. 25 di 41
DOCUMENTAZIONE ALV (4.6 C)

REUSE_ALV_COMMENTARY_WRITE
(documentazione ufficiale release 4.6C)
List body comment block output

Functionality
List header information is output according to its type. The output information is put in an internal table. Output attributes
are assigned to each line via the TYP field.
This module outputs formatted simple header information at TOP-OF-PAGE.

Example
List <-- Type 'H'
Currency DEM Controlling area currency <-- Type 'S'
Material FGS_TEST Test material <-- Type 'S'
Action info <-- Type 'A'
------------------- Column headers ----------------------------------
------------------- List --------------------------------------------

Parameter
 IT_LIST_COMMENTARY Comment block
Internal table with the following fields:
 TYP: Possible values:
- (H)eader: List header
only the contents of INFO are output (KEY is ignored)
usually one line = one entry
Attributes: - left-justified
- Bold
- followed by empty line
- (S)election: Important header information, e.g. currency of amounts in the list
display format: KEY (bold) INFO (normal)
Ex.: Currency DEM
Ctrl area FGS_TEST Test material
Usually several entries (one entry per line)
Attributes: - left-justified
- bold (KEY = on / INFO = off)
- followed by empty line
- (A)ction: Action info (see LIBS)
direct output via table
only the contents of INFO are output (KEY is ignored)
usually one entry
Attributes: - left-justified
- normal intensity
 KEY: String with keyword character output in combination with TYP = 'S'.
 INFO: Information output in header, formatted by type.
 I_LOGO

 I_END_OF_LIST_GRID

Function group
SALV (vedi alle pagine precedenti, nella documentazione del function module

Function Module REUSE_ALV_POPUP_TO_SELECT


Pag. 26 di 41
DOCUMENTAZIONE ALV (4.6 C)

REUSE_ALV_EVENTS_GET )

Esempio
(dal report standard d’esempio BALVSD01)
data: gt_list_top_of_page type slis_t_listheader.
data: gt_events type slis_t_event.
**********
initialization.
perform e03_eventtab_build using gt_events[].
perform e04_comment_build using gt_list_top_of_page[].
**********
form e03_eventtab_build using e03_lt_events type slis_t_event.
data: ls_event type slis_alv_event.
call function 'REUSE_ALV_EVENTS_GET'
exporting
i_list_type = 0
importing
et_events = e03_lt_events.
read table e03_lt_events with key name = slis_ev_top_of_page
into ls_event.
if sy-subrc = 0.
move gc_formname_top_of_page to ls_event-form.
append ls_event to e03_lt_events.
endif.
endform.
**********
form e04_comment_build2 using e04_lt_top_of_page type slis_t_listheadr.
data: ls_line type slis_listheader.
* Listenüberschrift: Typ H
clear ls_line.
ls_line-typ = 'H'.
* LS_LINE-KEY: not used for this type
ls_line-info = 'Intestazione lista'.
append ls_line to e04_lt_top_of_page.
* Kopfinfo: Typ S
clear ls_line.
ls_line-typ = 'S'.
ls_line-key = 'Chiave 1'.
ls_line-info = 'Testo informativo'.
append ls_line to e04_lt_top_of_page.
ls_line-key = 'Chiave 2'.
append ls_line to e04_lt_top_of_page.
* Aktionsinfo: Typ A
clear ls_line.
ls_line-typ = 'A'.
* LS_LINE-KEY: not used for this type
ls_line-info = 'Stato lista'.
append ls_line to e04_lt_top_of_page.
endform.
**********
form top_of_page.
* Scrive la top-of-page, ed è richiamata automaticamente
* da ALV grazie alle due perfom precedenti
call function 'REUSE_ALV_COMMENTARY_WRITE'
exporting
it_list_commentary = gt_list_top_of_page.
endform.

Output a video: top-of-page di una lista ALV


Intestazione lista

Function Module REUSE_ALV_POPUP_TO_SELECT


Pag. 27 di 41
DOCUMENTAZIONE ALV (4.6 C)

Chiave 1 Testo informativo


Chiave 2 Testo informativo

Stato lista

Function Module REUSE_ALV_POPUP_TO_SELECT


Pag. 28 di 41
DOCUMENTAZIONE ALV (4.6 C)

REUSE_ALV_HIERSEQ_LIST_DISPLAY
(documentazione ufficiale release 4.6C)
Hierarchical sequential list output

Functionality
This module outputs two internal tables as a formated hierarchical-sequential list.
Principle:
 Pass an internal table containing the set of header information to be output.
 Pass an internal table containing the set of item information to be output.
 Pass a structure containing the general list layout details
 Pass a field catalog in the form of an internal table. The field catalog describes the fields to be output in the list.

Notes
 All interactions which are performed on the list refer directly to the internal output tables, e.g. sorting the list also
sorts the passed internal output tables (passed by reference).
 The expected output data quantity is an important consideration for the use of the tool or various generic functions
(totals, subtotals).
The application must take account of this.

Parameter

ES_LAYOUT ( REUSE_ALV_LIST_DISPLAY - IS_LAYOUT)

ET_FIELDCAT ( REUSE_ALV_LIST_DISPLAY - IT_FIELDCAT)

ET_SORT ( REUSE_ALV_LIST_DISPLAY - IT_SORT)

ET_FILTER ( REUSE_ALV_LIST_DISPLAY - IT_FILTER)

ES_LIST_SCROLL

ES_VARIANT

E_WIDTH

ET_MARKED_COLUMNS

ET_FILTERED_ENTRIES

ET_FILTERED_ENTRIES_HEADER

ET_FILTERED_ENTRIES_ITEM

ET_OUTTAB

ET_OUTTAB_HEADER

ET_OUTTAB_ITEM

ET_COLLECT00

ET_COLLECT01

ET_COLLECT02

ET_COLLECT03

ET_COLLECT04

ET_COLLECT05

ET_COLLECT06

ET_COLLECT07

ET_COLLECT08

ET_COLLECT09


Per la spiegazione di questi parametri si rimanda alla documentazione del function module
REUSE_ALV_LIST_DISPLAY , anche se il nome è leggermente diverso

 ES_LIST_SCROLL Current list scroll status


Structure with fields which describe the current list scroll status:
 lsind
See the documentation of the system field SY-LSIND
 cpage
See the documentation of the system field SY-CPAGE

Function Module REUSE_ALV_POPUP_TO_SELECT


Pag. 29 di 41
DOCUMENTAZIONE ALV (4.6 C)

 staro
See the documentation of the system field SY-STARO
 cursor_line
current cursor row position in the list (not in the internal output table)
 cursor_offset
current cursor column position in the list (not in the internal output table)

Exceptions

NO_INFOS

PROGRAM_ERROR

Function group
SALV (vedi alle pagine precedenti, nella documentazione del function module
REUSE_ALV_EVENTS_GET )

Function Module REUSE_ALV_POPUP_TO_SELECT


Pag. 30 di 41
DOCUMENTAZIONE ALV (4.6 C)

REUSE_ALV_LIST_LAYOUT_INFO_GET
(documentazione ufficiale release 4.6C)
Read current ALV list information

Functionality
The caller can get current list status information with this module.
The current layout, the current field catalog, sort and current list scroll status information, and filter conditions are
returned.

Notes
Function module for modifying the information provided: REUSE_ALV_LIST_LAYOUT_INFO_SET

Parameter

ES_LAYOUT ( REUSE_ALV_LIST_DISPLAY - IS_LAYOUT)

ET_FIELDCAT ( REUSE_ALV_LIST_DISPLAY - IT_FIELDCAT)

ET_SORT ( REUSE_ALV_LIST_DISPLAY - IT_SORT)

ET_FILTER ( REUSE_ALV_LIST_DISPLAY - IT_FILTER)

ES_LIST_SCROLL

ES_VARIANT

E_WIDTH

ET_MARKED_COLUMNS

ET_FILTERED_ENTRIES

ET_FILTERED_ENTRIES_HEADER

ET_FILTERED_ENTRIES_ITEM

ET_OUTTAB

ET_OUTTAB_HEADER

ET_OUTTAB_ITEM

ET_COLLECT00

ET_COLLECT01

ET_COLLECT02

ET_COLLECT03

ET_COLLECT04

ET_COLLECT05

ET_COLLECT06

ET_COLLECT07

ET_COLLECT08

ET_COLLECT09

Per la spiegazione di questi parametri si rimanda alla documentazione del function module
REUSE_ALV_LIST_DISPLAY , anche se il nome è leggermente diverso

 ES_LIST_SCROLL Current list scroll status


Structure with fields which describe the current list scroll status:
 lsind
See the documentation of the system field SY-LSIND
 cpage
See the documentation of the system field SY-CPAGE
 staro
See the documentation of the system field SY-STARO
 cursor_line
current cursor row position in the list (not in the internal output table)
 cursor_offset
current cursor column position in the list (not in the internal output table)

Function Module REUSE_ALV_POPUP_TO_SELECT


Pag. 31 di 41
DOCUMENTAZIONE ALV (4.6 C)

Exceptions

NO_INFOS

PROGRAM_ERROR

Function group
SALV (vedi alle pagine precedenti, nella documentazione del function module
REUSE_ALV_EVENTS_GET )

Function Module REUSE_ALV_POPUP_TO_SELECT


Pag. 32 di 41
DOCUMENTAZIONE ALV (4.6 C)

REUSE_ALV_LIST_LAYOUT_INFO_SET
(documentazione ufficiale release 4.6C)
Set current ALV list information

Functionality
The caller can change the current list description with this module.

Example
If a list has initially been called without exceptions, the application could proceed as follows:
 get control after a user action (event USER_COMMAND)
 set exception values per list row and in the internal output table
 get the current layout structure from REUSE_ALV_LIST_LAYOUT_INFO_GET.
 change the layout structure (LAYOUT-BOX_FIELDNAME is specified)
 set the changed layout structure from REUSE_ALV_LIST_LAYOUT_INFO_SET.
 set the SELFIELD-REFRESH flag in the RS_SELFIELD interface structure which was passed at the USER_COMMAND
event.
See also the documentation of the IMPORTING parameter I_CALLBACK_USER_COMMAND.
The list is output again with the changed layout information. The traffic lights set in the User Exit appear in the list.

Parameter

IS_LAYOUT

IT_FIELDCAT

IT_SORT

IT_FILTER

IS_LIST_SCROLL ( REUSE_ALV_LIST_LAYOUT_INFO_GET - ES_LIST_SCROLL)


Per la spiegazione di questi parametri si rimanda alla documentazione del function module
REUSE_ALV_LIST_DISPLAY o (nel caso dell’ultimo parametro) del function module
REUSE_ALV_LIST_LAYOUT_INFO_GET.

Function group
SALV (vedi alle pagine precedenti, nella documentazione del function module
REUSE_ALV_EVENTS_GET )

Function Module REUSE_ALV_POPUP_TO_SELECT


Pag. 33 di 41
DOCUMENTAZIONE ALV (4.6 C)

REUSE_ALV_POPUP_TO_SELECT
(documentazione ufficiale release 4.6C)
List in dialog box to choose one or more entries (or display only)

Functionality
Module for displaying or selecting table entries in internal tables in a popup (single or multiple selection is possible).
Principle:
 pass an internal table with the superset of information to be output
 pass list layout detail flags
 pass a field catalog in the form of an internal table
The field catalog describes the fields to be output in the list.

Further Information
The module uses the function module ' REUSE_ALV_LIST_DISPLAY' internally. The documentation of this module
contains further information about the field catalog.

Parameter

I_TITLE

I_SELECTION

I_ZEBRA

I_SCREEN_START_COLUMN

I_SCREEN_START_LINE

I_SCREEN_END_COLUMN

I_SCREEN_END_LINE

I_CHECKBOX_FIELDNAME

I_LINEMARK_FIELDNAME

I_SCROLL_TO_SEL_LINE

I_TABNAME

I_STRUCTURE_NAME 

IT_FIELDCAT

IT_EXCLUDING

I_CALLBACK_PROGRAM

I_CALLBACK_USER_COMMAND

IS_PRIVATE

ES_SELFIELD

E_EXIT

T_OUTTAB


Per la spiegazione di questi parametri si rimanda alla documentazione del function module
REUSE_ALV_LIST_DISPLAY

 I_TITLE Dialog box title


Title to be displayed as the popup title.
 I_SELECTION (X) = Selection possible, ( ) = Display
I_SELECTION = 'X'  the user can select entries in the displayed internal table.
Default: Entries selectable
 I_ZEBRA Line output with alternating color
I_ZEBRA = 'X'  List rows are output in alternating colors for better readability. This
option should be used when the list is relatively wide.
Default: Output in alternating colors

 I_SCREEN_START_COLUMN Coordinates for list in dialog box

Function Module REUSE_ALV_POPUP_TO_SELECT


Pag. 34 di 41
DOCUMENTAZIONE ALV (4.6 C)

Column coordinate of the top left-hand corner of the popup. If no coordinates or only
the coordinates of the top left-hand corner are specified in the interface, the module
calculates the optimal coordinates using the table information. The coordinates need
not normally be specified in the interface parameters. You can position the popups by
specifying the top left-hand corner, without specifying its size.
Default: If the coordinates have initial values, the function module calculates the
optimal coordinates.
 I_SCREEN_START_LINE Coordinates for list in dialog box
Row coordinate of the top left-hand corner of the popup. If no coordinates or only the
coordinates of the top left-hand corner are specified in the interface, the module
calculates the optimal coordinates using the table information. The coordinates need
not normally be specified in the interface parameters. You can position the popups by
specifying the top left-hand corner, without specifying its size.
Default: If the coordinates have initial values, the function module calculates the
optimal coordinates.

 I_SCREEN_END_COLUMN Coordinates for list in dialog box


Column coordinate of the bottom right-hand corner of the popup. If no coordinates, or
only the coordinates of the top left-hand corner are specified in the interface, the
module attempts to calculate the optimal coordinates from the table information. So
normally the coordinates need not be specified in the interface parameters. You can
position the popup by specifying the top left-hand corner, without specifying its size.
Default: If the coordinate values are initial, the function modules calculates the
optimal coordinates.

 I_SCREEN_END_LINE Coordinates for list in dialog box


Row coordinate of the bottom right-hand corner of the popup. If no coordinates, or
only the coordinates of the top left-hand corner are specified in the interface, the
module calculates the optimal coordinates using the table information. The
coordinates need not normally be specified by specifying the interface interface
parameters. You can position the popup by specifying the top left-hand corner,
without specifying its size.
Default: If the coordinate values are initial, the function module calculates the
optimal coordinates.

 I_CHECKBOX_FIELDNAME Output table checkbox field name


If the table output in the popup has checkboxes at the beginning of the rows (e.g. for
multiple selection), the internal table must contain a field containing the value of the
checkbox. Assign the name of this field to the parameter I_CHECKBOX_FIELDNAME.
 I_LINEMARK_FIELDNAME Line selection color information field name
Name of the internal output table field containing the color code. A complete list row
is colored individually by color coding in a column of the internal output table. The
name of this field is assigned to this parameter. The internal output table field must be
of type CHAR(3). The coding must have the following syntax:
'Cxy': C = color (each code must begin with ' C')
x = color number ('1'-'9')
y = highlight ('0' = off, '1' = on)
Note: the color of the key columns is not affected.
 I_SCROLL_TO_SEL_LINE Scroll to default selection if necessary
A row has been color highlighted and its index in the internal output table is greater
than the number of entries which can be displayed in the popup without scrolling.
When the popup is called, the cursor should be immediately positioned on, or scrolled

Function Module REUSE_ALV_POPUP_TO_SELECT


Pag. 35 di 41
DOCUMENTAZIONE ALV (4.6 C)

to, this row.


Prerequisite: color code the highlighted row with 'C50'
See also the documentation of the importing parameter I_LINEMARK_FIELDNAME
Default: Positioning on the highlighted row

 I_TABNAME Table name with chosen values


Name of the internal output table in the calling program
 IT_EXCLUDING Table of inactive function codes
The optional IMPORTING parameter IT_EXCLUDING is an internal table. This is only
used when the caller wants to deactivate standard functions. The function codes of
these standard functions are entered in this table. At most the following functions are
active in the standard and can be deactivated using IT_EXCLUDING:
 Function code: &ETA (Detail)
 Function code: &SC (Find)
 Function code: &SC+ (Find next)
 Function code: &OUP (Sort ascending)
 Function code: &ODN (Sort descending)
 Function code: &ILT (Filter)
 Function code: &OL0 (Display variant)
 Function code: &CRB (Horizontal scroll: First column)
 Function code: &CRL (Horizontal scroll: Previous column)
 Function code: &CRR (Horizontal scroll: Next column)
 Function code: &CRE (Horizontal scroll: Last column)
 Function code: &AC1 (Cancel)
Only for active checkboxes:
 Function code: &ALL (Select all)
 Function code: &SAL (Deselect all)
 ES_SELFIELD Selection info for simple selection
The structure SELFIELD contains the following information about the current cursor
position
 tabname : internal output table name
 tabindex : internal output table index
 fieldname field name
 value : field contents
Multiple selection using checkboxes puts an ' X' in the I_CHECKBOX_FIELDNAME
field in the corresponding row in the internal table.
 E_EXIT 'X' = Cancel by user
Flag is set when the user leaves the popup with the 'Cancel' function.
 T_OUTTAB Selection value table
Internal table of any structure which contains the data to be output in list form. Only
the fields named in the field catalog and in the I_CHECKBOX_FIELDNAME parameter
are used for the list output. Other internal table fields are ignored.

Exceptions

PROGRAM_ERROR

Function group
SALV (vedi alle pagine precedenti, nella documentazione del function module
REUSE_ALV_EVENTS_GET)

Function Module REUSE_ALV_POPUP_TO_SELECT


Pag. 36 di 41
DOCUMENTAZIONE ALV (4.6 C)

REUSE_ALV_VARIANT_ALL_MAINTAIN
(documentazione ufficiale release 4.6C)

Maintain all object display variants

Functionality

The ALV variant maintenance dialog (setting defaults, list user-specific variants, list standard variants, delete variants,
etc.) runs outside ALV.

Parameter

IS_VARIANT

I_DEFAULT

I_USER_SPECIFIC 

I_TABNAME_HEADER

I_TABNAME_ITEM 

IS_LAYOUT

IT_DEFAULT_FIELDCAT

Per la spiegazione di alcuni parametri si rimanda alla documentazione dei seguenti function modules:

REUSE_ALV_LIST_DISPLAY

REUSE_ALV_HIERSEQ_LIST_DISPLAY

 I_USER_SPECIFIC Incl. user-spec. variants


Set this parameter to ' X' if display variants can be saved user-specifically in the call
context. The save mode (user-specific and/or standard) depends on the value of the
IMPORTING paramter I_SAVE of the function modules REUSE_ALV_LIST_DISPLAY or
REUSE_ALV_HIERSEQ_LIST_DISPLAY.

Exceptions

FOREIGN_LOCK

PROGRAM_ERROR

Function group
SALV (vedi alle pagine precedenti, nella documentazione del function module
REUSE_ALV_EVENTS_GET )

Function Module REUSE_ALV_VARIANT_ALL_MAINTAIN Pag. 37 di 41


DOCUMENTAZIONE ALV (4.6 C)

REUSE_ALV_VARIANT_DEFAULT_GET

REUSE_ALV_VARIANT_EXISTENCE
(documentazione ufficiale release 4.6C)

DEFAULT_GET: Read default display variant (description only, w/o field catalog)
EXISTENCE: Check existence of a display variant

Functionality

DEFAULT_GET: Provides the default variant for the list specified in the structure parameter CS_VARIANT of a
program.
EXISTENCE: This function module checks the existence in the database of a display variant passed in the interface.

Parameter

I_SAVE

CS_VARIANT


Per la spiegazione di questi parametri si rimanda alla documentazione del function module
REUSE_ALV_LIST_DISPLAY

Exceptions

WRONG_INPUT

NOT_FOUND

PROGRAM_ERROR

Function group
SALV (vedi alle pagine precedenti, nella documentazione del function module
REUSE_ALV_EVENTS_GET )

Function Module REUSE_ALV_VARIANT_DEFAULT_GET Pag. 38 di 41


REUSE_ALV_VARIANT_EXISTENCE
DOCUMENTAZIONE ALV (4.6 C)

REUSE_ALV_VARIANT_F4
(documentazione ufficiale release 4.6C)
Display variant selection dialog box

Functionality
Possible entries help, if the variant is defined explicitly as an input field on a screen. The selection must be specified by at
least partially filling the parameter structure IS_VARIANT.

Parameter

IS_VARIANT

I_TABNAME_HEADER

I_TABNAME_ITEM 

IT_DEFAULT_FIELDCAT

I_SAVE

I_DISPLAY_VIA_GRID

E_EXIT

ES_VARIANT

Per la spiegazione di alcuni parametri si rimanda alla documentazione dei seguenti function modules:

REUSE_ALV_LIST_DISPLAY

REUSE_ALV_HIERSEQ_LIST_DISPLAY

Exceptions

NOT_FOUND

PROGRAM_ERROR

Function group
SALV (vedi alle pagine precedenti, nella documentazione del function module
REUSE_ALV_EVENTS_GET )

Function Module REUSE_ALV_VARIANT_F4 Pag. 39 di 41


DOCUMENTAZIONE ALV (4.6 C)

REUSE_ALV_VARIANT_MAINTAIN
(documentazione ufficiale release 4.6C)
Definition of a display variant outside the list context

Functionality
The ALV variant definition dialog box (setting column width, column sequence, display fields, hidden fields, etc.) runs
outside ALV. The caller is informed when a setting is saved.

Parameter

I_TABNAME_HEADER

I_TABNAME_ITEM 

I_SAVE

I_POPUP

IS_LAYOUT

IT_SPECIAL_GROUPS

IT_SORT

E_SAVE

CT_FIELDCAT

Per la spiegazione di alcuni parametri si rimanda alla documentazione dei seguenti function modules:

REUSE_ALV_LIST_DISPLAY

REUSE_ALV_HIERSEQ_LIST_DISPLAY

 E_SAVE Changes were saved.


The Save function has been performed in the dialog (value: ' X').

Exceptions

NO_CHANGE

PROGRAM_ERROR

Function group
SALV (vedi alle pagine precedenti, nella documentazione del function module
REUSE_ALV_EVENTS_GET )

Function Module REUSE_ALV_VARIANT_MAINTAIN Pag. 40 di 41


DOCUMENTAZIONE ALV (4.6 C)

REUSE_ALV_VARIANT_SELECT
(documentazione ufficiale release 4.6C)
Read a display variant

Functionality
Read an ALV display variant
This function can also be performed with a dialog. The selection must be specified by at least partially filling the
parameter structure CS_VARIANT.

Parameter

I_DIALOG

I_USER_SPECIFIC

I_DEFAULT

I_TABNAME_HEADER

I_TABNAME_ITEM

IT_DEFAULT_FIELDCAT

I_LAYOUT

I_BYPASSING_BUFFER

I_BUFFER_ACTIVE

E_EXIT

ET_FIELDCAT

ET_SORT

ET_FILTER

ES_LAYOUT

CS_VARIANT

Per la spiegazione di alcuni parametri si rimanda alla documentazione dei seguenti function modules:

REUSE_ALV_LIST_DISPLAY

REUSE_ALV_HIERSEQ_LIST_DISPLAY

 I_TABNAME_HEADER Header Table Name


Name of the internal table in the program containing the highest hierarchy level of
output data. This parameter is only used for variants which refer to hierarchical-
sequential lists.
 I_TABNAME_ITEM Item Table Name
Name of the internal table in the program containing the lowest hierarchy level of
output data. This parameter is only used for variants which refer to hierarchical-
sequential lists.
 E_EXIT Dialog cancelled by user
This parameter is set (' X') if the function module was called with dialog, and the dialog
was canceled by the user.

Exceptions

WRONG_INPUT

FC_NOT_COMPLETE

NOT_FOUND

PROGRAM_ERROR

Function group
SALV (vedi alle pagine precedenti, nella documentazione del function module
REUSE_ALV_EVENTS_GET )

Function Module REUSE_ALV_VARIANT_SELECT Pag. 41 di 41

You might also like