开发约束

ABAP RESTful 应用程序编程模型 › 开发 › 开发约束

ABAP RESTful Application Programming Model 的当前版本对于以下内容仍具有一些约束:

CDS 枚举类型

不支持在基于 RAP 的 OData 服务中公开 CDS 枚举类型的元数据。CDS 枚举类型不能用作 RAP 业务对象的一部分。

协作草稿处理

仅当两个业务对象都启用协作草稿时,协作草稿才适用于跨业务对象场景。

事件驱动的副作用

执行以完整清单为目标的事件驱动副作用时,不会重新加载清单报表中新创建的项目。执行事件驱动的副作用后,只能更新清单报表中已存在的项目。

如果您在业务对象的同一服务绑定中同时公开了草稿实体和非草稿实体,则无法运行事件驱动的副作用。

重用草稿表

RAP 运行时不支持在不同业务对象 (BDEF) 中重用相同的草稿表,并且可能会导致运行时错误。

带草稿的可编辑树视图

层次结构到父关联必须是纯外键关系,即,此关联必须精确绑定层次结构父主键。例如,不支持绑定非主语义键。

不支持草稿查询视图。

尽管级联删除行为是可选的,但 UI 当前期望服务器级联子树的删除,并且在没有级联的情况下其行为并不一致,因为它不会发送对多选子树节点的请求。

对于具有延迟编号的非托管实体,不支持声明 with cascading delete。

不支持以下层次结构功能:

  • 具有多个父项的层次结构

  • 临时层次结构

  • 异构层次结构,例如具有不同节点类型的层次结构,如果在 UI 中选择节点,则会导致不同的对象页面。

CREATE (OData V4) 期间支持复杂集合中的异构请求

此功能与通过专用注释显示的应用程序特定值控制冲突。如果服务中至少有一个属性具有此类显式值控制属性,则为该服务完全禁用该功能。

BDEF C1 发布

BDEF 的 C1 版本当前不支持:

  • 托管和非托管的 BDEF(仅投影、接口和抽象)

  • 语言版本为 5 的 BDEF(客户对象),但允许用于接口和抽象

  • 实体包含虚拟或路径元素的 BDEF

  • 具有草稿范围的 BDEF

修改之前和增强出口

如果增强在“非原始”实例上添加操作(不属于原始请求),运行时会尝试自动锁定这些操作。为做出适当的响应,增强出口有责任使用“相关”语法将这些非原始实例与原始实例相关联。然后, 运行时会将非原始实例上的锁定失败映射回相应相关实例的故障。如果非原始实例需要权限(原始实例未涵盖),则由增强对其进行检查(例如,使用 GET PERMISSIONS)。

在同一更改集中创建和编辑

不允许在同一更改集(EML:事务)中发送 CREATE 和 EDIT。管理的草稿提供者应拒绝此类请求,但当前不会拒绝。

已发布 RAP BO 接口上的 OData UI 服务绑定

无法在 SAP 通过 C1 合同发布的业务对象接口上定义自定义 OData UI 服务绑定。

可扩展性

  • 节点可扩展性:当前无法为扩展审批合同审批服务定义扩展。因此,已发布的 RAP 业务对象的扩展节点只能通过 EML 使用,不能通过 OData 服务使用。

  • 行为可扩展性

    • 仅实施类型 managed 支持确定、验证、附加保存和清理的扩展。

    • 为了在 UI 上公开操作扩展,需要投影层的 CDS 视图扩展中的任何字段,操作扩展的 UI 注释可以参考这些字段。

  • 虚拟元素:无法将虚拟元素添加到投影层上的扩展。

  • 增强:无法在可扩展性场景中使用增强。

  • 草稿:针对扩展 (C0) 发布合同发布 RAP BO 接口或 CDS 投影后,无法随后对其进行草稿启用。

  • MAP_MESSAGES:无法在扩展中实施 MAP_MESSAGES。

  • 附加清理:无法在扩展中实施附加清理。

启用草稿的关联

查询运行时不支持将任意关联作为启用草稿的关联。对于 RAP 中启用草稿的关联,除非以下条件之一成立,否则会抛出 SADL 编译器错误(即用于 OData 公开):

  • 纯外键:关联是纯外键关联,即关联最多具有一个 的目标多样性,在条件上将源外键元素映射到目标主键元素,并且不包含更多条件。

  • 专业化:关联是启用草稿的纯外键关联的专业化。

  • 反向:关联是草稿启用纯外键关联的反向关联,即它镜像条件,但可能会添加更多条件。

  • 遍历:关联的启用条件声明两个外键的相等性,其中存在相应的纯外键关联,这些外键关联具有通用目标实体且已启用草稿。

事件测试双重框架

事件测试双重框架不考虑更新任务中引发的事件。

严格(2)

最好将 strict(2) 用于所有 RAP 业务对象,但:

OData V2 中的可选操作/函数参数

对于 OData V2,网关 DPC 接口不提供是否提供可选参数的信息。因此,不会拒绝强制操作或函数参数的请求,并且未提供的参数达到随初始值提供的行为实施。为了在 UI 上公开操作扩展,需要投影层的 CDS 视图扩展中的任何字段,操作扩展的 UI 注释可以参考这些字段。

OData V2 中的 UI 注释

UI 注释 UI.CreateHidden、UI.UpdateHidden 和 UI.DeleteHidden为了在 UI 上公开操作扩展,需要投影层的 CDS 视图扩展中的任何字段,OData V2 中不支持该 UI。

OData V4 中的十进制浮点数

在 OData V4 服务中包含 DECFLOAT 变量可能会导致使用 Fiori 元素不支持的 OData 版本。这可能会导致 Fiori 元素停止工作。

OData 客户端代理请求

请求 OData Request: Delta Link Query Option" 无法在 RAP 中与严格模式一起使用。此类请求不满足事务一致性的规则。

使 OData 服务失效

如果使用 OData 服务(V2 和 V4)更改(深度)操作参数或非实体操作结果,结果不会正确失效,因为在计算最后更改的时间戳时不会考虑这些更改。应急方案是激活,例如BDEF 或服务定义。

含参数的操作

如果将值帮助添加到操作参数(例如,通过操作参数的相应抽象实体中的注释 @ValueHelpDefinition),则值帮助不会自动添加到服务,并且必须显式添加到服务定义。

在同一请求中创建和编辑

在相同的 MODFY ENTITIES 语句中包含创建和编辑的 EML 请求当前会导致运行时错误。

使用具有两个命名空间的使用模型

OData 客户端代理不支持两个命名空间。

使用确定和验证

使用确定和验证时,提供以下约束:

  • 仅在与触发器操作 update 结合使用时,才支持用于确定和保存验证的触发器操作 create。

  • 触发器操作 delete 的使用受限,除非实体实例由语义键值标识。

  • 如果确定或验证具有触发器操作 delete,则无法将后代实体的确定或验证分配给确定操作。

增强

如果非原始实例需要权限(原始实例未涵盖),则增强实施负责检查其权限。

启用草稿的业务对象

  • 如果激活的实例在同一事务中再次锁定,则活动提供者可能存在锁定冲突。这是因为激活草稿实例后,活动实例的持久锁仍然存在。

  • 如果存在根实体的行为定义并定义启用草稿的 RAP 业务对象,则必须在行为定义中表示 CDS 构成层次结构中的每个子实体。

含草稿的非托管业务对象

有些功能可以在非托管业务对象的行为定义中定义,从而用于活动实例,但不能用于草稿实例:

  • 无法对草稿实例执行以下操作:

    • 通过业务对象内部关联逐个创建,这些关联已启用创建,但无构成

    • 直接在子实例上创建

  • 保存草稿实例时,汇总的管理数据字段不会自动更新。

  • 在绑定条件中使用 NOT 的关联无法启用草稿。

  • 不支持从草稿到活动实例的启用交易草稿的关联。

  • 不支持与客户端无关的 CDS 视图。

跨业务对象功能

不支持草稿范围。

使用 C1 发布合同发布 RAP 业务对象

目前,您无法发布 C1 发布以下 BDEF:

  • 实体包含虚拟或路径元素的 BDEF

  • 具有草稿范围的 BDEF

排序或筛选请求中的非托管查询

在过滤器或排序请求中,非托管查询无法使用具有外部目标的一对一关联处理路径表达式。

RAP 可测试性

缺少对已启用草稿的业务对象和相关表(如草稿管理数据、持久锁、消息)的可测试性的支持。

不同的预测

如果多个投影公开同一 RAP 业务对象,则不得通过同一 LUW 中的不同投影对其进行修改。

非标准工序中的深度参数

  • OData 公开通常不支持以下类型:

    • 标量类型

    • 深度表参数

    • 深度参数作为函数的输入参数或输出参数。

    如果在服务中使用此类参数,则服务绑定会显示错误消息。可以通过 EML 使用具有此类参数的操作。

  • OData V2 仅允许具有扁平参数的非标准操作。如果服务中包含具有深度参数的非标准操作,则服务绑定会显示错误消息。

大对象

  • RAP 运行时引擎拒绝具有 $expand 子句的 OData V4 请求,其中显式为包含属性 SAP__Messages 的扩展实体声明 $select 子句。如果展开的实体包含大对象属性,则即使没有为展开的实体指定 $select 子句,也会拒绝此类请求。

  • 无法直接将 Edm.Stream 定义为操作参数。解决方法是使用复杂类型作为具有所有 Edm.Stream 属性的操作的参数。

RAP 业务对象中的混合客户端相关性

不支持在其构成层次结构中具有混合客户端相关性的业务对象。

OData V4 参照约束

为了满足 OData 法规,不会在用于 OData V4 服务的已启用草稿业务对象中为关键字段生成引用约束。因此,没有可用于这些字段的快速视图。

持久锁

  • 更改活动实例,然后进行编辑

  • 激活活动实例,然后进行编辑

  • 放弃草稿实例(其锁定仍处于活动状态),然后进行编辑

  • 将新的草稿实例从业务对象实例移动(删除和创建)到同一业务对象的其他实例

  • 重新创建

    • 删除活动实例,然后删除具有相同键值的草稿创建

    • 创建新的草稿实例,然后放弃,然后使用相同键值创建(草稿或活动)

  • 放弃草稿实例(其锁不再处于活动状态),然后进行编辑

功能基数

对于函数,最多仅支持 1 个响应([0..1] 个基数)。

OData 客户端代理

只能使用本地客户端代理。

OData V2 远程使用无法处理空值,忽略处理

如果来自服务器的响应包含 NULL 值或从有效负载中省略了属性,则使用 OData 客户端的客户将无法获取信息。根据服务,此信息可能与客户端相关。此限制仅适用于使用的远程 OData V2 服务。

来源:SAP Help Portal · 2025 FPS02 (Oct 2026) · 中文为 SAP 官方机器翻译

← 开发 · 开发应用程序 →