实体操作语言 (EML)
ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › 实体操作语言 (EML)
实体操作语言 (EML) 是 ABAP 语言的一部分,允许访问 RAP 业务对象。
由于通过 OData 协议使用业务对象需要 Fiori UI 或 Web API,EML 通过使用 ABAP 启用对业务对象的类型安全访问。EML 通过触发指定实体的操作与业务对象进行交互。仅当在行为定义中为相关实体指定操作并且相应地实施操作时,EML 才能触发操作。
用例
EML 可用于提供业务对象的行为。例如,您可以实施首先使用 EML 触发创建,然后触发更新操作的操作。此操作允许使用缺省值创建实例,并在要为其提供行为的业务对象行为池中实施。
EML 也可用于使用业务对象。典型场景是单元测试,在独立于要测试的业务对象的类中实施。这些单元测试使用 EML 通过触发业务对象操作来检查业务对象的事务行为。其他场景涉及跨业务对象应用程序,其中业务对象使用彼此的操作实施其行为或已发布业务对象的使用。
备注
除了本指南中描述的标准 EML API 外,还有通用 EML API。通用 EML API 支持在其他框架中通用集成业务对象,本指南不涵盖。
EML 场景
下表概述了不同的 EML 场景、要考虑的内容以及查找示例和更多信息的位置:
|
场景 |
描述 |
相关报表 |
|---|---|---|
|
开发(业务对象在其行为池中的 IN LOCAL MODE 中) |
在 EML 开发场景中,您可以使用 EML 在其自己的行为池中为自己的业务对象提供功能。当 EML 使用 READ/READ-BY-ASSOCIATION、CREATE/CREATE-BY-ASSOCIATION、UPDATE、DELETE 和 EXECUTE 访问相应业务对象的实例时,您可以添加 IN LOCAL MODE 以绕过访问控制以及权限和功能控制实施。这意味着,例如,您可以更新在 EML 开发场景中定义为 READONLY 的字段。 |
|
|
使用(其他行为池中的业务对象/已发布的业务对象) |
在 EML 使用场景中,您可以使用 EML 在跨业务对象关系中使用业务对象,也可以使用已发布的业务对象。在使用场景中,无法将 IN LOCAL MODE 添加到语句以绕过访问控制以及权限和功能控制实施。 |
|
|
测试 |
在 EML 测试场景中,使用 EML 测试 ABAP 行为池外部的业务对象。这需要使用 COMMIT ENTITIES 来结束 RAP LUW。在行为池内实施 时,这将由 框架处理。 |
EML 语句
本部分提供可使用相应 EML 语句触发的操作的概览。有关每个语句的详细信息以及代码示例,请参阅使用 EML 访问业务对象的示例。
有关语法的详细信息,请参阅用于使用 RAP 业务对象的 ABAP(ABAP 关键字文档)。
READ
READ 语句包括不更改实体实例数据的所有操作(只读访问)。可以从所选实体和关联实体中读取数据。您可以在一个 READ 语句中触发多个读取操作。
有关实施的示例,请参阅 READ。
有关语法的详细信息,请参阅 READ ENTITY、ENTITIES(ABAP 关键字文档)。
MODIFY
MODIFY 语句包括更改实体实例数据的所有操作。您可以触发标准操作 CREATE、UPDATE 和 DELETE 以及非标准运算操作和函数。对于包含投影层的业务对象,您还可以在将请求传递到基本业务对象之前通过添加数据或修改操作来增强传入请求。示例用例使用实例数据增强创建请求,以便在增强实施中为新实例设置缺省值。可以通过一个 MODIFY 语句触发多个修改操作。如果这些操作彼此不相关(例如,不同实体上的多个更新操作),则不会确定其执行顺序。要确保这种情况下的特定执行顺序,请使用单独的 MODIFY 语句。
备注
如果
MODIFY语句在同一调用中使用%cid_ref触发 create 和 create-by-association 操作,则不会执行实例功能和实例权限实施。根据业务逻辑,您需要通过预检查和/或验证实施相应的检查。
有关实现的示例,请参见“MODIFY”。
有关语法的详细信息,请参阅 MODIFY ENTITY、ENTITIES(ABAP 关键字文档)。
COMMIT ENTITIES
COMMIT ENTITIES 语句为在 LUW 中更改的所有业务对象触发从事务缓冲区到数据库的数据持久性。
在包含 RAP 和非 RAP 实施的应用程序的上下文中,语句 COMMIT WORK 隐式触发 COMMIT ENTITIES,并以此隐式触发 RAP 保存顺序,以将事务缓冲区中的所有数据保存到数据库。如果从 RAP 实施保存数据失败(例如,由于在保存序列期间触发验证),则会中止提交并提交在此点之前的所有更改以确保数据一致性。当 COMMIT WORK 失败时,COMMIT ENTITIES 将中止。为避免这种情况,可以使用 COMMIT ENTITIES IN SIMULATION MODE 检查保存顺序是否正常运行。模拟模式会触发保存顺序,但不会保留任何数据。
有关 COMMIT ENTITIES 的示例,请参见 COMMIT ENTITIES。
有关语法的详细信息,请参阅 COMMIT ENTITIES(ABAP 关键字文档)。
有关 COMMIT ENTITIES in SIMULATION MODE 的示例,请参阅 ABAP EML - 模拟模式中的 COMMIT ENTITIES(ABAP 关键字文档)。
ROLLBACK ENTITIES
ROLLBACK ENTITIES 语句回退自上次提交以来的所有更改并重置事务缓冲区。
有关示例,请参见 ROLLBACK ENTITIES。
有关语法的详细信息,请参阅 ROLLBACK ENTITIES(ABAP 关键字文档)。
SET LOCKS
SET LOCKS 语句锁定实体实例,从而防止其他用户进行修改。
有关示例,请参见“SET LOCKS”。
有关语法的详细信息,请参阅 SET LOCKS(ABAP 关键字文档)。
EML 操作数
IN LOCAL MODE
仅当 EML 实施在其自己的行为池中使用 RAP BO 的实例时,才能实施 IN LOCAL MODE。附加项 IN LOCAL MODE 可确保在不检查访问控制、权限控制、功能控制或预检查的情况下直接访问 BO。有关语法的详细信息,请参阅 IN LOCAL MODE(ABAP 关键字文档)和 EML 操作数。
IN LOCAL MODE 对不同操作具有以下影响:
|
操作 |
IN LOCAL MODE 效果 |
行为池中受影响的方法 |
示例 |
|---|---|---|---|
|
IN LOCAL MODE 绕过:
|
|
|
|
IN LOCAL MODE 绕过:
|
|
|
有关使用 IN LOCAL MODE 的示例实施,请参阅 READ
PRIVILEGED
实施 PRIVILEGED 使使用者可以进行特权访问,例如绕过权限检查。
作为使用者,您可以使用对 RAP 业务对象的特权访问来规避业务对象的权限检查。该特权模式必须已由提供者在您要使用的 RAP BO 接口中使用权限上下文进行定义。仅当您要使用的 RAP BO 实体通过 PRIVILEGED 定义时,才能使用 with privileged mode。
有关语法的详细信息,请参阅 ABAP EML - PRIVILEGED(ABAP 关键字文档)。
基本报表组件
尽管功能多种多样,EML 语句通常包含一组共同组件。
MODIFY ENTITIES OF Business_Object
ENTITY BO_Entity
Operation FIELDS ( RelevantField1 RelevantField2 ) WITH internal_table | FROM internal_table
[FAILED failed]
[MAPPED mapped]
[REPORTED reported].
每个 EML 语句都以语句类型的关键字开头,用于指示 EML 语句的用途,例如,对于要处理实例的一个或多个实体,READ。对于涵盖不同操作类型的语句(如 MODIFY),EML 语句的实际操作在实体规范部分后指示。
根据操作,必须传递相关值以标识相关实例或传递实例的值。EML 希望明确标记与操作相关且应使用值的字段。可以使用字段语句指定这些字段,也可以通过填充控制结构来指定这些字段。
EML 语句触发的操作的响应存储在类型化响应参数中。例如,结构 failed 用于存储已触发操作失败的实例的键值,而表 result 包含 READ 操作或操作返回的结果。
来源:SAP Help Portal · 2025 FPS02 (Oct 2026) · 中文为 SAP 官方机器翻译
← CLEANUP_FINALIZE · 使用 EML 访问业务对象的示例 →