04 · 门② RAP 业务对象开发(从数据模型到能预览的 Fiori 应用)

📄 [教程] Day2 全天练习(Exercise 2 Part 1)+ PPT slide 14-18 🔗 [官方] ABAP RESTful Application Programming Model(ABAP Cloud) · RAP100 官方学习任务组 · RAP 入门博客合集

本章目标:在 03 章的数据模型上继续,亲手完成一个能预览、能建单的 RAP 应用——行为定义(BDEF)→ 行为池(自动订单号/日期)→ 编号范围 → 服务定义/绑定 → 浏览器预览;再对照我司"模式 A/B"读懂生产代码。

本章产出:

#

对象

类型

作用

1

ZI_ONLINE_SHOP

Behavior Definition(BDEF)

声明业务对象能做什么(增删改、determination)

2

ZBP_I_ONLINE_SHOP

行为池类(Behavior Pool)

实现 determination:自动取订单号、补日期

3

ZOSOID + 区间 01

编号范围对象(Number Range Object)

生成订单号 1、2、3…

4

ZSD_ONLINE_SHOP

Service Definition

决定暴露哪些实体

5

ZSB_ONLINE_SHOP

Service Binding(OData V2 – UI)

发布成 Fiori 可用的服务,Preview 建单

✅ 衔接:03 章结束时 ZONLINESHOP / ZI_ONLINE_SHOP / ZC_ONLINE_SHOP 已建好并激活。本章 Step 1 不再重复建数据模型;若你是从本章跳进来的,请先回 03 章 §3–§5 做完。


0. RAP 是什么:一个公式

RAP 应用 = 数据模型(CDS,第 03 章) + 行为(BDEF + 行为池类) + 服务(Service Definition + Binding) + UI(注解驱动 Fiori Elements)

四层各自的意义:

层

对象

谁负责

数据模型

CDS 视图(03 章)

查什么、字段是什么

行为

BDEF(声明)+ 行为池(实现)

能增删改吗、校验/动作/编号怎么写

服务

Service Definition + Binding

暴露哪些实体、以 OData V2/V4 给谁用

UI

元数据扩展里的 @UI 注解(03 章)

列表/明细页长什么样,不写前端代码

managed vs unmanaged(选型第一决策):

  • managed:框架管增删改与持久化(映射到表),你只写"额外逻辑"——自建表的维护类应用首选(本章用这个);

  • unmanaged:你全权管读写(实现 read/lock/save)——只读查询、特殊数据源时用(第 07 章报表即 unmanaged query)。


1. 完整实操(Day2 Exercise 2 Part 1 逐步还原)

场景:新员工在线下单买设备;订单号自动生成(编号范围)、创建日期自动填、交货日期默认 +10 天;发布后能在 Fiori 里建单、看列表。

步骤总览:

Step

做什么

在哪个工具

产出

1

数据模型(表 + 根视图 + 元数据扩展)

ADT

见 03 章,已完成

2

建行为定义 BDEF

ADT

ZI_ONLINE_SHOP 行为

3

实现行为池 determination

ADT

自动订单号/日期

4

建编号范围对象 ZOSOID

ADT

号段定义

5

维护编号区间 01(1–9999)

Fiori(浏览器)

可用的号段

6

建服务定义 ZSD_ONLINE_SHOP

ADT

暴露实体

7

建服务绑定 ZSB_ONLINE_SHOP 并 Publish

ADT

OData V2 服务

8

Preview 预览、建单验证

浏览器

跑通的 Fiori 应用

Step 1(03 章已完成):数据模型

对象

类型

在 03 章的位置

ZONLINESHOP

数据库表

§3 动手 1

ZI_ONLINE_SHOP

CDS 根视图

§4 动手 2

ZC_ONLINE_SHOP

元数据扩展(@UI 注解)

§5 动手 3

💡 本章所有对象都建在包 Z_Onlineshop 里,用同一个传输请求。开始前确认三个对象都已是"已激活"状态(图标不带红叉)。

Step 2:建行为定义 BDEF

步骤

操作

为什么

1

右键数据定义 ZI_ONLINE_SHOP → New → Behavior Definition

BDEF 必须挂在 BO 根视图上

2

Description:Behavior for ZI_ONLINE_SHOP;Root Entity:ZI_ONLINE_SHOP;Implementation Type:Managed

选 managed:框架代管持久化

3

选 TR → Finish

—

新建行为定义 (📄 Day2 脚本:右键 ZI_ONLINE_SHOP → New Behavior Definition,Implementation Type 选 Managed)

完整源码(覆盖编辑器里的模板):

managed implementation in class zbp_i_online_shop unique;
strict ( 2 );

define behavior for ZI_ONLINE_SHOP alias Online_Shop
persistent table zonlineshop
lock master
authorization master ( instance )
{
  field ( numbering : managed, readonly ) Order_Uuid;
  field ( readonly ) Orderid, Creationdate;

  determination calculate_order_id on modify { create; }

  create;
  update;
  delete;

  mapping for zonlineshop
  {
    Order_Uuid   = order_uuid;
    Orderid      = order_id;
    Material     = material;
    Quantity     = quantity;
    Creationdate = creationdate;
    Deliverydate = deliverydate;
  }
}

每一行的意义:

声明

意义

managed implementation in class ... unique

托管模式 + 唯一实现类(行为池)

strict ( 2 )

严格语法模式(新对象一律加,防未来不兼容)

persistent table zonlineshop

数据落哪张表

lock master / authorization master (instance)

并发锁与权限由本 BO 主导(instance = 可按实例授权,见 08 章)

field ( numbering : managed, readonly ) Order_Uuid

技术主键由框架自动生成 UUID,且只读

field ( readonly ) Orderid, Creationdate

界面不可改(由行为池自动填)

determination ... on modify { create; }

确定逻辑:创建时自动填派生字段(订单号/日期)

action ...

动作 = 界面按钮(本章练习没有自定义动作;需要时见第 07 章模式 B)

mapping for ...

CDS 字段 ↔ 表字段映射(托管模式必需)

用 Quick Fix 生成行为池类:

  1. 把光标放在 BDEF 第 1 行 managed implementation in class zbp_i_online_shop unique; 上;

  2. 按 Ctrl+1 → 选 Create behavior implementation class zbp_i_online_shop;

  3. 向导里选 TR → Finish,系统自动生成 ZBP_I_ONLINE_SHOP(含 lhc_Online_Shop 局部类骨架)。

Quick Fix 生成行为池 Quick Fix 选项 (📄 Day2 脚本:BDEF 首行 Ctrl+1 → 生成行为实现类)

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

Step 3:实现行为池(determination 自动订单号)

打开包下 Source Code Library → Classes → ZBP_I_ONLINE_SHOP,在 Local Types 里找到以别名命名的 lhc_Online_Shop 类,把 determination 方法补全:

类的位置 (📄 Day2 脚本:包 → Source Code Library → Classes → ZBP_I_ONLINE_SHOP)

CLASS lhc_Online_Shop DEFINITION INHERITING FROM cl_abap_behavior_handler.
  PRIVATE SECTION.
    METHODS calculate_order_id FOR DETERMINE ON MODIFY
      IMPORTING keys FOR Online_Shop~calculate_order_id.
ENDCLASS.

CLASS lhc_Online_Shop IMPLEMENTATION.
  METHOD calculate_order_id.
    DATA: online_shops TYPE TABLE FOR UPDATE zi_online_shop,
          online_shop  TYPE STRUCTURE FOR UPDATE zi_online_shop.

    " 1) EML 读自己(IN LOCAL MODE 绕过特性控制读全字段)
    READ ENTITIES OF zi_online_shop IN LOCAL MODE
      ENTITY Online_Shop ALL FIELDS WITH CORRESPONDING #( keys )
      RESULT DATA(lt_result)
      FAILED DATA(lt_failed)
      REPORTED DATA(lt_reported).

    DATA(today) = cl_abap_context_info=>get_system_date( ).

    LOOP AT lt_result INTO DATA(ls_read).
      online_shop = CORRESPONDING #( ls_read ).
      IF online_shop-Orderid IS INITIAL.
        " 2) 编号范围服务取号(复用组件,勿自写号码)
        TRY.
            CALL METHOD cl_numberrange_runtime=>number_get
              EXPORTING
                nr_range_nr = '01'
                object      = 'ZOSOID'
              IMPORTING
                number      = DATA(lv_number)
                returncode  = DATA(lv_rc).
          CATCH cx_nr_object_not_found.  "对象没建/没区间
          CATCH cx_number_ranges.
        ENDTRY.
        online_shop-Orderid      = CONV int4( lv_number ).
        online_shop-Creationdate = today.
        IF online_shop-Deliverydate IS INITIAL.
          online_shop-Deliverydate = today + 10.   "默认交期 +10 天
        ENDIF.
        APPEND online_shop TO online_shops.
      ENDIF.
    ENDLOOP.

    " 3) EML 写回自己(托管模式也要用 EML 更新,不能直接 UPDATE 表)
    MODIFY ENTITIES OF zi_online_shop IN LOCAL MODE
      ENTITY Online_Shop UPDATE SET FIELDS WITH online_shops
      MAPPED DATA(ls_mapped)
      FAILED DATA(ls_failed)
      REPORTED DATA(ls_reported).
  ENDMETHOD.
ENDCLASS.

三段式的意义:

  1. EML 读:READ ENTITIES ... IN LOCAL MODE 是 RAP 内部自读的标准姿势(LOCAL MODE 跳过权限/特性检查);

  2. 取号:cl_numberrange_runtime 是官方复用组件(Day2 PPT slide 19「Number range solution」)——号码对象 ZOSOID 要先在 ADT 建(下一步),再去 Fiori「Manage Number Range Intervals」建间隔 01(1..9999);

  3. EML 写:即使托管模式,修改字段也走 MODIFY ENTITIES ... UPDATE SET FIELDS——业务对象是唯一写入通道,禁止绕过 BO 直接 UPDATE 表。

⚠️ 激活类(Ctrl+F3)后先别急着预览——编号范围对象和区间还没建,建单会取不到号(方法里异常被 catch 了,Orderid 会留空)。

Step 4:建编号范围对象 ZOSOID(ADT)

步骤

操作

填什么

1

右键包 Z_Onlineshop → New → Other ABAP Repository Object → 搜索 Number Range Object → Next

—

2

Name / Description

ZOSOID / Online Shop Order ID

3

Number Length Domain

Z_OLSP_ORD_ID_DOMA(下一步现场建)

4

其他参数

Percent Warning 10;Rolling 勾选;Buffering No Buffering;Buffered Numbers 0;Sub Type 留空

5

选 TR → Finish

—

建编号范围对象 编号范围参数

创建长度域(点 Number Length Domain 旁的创建按钮):

字段

值

Name

Z_OLSP_ORD_ID_DOMA

Description

Z_OLSP_ORD_ID_DOMA

Data Type

CHAR

Length

10

建域 域类型 CHAR 10

最后分别激活域和编号范围对象(Ctrl+F3),Problems 无红叉。

Step 5:维护编号区间 01(Fiori,浏览器)

号码对象只是"定义",真正发号的区间在 Fiori 里维护:

步骤

操作

说明

1

浏览器打开 D 租户 Fiori Launchpad(与 ADT 同一套 SSO 账号)

不用重登

2

打开应用 Export Customizing Transports,先建一个 Customizing 传输请求并记住编号

Fiori 侧配置变更要挂 TR,没有它下一步存不了

3

打开应用 Manage Number Range Intervals,搜索 ZOSOID

—

4

点 Create 新增区间:Interval Number 01;Lower Limit 1;Upper Limit 9999;External Interval 不勾

订单号从 1 开始

5

保存(选第 2 步的 TR)

区间生效

Fiori 中建自定义传输 管理编号区间 维护区间 01

💡 检查点:回到 ADT,打开行为池类,确认 object = 'ZOSOID'、nr_range_nr = '01' 与 Fiori 里建的一致——大小写/前导零错一个都取不到号。

Step 6:建服务定义 ZSD_ONLINE_SHOP

步骤

操作

填什么

1

右键包 → New → Other ABAP Repository Object → 搜索 Service Definition → Next

—

2

Name / Description

ZSD_ONLINE_SHOP / Service Definition for online shop

3

选 TR → Finish

—

建服务定义

完整源码:

@EndUserText.label: 'Service Definition for online shop'
service ZSD_ONLINE_SHOP {
  expose ZI_ONLINE_SHOP;
}

激活(Ctrl+F3)。意义:Definition 决定"暴露什么",Binding 决定"以什么协议给谁"。

Step 7:建服务绑定 ZSB_ONLINE_SHOP 并发布

步骤

操作

填什么

1

右键包 → New → Other ABAP Repository Object → 搜索 Service Binding → Next

—

2

Name / Description

ZSB_ONLINE_SHOP / Service binding for online shop

3

Binding Type

OData V2 – UI

4

Service Definition

ZSD_ONLINE_SHOP

5

选 TR → Finish

—

6

打开绑定,点 Publish,等进度条完成

发布后才有 OData 服务

建服务绑定 发布服务

Step 8:Preview 预览、建单验证

  1. 在 Service Binding 页面展开 Entity Set(ZI_ONLINE_SHOP),点 Preview。

  2. 浏览器弹出 Fiori Elements 列表页,标题 ShopOrders,列:Order Id / Delivery Date / Material / Quantity / Creation Date。

  3. 点 Create 建一条订单:Material 填 Test-01,Quantity 填 10,Delivery Date 选一个日期 → Save。

  4. 验证自动逻辑:

    • Order Id 自动出现(1、2、3…,来自编号范围);

    • Creation Date = 今天;

    • Delivery Date 留空时会自动补今天 +10 天。

预览列表 预览建单 建单后自动生成订单号

💡 预览用的是你的开发权限,不需要配 IAM App/业务角色;正式要让业务用户用,走第 08 章发布链路。 ⚠️ Preview 打不开/列表空白:检查 Publish 是否成功、@UI 注解是否激活、BDEF 是否激活、浏览器是否拦截了弹窗。

Step 9(进阶可选):打印闭环

这一节是 Day2 Exercise 2 Part 2(打印),做完 Step 1–8 的应用已经验收;需要给业务单据加打印能力时再往下做。

💡 本节只给链路与代码骨架。打印 API 版(HTTP Service + 通信场景/安排 + Postman + 行为池 print 全代码)在 05 章 §5–§6 有完整实操;.xdp 表单模板怎么从零做出来,见 05 章 §1.3。

链路:服务定义取数 → Adobe 渲染 → 打印队列。三件套:

  1. 取数据结构(XSD)与数据(XML)——cl_fp_fdp_services:

DATA(lo_fdp_util) = cl_fp_fdp_services=>get_instance( 'ZSD_ONLINE_SHOP' ).
DATA(lv_schema)   = lo_fdp_util->get_xsd( ).           "给 Adobe Designer 当数据源
DATA(lt_keys)     = lo_fdp_util->get_keys( ).
lt_keys[ name = 'ORDER_UUID' ]-value = lv_uuid.
DATA(lv_xml)      = lo_fdp_util->read_to_xml( lt_keys ). "把 BO 实例读成 XML
  1. Adobe LiveCycle Designer 里 New Data Connection → XML Schema(选上一步导出的 .xsd)→ 拖字段排版,存 .xdp;

  2. 模板存表(练习用 ZFORMTEMPLATE 存二进制;也可改成 HTTP 上传);

  3. 渲染并进打印队列:

cl_fp_ads_util=>render_4_pq(                 "ADS 渲染 PDF
  EXPORTING iv_locale = 'en_US'
            iv_pq_name = 'DEVTEST'           "打印队列名
            iv_xml_data = lv_xml
            iv_xdp_layout = ls_form-form_binary
            is_options = VALUE #( trace_level = 0 )   "生产用 0!
  IMPORTING ev_pdl = DATA(lv_pdf) ).

cl_print_queue_utils=>create_queue_item_by_data(   "队列项=打印任务
  iv_qname = 'DEVTEST'  iv_print_data = lv_pdf
  iv_name_of_main_doc = |OnlieShopOrder_{ lv_uuid }| ).

前置条件(缺一不可):Adobe LiveCycle Designer、SAP Cloud Print Manager(pull 集成)、通信安排 SAP_COM_0466 + 通信用户、打印队列 DEVTEST。队列在 Fiori「Maintain Print Queues」可见,本地 Cloud Print Manager 拉取落地 PDF。完整截图见 Day2 练习脚本 Part 2(docs/12、SAP公有云开发培训/)。

控制台类取 XSD Adobe Designer 打印结果入队


2. EML 速查(Entity Manipulation Language)

📄 Day2 PPT slide 16-18:EML 让 ABAP 类型安全地操作(自己的或标准的)RAP BO——不经过 OData。

语句

用途

READ ENTITIES OF bo ENTITIES ent ALL FIELDS WITH keys RESULT ...

读

MODIFY ENTITIES OF bo ENTITIES ent CREATE FIELDS (...) WITH ...

建

MODIFY ... UPDATE SET FIELDS WITH ...

改

COMMIT ENTITIES / ROLLBACK ENTITIES

提交/回滚(保存时框架代管,独立调用时要显式)

... IN LOCAL MODE

行为池内部绕过权限/特性

FAILED/REPORTED/MAPPED 三返回

RAP 错误与消息的标准出口(配 REPORTED 出 message 给 UI)

调标准 BO 同一套语法——把 zi_online_shop 换成 released BO(如 i_journalentrytp 过账凭证),就是第 05 章的集成手段(我司 FI 在用)。


3. 草稿(Draft)机制要点

BDEF 加 with draft(或投影层 use draft):

  • 自动生成草稿表(如 zdtpp003)——每个草稿表必须手工建(表结构=业务表+草稿管理字段);

  • 界面自动获得 Edit/Activate/Discard/Resume/Prepare 动作(我司 PP 的 zc_pp003.bdef 投影里 use action Edit; use action Activate; ... 就是启用它们);

  • etag master LocalLastChangedAt + lock master total etag LastChangedAt 是并发与乐观锁的标配注解。

📦 [代码] 完整实例精读(维护类 App 的标准样板):sap-zzpp-master/src/zr_pp003.bdef.asbdef(managed+draft+early numbering)、sap-zzsd-master/src/zr_table_ztsd018.bdef.asbdef。


4. 我司模式 A / 模式 B 对照(学完立刻能读生产代码)

  • 模式 A(维护类应用)= 本章 managed 全家桶 + smbc(Fiori Elements 表格维护配置)+ MBC 目录。样板:PP 的 ZR_TABLE_ZTPP007、SD 的 ZR_TABLE_ZTSD018(多角贸易 STO 维护)。

  • 模式 B(查询报表)= unmanaged 投影 BDEF(readonly 字段 + 业务 action 按钮)+ if_rap_query_provider 实现类 + ZZCL_QUERY_UTILS 三件套(filtering/orderby/paging)。样板:sap-zzmm-master/src/zzcl_query_mm004.clas.abap。详解在第 07 章。

两模式完整步骤清单见第 09 章速查卡。


5. 本章检查清单

  • 能背 RAP 四层公式与 managed/unmanaged 选型

  • BDEF 每个关键字(strict/lock master/determination/mapping)能说出意义

  • 独立完成"BDEF → Quick Fix 生成行为池 → determination + 编号范围 + EML 写回"全流程

  • 编号范围对象 ZOSOID 与区间 01 建好,建单能取到 1、2、3…

  • 服务定义 + OData V2 UI 绑定已发布,Preview 能建单、能看列表

  • 理解 IN LOCAL MODE 与 FAILED/REPORTED/MAPPED

  • 精读一个我司 bdef + 行为池(推荐 PP zr_pp003 链——注意其类源码未在导出中,可读 SD 的 zbp_r_table_ztsd018)


➡️ 下一步