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

ZONLINESHOP

数据库表(Database Table)

已激活,字段见 §3.2

2

ZI_ONLINE_SHOP

CDS 根视图(Data Definition / Root View Entity)

已激活,可预览数据

3

ZC_ONLINE_SHOP

元数据扩展(Metadata Extension)

已激活,UI 注解就位

✅ 衔接:第 01 章已经建好包 Z_Onlineshop 和传输请求(TR),本章所有对象都建在这个包里。02 章是门① 低代码线(选读),ABAP 开发主线是 01 → 03 → 04。第 04 章会在本章这个数据模型上加行为、编号范围和服务,最终得到一个能预览的 Fiori 应用。


1. ABAP Cloud 语法纪律(写第一行代码前必读)

📄 Day2 slide 12 给出两个代表性对比:

传统 ABAP(本地部署)

ABAP Cloud(公有云)

SELECT * FROM mara 直查标准表

❌ 语法错误 → ✅ SELECT FROM i_product(released CDS)

Dynpro/ALV 老技术做界面

❌ 不存在 → ✅ RAP + Fiori Elements

修改标准代码/增强任意位置

❌ → ✅ 只实现 released BAdI(FOR BEHAVIOR/enhancement spot)

判断口诀:编辑器里输入对象名,若对象未 released,语法检查直接红——"能不能用"不用猜,系统会告诉你。ADT 里也可用 Released Objects 视图/搜索查询已发布对象。

📦 [代码] 我司四个包全部源码 ABAP_LANGUAGE_VERSION = 5 (cloudDevelopment)(见 sap-zzsd-master/.abapgit.xml 及 docs/ZZSD项目代码记录.md §1)。你写的所有对象同样默认锁在该语言版本下。


2. 数据字典对象族(建对象前对照)

总纲 PPT「ABAP字典」页列出六件套——建任何应用都从它们开始:

对象

ADT 类型

我司命名

用途

域 Domain

DOMA

ZZE*(少量)、专用如 Z_OLSP_ORD_ID_DOMA

值域+技术类型

数据元素 Data Element

DTel

ZZE*

语义字段(域+文本)

数据库表 Table

TABL

ZZT_MM###、ZZTSD###、ZZTFI###、ZZTPP###

持久化(草稿表 _D)

结构 Structure

TABL(struct)

ZZS_SDI001_REQ 等

API 报文骨架

表类型 Table Type

TTYP

ZZTT_*

结构的表

💡 本练习的在线商店表为了"照抄就能跑",字段直接用内置类型(abap.char/int4/dats、sysuuid_x16),不逐个建数据元素。正式项目再按公司规范补 Data Element(带 F1 帮助和字段标签)。


3. 动手 1:建数据库表 ZONLINESHOP

3.1 新建表对象

步骤

操作

为什么

1

在 Project Explorer 里右键包 Z_Onlineshop → New → Other ABAP Repository Object

所有对象的统一入口

2

搜索 database table,选中 → Next

启用 ABAP Cloud 新语法 define table

3

Name:ZONLINESHOP;Description:Persistence Layer for Online Shop

表名全大写、无引号

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;               "交货日期
}

字段为什么这么定:

字段

类型

说明

client

abap.clnt

客户端字段的表必须带,自动填

order_uuid

sysuuid_x16

技术主键。公有云表主键规范用 UUID,业务号不当主键,避免归档/合并问题

order_id

abap.int4

业务订单号,由编号范围对象 ZOSOID 生成(04 章),界面显示为 1、2、3…

material / quantity

char(18) / int4

物料与数量(界面上就是这两列)

creationdate / deliverydate

dats

创建日期由行为池自动补;交货日期默认 +10 天

⚠️ 如果你改了字段名或类型,第 04 章的 mapping for zonlineshop、行为池代码和 Web API/打印模板都要跟着改。练习阶段建议完全照抄。

3.3 激活与验证

  1. 按 Ctrl+F3(激活)。激活 = 保存 + 语法检查 + 生成运行时对象;只按 Ctrl+S 保存不生效。

  2. 看下方 Problems 视图:没有红叉才算过。常见红叉:abap.clnt 拼错、字段名重复、未选 TR。

  3. 验证:包下出现 Database Tables → ZONLINESHOP;右键表 → Open With → Data Preview 能打开空表。

  4. (可选)验证主键:Data Preview 里能看到 CLIENT / ORDER_UUID / ... 七列。


4. 动手 2:建 CDS 根视图 ZI_ONLINE_SHOP

RAP 要求数据与行为分离:CDS 管数据,BDEF 管行为。先建数据模型的根视图。

4.1 新建 Data Definition

步骤

操作

为什么

1

右键包 Z_Onlineshop → New → Other ABAP Repository Object

—

2

搜索 data definition → Next

CDS 视图(DDL)对象

3

Name:ZI_ONLINE_SHOP;Description:Data model for online shop

ZI_ = 接口层/根视图命名

4

选 TR → Finish

—

新建 CDS 视图 (📄 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
}

三个注解的意义:

注解

意义

@AccessControl.authorizationCheck: #NOT_REQUIRED

练习阶段不做 DCL 权限检查;生产改成 #CHECK 并写 DCL(见 08 章)

@Metadata.allowExtensions: true

允许把 UI 注解拆到 .ddlx 元数据扩展里——视图保持干净、注解分层治理

root(define root view entity)

标记业务对象根——RAP 只认 root view 作为 BO 根实体

💡 字段别名(as Orderid 等)就是后面 BDEF 映射和 UI 显示的字段名;Order_Uuid 是技术键,界面上通常隐藏(下一节通过元数据扩展控制)。

4.3 激活与验证

  1. Ctrl+F3 激活,Problems 无红叉。

  2. 右键视图 → Open With → Data Preview:能看到 ORDER_UUID / ORDERID / MATERIAL / QUANTITY / CREATIONDATE / DELIVERYDATE 六列(此时无数据属正常)。

  3. 顺手格式化:光标移到编辑器里按 Shift+F1(整段格式化;只选中一段则按 Ctrl+Shift+F1)。


5. 动手 3:建元数据扩展 ZC_ONLINE_SHOP(注解即 UI)

Fiori Elements 不写前端代码,界面完全由 CDS 注解驱动——注解即 UI。把 UI 注解外置到元数据扩展,视图本体保持业务语义。

5.1 新建 Metadata Extension

步骤

操作

为什么

1

右键数据定义 ZI_ONLINE_SHOP(不是包!)→ New → Metadata Extension

扩展必须挂在目标视图上

2

Name:ZC_ONLINE_SHOP;Description:Metadata Extension for ZC_ONLINE_SHOP

ZC_ = 消费层

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;
}

注解含义:

注解

结果

@UI.headerInfo

列表页标题显示 ShopOrders,单条叫 ShopOrder

@UI.lineItem

列表每一列(列顺序即 position)

@UI.selectionField

顶部筛选栏字段(练习里只筛 Orderid / Creationdate)

@UI.identification

对象页(明细页)上的字段

@UI.facet

对象页的分区分组(IDENTIFICATION_REFERENCE 表示字段区)

@UI.hidden: true

隐藏 Order_Uuid 技术键,不给用户看

5.3 激活与验证

  1. Ctrl+F3 激活,Problems 无红叉。

  2. 此时界面上还看不到东西——要等第 04 章建好 BDEF + Service Definition/Binding 并 Publish 后,Preview 才能看到这个界面。这是正常的,继续往下做即可。

  3. 验证注解语法:把光标放到 @UI.lineItem 上按 F2,能弹出注解说明。


6. CDS 三层建模与命名(我司规范,写业务时对照)

层

前缀

职责

我司例子

基础/根视图

ZR_*

直接 select 自定义表,定义关联、管理字段

ZR_TABLE_SD001、zr_ztmm003

接口视图

ZI_*

可复用的接口层(值帮助、供其他视图引用)

ZI_CONFIG_ZTSD013

消费视图

ZC_*

面向 UI/API 的投影 + UI 注解(通常配元数据扩展)

ZC_QUERY_MM004

💡 本章练习是"一个小应用一张表"的最小闭环,所以根视图直接叫 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)"


➡️ 下一步