ALV简介和Fieldcat与Layout相关参数属性
ALV(SAP List Viewer) 是SAP常用的屏幕显示列表控件对象,通过传递数据内表方式显示数据;
ALV显示格式分为Grid 和 List两种模式:
Grid模式有栏位选择按钮功能,允许用户直接输出格式,操作更为灵活;
List 模式则固定格式,应用于较严格的标准报表。
Grid Mode:

alv_grid_mode
List Mode:

alv_list_mode
输出ALV的 Function有两个:REUSE_ALV_GRID_DISPLAY 和 REUSE_ALV_GRID_DISPLAY_LVC
两个函数都可以将数据用ALV的形式显示出来,只是一些小部分有所不同。
2.1 在调用 ALV 函数前,需要引入一个类型池:SLIS
2.2 Layout和Fieldcat的定义
Layout 主要用于设定 ALV 的输出格式,为 ALV 输出的可选项;
Fieldcat 主要用于ALV的结构定义,包括具体的栏位及名称、类型、格式等属性,为 ALV 输出的必选项。
在调用ALV之前,需要先定义Layout 和Fieldcat,他们同属于类型池 SLIS:
其中,对于两个ALV函数用到的全局变量定义有所区别:
1) REUSE_ALV_GRID_DISPLAY 函数用到的全局变量:
DATA: wa_fieldcat TYPE slis_fieldcat_alv , " 相当于工作区 i_fieldcat TYPE slis_t_fieldcat_alv , " 存放输出栏位名称的列表 i_layout TYPE slis_layout_alv . " 负责整个ALV的全局属性
2) REUSE_ALV_GRID_DISPLAY_LVC函数用到的全局变量:
DATA: wa_fieldcat TYPE lvc_s_fcat , " 相当于工作区 i_fieldcat TYPE lvc_t_fcat , " 存放输出栏位名称的列表 i_layout TYPE lvc_s_layo . " 负责整个ALV的全局属性
可以看出:
REUSE_ALV_GRID_DISPLAY 的Layout 类型为 slis_layout_alv, Fieldcat 的类型为 slis_fieldcat_alv;
REUSE_ALV_GRID_DISPLAY_LVC 的Layout 类型为 lvc_s_layo, Fieldcat 的类型为 lvc_s_fcat;
其中,对于‘SLIS_’开头的,可以在类型池 SLIS 中查看,‘LVC_’开头的可以在数据字典(SE11)中查看。
SLIS 类型池中 slis_layout_alv 的定义:

slis_layout_alv
SE11中,lvc_s_layo的定义:

lvc_s_layo
3.1 slis_fieldcat_alv 常用具体字段栏位如下:
1) 公共部分
字段名称 | 描述 | 输入值 | 备注 |
no_colhead(1) | 不显示标题 | X-不显示,space-显示 | |
no_hotspot(1) | 标题不设热点 | X-没有,space-有 | |
zebra(1) | 使ALV表格按斑马线间隔条码方式显示 | X-有,space-没有 | |
no_vline(1) | 设置列间竖线 | X-不显示,space-显示 | |
no_hline(1) | 设置行间隔线 | X-不显示,space-显示 | |
cell_merge(1) | 设置是否压域复制 | X-可复制,space-不可复制 | |
edit(1) | 设置所有单元格可编辑 | X-可编辑,space-不可编辑 | |
edit_mode(1) | 编辑模式 | ||
numc_sum(1) | 设置仅NUMC类型字段进行总计 | X-仅Numc类型, space-不仅Numc类型 |
|
no_input(1) | 不允许输入,用于显示状态 | X-不允许,space-允许 | |
f2code | 设置触发弹出详细信息窗口的功能码 | sy-ucomm | ‘&ETA’ – 双击 |
no_keyfix (1) | 关键字不固定,可以随滚动条滚动 | X-不固定,space-固定 | |
expand_all (1) | 展开所有的node | 对hierarchy ALV函数而言 | |
no_author (1) | 设置是否需要系统标准权限检查 | X-不需要,space-需要 |
2) ALV菜单栏
字段名称 | 描述 | 输入值 | 备注 |
def_status (1) | 默认菜单状态 | A显示,space不显示 | ‘A’ – 为显示所有标准菜单 |
item_text (20) | 菜单按钮文本 | ||
countfname (1) | lvc_fname |
3) 显示选项
字段名称 | 描述 | 输入值 | 备注 |
colwidth_optimize(1) | 优化列宽设置 | X-优化 | 默认:space |
no_min_linesize(1) | 设置不允许最小宽度 | X-不允许,space-允许 | 默认:space |
min_linesize | ALV列表的最小宽度 | sy-linsz,取值10到250 | 可选参数 |
max_linesize | ALV列表的最大宽度 | sy-linsz,可取值80-1020 | 默认值250 |
window_titlebar | 窗口标题 | sy-title | |
no_uline_hs(1) | 输出ALV表不显示水平格线 | X-不显示,space-显示 |
4) 红绿灯显示异常
字段名称 | 描述 | 输入值 | 备注 |
lights_fieldname | 输出内表中定义的字段名,该字段用来显示状态灯 | 1:red,2:yellow,3:green | |
lights_tabname | 输出字段的参考内表名称 | ||
lights_rollname | 数据元素的名称,在灯字段按F1触发 | ||
lights_condense | 对输出的内表分类汇总的时候,小计行显示状态灯 | X |
5) 汇总合计
字段名称 | 描述 | 输入值 | 备注 |
no_sumchoice (1) | 不能进行选择总计 | ||
no_totalline (1) | 不能总计,但可以小计 | ||
no_subchoice (1) | 不能选择小计,但可以总计 | ||
no_subtotals (1) | 不能小计,但可以总计 | ||
no_unit_splitting | 有单位字段,不进行总计 | ||
totals_before_items | 总行将会显示在最前面 | ||
totals_only (1) | 仅显示合计 | ||
totals_text (60) | 合计,第一列显示的文本 | ||
subtotals_text (60) | 总计和小计行,第一列显示的文本 |
6) 交互
字段名称 | 描述 | 输入值 | 备注 |
box_fieldname | 设置ALV表格是否显示选择按钮栏位 | ||
box_tabname | box_fieldname 参考内表名称 | ||
box_rollname | 下拉框按钮名称 | ||
expand_fieldname | ’展开’字段名称 | ||
hotspot_fieldname | 热点字段 | ||
confirmation_prompt | 退出ALV列表的确认对话框 | ||
key_hotspot (1) | 关键字段作为热点 | ||
flexible_key (1) | 关键字段可以移动 | ||
group_buttons (1) | COL1 – COL5 按钮组 | ||
get_selinfos (1) | 获取选择屏幕 | ||
group_change_edit (1) | 设置用户新的按钮组 | ||
no_scrolling(1) | 滚动条无效,清单不随其滚动 | 仅list_alv有效 |
7) 明细窗口
字段名称 | 描述 | 输入值 | 备注 |
detail_popup (1) | 行项目明细弹窗形式 | X-显示,space-不显示 | 对list_alv有效 |
detail_initial_lines(1) | 明细中同时显示初始化行 | X-同时显示,space-不显示 | |
detail_titlebar | 明细窗口标题文本 | sy-title |
8) 显示变式
字段名称 | 描述 | 输入值 | 备注 |
header_text | 表头按钮 | ||
default_item (1) | 列表明细作为默认值 | X-激活,space-不激活 |
9) 颜色
字段名称 | 描述 | 输入值 | 备注 |
info_fieldname | 用于设置ALV输出报表每一行的颜色, 其参数为输出内表的栏位名称 |
C000~C999 | 倘若其数据输出内表名为LT_OUT,则需要在改内表增加一个栏位“COLOR”,并为内表每行赋值, LT_OUT-COLOR = ‘C500’ |
coltab_fieldname | 颜色值 |
10) 其他
字段名称 | 描述 | 输入值 | 备注 |
list_append | 设置是否Call屏幕 | ||
xifunckey | eXtended interaction(SAPQuery) | ||
xidirect | eXtended INTeraction(SAPQuery) | ||
dtc_layout | 设置Tabstip的布局格式配置 | DTC_S_LAYO | |
allow_switch_to_list | 设置从Grid模式转换为List模式 |
3.2 lvc_s_layo常用具体字段栏位如下:
1) 布局控制(ALV_S_LAYO)
字段名称 | 描述 | 输入值 | 备注 |
ZEBRA(1) | 使ALV表格按斑马线间隔条码方式显示 | X-有,space-没有 | |
EDIT(1) | 准备编辑 | X-可编辑,space-不可编辑 | |
EDIT_MODE(1) | 编辑模式 | ||
NO_KEYFIX(1) | 关键字不固定,可以随滚动条滚动 | X-不固定,space-固定 | |
FRONTEND(1) | |||
LANGUAGE | 语言标识符 | LANG | |
SMALLTITLE(1) | 标题大小 | ||
NO_HGRIDLN(1) | 是否隐藏水平网格线 | X-不显示,space-显示 | |
NO_VGRIDLN(1) | 是否隐藏垂直网格线 | X-不显示,space-显示 | |
NO_HEADERS(1) | 隐藏列抬头 | X-不显示,space-显示 | |
NO_MERGING(1) | 禁用单元格合并 | ||
CWIDTH_OPT(1) | 自动优化列宽 | X-优化,space-不自动优化 | |
TOTALS_BEF(1) | 在个别记录前总计输出 | ||
NO_TOTARR(1) | 汇总行前显示箭头表示汇总 | ||
NO_TOTEXP(1) | 只显示小计,不显示总计 | ||
NO_F4(1) | 屏蔽F4搜索帮助 | ||
COUNTFNAME | 内部表字段的字段名称 | LVC_FNAME |
2) 一般显示选项(LVC_S_L001)
字段名称 | 描述 | 输入值 | 备注 |
STYLEFNAME | 用来传输格表,以便把各显示为按钮 | LVC_FNAME |
3) 网格定制(LVC_S_L002)
字段名称 | 描述 | 输入值 | 备注 |
NO_ROWMARK | 禁用行选择 | ||
NO_TOOLBAR | 隐藏工具栏 | ||
GRID_TITLE | 标题栏文本 | ||
SEL_MODE(1) | 选择模式 | A-选择按钮,space-空白 | “A”在最左端有选择按钮 |
BOX_FNAME | 内部表字段的字段名称 | ||
SGL_CLK_HD | 第一次点击列的头的时候升序排列, 第二次点击的时候降序排列 |
4) 总计选项(LVC_S_L003)
字段名称 | 描述 | 输入值 | 备注 |
NO_TOTLINE(1) | 不输出总计行 | X-不输出,space-输出 | |
NUMC_TOTAL(1) | 禁止 NUMC 字段总计 | X-禁止,space-不禁止 | |
NO_UTSPLIT(1) | 按单元拆分总计行 | X-不拆分,space-拆分 |
5) 例外(LVC_S_L004)
字段名称 | 描述 | 输入值 | 备注 |
EXCP_FNAME | Field name with exception coding | ||
EXCP_ROLLN | Data element for exception documentation | ||
EXCP_CONDS(1) | Aggregate exceptions | ||
EXCP_LED(1) | Exception as LED | ||
EXCP_GROUP(1) | Exception Group |
6) 交互控制(LVC_S_L005)
字段名称 | 描述 | 输入值 | 备注 |
DETAILINIT | 在细节屏幕显示初始值 | ||
DETAILTITL | 细节屏幕的标题栏 | ||
KEYHOT | 关键列作为热点 | ||
NO_AUTHOR | 不执行 ALV 标准授权检查 | ||
XIFUNCKEY | 附加功能名 | ||
XIDIRECT | 一般标记 | ||
7) 拖&放控制设置(LVC_S_DD01)
字段名称 | 描述 | 输入值 | 备注 |
S_DRAGDROP | 拖&放控制设置结构 | LVC_S_DD01 |
8) 颜色(LVC_S_L006)
字段名称 | 描述 | 输入值 | 备注 |
INFO_FNAME | 带有简单行彩色代码的字段名称 | ||
CTAB_FNAME | 代表颜色信息的字段名 |
和Layout一样,REUSE_ALV_GRID_DISPLAY 函数中的 Fieldcat 结构: slis_t_fieldcat_alv 可在 SLIS 类型池中找到;
REUSE_ALV_GRID_DISPLAY_LVC函数中的 Fieldcat 结构: lvc_s_fcat 可在 SE11 中查看。
两者大同小异,常用具体字段栏位如下:
字段名称 | 描述 | 输入值 | 备注 |
row_pos | 输出行位置 | 1….n | |
col_pos | 输出列位置 | 1….n | |
fieldname | 字段名称 | ||
tabname | fieldname字段对应的内表名称 | ||
currency | 货币单位 | ||
cfieldname | 当前输出内表中的货币单位字段的字段名称 | ||
ctabname | Cfieldname字段值对应的内表名称 | ||
ifieldname | |||
quantity | 计量单位 | ||
qfieldname | 参考计量单位的字段名称 | ||
qtabname | Qfieldname 对应的输出内表名 | ||
round | 四舍五入保留位数 | ||
exponent | 流动表示的指数 | ||
key(1) | 将栏位设置为Key值 | ||
icon(1) | 将定义栏位以ICON的形式显示 | ||
symbol(1) | 作为Symbol符号输出, 在ALV输出内表中的字段值可以是ABAP名称 |
||
checkbox(1) | 作为复选框输出 | ||
just(1) | 定义栏位对齐方式 | (R)Right (L)Left (C)Center | |
lzero(1) | 输出前置零 | ||
no_sign(1) | 不输出正负号+、- | ||
no_zero(1) | 如果取值为零,则为空,既不输出零 | ||
no_convext(1) | |||
edit_mask | 输出编辑掩码, 同write语句中的edit mas格式是一样的 | 一般用来格式化时间和日期等 | |
emphasize(4) | 设置栏位的颜色 | ||
fix_column(1) | 固定列 | ||
do_sum(1) | 对当前列输出时自动求和 | ||
no_out(1) | 当前列隐藏输出 | ||
tech(1) | 技术字段,设置’X’后,该字段不会显示, 也不能输出,如同MANDT字段一样的效果 |
||
outputlen | 列的字符宽度 | ||
offset | 偏移量 | ||
seltext_l / scrtext_l | 长文本 | ||
seltext_m / scrtext_m | 中文本 | ||
seltext_s / scrtext_s | 短文本 | ||
ddictxt(1) | 列标题描述格式 | (S)hort (M)iddle (L)ong | |
rollname | |||
datatype | 数据类型 | ||
inttype | 整型 | ||
intlen | 整型长度 | ||
lowercase | 是否允许小写字母 | ||
decfloat_style | 浮点格式 | ||
ref_fieldname | 参考字段名称,配合ref_tabname一起使用, 一般用来使单元格生成F4帮助 |
||
ref_tabname | 参考表名称,配合ref_fieldname使用 | ||
roundfieldname | 四舍五入字段名称 | ||
roundtabname | 四舍五入内表名称 | ||
decimalsfieldname | 小数点字段名称 | ||
decimalstabname | 小数点内表名称 | ||
decimals_out(6) | 控制小数点的位数 | ||
text_fieldname | 文本字段名称 | ||
reptext_ddic | 与数据元素的主标题类似 | ||
ddic_outputlen | 数据字典输出长度 | ||
key_sel(1) | 这个参数只和设置了Key的字段相关,和Key一起使用 可以交互式的隐藏设置为Key的字段(alv_list有效) |
||
no_sum(1) | 不自动汇总 | ||
sp_group(4) | 分组需求 | ||
reprep(1) | selection for rep/rep | ||
input(1) | 输入 | ||
edit(1) | 编辑 | ||
hotspot(1) | 设置栏位是否有热点(热点栏位显示有下划线) |
使用ALV输出,可以直接参考数据字典中的现有透明表,也可以自定义Fieldcat来输出字段;
如若使用数据字典中的透明表或视图时,需要调用REUSE_ALV_FIELDCATALOG_MERGE 函数来对相应的Fieldcat 进行匹配;
另外,必须保证该结构或内表中的每个字段都参考数据字典中的Data Element,否则无法获取字段的相关信息.
以REUSE_ALV_GRID_DISPLAY 函数为例:
CALL FUNCTION 'REUSE_ALV_GRID_DISPLAY' EXPORTING i_interface_check = ' ' i_bypassing_buffer = ' ' i_buffer_active = ' ' i_callback_program = gv_repid "程序名称 i_callback_pf_status_set = 'FRM_SET_GUI' "定义触发工具栏定义的子程序 i_callback_user_command = 'FRM_USER_COMMAND' "单击alv工具栏按钮或双击行项目时触发所定义的子程序 i_callback_top_of_page = ' ' i_callback_html_top_of_page = ' ' i_callback_html_end_of_list = ' ' i_structure_name = i_background_id = ' ' i_grid_title = 'ALV输出' "ALV名称 i_grid_settings = is_layout = gt_layout "程序所定义的layout名称 it_fieldcat = gt_fieldcat[] "定义fieldcat数据 it_excluding = it_special_groups = it_sort = gt_sort[] it_filter = is_sel_hide = i_default = 'X' i_save = 'X' is_variant = it_events = gt_event[] it_event_exit = is_print = is_reprep_id = i_screen_start_column = '0' i_screen_start_line = '0' i_screen_end_column = '0' i_screen_end_line = '0' i_html_height_top = '0' i_html_height_end = '0' it_alv_graphics = it_hyperlink = it_add_fieldcat = it_except_qinfo = ir_salv_fullscreen_adapter = IMPORTING e_exit_caused_by_caller = es_exit_caused_by_user = TABLES t_outtab = gt_print EXCEPTIONS program_error = 1 OTHERS = 2.
下面看看两个函数各自输出的方式与操作;
1) REUSE_ALV_GRID_DISPLAY 函数:
REPORT ztest_jx_alv. TYPES: slis. TYPES: BEGIN OF ty_s_matnr, matnr TYPE mara-matnr, END OF ty_s_matnr. DATA: i_tab TYPE STANDARD TABLE OF ty_s_matnr. SELECT matnr FROM mara INTO CORRESPONDING FIELDS OF TABLE i_tab UP TO 20 ROWS. DATA: wa_fieldcat TYPE slis_fieldcat_alv , " 相当于工作区 i_fieldcat TYPE slis_t_fieldcat_alv , " 存放列名的列表 i_layout TYPE slis_layout_alv . " 负责整个ALV的全局属性 DATA: lv_pos TYPE p. wa_fieldcat-qtabname = wa_fieldcat-ctabname = wa_fieldcat-tabname = 'I_TAB'. wa_fieldcat-fieldname = 'MATNR'. " 需要输出的内表的字段名 wa_fieldcat-seltext_l = 'Material NO.'. " 字段的描述-长字段标签 wa_fieldcat-seltext_m = 'Material NO.'. " 字段描述-中字段标签 wa_fieldcat-seltext_s = 'Material NO.'. " 字段描述-短字段标签 wa_fieldcat-fix_column = 'X' . " 是否是固定列 APPEND wa_fieldcat TO i_fieldcat. CLEAR wa_fieldcat. i_layout-zebra = 'X' . " 使ALV界面呈现颜色交替 i_layout-colwidth_optimize = 'X' . " 自动优化列宽 i_layout-detail_initial_lines = 'X' . " 是否出现细节屏幕 i_layout-detail_titlebar = '详细内容' . " 细节屏幕标题 CALL FUNCTION 'REUSE_ALV_GRID_DISPLAY' EXPORTING i_callback_program = sy-repid " 当前程序 is_layout = i_layout " 属性内表 it_fieldcat = i_fieldcat[] " 列明内表 i_save = 'X' " 是否保存布局 TABLES t_outtab = i_tab EXCEPTIONS program_error = 1 OTHERS = 2.
输出结果:

reuse_alv_grid_display
2) REUSE_ALV_GRID_DISPLAY_LVC 函数
REPORT ztest_jx_alv_lvc. * 引入类型池 TYPES: slis. TYPES: BEGIN OF ty_s_matnr, matnr TYPE mara-matnr, END OF ty_s_matnr. DATA: i_tab TYPE STANDARD TABLE OF ty_s_matnr . SELECT matnr FROM mara INTO CORRESPONDING FIELDS OF TABLE i_tab UP TO 20 ROWS. DATA: wa_fieldcat_lvc TYPE lvc_s_fcat , " 相当于工作区 i_fieldcat_lvc TYPE lvc_t_fcat , " 存放列名的列表 i_layout_lvc TYPE lvc_s_layo . " 负责整个ALV的全局属性 wa_fieldcat_lvc-tabname = 'I_TAB'. wa_fieldcat_lvc-fieldname = 'MATNR'. " 需要输出的内表的字段名 wa_fieldcat_lvc-scrtext_l = 'Material NO.'. " 字段的描述-长字段标签 wa_fieldcat_lvc-scrtext_m = 'Material NO.'. " 字段描述-中字段标签 wa_fieldcat_lvc-scrtext_s = 'Material NO.'. " 字段描述-短字段标签 wa_fieldcat_lvc-fix_column = 'X' . " 是否是固定列 APPEND wa_fieldcat_lvc TO i_fieldcat_lvc . CLEAR wa_fieldcat_lvc. i_layout_lvc-zebra = 'X' . " 使ALV界面呈现颜色交替 i_layout_lvc-sel_mode = 'A' . " 选择模式,"A"在最左端有选择按钮 i_layout_lvc-cwidth_opt = 'X' . " 自动优化列宽 i_layout_lvc-detailinit = 'X' . " 是否出现细节屏幕 i_layout_lvc-detailtitl = '详细内容' . " 细节屏幕标题 CALL FUNCTION 'REUSE_ALV_GRID_DISPLAY_LVC' EXPORTING i_callback_program = sy-repid " 当前程序 is_layout_lvc = i_layout_lvc " 属性内表 it_fieldcat_lvc = i_fieldcat_lvc[] " 列明内表 i_save = 'X' " 是否保存布局 TABLES t_outtab = i_tab " 数据内表 EXCEPTIONS program_error = 1 OTHERS = 2.
输出结果:

reuse_alv_grid_display_lvc