VA02场景下更新VBAP append structure自定义字段时新增行项目存值为空问题排查

这是SAP销售订单保存链路的标准增强执行机制导致的异常，不存在遗漏的后台配置问题，核心原因是出口的执行时机和系统快照、字段追踪逻辑不匹配。

具体机制拆解 #

• USEREXIT_SAVE_DOCUMENT的触发点位于销售订单保存流程的最后阶段，但系统在触发该出口前后的逻辑存在明确的边界：
  • 针对已存在的旧行项目：系统生成UPDATE语句时，会在SAVE_DOCUMENT出口执行完成后，重新读取当前XVBAP内表的行值，且已经将VBAP的所有自定义字段纳入旧行的更新字段清单。因此你在出口中给旧行自定义字段赋的值会被完整读取，能够正常写入数据库。
  • 针对新增的行项目：系统在触发SAVE_DOCUMENT出口之前，就已经完成了两个关键动作：一是把新增行的当前内表值拷贝为INSERT语句的快照，二是基于USEREXIT_MOVE_FIELD_TO_VBAP的触发记录，确定新增行INSERT语句的字段清单——只有在USEREXIT_MOVE_FIELD_TO_VBAP阶段被处理过的自定义字段，才会被纳入INSERT的字段范围。
    这就导致两个必然的结果：你在SAVE_DOCUMENT出口中临时修改XVBAP里新增行的自定义字段时，已经被拷贝走的INSERT快照不会同步这些修改；且如果没有在USEREXIT_MOVE_FIELD_TO_VBAP阶段给自定义字段赋值，系统根本不会把这些字段纳入新增行的INSERT字段清单，最终生成的INSERT语句里自定义字段始终为空。

适配的修正方案 #

• 不需要更换整个增强的技术实现路径，只需要根据不同行的场景调整赋值逻辑的触发出口即可：
  • 针对新增行项目的赋值逻辑：把自定义字段的计算、赋值代码从USEREXIT_SAVE_DOCUMENT挪到USEREXIT_MOVE_FIELD_TO_VBAP出口。这个出口的触发时机是每次VBAP的屏幕交互值同步到内存内表的瞬间（包括新增行从屏幕读取值到内表、通过BAPI接口新增行的过程），在这里给自定义字段赋值，会被系统同步纳入INSERT的字段清单和快照里，不会出现丢值。
  • 针对已存在行项目的赋值逻辑：可以保留在USEREXIT_SAVE_DOCUMENT中，因为旧行的UPDATE语句会在出口执行完成后重新读取XVBAP的实时值，赋值逻辑可以正常生效。
• 不建议为了凑新增行的赋值逻辑，在SAVE_DOCUMENT出口里对新增行做二次修改后再手动刷新建表快照，这种实现会和系统标准的保存流程产生耦合，后续版本升级时容易出现兼容性问题。

内容的提问来源于stack exchange，提问作者Alex K