S/4HANA for Customer Management 里的搜索分页处理

这篇文章的英文版我发在了 SAP Community 上：Paging Implementation in S/4HANA for Customer Management

https://blogs.sap.com/2018/03/28/paging-implementation-in-s4hana-for-customer-management/

按照我的公众号文章里介绍的，S/4HANA for Customer Management 1.0 里的 Service Request UI 仍然是采用 CRM Webclient UI 技术来开发的。

假设我在 UI 上指定 max hit 值为 200：

每页默认显示 20 条数据，因此这 200 条搜索结果总共分 10 页显示。

关于 CRM WebClient UI 的分页机制，有两个要点：

1. 搜索按钮点击后，会有 max hit 的值指定条数的记录从数据库取出，存储于 WebClient UI 的应用的内存区域中。在我的例子里，我指定的 max hit 为 200，因此有 200 条 Service Request 从数据库里取出。

2. WebClient UI 是一项服务器端渲染的技术，意味着所有 WebClient UI 页面对应的 html 源代码都是在 ABAP 服务器里渲染的，然后直接在浏览器显示。在搜索这个场景里，任意时间段里，ABAP 后台只会生成默认 20 条搜索结果的 html 源代码。

例如我点了搜索按钮之后，只有第 1 条道第 20 条记录的 html 源代码在后台生成，然后返回给浏览器由其渲染。当了我点了第二页的超链接"2"时，第 21 条到第 40 条的源代码相应在后台生成。

下面是一些技术细节。

1. 可以使用事务码 ST05 找到 S4CRM 的 Service Request 搜索查询的 CDS view 的名称 CRMS4_SERVHSRCH

第 201 条记录被丢弃：

在视图 ICCMP_INBOX/INBOXRESULTVIEW.HTM 里设置断点, 在调试器里检查变量"me"：

通过这个路径能找到存储在内存中的 200 条搜索结果：

{O:5768*\CLASS-POOL=CL_BSP_WD_COLLECTION_WRAPPER\CLASS=LCL_COLLECTION_REF}-IF_BSP_WD_COLLECTION_REF~COLLECTION

2. 当我点第二页的超链接后：

后台生成好的针对从第 21 行到第 40 行记录的 html 源代码可以在 Chrome 开发者工具中观察到，如下图所示：

那么后台如何得知应该从第 21 行开始准备其 html 源代码呢？这个索引信息是从前台传到后台的，通过 http 请求头部的字段：ItemTree_visibleFirstRow.

如果您搞不清楚类似下图这种前缀 C36_W138_V139_的生成逻辑，请参考我的博客 WebClient UI element ID generation logic

在方法 CL_THTMLB_CELLERATOR~GET_REQUEST_PARAMETERS 设置断点，找到后台是在何处解析该前台请求传入的 visibleFirstRow:

在 BSP 渲染类 CL_THTMLB_CELLERATOR 里，这个变量 gv_visible_first_row 被用于渲染的起始索引：lv_current_row_index:

每一行的每一个单元的源代码在循环里依次生成好。循环基于表的列定义，当前我系统里默认的配置，搜索结果有 8 列：

出于调试目的，您可以在变量 GT_TABLE_ENTRIES 里查看生成好的用于当前页面显示的 html 源代码:

比如对于第二页，索引从 21 开始：

以 40 结束：

为什么变量 gt_table_entries 有 168 条记录？

每页默认显示 20 条记录，加上 1 行表头，每条记录 8 列，所以最后是( 20 + 1 ) * 8 = 168

要获取更多 Jerry 的原创技术文章，请关注公众号"汪子熙":