2026/9/9 20:05:15
FEATURED · 精选文章 
1. 背景ALV分类小计为什么要“沉底”1.1 一个常见但很折腾的需求先说说我遇到的实际场景。财务部门月底要做一张销售分析报表字段不复杂公司代码、物料组、物料描述、数量、金额。领导要求两个东西第一按物料组分类小计第二所有分类小计不要像传统分组报表那样插在每组明细的中间而是集中放到报告最后和总计一起方便他们拷贝到Excel里做下一步加工。听起来很简单对不对但真动手做ABAP ALV的时候你会发现系统默认的控制级别小计就长在分组中间。物料组A的明细显示完紧接着就是A的小计然后才是物料组B的明细。这种布局适合逐组核对但并不适合领导要求的“先把所有明细看完再统一看汇总”。这个需求不是个例。很多做物资、财务、销售月报的开发同学都提过类似问题。有人说你可以用控制级别加排序把小计行排到后面实际试过就知道ALV的控制级别是绑定排序键的小计位置基本由键值变化点决定想真正“沉底”只能另想办法。1.2 为什么原生ALV控制级别做不到ALV的分类小计官方叫subtotal实现原理是通过排序目录sort criteria的subtotal字段触发的。系统在数据输出前先按指定字段排序当检测到排序键值发生变化时自动插入一个小计行把上一个分组内的数值字段汇总一下然后继续输出下一组明细。这个机制有几个特点小计行一定出现在下一组第一条明细之前也就是上一组最后一条明细之后排序键必须是分类字段否则无法触发控制级别小计行是ALV内部生成的不占用你传入的输出内表条数分组小计之后还有一个ALV自动算出的总计行默认也可以开启。所以一旦你选择了“控制级别小计”小计行的位置就锁死在分组切换点上。你想要它跑到整张报表最后系统设计上就没有这个选项。除非你用一个取巧的做法比如把一个稳定递增的序列号也加进排序键让每个排序键都唯一这样系统永远不会触发“键值变化”就不生成任何小计。结果就是小计完全消失还得自己重新造。1.3 三条技术路线我最后选了哪条针对“分类小计沉底”这个需求我列过三个方案简单对比一下方案实现方式优点缺点方案A原生控制级别在set_sort_criteria中开启subtotal开发量最小系统自动汇总小计行固定在分组中间无法沉底样式也不好扩展方案BAFTER_LINE_OUTPUT里动态插行在事件触发时向ALV内部行模型追加新的汇总行表面上能任意控制行位置行索引错乱、刷新不稳定、操作复杂性能也差不推荐生产环境用方案C数据构造阶段追加汇总行自己计算分类小计和总计把汇总记录追加到输出内表末尾再用AFTER_LINE_OUTPUT做识别和样式定制位置完全可控逻辑透明好测试不容易出幺蛾子需要自己维护汇总计算工作量多一点我最终选择的是方案C。这个方案的核心思路其实很简单既然ALV不能把自动小计移到底部那我干脆不用自动小计直接构造一个“明细在前汇总在后”的输出内表。明细行放在前面所有分类小计行按顺序追加在末尾最后放一个总计行。然后用AFTER_LINE_OUTPUT事件在真正的输出阶段把汇总行识别出来做自定义显示控制。这里要特别注意AFTER_LINE_OUTPUT这个事件本身并不是用来“追加行”的。我看到很多刚接触ALV事件的人以为在这个事件里能用insert_row之类的方法往里塞新行实际是不行的。它是在ALV已经画完某一行之后才会触发行已经输出了你再想往渲染流里插新记录既危险也没必要不如一开始就把数据整理好。这也是方案C能成立的关键。2. 拆解AFTER_LINE_OUTPUT它的能力和边界2.1 事件触发时机与参数AFTER_LINE_OUTPUT是CL_GUI_ALV_GRID提供的一个事件直译过来就是“行输出之后”。当ALV网格把每一行输出到界面后系统会触发一次这个事件。和它经常一起出现的兄弟事件有TOOLBAR、USER_COMMAND、HOTSPOT_CLICK、DOUBLE_CLICK等等。声明这个事件处理方法的标准写法如下CLASS lcl_alv_event_handler DEFINITION. PUBLIC SECTION. METHODS: handle_after_line_output FOR EVENT after_line_output OF cl_gui_alv_grid IMPORTING e_dummy e_line_index. ENDCLASS.两个参数的含义E_DUMMY布尔类型一般不需要处理通常是空值或者初始值。E_LINE_INDEX整型表示当前输出的行索引。注意这个索引是ALV当前显示列表中的行号不是你原始内表的物理行号。如果ALV启用了排序、过滤索引会和原始内表顺序不一致。我自己在实际开发中一般会在事件方法开头加一个判断确保只有真实数据行才继续处理虚拟行直接返回避免干扰。METHOD handle_after_line_output. IF e_dummy IS NOT INITIAL. RETURN. ENDIF. 这里才是真正处理逻辑 ENDMETHOD.2.2 一个关键认知这一行已经画完了AFTER_LINE_OUTPUT这个事件最容易被误解的地方在于很多人以为可以在事件里修改当前行的数据和样式然后ALV会立刻按照修改后的效果重新渲染。实际上事件触发时当前行已经在画面上渲染完成了你在这个时点直接改数据并不会让用户看到实时变化。那这个事件到底有什么用我在多年项目里的经验是它更适合做“行输出后的后处理”和“状态同步”。比如在每一行输出后累计已经输出的行数做一些进度统计根据当前输出行的性质更新屏幕上的辅助控件显示把刚刚输出的汇总行信息记录下来供后面的工具栏按钮或导出功能使用配合一些自定义输出逻辑在行输出完成后触发后续动作。单纯想要“改变这一行长什么样”应该提前在数据构造阶段设置好字段目录或者把样式放在输出内表对应的样式字段中等ALV绘制时自动生效。理解了这一点你再看“用AFTER_LINE_OUTPUT自定义尾部汇总行”这个主题思路就清晰了。2.3 在“汇总行沉底”方案里事件承担什么角色既然AFTER_LINE_OUTPUT不能插行也不能直接改已完成渲染的行那我的方案里用它是干什么的答案是做汇总行的识别和联动控制。我在构造输出内表时会给每一行打一个类型标记比如D表示明细S表示分类小计T表示总计。然后把这个字段设为ALV不显示的隐藏技术字段。在AFTER_LINE_OUTPUT事件中根据当前行索引去读输出内表判断当前行类型从而决定要不要做一些附加动作。比如我可以在每次输出到分类小计行时把当前分类名称和汇总金额写入屏幕上的一个文本控件让用户在滚动时能看到当前尾部汇总的实时状态也可以在汇总行输出后把该行索引保存到一个内部表里后续用户点击工具栏的“导出汇总”按钮时能快速定位所有汇总行只导出这部分数据。所以这个事件的核心价值不在“渲染”而在“联动”。把数据流的准备和事件流的处理分开整个报表逻辑才会干净。3. 实操一步步把分类小计沉到报表尾部3.1 准备数据给每一行打上类型标签先定义一个输出结构为了演示方便我用销售报表的简化结构TYPES: BEGIN OF ty_out, matkl TYPE matkl, 物料组 maktx TYPE maktx, 物料描述 menge TYPE menge_d, 数量 netwr TYPE netwr, 金额 waers TYPE waers, 货币单位 rowtype TYPE char1, D-明细 S-分类小计 T-总计 linecolor TYPE char4, 行颜色代码用于ALV行着色 END OF ty_out.rowtype字段是这个方案的关键。所有明细行赋值D分类小计行赋值S总计时赋值T。后面ALV展示时这个字段要设置为不显示。因为我们在AFTER_LINE_OUTPUT事件中要按行类型做判断所以这个标记必须可靠。如果你希望汇总行显示不同颜色可以加一个行颜色字段例如linecolor。ALV布局中通过layout-info_fname指定这个字段后系统会自动按字段值着色。行颜色的取值规则类似C710表示灰色C510表示黄色等具体可以查LVC_S_COLO对象。3.2 计算分类小计与总计接下来是核心计算。我建议不要用AT END OF matkl这种旧语法因为它的正确性依赖于内表当前排序顺序一旦排序不稳定小计结果就可能错。用COLLECT或者新语法GROUP BY更可靠。下面是用COLLECT按物料组汇总的示例DATA: lt_detail TYPE TABLE OF ty_out, lt_subtotal TYPE TABLE OF ty_out, ls_subtotal LIKE LINE OF lt_subtotal, lt_total TYPE TABLE OF ty_out. 假设明细数据已经放到lt_detail中 LOOP AT lt_detail INTO DATA(ls_detail). CLEAR ls_subtotal. ls_subtotal-matkl ls_detail-matkl. ls_subtotal-menge ls_detail-menge. ls_subtotal-netwr ls_detail-netwr. ls_subtotal-waers ls_detail-waers. ls_subtotal-rowtype S. COLLECT ls_subtotal INTO lt_subtotal. ENDLOOP.COLLECT会自动按非数值关键字分组后累加数值字段也就是说会按照MATKL和WAERS组合分组数量和金额自动求和。然后算总计。总计算法更简单把明细内表直接汇总一遍或者把小计内表再汇总一遍都行。如果小计内表已经按物料组唯一把小计内表的金额和数量再累加一次就能得到总计。当然更稳妥的是直接从明细算DATA: ls_total LIKE LINE OF lt_total. CLEAR ls_total. ls_total-maktx 总 计. ls_total-rowtype T. LOOP AT lt_detail INTO DATA(ls_d). ls_total-menge ls_total-menge ls_d-menge. ls_total-netwr ls_total-netwr ls_d-netwr. ENDLOOP.注意这里的汇率和货币字段要保证一致如果报表涉及多种货币那就不能简单相加了要按汇率转换后汇总否则数字就会失真。这个属于业务逻辑实际项目里要提前跟财务确认。3.3 合并顺序明细在前汇总沉底计算完成后把三部分按顺序拼到最终输出内表中DATA: lt_out TYPE TABLE OF ty_out. 1. 明细部分 APPEND LINES OF lt_detail TO lt_out. 2. 分类小计部分放在明细之后 APPEND LINES OF lt_subtotal TO lt_out. 3. 总计放在最后 APPEND ls_total TO lt_out.这样最终的输出内表顺序就是所有明细行按原顺序展示中间没有小计干扰所有分类小计集中在末尾最后是总计。这里有一个细节如果明细本身需要按物料组排序你可以在取数SQL阶段用ORDER BY排好或者用SORT排序后再拼。但无论如何汇总行必须保持在末尾。所以我强烈建议在拼好lt_out之后不要再对整个内表做全局SORT否则汇总行会被重新打散。如果你确实需要用户能看到按物料组排过序的明细操作顺序应该是先对明细内表排序再计算小计最后拼接汇总行。小计的位置在拼接后的内表中是固定的不会再被排序影响。3.4 ALV基本配置与事件注册现在进入ALV配置环节。我一般用CL_GUI_ALV_GRID配合一个容器。先定义全局对象DATA: gr_container TYPE REF TO cl_gui_custom_container, gr_grid TYPE REF TO cl_gui_alv_grid, gr_handler TYPE REF TO lcl_alv_event_handler.创建容器和网格CREATE OBJECT gr_container EXPORTING container_name AREA_ALV. CREATE OBJECT gr_grid EXPORTING i_parent gr_container.字段目录可以从内表结构自动生成然后手工调整关键列DATA: lt_fcat TYPE lvc_t_fcat, ls_layout TYPE lvc_s_layo. CALL FUNCTION LVC_FIELDCATALOG_MERGE EXPORTING i_structure_name TY_OUT CHANGING ct_fieldcat lt_fcat.然后要把ROW TYPE和LINECOLOR两个技术字段隐藏LOOP AT lt_fcat ASSIGNING FIELD-SYMBOL(ls_fcat). CASE ls_fcat-fieldname. WHEN ROWTYPE OR LINECOLOR. ls_fcat-no_out X. WHEN MATKL. ls_fcat-coltext 物料组. WHEN MAKTX. ls_fcat-coltext 物料描述. WHEN MENGE. ls_fcat-coltext 数量. WHEN NETWR. ls_fcat-coltext 金额. WHEN WAERS. ls_fcat-coltext 货币. ENDCASE. ENDLOOP.布局设置主要调整小计和总计行的显示ls_layout-zebra X. ls_layout-cwidth_opt X. ls_layout-info_fname LINECOLOR. ls_layout-no_rowmark X.然后调用SET_TABLE_FOR_FIRST_DISPLAY把数据传给ALV这里用is_variant和导出参数选一个初始布局即可。事件注册的时机必须在显示数据之前或者在创建网格后立刻注册否则用户实际操作时可能已经错过了某次事件CREATE OBJECT gr_handler. SET HANDLER gr_handler-handle_after_line_output FOR gr_grid.3.5 AFTER_LINE_OUTPUT事件实现事件方法的具体实现如下CLASS lcl_alv_event_handler IMPLEMENTATION. METHOD handle_after_line_output. DATA: ls_out TYPE ty_out. FIELD-SYMBOLS: ls_row LIKE LINE OF gt_out. IF e_dummy IS NOT INITIAL. RETURN. ENDIF. 根据当前输出行索引读取数据 READ TABLE gt_out INDEX e_line_index ASSIGNING ls_row. IF sy-subrc 0. RETURN. ENDIF. CASE ls_row-rowtype. WHEN S. 分类小计行输出完成后把信息保存到汇总信息内表 后续可以用于工具栏按钮导出、状态栏提示等 APPEND ls_row TO gt_summary_info. WHEN T. 总计行输出完成设置完成标志 gv_total_rendered abap_true. ENDCASE. ENDMETHOD. ENDCLASS.这个方法做的事情看起来不多但在实际项目中有很大价值。比如gt_summary_info收集了所有汇总行索引后续用户通过工具栏的“导出汇总”按钮可以直接只输出这些汇总行不碰明细行。又比如在总计行输出完成后可以把界面上的状态栏文字更新成“报表输出完成共X条明细、Y个分类小计、合计金额Z”这种联动效果用其他事件还不太好实现。如果你确实需要让汇总行在视觉上有明显区分我建议把样式放到数据准备阶段而不是在AFTER_LINE_OUTPUT里临时改。方法很简单在构造小计行时给linecolor字段赋值。比如分类小计行用浅灰色C710总计行用黄色C510。ALV布局中已经指定了info_fname LINECOLOR所以这些行会自动带上背景色用户一眼就能看出来这些是汇总行。再补充一个让汇总行文本更友好的技巧。因为rowtype字段已经被隐藏汇总行的物料描述列显示什么内容完全由你控制。我习惯在准备汇总行时把maktx字段写成“物料组 XX 小计”总计行写成“全部物料组总计”并且把物料组字段清空。这样输出到末尾时用户看到的是一串清晰的汇总行而不是一堆空白。3.6 完整示例代码一个可直接抄的骨架我把上面这些内容整合成一个最简单的可运行示例按自己的真实程序结构稍作调整就能用REPORT z_alv_tail_summary. TYPES: BEGIN OF ty_out, matkl TYPE matkl, maktx TYPE maktx, menge TYPE menge_d, netwr TYPE netwr, waers TYPE waers, rowtype TYPE char1, linecolor TYPE char4, END OF ty_out. DATA: gt_out TYPE TABLE OF ty_out, gt_detail TYPE TABLE OF ty_out, gt_subtotal TYPE TABLE OF ty_out, gt_summary_info TYPE TABLE OF ty_out. CLASS lcl_alv_event_handler DEFINITION. PUBLIC SECTION. METHODS: handle_after_line_output FOR EVENT after_line_output OF cl_gui_alv_grid IMPORTING e_dummy e_line_index. ENDCLASS. CLASS lcl_alv_event_handler IMPLEMENTATION. METHOD handle_after_line_output. FIELD-SYMBOLS: ls_row LIKE LINE OF gt_out. IF e_dummy IS NOT INITIAL. RETURN. ENDIF. READ TABLE gt_out INDEX e_line_index ASSIGNING ls_row. IF sy-subrc 0. RETURN. ENDIF. IF ls_row-rowtype S OR ls_row-rowtype T. APPEND ls_row TO gt_summary_info. ENDIF. ENDMETHOD. ENDCLASS. START-OF-SELECTION. PERFORM get_data. PERFORM build_summary. PERFORM display_alv. FORM get_data. 从数据库取数存到gt_detail 这里省略可以根据实际业务写SQL或者调用函数 ENDFORM. FORM build_summary. DATA: ls_subtot TYPE ty_out, ls_total TYPE ty_out. 分类小计 LOOP AT gt_detail INTO DATA(ls_detail). CLEAR ls_subtot. ls_subtot-matkl ls_detail-matkl. ls_subtot-maktx |小计 { ls_detail-matkl }|. ls_subtot-waers ls_detail-waers. ls_subtot-rowtype S. ls_subtot-linecolor C710. ls_subtot-menge ls_detail-menge. ls_subtot-netwr ls_detail-netwr. COLLECT ls_subtot INTO gt_subtotal. ENDLOOP. 总计 CLEAR ls_total. ls_total-maktx 全部物料组总计. ls_total-waers CNY. 示例固定币种实际从数据中取 ls_total-rowtype T. ls_total-linecolor C510. LOOP AT gt_detail INTO ls_detail. ls_total-menge ls_total-menge ls_detail-menge. ls_total-netwr ls_total-netwr ls_detail-netwr. ENDLOOP. 按顺序拼接明细 - 分类小计 - 总计 APPEND LINES OF gt_detail TO gt_out. APPEND LINES OF gt_subtotal TO gt_out. APPEND ls_total TO gt_out. ENDFORM. FORM display_alv. DATA: gr_container TYPE REF TO cl_gui_custom_container, gr_grid TYPE REF TO cl_gui_alv_grid, gr_handler TYPE REF TO lcl_alv_event_handler, lt_fcat TYPE lvc_t_fcat, ls_layout TYPE lvc_s_layo. CREATE OBJECT gr_container EXPORTING container_name AREA_ALV. CREATE OBJECT gr_grid EXPORTING i_parent gr_container. PERFORM build_fcat CHANGING lt_fcat. CLEAR ls_layout. ls_layout-zebra X. ls_layout-cwidth_opt X. ls_layout-info_fname LINECOLOR. CALL METHOD gr_grid-set_table_for_first_display EXPORTING i_structure_name TY_OUT is_layout ls_layout CHANGING it_outtab gt_out it_fieldcatalog lt_fcat. CREATE OBJECT gr_handler. SET HANDLER gr_handler-handle_after_line_output FOR gr_grid. ENDFORM. FORM build_fcat CHANGING ct_fcat TYPE lvc_t_fcat. CALL FUNCTION LVC_FIELDCATALOG_MERGE EXPORTING i_structure_name TY_OUT CHANGING ct_fieldcat ct_fcat. LOOP AT ct_fcat ASSIGNING FIELD-SYMBOL(ls_fcat). CASE ls_fcat-fieldname. WHEN ROWTYPE OR LINECOLOR. ls_fcat-no_out X. ENDCASE. ENDLOOP. ENDFORM.这个代码骨架直接把核心逻辑拆成了三个步骤取数、构造汇总、ALV展示。事件里只做汇总行信息收集简洁清楚。4. 日常开发的坑我替你踩过了4.1 AFTER_LINE_OUTPUT事件不触发这是最常见的低级问题。SET HANDLER的时机不对或者SET HANDLER根本没有写事件永远不会触发。我见过不少同事把SET HANDLER写在CALL METHOD set_table_for_first_display之后然后发现事件偶尔不触发。虽然理论上注册顺序不影响但为了稳妥我习惯在创建grid对象后、第一次显示数据前就注册事件。还有一个隐蔽原因是CREATE OBJECT了handler但是没有保存到全局变量。如果gr_handler是局部变量方法结束后handler对象被垃圾回收事件自然就失效了。所以handler一定要用全局对象或类属性保存。4.2 E_LINE_INDEX和原始内表行号对不上ALV如果启用了排序、过滤、或用户手动调整了列顺序E_LINE_INDEX就不是原始输出内表的物理行号。你在事件里直接用READ TABLE gt_out INDEX e_line_index可能读到错误的行。我自己的处理策略是在这个方案里不建议在AFTER_LINE_OUTPUT中做依赖原始物理顺序的复杂逻辑。如果只是为了识别汇总行最好在数据行数较少时直接用行索引或者改用能传递当前行数据的变体。如果你的SAP版本支持给事件增加E_LINE_DATA参数用数据引用来判断会更准确。不过这个参数不是所有版本都支持需要查阅你系统的事件定义。更保守的方案是在输出内表里增加一个“顺序号”字段从1开始连续编号即使ALV做了排序和过滤你也可以通过某种方式反查原表。不过ALV的过滤会直接删除不显示的行反查也麻烦。所以我最终的推荐是干脆禁用用户排序和过滤在布局中通过layout限制保证显示顺序始终与内表一致。这样省心很多。4.3 汇总行被用户的“过滤”和“排序”误伤这是方案C最大的坑。当用户点开ALV的自动过滤功能比如筛选物料组为“A001”那么所有物料组不等于A001的明细和汇总行都会被过滤掉。你辛辛苦苦放在末尾的分类小计可能瞬间只剩几条甚至一条都不剩。解决办法有三个方向第一向用户
ABAP ALV分类小计沉底：AFTER_LINE_OUTPUT事件实践
1. 背景ALV分类小计为什么要“沉底”1.1 一个常见但很折腾的需求先说说我遇到的实际场景。财务部门月底要做一张销售分析报表字段不复杂公司代码、物料组、物料描述、数量、金额。领导要求两个东西第一按物料组分类小计第二所有分类小计不要像传统分组报表那样插在每组明细的中间而是集中放到报告最后和总计一起方便他们拷贝到Excel里做下一步加工。听起来很简单对不对但真动手做ABAP ALV的时候你会发现系统默认的控制级别小计就长在分组中间。物料组A的明细显示完紧接着就是A的小计然后才是物料组B的明细。这种布局适合逐组核对但并不适合领导要求的“先把所有明细看完再统一看汇总”。这个需求不是个例。很多做物资、财务、销售月报的开发同学都提过类似问题。有人说你可以用控制级别加排序把小计行排到后面实际试过就知道ALV的控制级别是绑定排序键的小计位置基本由键值变化点决定想真正“沉底”只能另想办法。1.2 为什么原生ALV控制级别做不到ALV的分类小计官方叫subtotal实现原理是通过排序目录sort criteria的subtotal字段触发的。系统在数据输出前先按指定字段排序当检测到排序键值发生变化时自动插入一个小计行把上一个分组内的数值字段汇总一下然后继续输出下一组明细。这个机制有几个特点小计行一定出现在下一组第一条明细之前也就是上一组最后一条明细之后排序键必须是分类字段否则无法触发控制级别小计行是ALV内部生成的不占用你传入的输出内表条数分组小计之后还有一个ALV自动算出的总计行默认也可以开启。所以一旦你选择了“控制级别小计”小计行的位置就锁死在分组切换点上。你想要它跑到整张报表最后系统设计上就没有这个选项。除非你用一个取巧的做法比如把一个稳定递增的序列号也加进排序键让每个排序键都唯一这样系统永远不会触发“键值变化”就不生成任何小计。结果就是小计完全消失还得自己重新造。1.3 三条技术路线我最后选了哪条针对“分类小计沉底”这个需求我列过三个方案简单对比一下方案实现方式优点缺点方案A原生控制级别在set_sort_criteria中开启subtotal开发量最小系统自动汇总小计行固定在分组中间无法沉底样式也不好扩展方案BAFTER_LINE_OUTPUT里动态插行在事件触发时向ALV内部行模型追加新的汇总行表面上能任意控制行位置行索引错乱、刷新不稳定、操作复杂性能也差不推荐生产环境用方案C数据构造阶段追加汇总行自己计算分类小计和总计把汇总记录追加到输出内表末尾再用AFTER_LINE_OUTPUT做识别和样式定制位置完全可控逻辑透明好测试不容易出幺蛾子需要自己维护汇总计算工作量多一点我最终选择的是方案C。这个方案的核心思路其实很简单既然ALV不能把自动小计移到底部那我干脆不用自动小计直接构造一个“明细在前汇总在后”的输出内表。明细行放在前面所有分类小计行按顺序追加在末尾最后放一个总计行。然后用AFTER_LINE_OUTPUT事件在真正的输出阶段把汇总行识别出来做自定义显示控制。这里要特别注意AFTER_LINE_OUTPUT这个事件本身并不是用来“追加行”的。我看到很多刚接触ALV事件的人以为在这个事件里能用insert_row之类的方法往里塞新行实际是不行的。它是在ALV已经画完某一行之后才会触发行已经输出了你再想往渲染流里插新记录既危险也没必要不如一开始就把数据整理好。这也是方案C能成立的关键。2. 拆解AFTER_LINE_OUTPUT它的能力和边界2.1 事件触发时机与参数AFTER_LINE_OUTPUT是CL_GUI_ALV_GRID提供的一个事件直译过来就是“行输出之后”。当ALV网格把每一行输出到界面后系统会触发一次这个事件。和它经常一起出现的兄弟事件有TOOLBAR、USER_COMMAND、HOTSPOT_CLICK、DOUBLE_CLICK等等。声明这个事件处理方法的标准写法如下CLASS lcl_alv_event_handler DEFINITION. PUBLIC SECTION. METHODS: handle_after_line_output FOR EVENT after_line_output OF cl_gui_alv_grid IMPORTING e_dummy e_line_index. ENDCLASS.两个参数的含义E_DUMMY布尔类型一般不需要处理通常是空值或者初始值。E_LINE_INDEX整型表示当前输出的行索引。注意这个索引是ALV当前显示列表中的行号不是你原始内表的物理行号。如果ALV启用了排序、过滤索引会和原始内表顺序不一致。我自己在实际开发中一般会在事件方法开头加一个判断确保只有真实数据行才继续处理虚拟行直接返回避免干扰。METHOD handle_after_line_output. IF e_dummy IS NOT INITIAL. RETURN. ENDIF. 这里才是真正处理逻辑 ENDMETHOD.2.2 一个关键认知这一行已经画完了AFTER_LINE_OUTPUT这个事件最容易被误解的地方在于很多人以为可以在事件里修改当前行的数据和样式然后ALV会立刻按照修改后的效果重新渲染。实际上事件触发时当前行已经在画面上渲染完成了你在这个时点直接改数据并不会让用户看到实时变化。那这个事件到底有什么用我在多年项目里的经验是它更适合做“行输出后的后处理”和“状态同步”。比如在每一行输出后累计已经输出的行数做一些进度统计根据当前输出行的性质更新屏幕上的辅助控件显示把刚刚输出的汇总行信息记录下来供后面的工具栏按钮或导出功能使用配合一些自定义输出逻辑在行输出完成后触发后续动作。单纯想要“改变这一行长什么样”应该提前在数据构造阶段设置好字段目录或者把样式放在输出内表对应的样式字段中等ALV绘制时自动生效。理解了这一点你再看“用AFTER_LINE_OUTPUT自定义尾部汇总行”这个主题思路就清晰了。2.3 在“汇总行沉底”方案里事件承担什么角色既然AFTER_LINE_OUTPUT不能插行也不能直接改已完成渲染的行那我的方案里用它是干什么的答案是做汇总行的识别和联动控制。我在构造输出内表时会给每一行打一个类型标记比如D表示明细S表示分类小计T表示总计。然后把这个字段设为ALV不显示的隐藏技术字段。在AFTER_LINE_OUTPUT事件中根据当前行索引去读输出内表判断当前行类型从而决定要不要做一些附加动作。比如我可以在每次输出到分类小计行时把当前分类名称和汇总金额写入屏幕上的一个文本控件让用户在滚动时能看到当前尾部汇总的实时状态也可以在汇总行输出后把该行索引保存到一个内部表里后续用户点击工具栏的“导出汇总”按钮时能快速定位所有汇总行只导出这部分数据。所以这个事件的核心价值不在“渲染”而在“联动”。把数据流的准备和事件流的处理分开整个报表逻辑才会干净。3. 实操一步步把分类小计沉到报表尾部3.1 准备数据给每一行打上类型标签先定义一个输出结构为了演示方便我用销售报表的简化结构TYPES: BEGIN OF ty_out, matkl TYPE matkl, 物料组 maktx TYPE maktx, 物料描述 menge TYPE menge_d, 数量 netwr TYPE netwr, 金额 waers TYPE waers, 货币单位 rowtype TYPE char1, D-明细 S-分类小计 T-总计 linecolor TYPE char4, 行颜色代码用于ALV行着色 END OF ty_out.rowtype字段是这个方案的关键。所有明细行赋值D分类小计行赋值S总计时赋值T。后面ALV展示时这个字段要设置为不显示。因为我们在AFTER_LINE_OUTPUT事件中要按行类型做判断所以这个标记必须可靠。如果你希望汇总行显示不同颜色可以加一个行颜色字段例如linecolor。ALV布局中通过layout-info_fname指定这个字段后系统会自动按字段值着色。行颜色的取值规则类似C710表示灰色C510表示黄色等具体可以查LVC_S_COLO对象。3.2 计算分类小计与总计接下来是核心计算。我建议不要用AT END OF matkl这种旧语法因为它的正确性依赖于内表当前排序顺序一旦排序不稳定小计结果就可能错。用COLLECT或者新语法GROUP BY更可靠。下面是用COLLECT按物料组汇总的示例DATA: lt_detail TYPE TABLE OF ty_out, lt_subtotal TYPE TABLE OF ty_out, ls_subtotal LIKE LINE OF lt_subtotal, lt_total TYPE TABLE OF ty_out. 假设明细数据已经放到lt_detail中 LOOP AT lt_detail INTO DATA(ls_detail). CLEAR ls_subtotal. ls_subtotal-matkl ls_detail-matkl. ls_subtotal-menge ls_detail-menge. ls_subtotal-netwr ls_detail-netwr. ls_subtotal-waers ls_detail-waers. ls_subtotal-rowtype S. COLLECT ls_subtotal INTO lt_subtotal. ENDLOOP.COLLECT会自动按非数值关键字分组后累加数值字段也就是说会按照MATKL和WAERS组合分组数量和金额自动求和。然后算总计。总计算法更简单把明细内表直接汇总一遍或者把小计内表再汇总一遍都行。如果小计内表已经按物料组唯一把小计内表的金额和数量再累加一次就能得到总计。当然更稳妥的是直接从明细算DATA: ls_total LIKE LINE OF lt_total. CLEAR ls_total. ls_total-maktx 总 计. ls_total-rowtype T. LOOP AT lt_detail INTO DATA(ls_d). ls_total-menge ls_total-menge ls_d-menge. ls_total-netwr ls_total-netwr ls_d-netwr. ENDLOOP.注意这里的汇率和货币字段要保证一致如果报表涉及多种货币那就不能简单相加了要按汇率转换后汇总否则数字就会失真。这个属于业务逻辑实际项目里要提前跟财务确认。3.3 合并顺序明细在前汇总沉底计算完成后把三部分按顺序拼到最终输出内表中DATA: lt_out TYPE TABLE OF ty_out. 1. 明细部分 APPEND LINES OF lt_detail TO lt_out. 2. 分类小计部分放在明细之后 APPEND LINES OF lt_subtotal TO lt_out. 3. 总计放在最后 APPEND ls_total TO lt_out.这样最终的输出内表顺序就是所有明细行按原顺序展示中间没有小计干扰所有分类小计集中在末尾最后是总计。这里有一个细节如果明细本身需要按物料组排序你可以在取数SQL阶段用ORDER BY排好或者用SORT排序后再拼。但无论如何汇总行必须保持在末尾。所以我强烈建议在拼好lt_out之后不要再对整个内表做全局SORT否则汇总行会被重新打散。如果你确实需要用户能看到按物料组排过序的明细操作顺序应该是先对明细内表排序再计算小计最后拼接汇总行。小计的位置在拼接后的内表中是固定的不会再被排序影响。3.4 ALV基本配置与事件注册现在进入ALV配置环节。我一般用CL_GUI_ALV_GRID配合一个容器。先定义全局对象DATA: gr_container TYPE REF TO cl_gui_custom_container, gr_grid TYPE REF TO cl_gui_alv_grid, gr_handler TYPE REF TO lcl_alv_event_handler.创建容器和网格CREATE OBJECT gr_container EXPORTING container_name AREA_ALV. CREATE OBJECT gr_grid EXPORTING i_parent gr_container.字段目录可以从内表结构自动生成然后手工调整关键列DATA: lt_fcat TYPE lvc_t_fcat, ls_layout TYPE lvc_s_layo. CALL FUNCTION LVC_FIELDCATALOG_MERGE EXPORTING i_structure_name TY_OUT CHANGING ct_fieldcat lt_fcat.然后要把ROW TYPE和LINECOLOR两个技术字段隐藏LOOP AT lt_fcat ASSIGNING FIELD-SYMBOL(ls_fcat). CASE ls_fcat-fieldname. WHEN ROWTYPE OR LINECOLOR. ls_fcat-no_out X. WHEN MATKL. ls_fcat-coltext 物料组. WHEN MAKTX. ls_fcat-coltext 物料描述. WHEN MENGE. ls_fcat-coltext 数量. WHEN NETWR. ls_fcat-coltext 金额. WHEN WAERS. ls_fcat-coltext 货币. ENDCASE. ENDLOOP.布局设置主要调整小计和总计行的显示ls_layout-zebra X. ls_layout-cwidth_opt X. ls_layout-info_fname LINECOLOR. ls_layout-no_rowmark X.然后调用SET_TABLE_FOR_FIRST_DISPLAY把数据传给ALV这里用is_variant和导出参数选一个初始布局即可。事件注册的时机必须在显示数据之前或者在创建网格后立刻注册否则用户实际操作时可能已经错过了某次事件CREATE OBJECT gr_handler. SET HANDLER gr_handler-handle_after_line_output FOR gr_grid.3.5 AFTER_LINE_OUTPUT事件实现事件方法的具体实现如下CLASS lcl_alv_event_handler IMPLEMENTATION. METHOD handle_after_line_output. DATA: ls_out TYPE ty_out. FIELD-SYMBOLS: ls_row LIKE LINE OF gt_out. IF e_dummy IS NOT INITIAL. RETURN. ENDIF. 根据当前输出行索引读取数据 READ TABLE gt_out INDEX e_line_index ASSIGNING ls_row. IF sy-subrc 0. RETURN. ENDIF. CASE ls_row-rowtype. WHEN S. 分类小计行输出完成后把信息保存到汇总信息内表 后续可以用于工具栏按钮导出、状态栏提示等 APPEND ls_row TO gt_summary_info. WHEN T. 总计行输出完成设置完成标志 gv_total_rendered abap_true. ENDCASE. ENDMETHOD. ENDCLASS.这个方法做的事情看起来不多但在实际项目中有很大价值。比如gt_summary_info收集了所有汇总行索引后续用户通过工具栏的“导出汇总”按钮可以直接只输出这些汇总行不碰明细行。又比如在总计行输出完成后可以把界面上的状态栏文字更新成“报表输出完成共X条明细、Y个分类小计、合计金额Z”这种联动效果用其他事件还不太好实现。如果你确实需要让汇总行在视觉上有明显区分我建议把样式放到数据准备阶段而不是在AFTER_LINE_OUTPUT里临时改。方法很简单在构造小计行时给linecolor字段赋值。比如分类小计行用浅灰色C710总计行用黄色C510。ALV布局中已经指定了info_fname LINECOLOR所以这些行会自动带上背景色用户一眼就能看出来这些是汇总行。再补充一个让汇总行文本更友好的技巧。因为rowtype字段已经被隐藏汇总行的物料描述列显示什么内容完全由你控制。我习惯在准备汇总行时把maktx字段写成“物料组 XX 小计”总计行写成“全部物料组总计”并且把物料组字段清空。这样输出到末尾时用户看到的是一串清晰的汇总行而不是一堆空白。3.6 完整示例代码一个可直接抄的骨架我把上面这些内容整合成一个最简单的可运行示例按自己的真实程序结构稍作调整就能用REPORT z_alv_tail_summary. TYPES: BEGIN OF ty_out, matkl TYPE matkl, maktx TYPE maktx, menge TYPE menge_d, netwr TYPE netwr, waers TYPE waers, rowtype TYPE char1, linecolor TYPE char4, END OF ty_out. DATA: gt_out TYPE TABLE OF ty_out, gt_detail TYPE TABLE OF ty_out, gt_subtotal TYPE TABLE OF ty_out, gt_summary_info TYPE TABLE OF ty_out. CLASS lcl_alv_event_handler DEFINITION. PUBLIC SECTION. METHODS: handle_after_line_output FOR EVENT after_line_output OF cl_gui_alv_grid IMPORTING e_dummy e_line_index. ENDCLASS. CLASS lcl_alv_event_handler IMPLEMENTATION. METHOD handle_after_line_output. FIELD-SYMBOLS: ls_row LIKE LINE OF gt_out. IF e_dummy IS NOT INITIAL. RETURN. ENDIF. READ TABLE gt_out INDEX e_line_index ASSIGNING ls_row. IF sy-subrc 0. RETURN. ENDIF. IF ls_row-rowtype S OR ls_row-rowtype T. APPEND ls_row TO gt_summary_info. ENDIF. ENDMETHOD. ENDCLASS. START-OF-SELECTION. PERFORM get_data. PERFORM build_summary. PERFORM display_alv. FORM get_data. 从数据库取数存到gt_detail 这里省略可以根据实际业务写SQL或者调用函数 ENDFORM. FORM build_summary. DATA: ls_subtot TYPE ty_out, ls_total TYPE ty_out. 分类小计 LOOP AT gt_detail INTO DATA(ls_detail). CLEAR ls_subtot. ls_subtot-matkl ls_detail-matkl. ls_subtot-maktx |小计 { ls_detail-matkl }|. ls_subtot-waers ls_detail-waers. ls_subtot-rowtype S. ls_subtot-linecolor C710. ls_subtot-menge ls_detail-menge. ls_subtot-netwr ls_detail-netwr. COLLECT ls_subtot INTO gt_subtotal. ENDLOOP. 总计 CLEAR ls_total. ls_total-maktx 全部物料组总计. ls_total-waers CNY. 示例固定币种实际从数据中取 ls_total-rowtype T. ls_total-linecolor C510. LOOP AT gt_detail INTO ls_detail. ls_total-menge ls_total-menge ls_detail-menge. ls_total-netwr ls_total-netwr ls_detail-netwr. ENDLOOP. 按顺序拼接明细 - 分类小计 - 总计 APPEND LINES OF gt_detail TO gt_out. APPEND LINES OF gt_subtotal TO gt_out. APPEND ls_total TO gt_out. ENDFORM. FORM display_alv. DATA: gr_container TYPE REF TO cl_gui_custom_container, gr_grid TYPE REF TO cl_gui_alv_grid, gr_handler TYPE REF TO lcl_alv_event_handler, lt_fcat TYPE lvc_t_fcat, ls_layout TYPE lvc_s_layo. CREATE OBJECT gr_container EXPORTING container_name AREA_ALV. CREATE OBJECT gr_grid EXPORTING i_parent gr_container. PERFORM build_fcat CHANGING lt_fcat. CLEAR ls_layout. ls_layout-zebra X. ls_layout-cwidth_opt X. ls_layout-info_fname LINECOLOR. CALL METHOD gr_grid-set_table_for_first_display EXPORTING i_structure_name TY_OUT is_layout ls_layout CHANGING it_outtab gt_out it_fieldcatalog lt_fcat. CREATE OBJECT gr_handler. SET HANDLER gr_handler-handle_after_line_output FOR gr_grid. ENDFORM. FORM build_fcat CHANGING ct_fcat TYPE lvc_t_fcat. CALL FUNCTION LVC_FIELDCATALOG_MERGE EXPORTING i_structure_name TY_OUT CHANGING ct_fieldcat ct_fcat. LOOP AT ct_fcat ASSIGNING FIELD-SYMBOL(ls_fcat). CASE ls_fcat-fieldname. WHEN ROWTYPE OR LINECOLOR. ls_fcat-no_out X. ENDCASE. ENDLOOP. ENDFORM.这个代码骨架直接把核心逻辑拆成了三个步骤取数、构造汇总、ALV展示。事件里只做汇总行信息收集简洁清楚。4. 日常开发的坑我替你踩过了4.1 AFTER_LINE_OUTPUT事件不触发这是最常见的低级问题。SET HANDLER的时机不对或者SET HANDLER根本没有写事件永远不会触发。我见过不少同事把SET HANDLER写在CALL METHOD set_table_for_first_display之后然后发现事件偶尔不触发。虽然理论上注册顺序不影响但为了稳妥我习惯在创建grid对象后、第一次显示数据前就注册事件。还有一个隐蔽原因是CREATE OBJECT了handler但是没有保存到全局变量。如果gr_handler是局部变量方法结束后handler对象被垃圾回收事件自然就失效了。所以handler一定要用全局对象或类属性保存。4.2 E_LINE_INDEX和原始内表行号对不上ALV如果启用了排序、过滤、或用户手动调整了列顺序E_LINE_INDEX就不是原始输出内表的物理行号。你在事件里直接用READ TABLE gt_out INDEX e_line_index可能读到错误的行。我自己的处理策略是在这个方案里不建议在AFTER_LINE_OUTPUT中做依赖原始物理顺序的复杂逻辑。如果只是为了识别汇总行最好在数据行数较少时直接用行索引或者改用能传递当前行数据的变体。如果你的SAP版本支持给事件增加E_LINE_DATA参数用数据引用来判断会更准确。不过这个参数不是所有版本都支持需要查阅你系统的事件定义。更保守的方案是在输出内表里增加一个“顺序号”字段从1开始连续编号即使ALV做了排序和过滤你也可以通过某种方式反查原表。不过ALV的过滤会直接删除不显示的行反查也麻烦。所以我最终的推荐是干脆禁用用户排序和过滤在布局中通过layout限制保证显示顺序始终与内表一致。这样省心很多。4.3 汇总行被用户的“过滤”和“排序”误伤这是方案C最大的坑。当用户点开ALV的自动过滤功能比如筛选物料组为“A001”那么所有物料组不等于A001的明细和汇总行都会被过滤掉。你辛辛苦苦放在末尾的分类小计可能瞬间只剩几条甚至一条都不剩。解决办法有三个方向第一向用户 
