03 · 门② ABAP Cloud 基础与数据字典(建表 → CDS → 注解 完整实操)
📄 [教程] Day2 PPT slide 11-12「Developer Extensibility / ABAP environment – Examples」;Day2 练习脚本 Step 1(建表 / 建 CDS / 建元数据扩展三段);总纲 PPT「ABAP字典」页 🔗 [官方] ABAP RESTful Application Programming Model(ABAP Cloud 版) · RAP 专题页
本章目标:掌握 ABAP Cloud 的"游戏规则"(什么能写什么不能写),并在 Eclipse ADT 里亲手建出在线商店示例的数据模型:数据库表 ZONLINESHOP → CDS 根视图 ZI_ONLINE_SHOP → 元数据扩展 ZC_ONLINE_SHOP,全部激活可用。
本章产出(做完自查):
# |
对象 |
类型 |
状态 |
|---|---|---|---|
1 |
|
数据库表(Database Table) |
已激活,字段见 §3.2 |
2 |
|
CDS 根视图(Data Definition / Root View Entity) |
已激活,可预览数据 |
3 |
|
元数据扩展(Metadata Extension) |
已激活,UI 注解就位 |
✅ 衔接:第 01 章已经建好包
Z_Onlineshop和传输请求(TR),本章所有对象都建在这个包里。02 章是门① 低代码线(选读),ABAP 开发主线是 01 → 03 → 04。第 04 章会在本章这个数据模型上加行为、编号范围和服务,最终得到一个能预览的 Fiori 应用。
1. ABAP Cloud 语法纪律(写第一行代码前必读)
📄 Day2 slide 12 给出两个代表性对比:
传统 ABAP(本地部署) |
ABAP Cloud(公有云) |
|---|---|
|
❌ 语法错误 → ✅ |
Dynpro/ALV 老技术做界面 |
❌ 不存在 → ✅ RAP + Fiori Elements |
修改标准代码/增强任意位置 |
❌ → ✅ 只实现 released BAdI( |
判断口诀:编辑器里输入对象名,若对象未 released,语法检查直接红——"能不能用"不用猜,系统会告诉你。ADT 里也可用 Released Objects 视图/搜索查询已发布对象。
📦 [代码] 我司四个包全部源码
ABAP_LANGUAGE_VERSION = 5 (cloudDevelopment)(见sap-zzsd-master/.abapgit.xml及docs/ZZSD项目代码记录.md§1)。你写的所有对象同样默认锁在该语言版本下。
2. 数据字典对象族(建对象前对照)
总纲 PPT「ABAP字典」页列出六件套——建任何应用都从它们开始:
对象 |
ADT 类型 |
我司命名 |
用途 |
|---|---|---|---|
域 Domain |
DOMA |
|
值域+技术类型 |
数据元素 Data Element |
DTel |
|
语义字段(域+文本) |
数据库表 Table |
TABL |
|
持久化(草稿表 |
结构 Structure |
TABL(struct) |
|
API 报文骨架 |
表类型 Table Type |
TTYP |
|
结构的表 |
💡 本练习的在线商店表为了"照抄就能跑",字段直接用内置类型(
abap.char/int4/dats、sysuuid_x16),不逐个建数据元素。正式项目再按公司规范补 Data Element(带 F1 帮助和字段标签)。
3. 动手 1:建数据库表 ZONLINESHOP
3.1 新建表对象
步骤 |
操作 |
为什么 |
|---|---|---|
1 |
在 Project Explorer 里右键包 |
所有对象的统一入口 |
2 |
搜索 database table,选中 → Next |
启用 ABAP Cloud 新语法 |
3 |
Name: |
表名全大写、无引号 |
4 |
传输请求选择 01 章创建的那个 TR(或新建)→ Finish |
云上一切对象变更都挂 TR |
(📄 Day2 脚本:右键包 → New → Other ABAP Repository Object → database table,填写 Name / Description)
3.2 填字段(完整字段清单)
向导完成会生成一个带模板的 .tabl 编辑器。把下面整段源码贴进去覆盖模板(字段名与第 04 章 BDEF 映射、打印模板一一对应,照抄即可):
@EndUserText.label : 'Persistence Layer for Online Shop'
@AbapCatalog.enhancement.category : #NOT_EXTENSIBLE
@AbapCatalog.tableCategory : #TRANSPARENT
@AbapCatalog.deliveryClass : #A
@AbapCatalog.dataMaintenance : #RESTRICTED
define table zonlineshop {
key client : abap.clnt not null; "客户端(自动)
key order_uuid : sysuuid_x16 not null; "UUID 主键(RAP 惯例,框架自动生成)
order_id : abap.int4; "业务订单号(编号范围生成,见 04 章)
material : abap.char(18); "物料
quantity : abap.int4; "数量
creationdate : abap.dats; "创建日期
deliverydate : abap.dats; "交货日期
}
字段为什么这么定:
字段 |
类型 |
说明 |
|---|---|---|
|
|
客户端字段的表必须带,自动填 |
|
|
技术主键。公有云表主键规范用 UUID,业务号不当主键,避免归档/合并问题 |
|
|
业务订单号,由编号范围对象 |
|
|
物料与数量(界面上就是这两列) |
|
|
创建日期由行为池自动补;交货日期默认 +10 天 |
⚠️ 如果你改了字段名或类型,第 04 章的
mapping for zonlineshop、行为池代码和 Web API/打印模板都要跟着改。练习阶段建议完全照抄。
3.3 激活与验证
按 Ctrl+F3(激活)。激活 = 保存 + 语法检查 + 生成运行时对象;只按 Ctrl+S 保存不生效。
看下方 Problems 视图:没有红叉才算过。常见红叉:
abap.clnt拼错、字段名重复、未选 TR。验证:包下出现
Database Tables → ZONLINESHOP;右键表 → Open With → Data Preview 能打开空表。(可选)验证主键:Data Preview 里能看到
CLIENT / ORDER_UUID / ...七列。
4. 动手 2:建 CDS 根视图 ZI_ONLINE_SHOP
RAP 要求数据与行为分离:CDS 管数据,BDEF 管行为。先建数据模型的根视图。
4.1 新建 Data Definition
步骤 |
操作 |
为什么 |
|---|---|---|
1 |
右键包 |
— |
2 |
搜索 data definition → Next |
CDS 视图(DDL)对象 |
3 |
Name: |
|
4 |
选 TR → Finish |
— |
(📄 Day2 脚本:Name ZI_ONLINE_SHOP、Description Data model for online shop)
4.2 完整源码
@AccessControl.authorizationCheck: #NOT_REQUIRED
@EndUserText.label: 'Data model for online shop'
@Metadata.allowExtensions: true
define root view entity ZI_ONLINE_SHOP
as select from zonlineshop
{
key order_uuid as Order_Uuid,
order_id as Orderid,
material as Material,
quantity as Quantity,
creationdate as Creationdate,
deliverydate as Deliverydate
}
三个注解的意义:
注解 |
意义 |
|---|---|
|
练习阶段不做 DCL 权限检查;生产改成 |
|
允许把 UI 注解拆到 |
|
标记业务对象根——RAP 只认 root view 作为 BO 根实体 |
💡 字段别名(
as Orderid等)就是后面 BDEF 映射和 UI 显示的字段名;Order_Uuid是技术键,界面上通常隐藏(下一节通过元数据扩展控制)。
4.3 激活与验证
Ctrl+F3 激活,Problems 无红叉。
右键视图 → Open With → Data Preview:能看到
ORDER_UUID / ORDERID / MATERIAL / QUANTITY / CREATIONDATE / DELIVERYDATE六列(此时无数据属正常)。顺手格式化:光标移到编辑器里按 Shift+F1(整段格式化;只选中一段则按 Ctrl+Shift+F1)。
5. 动手 3:建元数据扩展 ZC_ONLINE_SHOP(注解即 UI)
Fiori Elements 不写前端代码,界面完全由 CDS 注解驱动——注解即 UI。把 UI 注解外置到元数据扩展,视图本体保持业务语义。
5.1 新建 Metadata Extension
步骤 |
操作 |
为什么 |
|---|---|---|
1 |
右键数据定义 |
扩展必须挂在目标视图上 |
2 |
Name: |
|
3 |
选 TR → Finish |
— |
(📄 Day2 脚本:右键 ZI_ONLINE_SHOP → New Metadata Extension)
5.2 完整源码
@Metadata.layer: #CORE
@UI: {
headerInfo: {
typeName: 'ShopOrder',
typeNamePlural: 'ShopOrders'
}
}
annotate view ZI_ONLINE_SHOP with
{
@UI.facet: [ { id: 'order', purpose: #STANDARD, type: #IDENTIFICATION_REFERENCE, label: 'Order', position: 10 } ]
@UI.lineItem: [ { position: 10, label: 'Order Id' } ]
@UI.selectionField: [ { position: 10 } ]
@UI.identification: [ { position: 10, label: 'Order Id' } ]
Orderid;
@UI.lineItem: [ { position: 20, label: 'Delivery Date' } ]
@UI.identification: [ { position: 20 } ]
Deliverydate;
@UI.lineItem: [ { position: 30, label: 'Material' } ]
@UI.identification: [ { position: 30 } ]
Material;
@UI.lineItem: [ { position: 40, label: 'Quantity' } ]
@UI.identification: [ { position: 40 } ]
Quantity;
@UI.lineItem: [ { position: 50, label: 'Creation Date' } ]
@UI.selectionField: [ { position: 20 } ]
@UI.identification: [ { position: 50 } ]
Creationdate;
@UI.hidden: true
Order_Uuid;
}
注解含义:
注解 |
结果 |
|---|---|
|
列表页标题显示 ShopOrders,单条叫 ShopOrder |
|
列表每一列(列顺序即 position) |
|
顶部筛选栏字段(练习里只筛 Orderid / Creationdate) |
|
对象页(明细页)上的字段 |
|
对象页的分区分组(IDENTIFICATION_REFERENCE 表示字段区) |
|
隐藏 |
5.3 激活与验证
Ctrl+F3 激活,Problems 无红叉。
此时界面上还看不到东西——要等第 04 章建好 BDEF + Service Definition/Binding 并 Publish 后,
Preview才能看到这个界面。这是正常的,继续往下做即可。验证注解语法:把光标放到
@UI.lineItem上按 F2,能弹出注解说明。
6. CDS 三层建模与命名(我司规范,写业务时对照)
层 |
前缀 |
职责 |
我司例子 |
|---|---|---|---|
基础/根视图 |
|
直接 select 自定义表,定义关联、管理字段 |
|
接口视图 |
|
可复用的接口层(值帮助、供其他视图引用) |
|
消费视图 |
|
面向 UI/API 的投影 + UI 注解(通常配元数据扩展) |
|
💡 本章练习是"一个小应用一张表"的最小闭环,所以根视图直接叫
ZI_ONLINE_SHOP;公司正式项目按ZR_ → ZI_ → ZC_分层(09 章有完整模式卡)。草稿视图:带草稿(draft)的 BO 会自动多出
_D视图与草稿表,勿手工改(04 章 §3 讲)。
7. 值帮助与关联(写查询必备,第 05/07 章会用到)
@Consumption.valueHelpDefinition: [{ entity: { name: 'I_CompanyCodeVH', element: 'CompanyCode' } }]
key companycode : bukrs;
值帮助 = 指向一个 VH 后缀的标准视图;带参数联动用
additionalBinding。association定义视图间关系(_Item等),RAP 用它做父子导航。本章示例没有关联字段,先掌握"看到业务字段知道去哪查 VH"即可。
8. 本章检查清单
ZONLINESHOP已建、字段与 §3.2 一致、激活无错误ZI_ONLINE_SHOP根视图已建、Data Preview 能看到 6 列ZC_ONLINE_SHOP元数据扩展已建、激活无错误、F2 能看到注解帮助能说出
@AccessControl.authorizationCheck/@Metadata.allowExtensions/root三个注解的作用理解为什么主键用 UUID 而不是业务单号
知道"保存(Ctrl+S)≠ 激活(Ctrl+F3)"
➡️ 下一步
下一章:04 · 门② RAP 业务对象开发——给
ZI_ONLINE_SHOP加行为定义、行为池、编号范围、服务定义/绑定,最后预览并新建订单。主线回顾:01 · 环境准备与开发工具 → 03 → 04 · 门② RAP 业务对象开发