上个月我们项目组第一次拿到 S/4HANA Public Cloud 开发租户时我下意识先在电脑里找安装包准备装 SAP GUI结果发现这套老思路根本带不动公共云压根不开放传统 GUI 的 RFC 端口管理员丢过来的只是一串浏览器登录链接。也就是说从这一天起过去二十多年在 SE38、SE80 里写 ABAP 的习惯必须整体切换到 Eclipse 里的 ADTABAP Development Tools。这台开发租户就是后续所有定制扩展的主战场不管你是做自定义报表、CDS 视图、RAP 业务对象还是接 CPI、串 Workflow全都得从 ADT 连接开始。这篇文章就把我这次从零连上开发租户的完整过程、原理和踩坑记录整理出来。适合刚拿到公共云开发环境的 ABAP 顾问、准备从传统 ECC 转云端开发的同行以及做 BTP 集成的同学参考。我会把每个关键步骤背后的“为什么”也讲清楚避免你照着文档点完按钮却不知道自己在做什么。1. 为什么公共云开发必须“弃 GUI 投 ADT”1.1 SAP GUI 在公共云里为什么行不通传统 ECC 或 S/4HANA 私有化部署我们早已习惯“SAP GUI 事务码”这套组合。但 S/4HANA Public Cloud 的产品定位是标准化 SaaSSAP 只会开放 HTTPS 协议相关端口你根本摸不到背后的应用服务器。SAP GUI 走的是 DIAG/RFC 协议连接依赖内网直连、负载均衡地址、SAProuter 这些基础设施在云端租户里都是不可用的。就算你强行把 GUI 指向租户地址也会发现连接被直接拒绝这不是配置问题是产品设计上就不允许。我一开始还想着“能不能让管理员开个 RFC 权限”结果发现公共云的权限模型里压根没有传统 SAP 用户的说法。用户来自 BTP Cockpit / IAS 身份提供商认证走 SAML 或 OAuth 2.0登录的是 Fiori Launchpad不是 SAP GUI 登录框。所以从根上看旧路已经堵死。1.2 ADT 到底是什么它在开发链路上扮演什么角色ADT 全称 ABAP Development Tools是 SAP 基于 Eclipse 平台打磨出来的 ABAP 开发环境。它不是另一个“SAP GUI 的替代品”而是一套基于 Eclipse 插件体系的远程开发工具Eclipse 装在你本机代码编辑、语法高亮、重构这些活在本机完成但真正创建 Package、激活对象、运行 ATC 检查、执行语法编译都发生在远端那个 ABAP 系统里。它能连公共云核心原因是通信协议换成了 HTTPS 上的 RESTful 接口。ADT 通过 ABAP 后端暴露的 ADT 服务端点与系统交互比如创建 CDS 视图、读取元数据、上传代码等动作本质都是调 HTTP 接口。对比之下SAP GUI 那种“实时对话式”协议不仅重而且云租户根本不会开放。所以可以简单理解为ADT 是适配云世界的“开发客户端”云租户是“服务端”。我们写的每一行代码最终还是编译、激活、存储在云端的 ABAP 数据库里只是中间交换信息的通道从 RFC 换成了 HTTPS。1.3 开发模式的转变ABAP Cloud连接只是第一步真正要适应的是 ABAP Cloud 这套开发规范。公共云开发租户里你不能一上来就建 Z 表、写传统报表然后再慢慢调优。SAP 强制要求使用公共接口和云兼容语法最典型的三件套是 CDS 视图、RAP 行为定义BDEF、AMDP 数据库存储过程。这三件套在传统 ECC 里也能用但在公共云里成了“必须”。原因也简单SAP 要保证每个客户扩展不会破坏标准功能升级时才不会因自定义代码报错。你写的代码如果是直接基于内部表结构或非发布 APIATC 检查会直接拦截。这个转变对老顾问来说是最难受的但一旦适应反而会发现自己写的代码结构更清晰、耦合更低。2. 连接前我做了哪些准备2.1 账号和角色别等连不上才想起找管理员很多同事拿到租户地址后第一件事就是输用户名密码结果发现登录框都出不来。实际上公共云开发租户不是“谁拿到地址谁就能登”需要提前在 SAP BTP Cockpit 里维护用户并分配足够的角色。我这次踩了个典型的坑团队里给的是“开发管理员”业务角色但我在连接时新建 Package 一直报“对象创建权限不足”后来查 Fiori Launchpad 的角色插件才发现需要的是 SAP_BR_DEVELOPER 这类开发角色同时还要有“自定义代码开发”“通信管理”“自定义字段”相关应用的使用权限。由于公共云的权限是通过业务角色勾选出来的不是传 ID 直接分配的所以建用户的时候要特别确认勾了哪些授权的业务目录。另外一个长期教训如果你还要访问“自定义代码迁移”这类工具那至少要有“迁移专家”或“质量管理员”角色。连接 ADT 本身可能只需要基础登录权限但“能连接”和“能开发”之间隔着一整套角色配置。2.2 租户链接与服务端点S/4HANA Public Cloud 开发租户的访问地址一般长这样https://xxxxx.s4hana.ondemand.com可能是生产租户也可能是开发租户。有些团队会有多个租户开发、测试、生产。刚开始很容易搞混建议先在浏览器里登录 Fiori Launchpad看系统标题或 URL 里的租户标识确认自己手上的是不是开发租户。ADT 连接时服务端点默认是/sap/bc/adtEclipse 新建项目时会自动拼上。如果后面手工维护项目一定不要漏掉这个路径。很多“连接失败”其实是把https://host直接填进去了缺少/sap/bc/adt导致请求 404。顺便说一句BTP ABAP EnvironmentSteampunk的连接地址同样用/sap/bc/adt。如果你既连 S/4HANA Cloud 又连 BTP ABAP Environment注意区分项目名称别在同一个 ADT 工作区里建了两个相似项目回头一保存就改错系统。2.3 安装 Eclipse 和 ADT 插件的正确姿势ADT 不是独立安装包而是 Eclipse 插件。第一步先下载 Eclipse。建议从 eclipse.org 下载 “Eclipse IDE for Enterprise Java and Web Developers”这个版本对 Java Web 相关依赖支持比较全也省得后面要装其他插件时互相打架。下载前一定要确认 JDK 版本。Eclipse 对 JDK 版本要求挺挑剔比如 2023-12 版本通常要求 JDK 172024-03 之后可能要求 JDK 21。你可以在命令行里执行java -version确认本机版本。如果本机装了多个 JDK建议在 eclipse.ini 里显式指定-vm参数指向你要用的 JDK 路径。ADT 插件安装非常简单Eclipse 菜单 Help - Install New SoftwareWork with 填https://tools.hana.ondemand.com/latest回车后勾选 “ABAP Development Tools”。安装过程中 Eclipse 会提示重启重启之后在 Window - Perspective - Open Perspective - Other 里能看到 “ABAP” 相关透视图就说明装好了。这里有个细节ADT 版本和 Eclipse 版本有兼容矩阵SAP 官方在 Help Portal 和 wiki 里会列出每个 ADT 版本支持的 Eclipse 版本范围。不要图新装了 2024-12 的 Eclipse 就装最新 ADT万一不在支持矩阵里后面连接时会出现奇奇怪怪的错误。稳妥做法是装官方 release notes 里对应支持的版本组合。2.4 网络体检浏览器能开不代表 ADT 能连连接前最好先做一轮网络检查。用浏览器直接访问租户地址能打开登录页、能进入 Fiori Launchpad说明网络链路基本通。但这里有个容易迷惑的点S/4HANA Public Cloud 的 ADT 连接走 HTTPS 443 端口而有些企业网络会做 TLS 流量检查或代理拦截导致浏览器没问题、ADT 连不上。如果公司有对外代理通常要在 Eclipse 的eclipse.ini或“Window - Preferences - General - Network Connections”里配置 Active Provider并填好 HTTPS 代理。我遇到过一次浏览器能打开任何网页但 ADT 一直报连接超时最后排查发现是 Eclipse 默认使用 “Direct” 连接压根没走代理。证书问题也要提前看。如果浏览器访问租户地址时左下角有锁图标但企业电脑装了自己的根证书而 Eclipse 运行的 JDK 没有信任这份根证书ADT 就会抛SunCertPathBuilderException。这个问题在第 5 部分我会详细讲处理办法。3. 第一次连接开发租户的完整过程3.1 新建 ABAP Project安装完插件、整理好账号后就可以开始建立第一个 ADT 项目。打开 Eclipse菜单 File - New - Other在弹出的搜索框里输入 “ABAP Project”选中后点击 Next。这一步会问你系统信息不同版本界面略有差异但核心字段是一致的系统 URL也叫服务端点。我在这步填的是https://xxxxx.s4hana.ondemand.com注意不要填成 Fiori Launchpad 里某个应用的完整 URL只填租户根地址。ADT 通常会在后台自动拼接/sap/bc/adt如果你不放心可以在 URL 末尾手动加上/sap/bc/adt。填完后点击 Next/FinishEclipse 会尝试初始化项目并弹出登录窗口。第一次连通常需要等大概 10 到 30 秒因为 ADT 要从云端拉取包、DDIC 对象元数据、软件组件版本等一堆信息。如果等了几分钟还没反应多半是网络、证书或账号问题。3.2 登录认证选择SAML 还是用户密码登录窗口是 ADT 连接里最有“分裂感”的一步。老 ABAP 顾问习惯用 User/Password但公共云租户一般默认走 SAML 2.0。我实际推荐用 SAML 单点登录。理由是S/4HANA Public Cloud 的用户体系挂在 IASIdentity Authentication Service上如果直接用密码登录密码策略、MFA、会话时长都由本地 ADT 对话窗管理容易和云端的会话策略冲突用 SAML 则可以让 Eclipse 自动打开浏览器跳转到企业身份提供商完成认证认证完自动回跳到 Eclipse体验很像扫码登录。有一次我因为测试环境开了 MFAADT 自带的密码登录框根本没法输入动态验证码用 SAML 后浏览器弹出 MFA 页面问题直接解决。所以如果你的企业配置了多因素认证记得优先用 SAML 选项。如果弹框里没有 SAML检查一下 ADT 插件版本是否过老或者租户的身份联配是否配置完整。3.3 连接成功后的第一眼项目结构认证通过后Project Explorer 里会出现一个 ABAP Project 缩略节点展开后你能看到 Package、ABAP Objects、CDS Views、Access Control 等目录。这个视角更像是“按 Repository 浏览代码”而不是传统 GUI 的“按事务码找功能”。这时候我建议先做两件事。第一右键项目 - Properties把项目名改成容易辨识的名字比如S4HC_DEV不然下次同时开五个 ABAP Project全是默认名字会让你崩溃。第二确认项目连接状态正常最直观的验证方式是在 Package 节点下能看到标准包列表比如SAPL*、Z*等。如果这个阶段 Package 树是空的或者只显示一个光标转圈多半是用户角色没配好导致 ADT 无法读取包元数据。别急着删项目重建先在 Fiori Launchpad 里确认用户能打开“自定义代码开发”相关应用再回到 ADT 右键项目 - Refresh。3.4 用一个小 CDS 视图验证开发链路连接成功不代表开发链路通。我最推荐的做法是立刻创建一个简单 CDS 视图走通“创建 - 激活 - Data Preview”整条链路。既可以验证权限又能提前发现云语法兼容问题。右键你新建的 Z 包选择 New - Other ABAP Repository Object搜索 “CDS Data Definition”创建名为ZI_TEST_CONN的视图。入门模板可以直接基于公开接口I_Product做一个只读视图AbapCatalog.sqlViewName: ZIS_TEST_CONN EndUserText.label: 连接测试视图 AccessControl.authorizationCheck: #NOT_REQUIRED define view ZI_TEST_CONN as select from I_Product { key Product as ProductId, ProductType as ProductType, ProductGroup as ProductGroup }保存后如果语法正确ADT 会高亮显示“已激活”状态。这里有三个容易忽略的地方第一公共云里不允许直接用MARA、MARC这种底层表名去 SELECT编译器会直接报“表不可访问”因为 ABAP Cloud 只开放公共 CDS 接口。代码里访问底层表是传统 ECC 的习惯在云端必须戒掉。第二AccessControl.authorizationCheck: #NOT_REQUIRED在公共云里能不能随便用能但尽量不要。这只是测试视角的临时做法真实业务视图还是要配好权限控制否则上线前一天你会发现标准数据保护检查直接拦截了你。第三激活后右键 CDS 视图节点选择 Open With - Data Preview。能正常出数据说明 ADT 到云端租户的读链路完全正常。走到这一步你的开发环境算是真正“能用了”。4. 在 ADT 里干活的日常要点4.1 从零搭一个 RAP 业务对象RAPABAP RESTful Application Programming Model是公共云开发的主要业务对象框架。第一次用 ADT 建 RAP 对象时我建议跟这个顺序走先建 CDS 根视图再建行为定义BDEF再生成服务定义和服务绑定。右键 Z 包New - Other ABAP Repository Object搜索 “Business Object”选好后下一步它会让你指定绑定视图。选择刚才建好的ZI_TEST_CONN生成的 BO 会带默认的 BDEF 文件managed implementation in class zbp_i_test_conn unique; strict (2); define behavior for ZI_TEST_CONN alias TestConn { create; update; delete; }这个模板是最典型的“托管实现”写法翻译成人话就是RAP 框架自动帮你处理创建、更新、删除的持久化逻辑你只需要补业务规则和校验不用手动写数据库操作。这正是公共云里“代码更简洁”的核心原因。BDEF 生成后还需要写一个行为实现类。ADT 会在你保存激活时自动生成类的骨架双击类名就能跳转到实现位置。我在测试项目里加了一段简单的校验CLASS zbp_i_test_conn IMPLEMENTATION. METHOD validate_product. LOOP AT products INTO DATA(product). IF product-ProductType SERV. DO NOTHING ENDIF. ENDLOOP. ENDMETHOD. ENDCLASS.实际开发时校验逻辑会更复杂但核心思路一致所有业务操作都收敛在 RAP 里不散落在一堆报表函数里。这也是 ATC 检查希望看到的架构。4.2 运行 ATC 与代码合规检查如果你是从传统 ABAP 转过来的初期最痛苦的就是 ATCABAP Test Cockpit检查。传统 ECC 里 ATC 过不了最多黄灯你能继续激活公共云不一样ATC 错误默认直接视为激活失败你压根没法走到“激活”那一步。实际操作时右键 CDS 视图或 ABAP 类选择 Run As - ABAP Test Cockpit会弹出检查结果。公共云的 ATC 检查项里最关键的是“云兼容性”Cloud Readiness和“性能检查”。比如你不能在 ABAP 里直接访问非发布数据库表不能使用过时的SELECT *之类写法不能使用PERFORM这种老式内联。每个 ATC 错误的注释里都会给出修改建议基本不需要太多脑细胞去猜。我个人的小技巧是每写一个类或一个视图就右键运行 ATC而不是等整个项目写完再统一跑。原因很简单——云端激活失败往往是连环的对象 A 依赖 BB 没过检查A 也会挂反而更难定位。拆分成小步每步只处理一个对象的报错重复几次就会养成肌肉记忆。4.3 公共云里的“传输请求”怎么理解传统 ECC 里我们保存代码后会弹出一个 Transport Request手动维护到某个请求号里。公共云开发租户里这个过程被大幅简化了在 ADT 中直接激活对象即可对象会变成活动版本。但如果你想把这些对象从开发租户搬到测试或生产租户就不像以前那样“释放请求”了。公共云采用的是基于软件组件和“发布策略”的部署方式。开发租户中的代码归属于某个软件组件当你完成验证后通过“自定义代码迁移”或“发布”流程将整个软件组件打包升级到目标租户。这个节奏通常由管理员控制不是开发人员随手点两下就能推上线。所以当你听到老同事问“这套代码挂在哪个请求下”时可以解释一句公共云里没有经典 SE09/SE10 的逻辑你的关注点应该放在“软件组件版本”和“发布管道”上。这听上去复杂但实际上比传统请求管理更省心因为每个对象都自带变更历史且打包发布时一致性由平台保证。4.4 不用 SE16N怎么查 SAP 常用表我看群里不少人问“SAP 常用表”“MD07 界面”“MARA 库存”这类问题。在传统 ECC 里直接 SE16N 查表是日常操作但公共云里没有 SE16N也没有直接的 SQL Console怎么办我的做法比较务实需要临时看数据时直接创建一个只读 CDS 视图挂到数据预览里查看。比如要看产品主数据就建一个ZI_PRODUCT_SNAP视图基于I_Product做简单映射然后右键 Open With - Data Preview。Data Preview 里能筛选、排序还能导出表格足够应付 90% 的临时取数需求。如果你需要做跨模块的汇总比如把 MD07 式的物料需求库存视图、销售订单、采购订单串起来在传统 ECC 里通常是写一个 ALV 报表访问一堆底表在公共云里更合理是把 CDS 视图作为数据源配合 RAP Fiori Elements 做成一个合规的云端报表应用。这个思路也正好回应了“从采购到 PS 到销售的业务流程图怎么做”这类问题别画在 PPT 里用 CDS 把它建模成可查询的语义层再展现在 Fiori Launhpad 上。5. 我踩过的坑问题排查实录5.1 Could not connect多半是服务端点第一次连接失败时错误提示是Could not connect to ...。排查思路相对固定先确认租户 URL 能在浏览器打开排除网络层问题再确认 URL 末尾是否带/sap/bc/adt多数情况下是漏了路径导致 404。还有一个隐藏坑你在浏览器里访问 https 成功但项目里填的是http不带 sADT 会尝试走 80 端口自然失败。我见过有些同事从邮件里复制 URL 时把https丢了Eclipse 自动判定为 http结果折腾半天。检查项目属性里的 URL确保是https://开头。5.2 证书和 JDK 的坑错误信息如果包含unable to find valid certification path那就是 JDK 信任库问题。Eclipse 运行在 JDK 上它启用的 JVM 必须信任目标服务器的 SSL 证书。处理办法不复杂。先用浏览器把租户地址的证书导出成.cer文件然后在命令行找到 Eclipse 使用的 JDK执行keytool -importcert -alias s4hc_dev \ -file /path/to/s4hc.cer \ -keystore /path/to/jdk/lib/security/cacerts \ -storepass changeit注意changeit是 JDK 默认密码如果你本机改过用你自己的密码。执行完重启 Eclipse 大概率就通了。这个坑的根源往往不是 SAP 证书本身而是企业内部根证书没进 Eclipse 的 JVM。5.3 登录失败但浏览器明明能进 Fiori这是公共云连接让人很崩溃的一个问题浏览器能正常打开 Fiori但 ADT 登录时反复提示认证失败。我遇到的情况基本两类。一类是 ADT 版本太老对 IAS 的 SAML 重定向支持不好更新 ADT 插件到 release notes 推荐版本即可解决。第二类是你浏览器里已经登录过一个 IAS 用户而 ADT 里想用另一个用户登录浏览器会优先复用旧会话导致身份不一致。解决办法也很土先用无痕模式或关掉所有已打开的 IAS 会话然后在 ADT 登录窗里重新走 SAML 流程确保弹出的是新的登录界面。如果还不行直接删掉 ADT 项目重建通常能快速解决会话错乱问题。5.4 右键没有 ABAP Cloud 项目选项有些同事装完 ADT 后新建 ABAP Project 时看不到 “ABAP Cloud” 类型以为哪里装错了。其实公共云默认项目就是 ABAP Project所谓 “ABAP Cloud” 更多是指 ABAP Cloud 开发模型而不是独立的连接类型。真正值得检查的是 ADT 插件版本如果版本过老新建项目向导里没有“SAP S/4HANA Cloud”或“ABAP Cloud” 相关的项目标记/能力选项连接后很多云端专属操作比如发布服务、OData 绑定时选择云模型会缺失。解决办法是在 Eclipse 的 Help - Check for Updates 里更新 ADT 到最新版本而不是反复重装 Eclipse。另外如果你在 ADT 里应该看到 “Service Consumption Model” 或 “Communication Management” 相关节点而看不到也基本是插件版本问题不要浪费时间改本地配置。5.5 对象状态灰显或权限不足连接成功后新建 Package、激活对象时如果提示not authorized或对象灰显问题大概率出在角色。S/4HANA Public Cloud 对开发对象是有命名空间和包权限控制的不是登录必能写。我建议按这个顺序排查第一确认租户是否正确开发账号连到的是不是开发租户而不是只读的生产租户第二在 Fiori Launchpad 中查看用户分配的业务角色里有没有SAP_BR_DEVELOPER以及是否有“自定义代码开发”“质量经理”等应用权限第三如果确认角色存在让管理员检查业务目录是否激活因为角色即使分配业务目录没发布也会出现权限计算不到的情况。还有一个小坑创建包时公共云默认只允许客户在 Z 命名空间下创建。如果你手一抖填了YABC*之类的名字部分租户可能不支持直接报命名空间错误。按 SAP 推荐客户扩展统一Z测试代码也放到Z包下后面审计也方便。结尾几句实际操作的体会我个人整个接入过程最大的收获不是学会了点 Eclipse 按钮而是彻底调整了开发心智云端开发不允许我再用“底层表 事务码”的思维去解业务问题必须先找公开 CDS 接口再包 RAP最后发布服务。这个“三步走”框架打通之后ADT 从“不知道怎么连”变成了“日常干活工具”。如果你正准备接入这套环境建议别急着写业务代码先按我上面的顺序把角色、版本、证书、登录方式四项确认好然后建一个空的 CDS 视图走通 Data Preview再试着生成一个最小 RAP 对象。整个过程快的话一个下午就能跑通。跑通之后哪怕后面接 CPI、搭 Workflow 审批也都是在这个基础上按场景叠加功能。
S/4HANA 公共云开发环境接入：SAP GUI 切换到 ADT 的完整指南
上个月我们项目组第一次拿到 S/4HANA Public Cloud 开发租户时我下意识先在电脑里找安装包准备装 SAP GUI结果发现这套老思路根本带不动公共云压根不开放传统 GUI 的 RFC 端口管理员丢过来的只是一串浏览器登录链接。也就是说从这一天起过去二十多年在 SE38、SE80 里写 ABAP 的习惯必须整体切换到 Eclipse 里的 ADTABAP Development Tools。这台开发租户就是后续所有定制扩展的主战场不管你是做自定义报表、CDS 视图、RAP 业务对象还是接 CPI、串 Workflow全都得从 ADT 连接开始。这篇文章就把我这次从零连上开发租户的完整过程、原理和踩坑记录整理出来。适合刚拿到公共云开发环境的 ABAP 顾问、准备从传统 ECC 转云端开发的同行以及做 BTP 集成的同学参考。我会把每个关键步骤背后的“为什么”也讲清楚避免你照着文档点完按钮却不知道自己在做什么。1. 为什么公共云开发必须“弃 GUI 投 ADT”1.1 SAP GUI 在公共云里为什么行不通传统 ECC 或 S/4HANA 私有化部署我们早已习惯“SAP GUI 事务码”这套组合。但 S/4HANA Public Cloud 的产品定位是标准化 SaaSSAP 只会开放 HTTPS 协议相关端口你根本摸不到背后的应用服务器。SAP GUI 走的是 DIAG/RFC 协议连接依赖内网直连、负载均衡地址、SAProuter 这些基础设施在云端租户里都是不可用的。就算你强行把 GUI 指向租户地址也会发现连接被直接拒绝这不是配置问题是产品设计上就不允许。我一开始还想着“能不能让管理员开个 RFC 权限”结果发现公共云的权限模型里压根没有传统 SAP 用户的说法。用户来自 BTP Cockpit / IAS 身份提供商认证走 SAML 或 OAuth 2.0登录的是 Fiori Launchpad不是 SAP GUI 登录框。所以从根上看旧路已经堵死。1.2 ADT 到底是什么它在开发链路上扮演什么角色ADT 全称 ABAP Development Tools是 SAP 基于 Eclipse 平台打磨出来的 ABAP 开发环境。它不是另一个“SAP GUI 的替代品”而是一套基于 Eclipse 插件体系的远程开发工具Eclipse 装在你本机代码编辑、语法高亮、重构这些活在本机完成但真正创建 Package、激活对象、运行 ATC 检查、执行语法编译都发生在远端那个 ABAP 系统里。它能连公共云核心原因是通信协议换成了 HTTPS 上的 RESTful 接口。ADT 通过 ABAP 后端暴露的 ADT 服务端点与系统交互比如创建 CDS 视图、读取元数据、上传代码等动作本质都是调 HTTP 接口。对比之下SAP GUI 那种“实时对话式”协议不仅重而且云租户根本不会开放。所以可以简单理解为ADT 是适配云世界的“开发客户端”云租户是“服务端”。我们写的每一行代码最终还是编译、激活、存储在云端的 ABAP 数据库里只是中间交换信息的通道从 RFC 换成了 HTTPS。1.3 开发模式的转变ABAP Cloud连接只是第一步真正要适应的是 ABAP Cloud 这套开发规范。公共云开发租户里你不能一上来就建 Z 表、写传统报表然后再慢慢调优。SAP 强制要求使用公共接口和云兼容语法最典型的三件套是 CDS 视图、RAP 行为定义BDEF、AMDP 数据库存储过程。这三件套在传统 ECC 里也能用但在公共云里成了“必须”。原因也简单SAP 要保证每个客户扩展不会破坏标准功能升级时才不会因自定义代码报错。你写的代码如果是直接基于内部表结构或非发布 APIATC 检查会直接拦截。这个转变对老顾问来说是最难受的但一旦适应反而会发现自己写的代码结构更清晰、耦合更低。2. 连接前我做了哪些准备2.1 账号和角色别等连不上才想起找管理员很多同事拿到租户地址后第一件事就是输用户名密码结果发现登录框都出不来。实际上公共云开发租户不是“谁拿到地址谁就能登”需要提前在 SAP BTP Cockpit 里维护用户并分配足够的角色。我这次踩了个典型的坑团队里给的是“开发管理员”业务角色但我在连接时新建 Package 一直报“对象创建权限不足”后来查 Fiori Launchpad 的角色插件才发现需要的是 SAP_BR_DEVELOPER 这类开发角色同时还要有“自定义代码开发”“通信管理”“自定义字段”相关应用的使用权限。由于公共云的权限是通过业务角色勾选出来的不是传 ID 直接分配的所以建用户的时候要特别确认勾了哪些授权的业务目录。另外一个长期教训如果你还要访问“自定义代码迁移”这类工具那至少要有“迁移专家”或“质量管理员”角色。连接 ADT 本身可能只需要基础登录权限但“能连接”和“能开发”之间隔着一整套角色配置。2.2 租户链接与服务端点S/4HANA Public Cloud 开发租户的访问地址一般长这样https://xxxxx.s4hana.ondemand.com可能是生产租户也可能是开发租户。有些团队会有多个租户开发、测试、生产。刚开始很容易搞混建议先在浏览器里登录 Fiori Launchpad看系统标题或 URL 里的租户标识确认自己手上的是不是开发租户。ADT 连接时服务端点默认是/sap/bc/adtEclipse 新建项目时会自动拼上。如果后面手工维护项目一定不要漏掉这个路径。很多“连接失败”其实是把https://host直接填进去了缺少/sap/bc/adt导致请求 404。顺便说一句BTP ABAP EnvironmentSteampunk的连接地址同样用/sap/bc/adt。如果你既连 S/4HANA Cloud 又连 BTP ABAP Environment注意区分项目名称别在同一个 ADT 工作区里建了两个相似项目回头一保存就改错系统。2.3 安装 Eclipse 和 ADT 插件的正确姿势ADT 不是独立安装包而是 Eclipse 插件。第一步先下载 Eclipse。建议从 eclipse.org 下载 “Eclipse IDE for Enterprise Java and Web Developers”这个版本对 Java Web 相关依赖支持比较全也省得后面要装其他插件时互相打架。下载前一定要确认 JDK 版本。Eclipse 对 JDK 版本要求挺挑剔比如 2023-12 版本通常要求 JDK 172024-03 之后可能要求 JDK 21。你可以在命令行里执行java -version确认本机版本。如果本机装了多个 JDK建议在 eclipse.ini 里显式指定-vm参数指向你要用的 JDK 路径。ADT 插件安装非常简单Eclipse 菜单 Help - Install New SoftwareWork with 填https://tools.hana.ondemand.com/latest回车后勾选 “ABAP Development Tools”。安装过程中 Eclipse 会提示重启重启之后在 Window - Perspective - Open Perspective - Other 里能看到 “ABAP” 相关透视图就说明装好了。这里有个细节ADT 版本和 Eclipse 版本有兼容矩阵SAP 官方在 Help Portal 和 wiki 里会列出每个 ADT 版本支持的 Eclipse 版本范围。不要图新装了 2024-12 的 Eclipse 就装最新 ADT万一不在支持矩阵里后面连接时会出现奇奇怪怪的错误。稳妥做法是装官方 release notes 里对应支持的版本组合。2.4 网络体检浏览器能开不代表 ADT 能连连接前最好先做一轮网络检查。用浏览器直接访问租户地址能打开登录页、能进入 Fiori Launchpad说明网络链路基本通。但这里有个容易迷惑的点S/4HANA Public Cloud 的 ADT 连接走 HTTPS 443 端口而有些企业网络会做 TLS 流量检查或代理拦截导致浏览器没问题、ADT 连不上。如果公司有对外代理通常要在 Eclipse 的eclipse.ini或“Window - Preferences - General - Network Connections”里配置 Active Provider并填好 HTTPS 代理。我遇到过一次浏览器能打开任何网页但 ADT 一直报连接超时最后排查发现是 Eclipse 默认使用 “Direct” 连接压根没走代理。证书问题也要提前看。如果浏览器访问租户地址时左下角有锁图标但企业电脑装了自己的根证书而 Eclipse 运行的 JDK 没有信任这份根证书ADT 就会抛SunCertPathBuilderException。这个问题在第 5 部分我会详细讲处理办法。3. 第一次连接开发租户的完整过程3.1 新建 ABAP Project安装完插件、整理好账号后就可以开始建立第一个 ADT 项目。打开 Eclipse菜单 File - New - Other在弹出的搜索框里输入 “ABAP Project”选中后点击 Next。这一步会问你系统信息不同版本界面略有差异但核心字段是一致的系统 URL也叫服务端点。我在这步填的是https://xxxxx.s4hana.ondemand.com注意不要填成 Fiori Launchpad 里某个应用的完整 URL只填租户根地址。ADT 通常会在后台自动拼接/sap/bc/adt如果你不放心可以在 URL 末尾手动加上/sap/bc/adt。填完后点击 Next/FinishEclipse 会尝试初始化项目并弹出登录窗口。第一次连通常需要等大概 10 到 30 秒因为 ADT 要从云端拉取包、DDIC 对象元数据、软件组件版本等一堆信息。如果等了几分钟还没反应多半是网络、证书或账号问题。3.2 登录认证选择SAML 还是用户密码登录窗口是 ADT 连接里最有“分裂感”的一步。老 ABAP 顾问习惯用 User/Password但公共云租户一般默认走 SAML 2.0。我实际推荐用 SAML 单点登录。理由是S/4HANA Public Cloud 的用户体系挂在 IASIdentity Authentication Service上如果直接用密码登录密码策略、MFA、会话时长都由本地 ADT 对话窗管理容易和云端的会话策略冲突用 SAML 则可以让 Eclipse 自动打开浏览器跳转到企业身份提供商完成认证认证完自动回跳到 Eclipse体验很像扫码登录。有一次我因为测试环境开了 MFAADT 自带的密码登录框根本没法输入动态验证码用 SAML 后浏览器弹出 MFA 页面问题直接解决。所以如果你的企业配置了多因素认证记得优先用 SAML 选项。如果弹框里没有 SAML检查一下 ADT 插件版本是否过老或者租户的身份联配是否配置完整。3.3 连接成功后的第一眼项目结构认证通过后Project Explorer 里会出现一个 ABAP Project 缩略节点展开后你能看到 Package、ABAP Objects、CDS Views、Access Control 等目录。这个视角更像是“按 Repository 浏览代码”而不是传统 GUI 的“按事务码找功能”。这时候我建议先做两件事。第一右键项目 - Properties把项目名改成容易辨识的名字比如S4HC_DEV不然下次同时开五个 ABAP Project全是默认名字会让你崩溃。第二确认项目连接状态正常最直观的验证方式是在 Package 节点下能看到标准包列表比如SAPL*、Z*等。如果这个阶段 Package 树是空的或者只显示一个光标转圈多半是用户角色没配好导致 ADT 无法读取包元数据。别急着删项目重建先在 Fiori Launchpad 里确认用户能打开“自定义代码开发”相关应用再回到 ADT 右键项目 - Refresh。3.4 用一个小 CDS 视图验证开发链路连接成功不代表开发链路通。我最推荐的做法是立刻创建一个简单 CDS 视图走通“创建 - 激活 - Data Preview”整条链路。既可以验证权限又能提前发现云语法兼容问题。右键你新建的 Z 包选择 New - Other ABAP Repository Object搜索 “CDS Data Definition”创建名为ZI_TEST_CONN的视图。入门模板可以直接基于公开接口I_Product做一个只读视图AbapCatalog.sqlViewName: ZIS_TEST_CONN EndUserText.label: 连接测试视图 AccessControl.authorizationCheck: #NOT_REQUIRED define view ZI_TEST_CONN as select from I_Product { key Product as ProductId, ProductType as ProductType, ProductGroup as ProductGroup }保存后如果语法正确ADT 会高亮显示“已激活”状态。这里有三个容易忽略的地方第一公共云里不允许直接用MARA、MARC这种底层表名去 SELECT编译器会直接报“表不可访问”因为 ABAP Cloud 只开放公共 CDS 接口。代码里访问底层表是传统 ECC 的习惯在云端必须戒掉。第二AccessControl.authorizationCheck: #NOT_REQUIRED在公共云里能不能随便用能但尽量不要。这只是测试视角的临时做法真实业务视图还是要配好权限控制否则上线前一天你会发现标准数据保护检查直接拦截了你。第三激活后右键 CDS 视图节点选择 Open With - Data Preview。能正常出数据说明 ADT 到云端租户的读链路完全正常。走到这一步你的开发环境算是真正“能用了”。4. 在 ADT 里干活的日常要点4.1 从零搭一个 RAP 业务对象RAPABAP RESTful Application Programming Model是公共云开发的主要业务对象框架。第一次用 ADT 建 RAP 对象时我建议跟这个顺序走先建 CDS 根视图再建行为定义BDEF再生成服务定义和服务绑定。右键 Z 包New - Other ABAP Repository Object搜索 “Business Object”选好后下一步它会让你指定绑定视图。选择刚才建好的ZI_TEST_CONN生成的 BO 会带默认的 BDEF 文件managed implementation in class zbp_i_test_conn unique; strict (2); define behavior for ZI_TEST_CONN alias TestConn { create; update; delete; }这个模板是最典型的“托管实现”写法翻译成人话就是RAP 框架自动帮你处理创建、更新、删除的持久化逻辑你只需要补业务规则和校验不用手动写数据库操作。这正是公共云里“代码更简洁”的核心原因。BDEF 生成后还需要写一个行为实现类。ADT 会在你保存激活时自动生成类的骨架双击类名就能跳转到实现位置。我在测试项目里加了一段简单的校验CLASS zbp_i_test_conn IMPLEMENTATION. METHOD validate_product. LOOP AT products INTO DATA(product). IF product-ProductType SERV. DO NOTHING ENDIF. ENDLOOP. ENDMETHOD. ENDCLASS.实际开发时校验逻辑会更复杂但核心思路一致所有业务操作都收敛在 RAP 里不散落在一堆报表函数里。这也是 ATC 检查希望看到的架构。4.2 运行 ATC 与代码合规检查如果你是从传统 ABAP 转过来的初期最痛苦的就是 ATCABAP Test Cockpit检查。传统 ECC 里 ATC 过不了最多黄灯你能继续激活公共云不一样ATC 错误默认直接视为激活失败你压根没法走到“激活”那一步。实际操作时右键 CDS 视图或 ABAP 类选择 Run As - ABAP Test Cockpit会弹出检查结果。公共云的 ATC 检查项里最关键的是“云兼容性”Cloud Readiness和“性能检查”。比如你不能在 ABAP 里直接访问非发布数据库表不能使用过时的SELECT *之类写法不能使用PERFORM这种老式内联。每个 ATC 错误的注释里都会给出修改建议基本不需要太多脑细胞去猜。我个人的小技巧是每写一个类或一个视图就右键运行 ATC而不是等整个项目写完再统一跑。原因很简单——云端激活失败往往是连环的对象 A 依赖 BB 没过检查A 也会挂反而更难定位。拆分成小步每步只处理一个对象的报错重复几次就会养成肌肉记忆。4.3 公共云里的“传输请求”怎么理解传统 ECC 里我们保存代码后会弹出一个 Transport Request手动维护到某个请求号里。公共云开发租户里这个过程被大幅简化了在 ADT 中直接激活对象即可对象会变成活动版本。但如果你想把这些对象从开发租户搬到测试或生产租户就不像以前那样“释放请求”了。公共云采用的是基于软件组件和“发布策略”的部署方式。开发租户中的代码归属于某个软件组件当你完成验证后通过“自定义代码迁移”或“发布”流程将整个软件组件打包升级到目标租户。这个节奏通常由管理员控制不是开发人员随手点两下就能推上线。所以当你听到老同事问“这套代码挂在哪个请求下”时可以解释一句公共云里没有经典 SE09/SE10 的逻辑你的关注点应该放在“软件组件版本”和“发布管道”上。这听上去复杂但实际上比传统请求管理更省心因为每个对象都自带变更历史且打包发布时一致性由平台保证。4.4 不用 SE16N怎么查 SAP 常用表我看群里不少人问“SAP 常用表”“MD07 界面”“MARA 库存”这类问题。在传统 ECC 里直接 SE16N 查表是日常操作但公共云里没有 SE16N也没有直接的 SQL Console怎么办我的做法比较务实需要临时看数据时直接创建一个只读 CDS 视图挂到数据预览里查看。比如要看产品主数据就建一个ZI_PRODUCT_SNAP视图基于I_Product做简单映射然后右键 Open With - Data Preview。Data Preview 里能筛选、排序还能导出表格足够应付 90% 的临时取数需求。如果你需要做跨模块的汇总比如把 MD07 式的物料需求库存视图、销售订单、采购订单串起来在传统 ECC 里通常是写一个 ALV 报表访问一堆底表在公共云里更合理是把 CDS 视图作为数据源配合 RAP Fiori Elements 做成一个合规的云端报表应用。这个思路也正好回应了“从采购到 PS 到销售的业务流程图怎么做”这类问题别画在 PPT 里用 CDS 把它建模成可查询的语义层再展现在 Fiori Launhpad 上。5. 我踩过的坑问题排查实录5.1 Could not connect多半是服务端点第一次连接失败时错误提示是Could not connect to ...。排查思路相对固定先确认租户 URL 能在浏览器打开排除网络层问题再确认 URL 末尾是否带/sap/bc/adt多数情况下是漏了路径导致 404。还有一个隐藏坑你在浏览器里访问 https 成功但项目里填的是http不带 sADT 会尝试走 80 端口自然失败。我见过有些同事从邮件里复制 URL 时把https丢了Eclipse 自动判定为 http结果折腾半天。检查项目属性里的 URL确保是https://开头。5.2 证书和 JDK 的坑错误信息如果包含unable to find valid certification path那就是 JDK 信任库问题。Eclipse 运行在 JDK 上它启用的 JVM 必须信任目标服务器的 SSL 证书。处理办法不复杂。先用浏览器把租户地址的证书导出成.cer文件然后在命令行找到 Eclipse 使用的 JDK执行keytool -importcert -alias s4hc_dev \ -file /path/to/s4hc.cer \ -keystore /path/to/jdk/lib/security/cacerts \ -storepass changeit注意changeit是 JDK 默认密码如果你本机改过用你自己的密码。执行完重启 Eclipse 大概率就通了。这个坑的根源往往不是 SAP 证书本身而是企业内部根证书没进 Eclipse 的 JVM。5.3 登录失败但浏览器明明能进 Fiori这是公共云连接让人很崩溃的一个问题浏览器能正常打开 Fiori但 ADT 登录时反复提示认证失败。我遇到的情况基本两类。一类是 ADT 版本太老对 IAS 的 SAML 重定向支持不好更新 ADT 插件到 release notes 推荐版本即可解决。第二类是你浏览器里已经登录过一个 IAS 用户而 ADT 里想用另一个用户登录浏览器会优先复用旧会话导致身份不一致。解决办法也很土先用无痕模式或关掉所有已打开的 IAS 会话然后在 ADT 登录窗里重新走 SAML 流程确保弹出的是新的登录界面。如果还不行直接删掉 ADT 项目重建通常能快速解决会话错乱问题。5.4 右键没有 ABAP Cloud 项目选项有些同事装完 ADT 后新建 ABAP Project 时看不到 “ABAP Cloud” 类型以为哪里装错了。其实公共云默认项目就是 ABAP Project所谓 “ABAP Cloud” 更多是指 ABAP Cloud 开发模型而不是独立的连接类型。真正值得检查的是 ADT 插件版本如果版本过老新建项目向导里没有“SAP S/4HANA Cloud”或“ABAP Cloud” 相关的项目标记/能力选项连接后很多云端专属操作比如发布服务、OData 绑定时选择云模型会缺失。解决办法是在 Eclipse 的 Help - Check for Updates 里更新 ADT 到最新版本而不是反复重装 Eclipse。另外如果你在 ADT 里应该看到 “Service Consumption Model” 或 “Communication Management” 相关节点而看不到也基本是插件版本问题不要浪费时间改本地配置。5.5 对象状态灰显或权限不足连接成功后新建 Package、激活对象时如果提示not authorized或对象灰显问题大概率出在角色。S/4HANA Public Cloud 对开发对象是有命名空间和包权限控制的不是登录必能写。我建议按这个顺序排查第一确认租户是否正确开发账号连到的是不是开发租户而不是只读的生产租户第二在 Fiori Launchpad 中查看用户分配的业务角色里有没有SAP_BR_DEVELOPER以及是否有“自定义代码开发”“质量经理”等应用权限第三如果确认角色存在让管理员检查业务目录是否激活因为角色即使分配业务目录没发布也会出现权限计算不到的情况。还有一个小坑创建包时公共云默认只允许客户在 Z 命名空间下创建。如果你手一抖填了YABC*之类的名字部分租户可能不支持直接报命名空间错误。按 SAP 推荐客户扩展统一Z测试代码也放到Z包下后面审计也方便。结尾几句实际操作的体会我个人整个接入过程最大的收获不是学会了点 Eclipse 按钮而是彻底调整了开发心智云端开发不允许我再用“底层表 事务码”的思维去解业务问题必须先找公开 CDS 接口再包 RAP最后发布服务。这个“三步走”框架打通之后ADT 从“不知道怎么连”变成了“日常干活工具”。如果你正准备接入这套环境建议别急着写业务代码先按我上面的顺序把角色、版本、证书、登录方式四项确认好然后建一个空的 CDS 视图走通 Data Preview再试着生成一个最小 RAP 对象。整个过程快的话一个下午就能跑通。跑通之后哪怕后面接 CPI、搭 Workflow 审批也都是在这个基础上按场景叠加功能。
