★ FEATURED ARTICLE 简介SAP GUI 770 最新版客户端面向需要连接SAP系统处理日常业务的Windows用户也适合刚接触SAP的初学者、业务顾问与运维人员可用于系统连接配置、事务代码操作、界面与快捷键调整、多系统会话管理及常见连接问题排查。压缩包共2616个文件约660.27MB包含exe与msi安装程序、dll与ocx运行库、xml与cfg配置模板、pdf与chm帮助文档、txt说明、pak语言资源以及bmp与jpg界面素材等组件层次较完整便于按用途查阅和部署。已有1681人学习下载说明它在实际工作与入门环境中具有一定参考价值。借助包内文档、配置示例和运行组件读者可以进一步了解客户端目录结构、连接参数设置、个性化选项和性能相关配置为高效使用SAP GUI打下基础。1. 装 SAP GUI 770 之前先把“覆盖升级”这个念头排除掉上个月帮一位做报表的开发者收拾一台新笔记本SAP GUI 770 客户端他一共建了三遍第一遍解压到一半报错第二遍装完 SAP Logon 打开是空白第三遍直接盖在 7.60 上原来那串连接列表全没了。SAPGUI770 这个包看着就是个“下一步下一步”的安装程序实际上它对运行库、旧版本残留、配置文件格式都很挑装坏了不是重装就能好注册表里两套前端组件叠着症状往往是“能打开、点不动”排查起来挺玄学。这篇按我平时的顺序写先清点系统和包结构再交互装一遍、静默装一遍接着把连接清单和脚本开关配好最后给一套装完能自证的三层验证。刚接手 SAP 客户端的新人要给几十台机器铺包的老手都能照着走。2. 装前清点SAP GUI 770 的系统要求与安装包里到底有什么2.1 版本与系统要求这张表决定你会不会白装一遍SAP GUI 是典型的“32 位程序跑在 64 位系统上”这一条决定了后面注册表要写 WOW6432Node、运行库要 x86 和 x64 都装。下面这张表是我自己在机器上按实际占用填的官方口径会略有出入但按这个留余量基本不会卡住。项目最低能跑我一般按这个配操作系统Windows 10 64 位Windows 10 21H2 以上 / Windows 11内存4 GB8 GB同时开 Office 就上 16 GB磁盘约 1.5 GB预留 5 GB留给日志和后续补丁运行库.NET Framework 4.8提前离线装好别指望联网下运行库VC 2015-2022 运行库x86 与 x64 两个都要装权限本地管理员域账号要能提权否则装到一半回滚显示1024×7681920×1080缩放保持 100%最容易忽略的是最后一行。高 DPI 缩放下 SAP GUI 的工具栏和状态栏会错位看着像装坏了实际上是显示兼容问题把缩放调回 100% 或者在兼容性里勾“替代高 DPI 缩放行为”就好。2.2 解压后先看这五个位置别急着双击安装程序拿到手的通常是自解压壳双击会先解压再自动拉起安装。我的习惯是先让它解压到一个固定目录然后自己去看结构不要一路点下去。SAPGUI770\ ├─ Setup\ │ ├─ NwSapSetup.exe # 真正干活的安装引擎 │ ├─ NwSapSetupAdmin.exe # 打包工具做静默包用 │ └─ Setup.exe # 引导壳双击它等于调 NwSapSetup ├─ PREREQUISITE\ # VC / .NET 之类的前置运行库 ├─ GUI\Windows\ # 桌面客户端组件本体 └─ GUI\Java\ # 非 Windows 那套用不上可以不管不同补丁层级的目录名会有一点差别认准NwSapSetup.exe就行它是入口。PREREQUISITE目录值得单独记一笔很多人装完点不开 SAP Logon报的都是这里面的运行库没装上而不是主体没装好。GUI\Java那部分除非你确实要连非 Windows 终端否则不用勾勾了只是多占几百兆。解压路径上有一条底线不要带中文、不要带空格、不要放在同步盘或者网络盘里。安装过程中引擎会按路径写注册表和服务项路径里带空格时某些老补丁会截断装完看着成功实际组件是残缺的。我一般就放在C:\SAPGUI770这种短路径下装完再删。2.3 三种装法先选一种单机手装、静默铺机、管理员打包同样是装 770场景不同做法差很多。先想清楚你属于哪一种别拿单机装法去铺几十台机器。场景用什么要不要人守着适合谁单机自用Setup.exe交互安装要一两台机器、想自己挑组件批量铺机NwSapSetup.exe /silent不要域内几十台、组件统一裁剪组件NwSapSetupAdmin.exe打包打包时要装时不要只想给业务装最小集合单机手装最直接但向导里有几处坑不能一路下一步静默装适合写进部署脚本缺点是出了问题要靠日志倒查打包是把“装什么组件”这件事提前定死好处是新机器上跑的包完全一致坏处是包和引擎版本得配套拿旧引擎装新包会直接失败。提示三种方式都建议先在一台“干净机器”上跑通再推广。已经装过旧版客户端的机器上变量太多一次成功不代表每次都成。3. 动手装SAP GUI 770 交互安装与静默安装的完整命令3.1 交互式安装向导里有四处不能一路下一步正式动手前有两件事必须先做停进程和备份配置。SAP Logon 有个特性退出时会把自己内存里的连接列表回写一遍你要是开着它去覆盖配置文件退出那一刻就把你改的东西盖回去了。这个坑后面第 5 章还会提一次。# 装之前先把老配置和注册表留一份翻车了能回滚 $stamp Get-Date -Format yyyyMMdd_HHmm $bak D:\backup\sapgui_$stamp New-Item -ItemType Directory -Force -Path $bak | Out-Null # 用户级连接清单7.70 主要以 XML 这份为准 Copy-Item $env:APPDATA\SAP\Common\SAPUILandscape.xml $bak -ErrorAction SilentlyContinue # 老版本可能还留着 ini一起带走迁移时用得上 Copy-Item $env:APPDATA\SAP\Common\saplogon.ini $bak -ErrorAction SilentlyContinue # 前端注册表项脚本开关、主题、超时设置都在里面 reg export HKCU\Software\SAP\SAPGUI Front $bak\sapgui_front.reg /y这段脚本做了三件事按时间戳建备份目录、把两种格式的连接清单拷进去、导出前端注册表。-ErrorAction SilentlyContinue是给全新机器用的文件不存在时不报错继续走。备份目录别放 C 盘重装系统时最容易一起格式化掉。备份完停进程任务管理器里结束saplogon.exe、sapgui.exe、sapshcut.exe三个托盘里那个 SAP 图标也要右键退出。然后才是双击SAPGUI770_*.EXE解压。向导里这四处要停下来想一想第一处是安装类型。默认推荐“典型”但典型会把 Business Client 和一堆扩展组件一起塞进来体积大不说还可能抢走已有客户端的默认打开方式。选“自定义”。第二处是安装路径。保持默认的C:\Program Files (x86)\SAP\就行别改成 D 盘某个中文目录。SAP GUI 主体是 32 位程序装到Program Files (x86)是正常的看到这个不要以为是装错了。第三处是组件树。桌面客户端那部分必选Business Client 按需业务只用经典界面就别装SAP GUI for Java 不用脚本和打印相关的子组件要留着——很多人为了省空间把它们去掉后面做自动化时又得重装一遍白折腾。第四处是最后的重启。别跳过。安装器会把一些注册表写入和文件注册推迟到重启后执行不重启直接点 SAP Logon有一定概率提示找不到组件。3.2 静默安装一条 NwSapSetup 命令覆盖整批机器批量场景下没人会一台台点向导。静默安装的核心就一个可执行文件加几个参数但参数用错会静默失败比交互装更难查。:: 静默安装必须用管理员身份的 cmd 运行普通 PowerShell 窗口有时会被 UAC 拦掉 :: 1) 装默认组件集不写 /package引擎按内置默认清单装 C:\SAPGUI770\Setup\NwSapSetup.exe /silent :: 2) 装裁剪过的包/package 指向 NwSapSetupAdmin 生成的目录 C:\SAPGUI770\Setup\NwSapSetup.exe /packageD:\SAPDeploy\Z_STD /silent :: 3) 修复安装缺文件、升级覆盖后异常先试这个再考虑重装 C:\SAPGUI770\Setup\NwSapSetup.exe /reinstall /silent :: 4) 干净卸载换版本前先跑跑完还要手工清残留目录 C:\SAPGUI770\Setup\NwSapSetup.exe /uninstall /silent四个参数各管一件事/silent是所有静默场景的前提没有它就会弹向导/package指定组件清单路径指向打包工具生成的目录写错路径时引擎会退回默认组件集不报错这是最容易误判的地方/reinstall是我用得最多的一个客户端升级后偶发的“点菜单没反应”八成是组件文件版本对不上跑一遍修复比卸载重装快得多/uninstall负责卸载主体但它清不干净配置目录卸载完还得手工删。运行库我一般单独补一遍不指望引擎自动带:: SAP GUI 主体是 32 位x86 这份是关键漏了会报缺 mfc140u.dll C:\SAPGUI770\PREREQUISITE\vc_redist.x86.exe /install /quiet /norestart :: 64 位这份给 Business Client 和其他 64 位组件用 C:\SAPGUI770\PREREQUISITE\vc_redist.x64.exe /install /quiet /norestart/quiet无界面/norestart抑制重启因为你可能还要接着装别的东西重启留到最后统一做。为什么引擎自己会装还要手动补一遍因为机器上已存在更高版本的运行库时安装器会跳过这一项而跳过之后组件仍然可能找不到对应的 DLL——这属于典型的血泪经验遇到过一次就会每次都手动补。装完看退出码。%ERRORLEVEL%为 0 表示成功3010 表示成功但需要重启其他值都是失败。静默安装的日志一般落在%ProgramData%\SAP\SapSetup\Log下面不同补丁层级目录名会有点差别找不到就直接在C:\ProgramData\SAP里翻最近修改的文本文件。3.3 用 NwSapSetupAdmin 打一个只含必需组件的包如果你要给一批只用经典界面的业务装机最好的做法是打一个最小包而不是每次都去向导里手点组件。流程是这样的在一台已经装好完整客户端的机器上打开NwSapSetupAdmin.exe选创建安装包在组件树里只勾需要的部分桌面客户端、脚本支撑、打印相关指定一个输出目录等它生成完目录里会同时有安装引擎和包描述文件整个目录拷到共享盘或者 U 盘就能分发。目标机器上只需要跑NwSapSetup.exe /silent引擎会自动认旁边那个包。这里有一个版本强绑定的坑包是用哪个版本的NwSapSetupAdmin生成的就得用同版本的NwSapSetup.exe去装。拿 7.60 的引擎去跑 7.70 的包表现是静默跑完退出码为 0但组件一个没装上。所以打包目录一定要跟引擎目录放在一起别东拼西凑。4. 配置落地连接清单、SAPUILandscape.xml 与 Scripting 三处开关4.1 连接列表怎么进机器SAPUILandscape.xml 的位置与下发方式装完客户端只是有了个空壳真正让人能用起来的是连接清单。从 7.70 这一代开始客户端基本只认 XML 格式的SAPUILandscape.xml老的那套saplogon.ini已经不建议再依赖迁移时要做的第一件事就是把旧清单导进来再另存。文件典型位置作用SAPUILandscape.xml%APPDATA%\SAP\Common\用户级连接清单日常改的是这份安装目录下的同名文件客户端安装目录内模板首次启动时复制到用户目录saplogon.ini%APPDATA%\SAP\Common\旧格式仅作迁移来源理解这张表的关键是“模板”那一行客户端首次启动时会把安装目录里的清单复制一份到用户目录之后所有改动都作用在用户目录那份上。这也解释了一个常见现象——你在共享盘更新了模板老用户那边毫无变化因为他们的用户目录里早就有一份旧的了。批量下发我一般用登录脚本推# 把统一下发的连接清单推到当前用户的 SAP 配置目录 $src D:\SAPDeploy\SAPUILandscape.xml $dst Join-Path $env:APPDATA SAP\Common # 目录不存在时先建全新机器上是没有这个目录的 New-Item -ItemType Directory -Force -Path $dst | Out-Null # 覆盖前先看 SAP Logon 是否在跑在跑就别动否则它退出时会把你的文件盖回去 if (Get-Process saplogon -ErrorAction SilentlyContinue) { Write-Host SAP Logon 正在运行先退出再下发 } else { Copy-Item $src (Join-Path $dst SAPUILandscape.xml) -Force }Join-Path拼接路径比手写字符串安全-Force允许覆盖已存在文件。中间那个进程判断是这段脚本的核心价值SAP Logon 退出时会回写配置如果它正开着你覆盖文件之后它一退出就把旧的写回去了表现是“脚本明明跑了用户那边没变化”。这种问题排查起来非常费时间加上这三行判断能省掉一整晚。如果只是自己用、连接项就两三个直接在 SAP Logon 里手动加更快加完从菜单里导出一份 XML 存好下次换机器导入就行。4.2 打开 Scripting客户端注册表和服务端参数要一起改要做自动化、要录制脚本、要用外部程序驱动 SAP GUI就必须打开 Scripting。这件事最容易翻车的地方在于它是三层开关少一层都不生效而报错信息只说一句“脚本被禁用”不告诉你是哪一层。:: 第一层当前用户开脚本改完要完全退出 SAP Logon 再开才生效 reg add HKCU\Software\SAP\SAPGUI Front\SAP Frontend Server\Security /v UserScripting /t REG_DWORD /d 1 /f :: 第二层机器级保证新用户第一次登录就带着开关 :: 注意 SAP GUI 是 32 位程序机器级键值要落到 WOW6432Node 下面 reg add HKLM\SOFTWARE\WOW6432Node\SAP\SAPGUI Front\SAP Frontend Server\Security /v UserScripting /t REG_DWORD /d 1 /f/v指定值名/t REG_DWORD指定类型/d 1是开/f表示已存在就覆盖不询问。HKCU 那条作用于当前登录用户权限要求低改完立刻可用HKLM 那条影响所有用户需要管理员权限而且因为程序是 32 位的路径必须走WOW6432Node写成 64 位路径看着成功实际读不到。第三层在界面里打开 SAP Logon进选项找辅助功能与脚本那一栏勾上启用脚本顺便把“脚本附加时通知”和“脚本打开连接时通知”两个勾也打上。这两个通知不是多余自动化跑起来时满屏窗口自己动没有提示你会怀疑机器中了招。第四层在服务端这个得找 BASIS 配合用事务码RZ11查参数sapgui/user_scripting值要是TRUE。改完是动态生效的但已经建立的连接需要重新登录一次才读到新值。要持久化就写进RZ10的实例参数里否则下次重启又变回去了。四层都通了之后SAP Logon 里那个原本灰着的脚本录制按钮才会亮。我的经验是先只改客户端三层让用户重连一次试试不行再去动服务端——服务端参数是全系统共享的为了一个人调试去改它影响面太大。4.3 用 sapshcut 做参数化快捷方式但别把密码写进去业务同事最烦的是每次都要在登录界面里挑系统、输客户端号。用sapshcut.exe生成一个带参数的快捷方式双击直接到登录框省两步操作。:: 生成一个固定系统 客户端 语言的快捷方式 :: -maxgui 表示登录后直接最大化窗口省得每次手动拉 C:\Program Files (x86)\SAP\FrontEnd\SAPgui\sapshcut.exe ^ -systemDEV -client100 -languageZH -titleDEV 100 -maxgui-system对应连接项的 SID-client是客户端号-language控制界面语言-title是窗口标题方便同时开多个系统时区分。这些参数都能从 SAP Logon 的连接属性里找到对应值不用背。有一条必须说清楚sapshcut支持直接带用户名密码参数但千万别用。密码会明文留在快捷方式的命令行里任何人右键看属性都能读到。要免输入就走单点登录别在快捷方式上打主意。这个参数我见过有人在共享桌面目录里用过一次后来那台机器上所有账号都改了一遍密码。5. 避坑与排查SAP GUI 770 装完不能用的五个典型现场5.1 安装阶段解压失败、装到一半回滚现象一自解压到百分之八九十报错退出或者双击完全没反应。原因通常是路径问题或杀软拦截解压目标带中文、带空格、落在网络盘或 U 盘上或者包里某个 DLL 被实时防护隔离了。解决方式很固定——先把包拷到本地C:\SAPGUI770这种短路径装之前临时关掉实时扫描或把目录加进白名单装完再打开。如果还是失败比对一下包大小传输中断导致的半截包也是常见原因。现象二安装进度走到一半回滚日志里是一个 1603 错误。1603 是个万能错误码但在这个场景里八成是两件事旧版本进程没退干净或者当前账号权限不足。解决顺序是先开任务管理器把saplogon.exe、sapgui.exe、sapshcut.exe全部结束托盘图标也退掉然后用管理员身份的 cmd 重新跑一遍。仍然失败就去看C:\ProgramData\SAP下最新那份日志里面会明确写是哪一步失败的。现象三从 7.60 覆盖安装到 770 之后SAP Logon 打开一片空白连接列表也没了。原因有两个叠加一是两代前端组件同时留在注册表里读配置时打架二是旧格式的连接清单没有被自动迁移到新格式。解决办法是先跑/uninstall /silent干净卸载卸载完手工删掉安装目录残留和HKCU\Software\SAP下对应的项删之前一定先导出备份再全新安装最后用备份的旧清单在 SAP Logon 里导入一次。这一类问题基本没有“修一修就好”的路径卸载重装比反复尝试省时间。5.2 运行阶段点不开、脚本不动现象四装完双击 SAP Logon 没反应或者弹窗提示缺少mfc140u.dll、api-ms-win-crt-*.dll。原因是 VC 运行库缺失而且多半是缺 x86 那一份——很多人看到系统是 64 位就只装了 x64忘了客户端主体是 32 位程序。解决方式是回到PREREQUISITE目录把 x86 和 x64 两份都静默装一遍装完重启。如果两台机器一台能跑一台不能第一件事就是对比运行库列表别去怀疑安装包。现象五能正常登录但脚本录制按钮是灰的或者外部程序一调就报脚本未启用。原因就是 4.2 节那几层开关漏了某一层最常见的是只改了注册表没在界面里勾选或者界面勾了但服务端参数还是FALSE。排查顺序建议反过来先看服务端参数sapgui/user_scripting是不是TRUE这个可以找 BASIS 一句话确认再看客户端注册表 HKCU 下的UserScripting是不是 1最后看界面里的勾选项。改完注册表必须完全退出 SAP Logon 再启动只关窗口不算退出托盘里的图标还在跑这一点坑过很多人。6. 装完怎么验证三层自检从能打开到能跑脚本交付之前我一定会跑一遍三层验证缺一层都不算装完。第一层看文件和开关第二层看能不能真登进去第三层看脚本通道通不通。# 装完先跑这一遍三项都有输出再往下走 $exe C:\Program Files (x86)\SAP\FrontEnd\SAPgui\saplogon.exe # 1) 文件版本能读到带有 770 字样的构建号说明主体装上了 (Get-Item $exe).VersionInfo.FileVersion # 2) 脚本开关HKCU 下这个值必须是 1读不到就是没写进去 (Get-ItemProperty HKCU:\Software\SAP\SAPGUI Front\SAP Frontend Server\Security -Name UserScripting).UserScripting # 3) 运行库列表里能看到 x86 和 x64 两条 VC 条目才算齐 Get-ItemProperty HKLM:\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\* | Where-Object DisplayName -like *Visual C*Redistributable* | Select-Object DisplayName, DisplayVersion三段分别对应主体、开关、运行库。第一段读不到版本号说明路径不对或者根本没装上第二段返回空说明注册表那一步漏了第三段只列出一条说明只装了 64 位那份得回补 x86。第二层验证靠眼睛双击 SAP Logon连一个系统登录成功后看窗口底部状态栏。状态栏会依次显示系统标识、客户端号、用户名和当前事务码四个都对上说明连接、权限、语言都没问题。接着随便跑一个只读事务看看界面渲染是否正常——工具栏错位、中文字体发虚多半是高 DPI 缩放没调回 100%。第三层验证靠一次实际动作在 SAP Logon 选项里确认两个脚本通知都勾上了然后让外部程序或者录制工具触发一次动作。如果弹出“某程序想要附加到会话”的提示说明通道是通的如果毫无反应、录制按钮仍然是灰的回到 4.2 节把四层开关重新对一遍。层级检查手段通过标准文件与开关上面那段自检脚本三项都有值、版本含 770、注册表值 1登录与显示连一个系统看状态栏系统、客户端、用户、事务码四项齐全脚本通道触发一次脚本附加弹出附加提示录制按钮可用从那以后我每装完一台 SAP GUI 770都会把这三层走一遍再交出去从来不靠“点开能启动”就判定成功——启动只是第一层里的一小半。装客户端这事没什么技术含量值钱的全是这些顺序和确认动作。这份 SAP GUI 770 客户端和配套的文档资料你要是正卡在装不上或者装完点不开的阶段按第 2 章到第 4 章的顺序重来一遍比在机器上瞎试一晚上省事。希望帮到你。本文还有配套的精品资源点击获取
阅读完成 · 觉得有帮助？
