SAP LSMW批量导入全流程指南：录屏、字段映射与会话处理

简介这是一份面向SAP实施顾问与后勤数据迁移用户的LSMW批量导入操作手册全面讲解如何利用LSMW工具将外部系统数据导入SAP。压缩包仅3.54MB包含1个PDF文档适合在项目现场随时查阅目前已有752人学习下载。手册按实操流程拆解14个关键步骤从设置项目名称、定义对象属性与创建录屏到定义源结构、字段映射与转换关系再到指定导入文件、读取/转换数据并创建批处理会话形成完整可落地的导入链路。同时补充了录屏后不点Default All可能导致失败的细节提醒、自动映射时的接受操作技巧、Excel数据整理时对逗号/空格/制表符的避坑说明以及分隔符选错引发转换报错的处理思路能帮助初学者快速上手也能为有经验者提供标准化操作参照。1. LSMW批量导入是什么先看完这几个场景再决定要不要碰它第一次碰 SAP LSMW 批量导入的人通常栽在同一件事上录屏录得飞快结果跑完一万条只成功一半。LSMW 是 SAP Legacy System Migration Workbench 的缩写ECC 和 S/4 里都自带不需要额外许可。它解决的是把 Excel、CSV、SAP 旧表里的数据按标准事务代码的屏幕顺序回填进去适合物料、客户、供应商、总账凭证、成本中心这类结构化主数据和业务数据。这篇笔记按一张总账凭证从模板到落库的全过程把 LS M W 批导的路走一遍重点回答四个问题录屏前要做什么、项目怎么建、会话怎么跑、坑在哪。适合负责数据迁移的财务顾问、MM 顾问和运维工程师看也适合刚接手批导任务的 ABAP 新人顺着步骤走一遍。2. 做LSMW批量导入前的三板斧录屏路径选择、数据模板清洗与SHDB录制参数2.1 选录屏还是选BAPILSMW批导的两种路径怎么挑LSMW 本身只是一套框架真正干活的是底层的数据传输机制。创建对象的时候系统会让你选对象类型常见两类一类是录屏回放Batch Input Recording也就是常说的 BDC另一类是 BAPI 调用。选哪个直接决定了后面录屏和映射的工作量。我的判断标准很简单先查这个事务代码有没有公开 BAPI。比如物料主数据有 BAPI_MATERIAL_SAVEDATA成本中心有 BAPI_COSTCENTER_CREATEMULTIPLE银行主数据有 BAPI_BANK_CREATE这些能直接当 LSMW 对象类型选的就别走录屏。BAPI 路径的字段语义清楚报错信息也比录屏友好字段映射时直接对着 BAPI 参数填就行。反过来FICO 里的一堆转账、清账、凭证过账事务很多没有像样的 BAPI或者 BAPI 的字段覆盖不全。这时录屏回放反而是更可靠的路子。录屏回放的本质是把用户在 SAP GUI 上的操作记录下来生成一串包含程序名、屏幕号、字段名、字段值和 OK_CODE 的指令序列LSMW 在后台按这段序列把数据填进标准屏幕。它不要求你会 ABAP唯一的要求是屏幕字段和源数据字段能对上。一个容易踩的误区是很多人以为录屏比 BAPI 差。实际上对于凭证类批量导入录屏能完整覆盖界面上的所有字段包括 BAPI 没暴露的字段比如某些行项目增强字段、状态字段。SAP BDC 组件在 ECC 到 S/4 一路都能跑我这些年交付的批导项目里至少一半走的是录屏路径。决策顺序是有 BAPI 且字段够用 → 用 BAPI没有 BAPI 或字段不全 → 用录屏两者都拿不准 → 录屏兜底因为录屏的排查链路更直观。2.2 用SHDB录事务代码录屏的动作规范和五个必盯的录制细节录屏工具不是 LSMW 里的而是事务代码 SHDB。全称 Batch Input Recorder打开后界面很简单新建录制、输入名字、输入事务代码然后你就像正常操作一样把界面走一遍最后保存退出这段操作就存下来了。先说命名规范。录制名建议按“Z_用途_流水号”来例如 Z_FB50_001别用中文名也别起 TEST1 这样的名字。批导项目一旦多了录制文件就是你的资产命名随意后面根本找不到对应关系。录完第一版后在 SHDB 里双击录制名可以回放、查看、删除也可以导出/导入录制文件这个功能后面排错和迁移系统时特别有用。录屏过程的动作规范是我每次培训新人必强调的部分字段之间用 Tab 切换不要用鼠标点选。鼠标点选虽然也能录进去但会让光标定位和字段顺序不可控。尽量少按 Enter。Enter 在 BDC 里对应 OK_CODE 为 /00的动作它会触发校验、弹窗、屏幕切换。录制时每按一次 Enter就要在源字段映射阶段给这个动作准备数据或规则否则回放时会卡在中间屏幕。每个可输入字段都要录一遍哪怕源数据里没有这个字段。比如 FB50 的“参考”字段、行项目里的“文本”你在录制时先填个占位值进去后面用常量或映射规则填充这样回放时才不会漏字段导致屏幕布局漂移。保存动作要明确。FB50 这类凭证事务代码保存的 OK_CODE 是 /11。录制时最后一步一定是从“保存”按钮退出不要用 Exit 或 Cancel否则回放会生成未保存的凭证。录完不要急着关先在 SHDB 里点“测试”或模拟回放一遍确认这条录制能静静走完整个屏幕流。SHDB 录制文件实际是一串 BDC 指令底层长这样* SHDB 录制生成的 BDC 数据块查看方式SHDB → 双击录制名 → 双击某行 * PROGRAM当前所在程序名 * DYNPRO当前屏幕号 * BDC_OKCODE本次动作的功能码/00 是回车/11 是保存 * BDC_CURSOR光标所在字段 PROGRAM SAPMF05A DYNPRO 0100 FIELDS: BDC_OKCODE MODA BDC_CURSOR BKPF-BKTXT BKPF-BUKRS 1000 BKPF-BUDAT 20250617 BKPF-BLART SA BKPF-BKTXT 批量导入测试这段结构里最关键的是 BDC_OKCODE 和 BDC_CURSOR。OKCODE 决定当前屏幕执行什么动作是回车还是保存还是 F4 帮助录屏回放几乎所有异常都出在 OKCODE 上。CURSOR 决定光标落在哪个字段不填多数情况下不影响但如果屏幕有动态字段显示光标位置错会导致界面重排。后面的字段列表按屏幕顺序排列顺序错了数据就会填到别的框里。回放时如果报“字段不存在”或“屏幕布局异常”第一个怀疑对象就是录制时按了多余的回车导致多出来一段屏幕跳转指令。2.3 数据模板与电子表格格式洗好源数据再进LSMW录屏录好了接下来是数据侧的准备。LSMW 支持的数据来源很多前台文件、服务器文件、SAP 表、数据库表都有但项目里最常用的是 Excel 文件。LSMW 的一个坑在这里埋着它读 Excel 依赖的是 ODBC 驱动和系统中配置的电子表格格式不是直接读 .xlsx 文件那么简单。版本匹配不上、驱动缺失后面读数据时会报一些看不明白的错误。我在实践里的做法是项目根目录放一份模板 Excel第一行是字段名以下每一行为一条数据对于表头表项结构的对象再准备一个带批次的平铺结构。比如 FB50 凭证抬头信息在每一行重复出现行项目字段跟在后面行数不足的补空。这样一份模板老用户看着也直观不用管 LSMW 内部结构。公司代码凭证日期过账日期凭证类型抬头文本行项目文本科目金额记账码10002025061720250617SA广告费6月广告费6000105600.004010002025061720250617SA广告费应付客户A2000105600.0050模板里有一个细节金额和日期列必须设成文本格式或者统一成不含千分位的数字。Excel 一旦把日期转成“2025/6/17”、把金额显示成“5,600.00”LSMW 读到的是日期序列号和带千分位的字符串转换阶段要么报错要么落库时金额翻一倍。我一般直接在 Excel 单元格格式里锁定文本数据录入时强制不带千分位。源数据在进入 LSMW 之前还要过一遍清洗科目号和客户号是否有前导零文本字段是否有多余空格凭证日期和过账日期跨月时过账期间是否正确。这些在 Excel 里用一两列公式先算好不要指望 LSMW 的转换规则覆盖所有脏数据。LSMW 的转换规则处理固定值、去零、拼接没问题但清洗逻辑复杂时规则树会变得难以维护不如源头先洗干净。3. 从零建LSMW项目源字段定义、结构对应与转换规则的完整四步3.1 建项目和对象把录屏挂进LSMW的主体流程进入事务代码 LSMW第一屏会看到一个项目树。项目下面的层级是项目 → 子项目 → 对象。这个层级不是摆设建议按模块和业务场景分比如项目叫 ZDATA_MIG子项目按模块分 MM、FI、SD对象按具体的导入场景命名比如 FI_GL_POST、FI_AP_INVOICE。建完对象双击进去会看到执行流程树这就是接下来要一步步走完的任务清单。流程按顺序执行缺一步后面的菜单就灰着。我按常用顺序整理如下步骤作用对应准备工作维护对象属性指定对象类型、文件类型确定录屏还是 BAPI维护源结构定义数据层级决定表头表项维护源字段定义每个字段对应 Excel 列维护结构关系关联源结构平铺数据可跳过维护字段映射屏幕字段和源字段对应录屏回放的核心维护固定值/转换规则补充常量、格式转换前导零、固定记账码读取数据从 Excel/SAP 表加载数据文件就位显示读取数据检查读入内容排查列错位转换数据把源数据转为 BDC 指令此处报错最多创建批导会话生成批导队列按批次拆分处理批导会话前台/后台执行落入 SAP 系统前面 1-6 步是配置7-9 步是试跑10-11 步是正式执行。这套流程第一次做的人容易犯的错是配置完直接进第 9 步转换报错后不知道回头查哪其实查数据在 8、9 两步的显示界面上就能定位。3.2 定义源结构和源字段表头表项怎么设三个好用的转换规则源结构描述的是数据在 LSMW 里按什么层级组织。凭证类数据一般设两个源结构抬头HEADER和行项目ITEM二者的关系是 1:N。如果数据只有一层比如物料主数据的基本视图就设一个源结构运行级别选“1”表示单层。这一步的界面长这样* 源结构定义界面 * 源结构抬头表结构 源结构 : ZFI_HEADER 描述 : 凭证抬头 运行级别 : 1 * 源结构行项目表结构挂在抬头下面 源结构 : ZFI_ITEM 描述 : 凭证行项目 运行级别 : 2这里的运行级别很关键。1 级是抬头层2 级挂在 1 级下面表示每个抬头下面有多条行项目。源数据读取时LSMW 按这个层级关系来回填 BDC 指令抬头字段只在第一条行项目里带一次行项目字段反复循环。如果平铺结构只设一个源结构那抬头字段和行项目字段就在同一层转换时每行都会重复填一次抬头字段屏幕回放会多出大量冗余赋值不影响结果但性能差、日志长。源字段就是 Excel 列名的映射。把 Excel 每一列和源结构里的字段名一一注册进去字段类型选字符CHAR最多日期字段选 DATS数额字段选 CURR。设置错了类型读取数据阶段不会直接报错但转换时会出现一堆“数值格式无效”。这一步我最常被问的是Excel 里的表头要不要和这里完全一致。答案是完全一致字段名不要带括号、空格、单位一律英文字母加下划线。转换规则里有三个高频用的规则我在字段映射前先把它们设好规则写法用途固定常量CONSTANT把某个屏幕字段固定填一个值比如凭证类型 SA直接赋值 源字段默认映射源字段直接填到屏幕字段前导零规则里设 X科目、客户、供应商号缺零时补足前导零那条最容易漏。Excel 里科目号写 600010但 SAP 标准科目表里存的是 0000600010如果映射规则里不补零回放时屏幕会报“科目 600010 不存在”。补零不是 LSMW 界面里一个勾选按钮而是在转换规则里对目标字段设置一个带前导零规则的转换熟练的人一眼就知道哪里补。3.3 字段映射屏幕字段和源字段一一对应别漏记账码和金额字段映射是 LSMW 配置里最直观也最考验耐心的一步。界面左边是源结构树和源字段列表右边是录屏里出现的程序名、屏幕号和字段列表。你要做的就是把右侧屏幕字段和左侧源字段拉到对应关系里拉完之后这一步还能补固定值。以 FB50 为例右侧屏幕字段一堆我每次都先勾这几个防止漏BKPF-BUKRS 公司代码BKPF-BUDAT 凭证日期BKPF-BLART 凭证类型BKPF-BKTXT 抬头文本BSEG-HKONT 科目BSEG-WRBTR 金额BSEG-BSCHL 记账码BSEG-SGTXT 行项目文本这里最容易翻车的是“记账码”和“金额”这两个字段。很多人录屏时录到了但映射时只顾着填科目和金额记账码漏了。回放时屏幕默认带出来的记账码是 40如果源数据里全是 40 开头还好一旦混了 50贷方、31客户发票这种后半批数据全部过不了行项目校验。所以记账码不要用默认值要么映射源字段要么用固定值拆分两种凭证类型分别建对象。金额的正负号也要在映射阶段处理。很多业务数据里借方正数贷方负数但 FB50 屏幕只认记账码不认正负号负号传输进去会报“金额必须大于零”或者反过来把金额折半。我的建议是源数据里金额全部存正数正负通过记账码区分模板生成时就处理掉不要在 LSMW 转换规则里做乘负一的操作。映射完成后一定要点一次界面上的“检查”按钮。LSMW 会提示哪些必需字段没有被映射。这一步拦截的问题比后面转换阶段报的错容易理解得多。但注意检查通过不代表万事大吉它只检查映射关系存在性不检查值是否合法值层面的问题只能在转换和试跑里暴露。3.4 源数据清洗脚本把Excel模板拆成LSMW能吃的表头和表项前面说了模板是平铺的但 LSMW 源结构是分层的需要把平铺数据拆成抬头表和行项目表。这一步我用 Python 脚本做干净可重复。脚本放在项目模板同目录下每次拿到新月份数据跑一遍即可。import pandas as pd # 读取模板抬头列和行项目列都在同一个 sheet 里 raw pd.read_excel(FB50_模板.xlsx, dtypestr) # 抬头字段取前 6 列去掉行项目相关列 header_cols [BUKRS, BUDAT, BLART, BKTXT] header raw[header_cols].drop_duplicates().reset_index(dropTrue) header.insert(0, 批次, range(1, len(header) 1)) # 行项目字段每条抬头对应一行或多行 item_cols [BUKRS, BUDAT, BKTXT, SGTXT, HKONT, WRBTR, BSCHL] item raw[item_cols].copy() item.insert(0, 批次, 0) # 行项目按抬头字段合并批次号 merge_keys [BUKRS, BUDAT, BKTXT] batch_map header.reset_index().set_index(merge_keys)[批次] item[批次] item.set_index(merge_keys).index.map(batch_map) header.to_csv(FBN_HEADER.csv, indexFalse, encodingutf-8-sig) item.to_csv(FBN_ITEM.csv, indexFalse, encodingutf-8-sig)脚本逻辑是先把抬头去重再给每一条抬头编批次号最后把行项目挂到对应批次下。批次号是 LSMW 分层数据读取的关键抬头表和行项目表靠批次号关联。实际使用时把列名替换成你的模板列名就行字段名要严格等于 LSMW 里源字段定义的名称否则读取阶段对不上。这一段脚本的价值在于模板里数据再乱只要抬头键值组合能唯一定位生成的两个 CSV 就能稳定喂给 LSMW。我见过不少人手工在 Excel 里拆表头表项拆到两三千条就眼花了批次对错位、抬头落到别的凭证上这种低级错误用脚本一次根治。4. 创建并处理批导会话前台调式、后台跑批与日志核对4.1 创建批导会话先跑10条样本再决定要不要全量配置做完了数据也读取转换完了接下来到第 10 步“创建批导会话”。这一步把转换好的数据生成一个批导会话队列后面 SM35 里处理的就是这个队列。在点创建之前我的习惯是先把源数据文件截断成 10 条走完整个读取和转换流程再创建批导会话用前台模式跑一遍。“截断”不是删是新建一个叫 TEST 的源结构对应当前模板的子集或者直接复制 Excel 前 10 行另存一份。10 条数据的批次信息足够覆盖一个抬头挂多个行项目的场景也能验证两条抬头之间的切换逻辑。创建批导会话界面里有个必填参数会话名称。名称里带上日期和用途比如 ZFB50_20250617_V1。这里的版本号 V1 是我的习惯第一次跑 V1有问题改完配置后跑 V2这样 SM35 会话列表里按名称排序永远能找到最新版本出问题也能翻出旧版本对比数据转换结果。会话大小也要关心。LSMW 里一次创建的会话数据量过大处理的时候内存占用高、卡死、中途断掉都是常事。我一般控制在一个会话两三千条以内超过的就拆批。拆批的逻辑在创建前数据源就规划好不要在 SM35 里把一个大会话拆那个过程反而麻烦。4.2 处理批导会话SM35前台/后台的取舍与重跑逻辑创建完会话去事务代码 SM35 就能看到它。SM35 是批导会话处理的总入口界面上有会话名称、创建日期、状态、条目数这些信息。选中会话点“处理”按钮弹出的选项框决定执行方式选项含义适用场景前台处理逐屏回放能看到每一条数据的屏幕状态10 条以内排错后台处理直接跑不弹屏幕数据量大的正式批导仅显示错误只回放有问题的数据大批量第一轮排错后台处理时可以勾选“错误时取消”“错误时继续”“仅处理错误数据”这些分支动作。我的做法是第一轮用“仅显示错误”模式把错误数据挑出来看第二轮把正确数据用后台处理跑掉第三轮针对错误数据修正后单独跑一个会话。这样循环错误数据不会反复占用批导队列。正式后台跑之前一定要确认会话状态是“已创建”而不是“正在处理”。有些新手在 SM35 里重复点处理同一个会话会报会话被锁或者重复过账。LSMW 生成的会话处理完就没了如果处理过程中系统崩了SM35 里会话状态会是“错误”这时需要把会话标记为删除重建而不是硬着头皮再点一次处理。还有一个容易被忽略的点批导会话处理时后台作业是立刻排到 SAP 后台的。如果有多个会话同时跑尤其它们操作的是同一类主数据会出现数据库锁等待。最常见的就是物料主数据批导两个会话同时创建同一个物料号后一个等前一个的表锁等到超时。所以大批量任务要么分批串行跑要么不同会话错开时间跑别一起压在服务器上。4.3 日志核对BDC错误行、事务码和底表的三种验证方式会话跑完日志分两处一处是 SM35 会话列表的日志按钮另一处是 LSMW 流程树第 11 步的执行日志。SM35 里的日志按会话记录执行日志按数据行记录两边都能定位到具体是哪条源数据出了问题。SM35 日志里最常见的报错是“字段值无效”“金额格式不正确”“科目不存在”。双击错误行会展开到具体的 BDC 指令能看到是哪个字段报错。但这里有一个坑SM35 日志显示的是 BDC 指令层面的错不是业务层面的错。比如凭证过账成功但抬头文本被截断、日期被系统自动修正SM35 日志里显示成功实际数据已经变了样。这种业务层面的错SM35 看不出来只能查底表。查底表我用 SE16N 直接翻比看日志直观得多。凭证类数据查 BKPF凭证抬头和 BSEG凭证行项目物料主数据查 MARA基本数据和 MARC工厂视图。SE16N 里按公司代码、过账日期过滤把当天批导产生的凭证导出来跟源文件逐条对核对科目、金额、日期、文本四个关键字段。日志核对这一步是决定批导项目能不能交付的关键。我在项目上的要求是无论 LSMW 日志多干净都必须做底表抽验。抽验比例一般 5%随机抽样日期选月初月末跨过账期间的最容易暴露出会计期间的坑。底表抽验通过批导会话这一步才算真正收口。5. LSMW批导五个高频坑现象、原因与处理办法坑一回放时报“字段 BKPF-WAERS 不存在”现象后台处理会话SM35 日志里大量报错全是指向凭证货币字段。原因录制时你在凭证抬头界面手工输过一次货币但这个字段在屏幕上是可选的后来系统里默认货币已经带出录屏回放时字段被系统隐藏或只读导致回放找不到这个输入框。解决录制时不要手工输入系统自动带出的字段。货币、公司代码、过账期间这类自动带出值录制时直接跳过回放时由系统默认值填充顶多在映射阶段用固定值兜底。坑二前导零导致物料号报错现象MM 物料主数据批导源数据 Excel 里物料号是 1000系统里实际是 000000000000001000回放时屏幕报“物料 1000 不存在”。原因源数据没有补足 18 位前导零BDC 在某层屏幕上做存在性检查直接失败。解决用转换规则对映射字段做前导零补齐。做法是维护转换规则时选“前导零”处理方式让系统自动按字段定义长度补零源文件里保持不带零的原始值规则层统一补全。坑三Excel 日期被自动转成序列号现象读取数据阶段正常转换阶段大量报日期格式错误报错指向 BUDAT 字段。原因Excel 里日期列是真正的日期格式而不是文本LSMW 通过 ODBC 读到时拿到的是 45890 这样的数值序列号。解决模板里日期列从源头锁定文本格式或者数据录入时统一用 YYYYMMDD 格式字符串。已经变成序列号的在 Excel 里用 TEXT 函数转回文本再另存一份不要在 LSMW 里做格式修复那个过程又慢又容易漏。坑四批导会话后台处理说完成了凭证却没生成现象SM35 会话状态显示“已完成”但用 SE16N 查 BKPF 找不到任何新凭证。原因处理会话时勾了“测试运行”或者在 LSMW 对象的录屏里录制时勾选了测试模式。测试运行会在最后一步模拟过账但不写表日志看起来全绿实际一条数据没落库。解决到 SM35 里看会话处理详情的模式列确认是“显示”还是“更新”更新模式才会真正写表。LSMW 录屏录制阶段也要确认最后保存动作是真正的保存事务而不是测试保存。坑五记账码和金额正负不匹配导致行项目一半失败现象一批凭证只有贷方行全部失败借方行全成功。原因源文件里金额带负号表示贷方而屏幕字段把负号当非法字符拒绝。解决模板生成时规范金额永远存正数正负关系由记账码表达40 记借方、50 记贷方。如果源数据是 ERP 导出的余额导出时先做一层正负转换把金额取绝对值并生成对应记账码再进 LSMW 模板。这个规则要写进模板使用说明里不然每个月的财务导数据都会踩一次。6. 让LSMW批导更省事的三个进阶习惯第一个习惯录屏文件也做版本管理。SHDB 录完的录制文件可以导出来存一份。系统刷新、迁移到新环境、S/4 升级录屏文件大多还能用但录过屏的人都知道升级后屏幕布局一旦变回放就卡屏。我现在的做法是每个录制文件导出一份命名带日期和版本的文件放在项目目录升级后先拿旧录制文件回放一次回放正常就用回放异常就基于旧文件重新录一版比从零录快很多。第二个习惯大批量批导用 SM36 排作业不用人工盯。数据量上十万的导入SM35 里挂着会话等它跑完中间出个数据库锁能等半小时。把会话交给 SM36 后台作业频率设成每 15 分钟轮询一次错误自动记录。处理完后系统会自动跑一遍检查把结果发到 SP01 输出列表里。这个习惯在月度大批量导入时特别好用晚上挂上第二天早上看输出报告收结果。第三个习惯验证流程固定成三段式。第一段看日志SM35 错误率降到零以下才算过第二段看底表SE16N 里按当天日期查 BKPF/BSEG 的凭证数和金额合计跟源文件总数对上第三段看业务报表用事务代码跑一遍总账科目余额表或者物料价值串起底账确认数据在业务侧也是通的。这里有一段查凭证的 SQL 可以做参考SELECT BUKRS, BELNR, GJAHR, BLART, BUDAT FROM BKPF WHERE BUKRS 1000 AND BUDAT 20250617 ORDER BY BELNR; SELECT BUKRS, BELNR, GJAHR, POSNR, HKONT, WRBTR, BSCHL FROM BSEG WHERE BUKRS 1000 AND BUDAT 20250617 AND HKONT IN (600010, 200010) ORDER BY BELNR, POSNR;三段式验证每做一次批导出问题的定位时间就从小时级降到分钟级。我个人的习惯是正式批导前一定留好“后悔药”源文件备份、生成的 CSV 备份、批导会话名称带版本号必要时还能靠这些在几小时内重建会话重新跑。这个备份习惯在一次公司迁移项目里救过我源文件被人覆盖了靠模板目录下的历史 CSV 在一小时内重新生成了所有文件。做批导真正值钱的从来不是点击的那一下而是你留下的完整链路记录。希望帮到你。本文还有配套的精品资源点击获取