Documentación Tema 2 - ALV Con Módulos de Funciones

SAB ABAP List Viewer – ALV
ALV basado en módulos de funciones
TEORÍA
ALV basado en los módulos de funciones
SAP ABAP List Viewer - ALV
1
Contenido
1. Introducción ......................................................................................................................... 3
2. ALV List ................................................................................................................................. 5
2.1. Módulo de funciones REUSE_ALV_LIST_DISPLAY ...................................................... 5
2.2. Catálogo de campos .................................................................................................... 6
2.3. Eventos ........................................................................................................................ 8
2.4. Pasos para generar un ALV List ................................................................................. 11
3. ALV Grid ............................................................................................................................. 13
3.1. Módulo de funciones REUSE_ALV_GRID_DISPLAY .................................................. 13
3.2. Catálogo de campos .................................................................................................. 15
3.4. Pasos para generar un ALV Grid ............................................................................... 15
4. ALV Jerárquico ................................................................................................................... 17
4.1. Módulo de funciones REUSE_ALV_HIERSEQ_LIST_DISPLAY .................................... 17
4.2. Catálogo de campos .................................................................................................. 19
4.3. Eventos ...................................................................................................................... 20
4.4. Pasos para generar un ALV Jerárquico ..................................................................... 20
2
1. Introducción
El ALV es una herramienta de visualización de datos. El nombre de ALV
proviene de ABAP List Viewer o el "Visor de listas ABAP". SAP ofrece la
posibilidad de visualizar los datos a través de los ALVs en forma de Tabla
con filas y columnas, en forma de listado Jerárquico o como listado de
tipo Árbol.
Existen tres módulos de funcione principales que se utilizan para la
implementación de las listas ALV basados en los módulos de funciones:
• REUSE_ALV_LIST_DISPLAY - Muestra una lista simple
• REUSE_ALV_GRID_DISPLAY - Salida de una lista Grid
• REUSE_ALV_HIERSEQ_LIST_DISPLAY - Salida de lista secuencial
jerárquica
Junto con estas funciones existen una serie de módulos de funciones
que se pueden utilizar adicionalmente para construir objetos necesarios
para la visualización del ALV, como puede ser la generación automática
del catálogo de campos.
Las funciones ALV se utilizan para la generación de reportes ofreciendo
muchas ventajas y utilidades que vienen ya implementadas en la propia
función. Entre las funciones integradas para manipular resultados
encontramos opciones como: clasificación, totales, filtros, ordenación
por columnas o la posibilidad de ocultar columnas y también funciones
para exportar los resultados en objetos Excel, fichero local, Archivos CSV,
en formato HTML.
Técnicamente, para la construcción de un ALV basado en los módulos de
funciones, están involucrados los siguientes objetos:
1. Dynpro – Pantalla generada implícitamente por el mismo
módulo de funciones estándar.
2. Catálogo de campos – Tabla interna con detalles técnicos sobre
las columnas del listado (tipo de dato, longitud, etc.). Este objeto
se puede crear manual o automáticamente a través de módulos
de funciones estándar.
3. Los datos del listado – El programador tiene la responsabilidad
de pasar una tabla interna con los datos al módulo de funciones
3
del ALV. Las columnas de la tabla interna deben coincidir con los
detalles técnicos del catálogo de campos.
4. Layout – El diseño para la visualización del ALV donde se pueden
ocultar columnas u ofrecer solo algunas funciones estándar en la
barra de herramientas. También se puede añadir funcionalidad
personalizada en la barra de herramientas.
4
2. ALV List
2.1. Módulo de funciones REUSE_ALV_LIST_DISPLAY
Para la generación de los reportes ALV List se debe utilizar el módulo de

funciones REUSE_ALV_LIST_DISPLAY que contiene los siguientes
parámetros:
• Parámetros Import:
Nombre parámetro Tipo de datos Descripción

Comprobación de coherencia de
I_INTERFACE_CHECK la interfaz de salida
I_BYPASSING_BUFFER CHAR01 ¿Saltar todos los buffers?
I_BUFFER_ACTIVE Buffer activo
Nombre del programa para
I_CALLBACK_PROGRAM SY-REPID llamar
Subrutina que establece el
I_CALLBACK_PF_STATUS_SET SLIS_FORMNAME estatus
I_CALLBACK_USER_COMMAND SLIS_FORMNAME Subrutina para User Command
Nombre de la estructura de la
I_STRUCTURE_NAME DD02L-TABNAME tabla de salida
Lista de especificaciones de
IS_LAYOUT SLIS_LAYOUT_ALV diseño
Catálogo de campo con
IT_FIELDCAT SLIS_T_FIELDCAT_ALV descripciones de campo
Tabla de códigos de función
IT_EXCLUDING SLIS_T_EXTAB inactiva
Agrupando campos para
IT_SPECIAL_GROUPS SLIS_T_SP_GROUP_ALV selección de columnas
Criterios de clasificación para la
IT_SORT SLIS_T_SORTINFO_ALV primera visualización de la lista
Criterios de filtro para la
IT_FILTER SLIS_T_FILTER_ALV primera salida de la lista
Modificación de información de
IS_SEL_HIDE SLIS_SEL_HIDE_ALV selección
Variante inicial lógica activa /
I_DEFAULT inactiva
I_SAVE Las variantes se pueden guardar
IS_VARIANT DISVARIANT Información variante
IT_EVENTS SLIS_T_EVENT Tabla de eventos a realizar.
Tabla de solicitudes de salida de
IT_EVENT_EXIT SLIS_T_EVENT_EXIT código estándar
IS_PRINT SLIS_PRINT_ALV Imprimir información
Clave de inicialización para la
IS_REPREP_ID SLIS_REPREP_ID interfaz Re/Re
Coordenadas para la lista en el
I_SCREEN_START_COLUMN cuadro de diálogo
I_SCREEN_START_LINE cuadro de diálogo
5

I_SCREEN_END_COLUMN cuadro de diálogo
I_SCREEN_END_LINE cuadro de diálogo
Adaptador para salida de datos
IR_SALV_LIST_ADAPTER CL_SALV_LIST_ADAPTER en una lista
Estructura para Quickinfos de
IT_EXCEPT_QINFO SLIS_T_QINFO_ALV Excepciones
Si no existen datos, no se genera
I_SUPPRESS_EMPTY_DATA SAP_BOOL ninguna tabla
• Parámetros Export:

E_EXIT_CAUSED_BY_CALLER Eliminar lista en
CALLBACK_USER_COMMAND
ES_EXIT_CAUSED_BY_USER SLIS_EXIT_BY_USER Como el usuario dejó la lista
• Parámetros Tables:

T_OUTTAB Tabla con datos a visualizar.
• Excepciones:

PROGRAM_ERROR Error del programa
2.2. Catálogo de campos
El catálogo de campos es un objeto de tipo tabla interna que contiene

los detalles técnicos sobre las columnas del listado (tipo de dato,
longitud, etc.).
Existen dos formas para la creación del catálogo de campos:
6
2.2.1. Creación manual

En el proceso manual se deben pasar valor a los componentes de la
estructura de tipo SLIS_FIELDCAT_ALV y adjuntar un registro por cada
columna en la tabla interna de tipo SLIS_T_FIELDCAT_ALV.
Ejemplo de código:
DATA: lt_fieldcat TYPE slis_t_fieldcat_alv,
ls_fieldcat TYPE slis_fieldcat_alv.
ls_fieldcat-fieldname = 'CARRID'.
ls_fieldcat-seltext_l = 'Airline Code'.
ls_fieldcat-seltext_m = 'Airline Code'.
APPEND ls_fieldcat TO lt_fieldcat.
2.2.2. Creación automática

El módulo de funciones REUSE_ALV_FIELDCATALOG_MERGE genera el
catálogo de campos en base al nombre de una estructura o tabla del
diccionario de datos ABAP.
En el siguiente código se obtiene el catálogo de campos para la tabla
estándar MARA:
DATA: lt_fieldcat TYPE slis_t_fieldcat_alv.
CALL FUNCTION 'REUSE_ALV_FIELDCATALOG_MERGE'

EXPORTING
* i_program_name =
* i_internal_tabname =
i_structure_name = 'MARA'
* I_CLIENT_NEVER_DISPLAY = 'X'
* I_INCLNAME =
* I_BYPASSING_BUFFER =
* I_BUFFER_ACTIVE =
CHANGING
ct_fieldcat = lt_fieldcat
EXCEPTIONS
inconsistent_interface = 1
program_error = 2
OTHERS = 3.
IF sy-subrc <> 0.
* Implement suitable error handling here
ENDIF.
7
2.3. Eventos
El parámetro Importing con el nombre IT_EVENTS admite una tabla

interna con eventos para que el ALV responda a los eventos adjuntados
en la tabla interna.
Pasos que seguir para implementar un evento:
1. Encontrar el nombre del evento
El módulo de funciones estándar REUSE_ALV_EVENTS_GET

devuelve una lista con los nombres de los eventos en función del
tipo de ALV, sea List, Grid o Jerárquico.
En función del valor del parámetro de entrada I_LIST_TYPE, el
módulo de funciones devuelve el listado con los nombres de los
eventos. Admite uno de los valores 0, 1, 2 o 3 que representan:
• 0 = Lista simple REUSE_ALV_LIST_DISPLAY

• 1 = Jerárquico secuencial REUSE_ALV_HIERSEQ_LIST_DISPLAY
• 2 = Bloque simple REUSE_ALV_BLOCK_LIST_APPEND
• 3 = Bloque Jerárquico secuencial REUSE_ALV_BLOCK_LIST_HS_APPEND
• 4 = Pantalla completa REUSE_ALV_GRID_DISPLAY
En la siguiente ilustración se puede ver la lista de los eventos para

la lista simple:
8
2. Adjuntar en la tabla interna del parámetro el evento y la subrutina

encargada de manejar la lógica del evento.
La siguiente ilustración muestra un ejemplo de código que
implementa el evento END_OF_LIST indicando que la subrutina
HANDLE_END_OF_LIST es la encargada de manejar la lógica del
evento:
9
10
2.4. Pasos para generar un ALV List
Para generar un listado ALV de tipo List debe realizar los siguientes
pasos:
1. Obtener los datos a mostrar en el ALV (obligatorio)
2. Generar el catálogo de campos (obligatorio)
3. Configurar el Layout (opcional)
4. Implementar subrutina para User Command (opcional)
5. Implementar subrutina para el encabezado y el pie del listado
(opcional)
6. Implementar los eventos (opcional)
7. Establecer filtros (opcional)
8. Establecer criterios de ordenación (opcional)
9. Configurar variantes (opcional)
10.Llamar al módulo de funciones REUSE_ALV_LIST_DISPLAY
(obligatorio)
Ejemplo reporte ALV List:
11
12
3. ALV Grid
3.1. Módulo de funciones REUSE_ALV_GRID_DISPLAY
Para la generación de los reportes ALV Grid se debe utilizar el módulo

de funciones REUSE_ALV_GRID_DISPLAY que contiene los siguientes
parámetros:

I_INTERFACE_CHECK Comprobación de coherencia
de la interfaz de salida
I_BYPASSING_BUFFER CHAR01 Ignorar todos los buffers
I_BUFFER_ACTIVE Buffering activo
I_CALLBACK_PROGRAM SY-REPID Nombre del programa que
llama
I_CALLBACK_PF_STATUS_SET SLIS_FORMNAME Subrutina para establecer el
estatus
I_CALLBACK_USER_COMMAND SLIS_FORMNAME Subrutina para el User
Command
I_CALLBACK_TOP_OF_PAGE SLIS_FORMNAME Rutina de salida para manejar
TOP-OF-PAGE
I_CALLBACK_HTML_TOP_OF_PA SLIS_FORMNAME Rutina de salida para HTML
GE TOP-OF-PAGE
I_CALLBACK_HTML_END_OF_LIS SLIS_FORMNAME Rutina de salida para HTML
T END-OF-LIST
I_STRUCTURE_NAME DD02L-TABNAME Nombre de la estructura de la
tabla de salida interna
I_BACKGROUND_ID SDYDO_KEY ID de objeto de fondo de
pantalla
I_GRID_TITLE LVC_TITLE Título de control
I_GRID_SETTINGS LVC_S_GLAY Configuración de cuadrícula
IS_LAYOUT SLIS_LAYOUT_ALV Lista de especificaciones de
diseño
IT_FIELDCAT SLIS_T_FIELDCAT_ALV Catálogo de campo con
descripciones de campo.
IT_EXCLUDING SLIS_T_EXTAB Tabla de códigos de función
inactiva
IT_SPECIAL_GROUPS SLIS_T_SP_GROUP_ALV Agrupando campos para
selección de columnas
IT_SORT SLIS_T_SORTINFO_ALV Criterios de clasificación para
la visualización de la primera
lista
IT_FILTER SLIS_T_FILTER_ALV Criterios de filtro para la salida
de la primera lista
IS_SEL_HIDE SLIS_SEL_HIDE_ALV Modificación de información
de selección
I_DEFAULT Variante inicial lógica activa /
inactiva
13
I_SAVE Las variantes se pueden

guardar
IT_EVENT_EXIT SLIS_T_EVENT_EXIT Tabla de solicitudes de salida
de código estándar
IS_PRINT SLIS_PRINT_ALV Imprimir informacion
IS_REPREP_ID SLIS_REPREP_ID Clave de inicialización para la
interfaz Re / Re
I_SCREEN_START_COLUMN Coordenadas para la lista en el
cuadro de diálogo
I_SCREEN_END_LINE Coordinates for list in dialog
box
I_HTML_HEIGHT_TOP I HTML_TOP_OF_PAGE Height
I_HTML_HEIGHT_END I HTML_END_OF_PAGE Height
IT_ALV_GRAPHICS DTC_T_TC Parameter for ALV graphic
IT_HYPERLINK LVC_T_HYPE Hyperlinks
IT_ADD_FIELDCAT SLIS_T_ADD_FIELDCAT Additional Field Catalog
Options
IT_EXCEPT_QINFO SLIS_T_QINFO_ALV
IR_SALV_FULLSCREEN_ADAPTER CL_SALV_FULLSCREEN_A Adapter Fullscreen -> Table
DAPTER


T_OUTTAB Tabla con datos a visualizar
• Excepciones:

14

longitud, etc.).
- Creación manual (vea la sección 2.2.1. Creación manual)
- Creación automática (vea la sección 2.2.2. Creación automática)
3.3. Eventos

Los pasos que seguir para implementar un evento son los mismos que
para el ALV List que se han visto en la sección 2.3. Eventos.
3.4. Pasos para generar un ALV Grid
Para generar un listado ALV de tipo Grid debe realizar los siguientes
pasos:
(opcional)
10.Llamar al módulo de funciones REUSE_ALV_GRID_DISPLAY
(obligatorio)
15
16
4. ALV Jerárquico
4.1. Módulo de funciones

REUSE_ALV_HIERSEQ_LIST_DISPLAY
Para la generación de los reportes ALV Jerárquico se debe utilizar el

módulo de funciones REUSE_ALV_HIERSEQ_LIST_DISPLAY que contiene
los siguientes parámetros:

I_INTERFACE_CHECK Comprobación de coherencia
de la interfaz de salida
I_CALLBACK_PROGRAM SY-REPID Nombre del programa que
llama
I_CALLBACK_PF_STATUS_SET SLIS_FORMNAME Subrutina que establece el
estatus
I_CALLBACK_USER_COMMAND SLIS_FORMNAME Subrutina para User
Command
IS_LAYOUT SLIS_LAYOUT_ALV Lista de especificaciones de
diseño
IT_FIELDCAT SLIS_T_FIELDCAT_ALV Catálogo de campo con
descripciones de campo.
IT_EXCLUDING SLIS_T_EXTAB Tabla de códigos de función
inactiva
IT_SPECIAL_GROUPS SLIS_T_SP_GROUP_ALV Agrupando campos para
selección de columnas
IT_SORT SLIS_T_SORTINFO_ALV Criterios de clasificación para
la visualización de la primera
lista
IT_FILTER SLIS_T_FILTER_ALV Criterios de filtro para la salida
de la primera lista
IS_SEL_HIDE SLIS_SEL_HIDE_ALV Modificación de información
de selección
I_SCREEN_START_COLUMN Coordenadas para la lista en el
cuadro de diálogo
I_SCREEN_START_LINE Coordenadas para la lista en el
cuadro de diálogo
I_SCREEN_END_COLUMN Coordenadas para la lista en el
cuadro de diálogo
I_SCREEN_END_LINE Coordenadas para la lista en el
cuadro de diálogo
I_DEFAULT Variante inicial lógica activa /
inactiva
I_SAVE Las variantes se pueden
guardar
17
IT_EVENT_EXIT SLIS_T_EVENT_EXIT Tabla de solicitudes de salida

de código estándar
I_TABNAME_HEADER SLIS_TABNAME Nombre de la tabla de
encabezado
I_TABNAME_ITEM SLIS_TABNAME Nombre de la tabla del
artículo
I_STRUCTURE_NAME_HEADER DD02L-TABNAME Nombre de la estructura de la
tabla de salida interna
(encabezado)
I_STRUCTURE_NAME_ITEM DD02L-TABNAME Tabla de salida interna (pos.)
Nombre de la estructura
IS_KEYINFO SLIS_KEYINFO_ALV Encabezado / puesto. enlaces
de campo de tabla
IS_PRINT SLIS_PRINT_ALV Imprimir informacion
IS_REPREP_ID SLIS_REPREP_ID Clave de inicialización para la
interfaz Re / Re
I_BYPASSING_BUFFER CHAR01 ¿Saltar todos los buffers?
I_BUFFER_ACTIVE CHAR01 Buffer de usuario A
IR_SALV_HIERSEQ_ADAPTER CL_SALV_HIERSEQ_ADA Adaptador para el Hierseq.
PTER Liza
IT_EXCEPT_QINFO SLIS_T_QINFO_ALV
I_SUPPRESS_EMPTY_DATA SAP_BOOL Si no existen datos, no se

genera ninguna tabla


T_OUTTAB_HEADER Tabla de cabecera con datos a
visualizar
T_OUTTAB_ITEM Tabla de posiciones con datos
a visualizar
• Excepciones:

18

longitud, etc.).
- Creación manual (vea la sección 2.2.1. Creación manual)
- Creación automática (vea la sección 2.2.2. Creación automática)
Para el ALV Jerárquico se deben crear los catálogos de campos para las
dos tablas internas, la de cabecera y para la de posiciones.
Como buena práctica se modulariza la generación del catálogo

automático en una subrutina y se realizan dos llamadas a la subrutina:
una para la generación del catálogo para la tabla de cabecera y la
segunda para la tabla de posiciones:
La siguiente subrutina contiene la lógica de generación del catálogo

recibiendo como parámetros el nombre del programa, el nombre de la
tabla interna que contiene los datos, el nombre de la estructura o la
tabla de base de datos y por último un parámetro CHANGING con la
tabla interna del catálogo de campos:
FORM build_fieldcat_hier
USING pv_program_name TYPE syrepid
pv_internal_tabname TYPE slis_tabname
pv_structure_name TYPE tabname
CHANGING ct_fieldcat TYPE slis_t_fieldcat_alv.
CALL FUNCTION 'REUSE_ALV_FIELDCATALOG_MERGE'

EXPORTING
i_program_name = pv_program_name
i_internal_tabname = pv_internal_tabname
i_structure_name = pv_structure_name
* I_CLIENT_NEVER_DISPLAY = 'X'
* I_INCLNAME =
* I_BYPASSING_BUFFER =
* I_BUFFER_ACTIVE =
CHANGING
ct_fieldcat = ct_fieldcat
EXCEPTIONS
inconsistent_interface = 1
program_error = 2
19
OTHERS = 3.
IF sy-subrc <> 0.
* Implement suitable error handling here
MESSAGE 'Error on fieldcat merge' TYPE 'E'.
ENDIF.
ENDFORM.
Para tener el catálogo de campos de las dos tablas internas, de cabecera

y de posiciones debe realizar dos llamadas a la subrutina anterior igual
que en siguiente ejemplo de código:
PERFORM build_fieldcat_hier USING sy-repid

'GT_HEADER'
'SPFLI'
CHANGING gt_fieldcat_hier.
PERFORM build_fieldcat_hier USING sy-repid

'GT_ITEMS'
'SFLIGHT'
CHANGING gt_fieldcat_hier.
4.3. Eventos

Los pasos que seguir para implementar un evento son los mismos que
para el ALV List que se han visto en la sección 2.3. Eventos.
4.4. Pasos para generar un ALV Jerárquico
Para generar un listado ALV de tipo List debe realizar los siguientes
pasos:
(opcional)
20

10.Llamar al módulo de funciones REUSE_ALV_HIERSEQ_LIST_DISPLAY
(obligatorio)
21

Documentación Tema 2 - ALV Con Módulos de Funciones

Cargado por

Información del documento

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Documentación Tema 2 - ALV Con Módulos de Funciones

Cargado por

Copyright:

Formatos disponibles

SAB ABAP List Viewer – ALV

ALV basado en módulos de funciones

2.1. Módulo de funciones REUSE_ALV_LIST_DISPLAY

Para la generación de los reportes ALV List se debe utilizar el módulo de

Nombre parámetro Tipo de datos Descripción

Coordenadas para la lista en el

Nombre parámetro Tipo de datos Descripción

Nombre parámetro Tipo de datos Descripción

Nombre parámetro Tipo de datos Descripción

2.2. Catálogo de campos

El catálogo de campos es un objeto de tipo tabla interna que contiene

2.2.1. Creación manual

2.2.2. Creación automática

CALL FUNCTION 'REUSE_ALV_FIELDCATALOG_MERGE'

El parámetro Importing con el nombre IT_EVENTS admite una tabla

El módulo de funciones estándar REUSE_ALV_EVENTS_GET

• 0 = Lista simple REUSE_ALV_LIST_DISPLAY

En la siguiente ilustración se puede ver la lista de los eventos para

2. Adjuntar en la tabla interna del parámetro el evento y la subrutina

2.4. Pasos para generar un ALV List

Ejemplo reporte ALV List:

3.1. Módulo de funciones REUSE_ALV_GRID_DISPLAY

Para la generación de los reportes ALV Grid se debe utilizar el módulo

Nombre parámetro Tipo de datos Descripción

I_SAVE Las variantes se pueden

Nombre parámetro Tipo de datos Descripción

Nombre parámetro Tipo de datos Descripción

Nombre parámetro Tipo de datos Descripción

3.2. Catálogo de campos

El catálogo de campos es un objeto de tipo tabla interna que contiene

El parámetro Importing con el nombre IT_EVENTS admite una tabla

3.4. Pasos para generar un ALV Grid

Ejemplo reporte ALV List:

4.1. Módulo de funciones

Para la generación de los reportes ALV Jerárquico se debe utilizar el

Nombre parámetro Tipo de datos Descripción

IT_EVENT_EXIT SLIS_T_EVENT_EXIT Tabla de solicitudes de salida

I_SUPPRESS_EMPTY_DATA SAP_BOOL Si no existen datos, no se

Nombre parámetro Tipo de datos Descripción

Nombre parámetro Tipo de datos Descripción

Nombre parámetro Tipo de datos Descripción

4.2. Catálogo de campos

El catálogo de campos es un objeto de tipo tabla interna que contiene

Como buena práctica se modulariza la generación del catálogo

La siguiente subrutina contiene la lógica de generación del catálogo

CALL FUNCTION 'REUSE_ALV_FIELDCATALOG_MERGE'

Para tener el catálogo de campos de las dos tablas internas, de cabecera

PERFORM build_fieldcat_hier USING sy-repid

PERFORM build_fieldcat_hier USING sy-repid

El parámetro Importing con el nombre IT_EVENTS admite una tabla

4.4. Pasos para generar un ALV Jerárquico

6. Implementar los eventos (opcional)

Ejemplo reporte ALV List:

También podría gustarte