Entering content frame

Object documentation Columns with Special Technical Meaning Locate the document in its SAP Library structure

Definition

As a rule, columns from the internal data table are displayed directly in the ALV output. However, you are able to define columns that have a special technical function. These columns are then either not displayed at all or their content is presented in a special way. You are able to use the following types of special columns:

·        Control columns
These columns are technical columns, which means they are usually not displayed. They contain information on how the contents are being displayed in another column.
Examples of control columns are:

¡        Color column (technical column)

¡        Currency column (visible column)

Note

Many of the properties that you assign to specific cells using control columns can also be assigned to a whole column (for example assigning a currency to a whole column).

·        Graphic columns
To display icons, exceptions and symbols, you use specific notation (for example
@AB@). So that these character strings are interpreted as IDs for a graphic and not as text, you define the column accordingly as an icon-, exception or symbol column.

·        Columns with special function
These columns include functions that are only useful in very specific situations.
Examples of these columns include:

¡        Expansion column for the hierarchical-sequential list

¡        Text Column for Labels in Results Rows for Intermediate Results

¡        Counter Column to Determine the Number of Rows

Use

Depending on how you use a special column, you need to be aware of different things.

Using Control Columns

With control columns you assign specific properties to one or more cells.

Note

An entry in the control column always refers to cells from those rows that include the entry as well.

There are two types of control columns:

·        Control columns that are fixed and assigned to a specific column.

·        Control Columns That Contain Information for Any Number of Columns

Control Columns That are Assigned to a Specific Column

Specifications in the control column exclusively refer to the current column. The cells of this control column each can only contain one value that controls the content of the linked cell.

This graphic is explained in the accompanying text

For this type of control columns, use the following methods:

Control column

Class

Method

Currency column

CL_SALV_COLUMN

SET_CURRENCY_COLUMN
GET_CURRENCY_COLUMN

Column for decimal places

SET_DECIMALS_COLUMN
GET_DECIMALS_COLUMN

Column for units of measure

SET_QUANTITY_COLUMN
GET_QUANTITY_COLUMN

Rounding column

SET_ROUND_COLUMN
GET_ROUND_COLUMN

 

Display type

ALV Tool

Classic ABAP list

Full screen

In the Container

Simple, two-dimensional table

Yes

Yes

Yes

Hierarchical-sequential list

Yes

 

 

Tree structure

 

Yes

Yes

Note

In hierarchical-sequential lists you also have to specify in which of the two hierarchy columns the control column is located. To do this, use one of the SET_*_COLUMN_LEVEL methods in the class CL_SALV_COLUMN_HIERSEQ.

Control Columns That Contain Information for Any Number of Columns

The cells of this control column contain whole tables:

·        Each of these tables exclusively refers to cells in the same row of the ALV output.

·        If this table contains multiple rows, each of these rows controls a specific column of the ALV output.

·        Every row then contains the name of the column in the ALV output to which the settings refer (in the graphic below, rows 1 and 2).

·        If no column name is specified, all columns of the ALV output get the settings (in the graphic below, row 3).

This graphic is explained in the accompanying text

For this type of control columns, use the following methods:

Control column

Class

Method

Column for cell types

CL_SALV_COLUMNS_LIST

SET_CELL_TYPE_COLUMN
GET_CELL_TYPE_COLUMN

Color column

SET_COLOR_COLUMN
GET_COLOR_COLUMN

Hyperlink column

SET_HYPERLINK_ENTRY_
COLUMN
GET_HYPERLINK_ENTRY_
COLUMN

Dropdown column

SET_DROPDOWN_ENTRY_
COLUMN
GET_DROPDOWN_ENTRY_
COLUMN

 

Display type

ALV Tool

Classic ABAP list

Full screen

In the Container

Simple, two-dimensional table

Yes

Yes

Yes

Hierarchical-sequential list

Yes

 

 

Tree structure

 

No

No

Note

In the tree structure you are able to assign colors to nodes or to an individual item.

Use Graphic Column

In list-type ALV outputs, you are only able to display icons or symbols in columns that are specifically defined for this purpose. They may only contain entries that uniquely identify an icon or symbol in your system.

Display type

ALV Tool

Classic ABAP list

Full screen

In the Container

Simple, two-dimensional table

Yes

Yes

Yes

Hierarchical-sequential list

Yes

 

 

Tree structure

 

No

No

Note

In the tree structure you can display an icon in any item. To do this, use the method SET_ICON in the CL_SALV_ITEM class.

Methods

Function

Class

Method

Defining the column as a icon column

CL_SALV_COLUMN_LIST

SET_ICON

Check whether the current column is an icon column

IS_ICON

Define the column as a symbol column

SET_SYMBOL

Check whether the current column is an symbol column

IS_SYMBOL

Exception Column

The exception column is a special form of the graphic column:

It displays a status of the current data record with specific icons.

Example

The most common display of exception icons is the traffic light: with the icons and This graphic is explained in the accompanying text , This graphic is explained in the accompanying text  and This graphic is explained in the accompanying text for example, you are able to display the release status.

As opposed to regular graphic columns, the exception column has additional properties:

·        The values in the exception column must be between 1 and 5

·        It can only display a specific set of icons. You are able to choose the icons you wish to display from several exception groups. In the exception column itself, only the values allowed in this exception group are available

·        Users cannot hide the exception column

·        In list-type ALV outputs, the exception column is always displayed as the first column

Display type

ALV Tool

Classic ABAP list

Full screen

In the Container

Simple, two-dimensional table

Yes

Yes

Yes

Hierarchical-sequential list

Yes

 

 

Tree structure

 

Yes

Yes

Methods

Function

Class

Method

Specify exception column

CL_SALV_COLUMNS_LIST

CL_SALV_COLUMNS_TREE

SET_EXCEPTION_COLUMN

Get exception group

GET_EXCEPTION_COLUMN

GET_EXCEPTION_SETTINGS
(Parameter GROUP)

Note

Results rows from aggregations remain empty in the exception column by default. In list-type ALV outputs, however, you are able to display exception icons. To do this, in the class CL_SALV_COLUMNS_LIST, use the method SET_EXCEPTION_COLUMN (Parameter CONDENSED). You check whether the results row is displaying an exception icon using the method IS_EXCEPTION_CONDENSED or GET_EXCEPTION_SETTINGS
(Parameter CONDENSED).

Columns with Special Function

With some special columns, you control functions that are only useful in very specific situations.

Expansion Column

This column is only available in the hierarchical-sequential list. You use it to specifically display and hide position rows for specific headers. Here you only check whether an entry in a row of this column is included: if the cell is empty, only the position rows for the associated header are displayed.  If the cell gets a value, the position rows for the associated header are hidden.

Display type

ALV Tool

Classic ABAP list

Full screen

In the Container

Simple, two-dimensional table

No

No

No

Hierarchical-sequential list

Yes

 

 

Tree structure

 

No

No

Methods

Function

Class

Method

Define expansion column

CL_SALV_COLUMNS_HIERSEQ

SET_EXPAND_COLUMN

Get current expansion column

GET_EXPAND_COLUMN

Text Column for Labels in Results Rows for Intermediate Results

You are able to display intermediate results for aggregations. These intermediate results are displayed in a special results row in the column the values of which are used in the aggregation. All other columns in this row are empty by default. You are able to specify a column the values of which are also transferred to the results row.

Display type

ALV Tool

Classic ABAP list

Full screen

In the Container

Simple, two-dimensional table

Yes

Yes

Yes

Hierarchical-sequential list

Yes

 

 

Tree structure

 

No

No

Methods

Function

Class

Method

Define text column

CL_SALV_COLUMN_LIST

SET_TEXT_COLUMN

Get current text column

GET_TEXT_COLUMN

Counter Column to Determine the Number of Rows

You are able to determine and output the number of data records of the ALV output. To do this, you need a special column, the count column. The rows of this count column never display data. The results row, however, contains the number of data records.

Display type

ALV Tool

Classic ABAP list

Full screen

In the Container

Simple, two-dimensional table

Yes

Yes

Yes

Hierarchical-sequential list

Yes

 

 

Tree structure

 

No

No

Methods

Function

Class

Method

Define count column

CL_SALV_COLUMNS_LIST

SET_COUNT_COLUMN

Get count column

 

GET_COUNT_COLUMN

 

 

Leaving content frame