EML 中的消息行为(实体操作语言)
ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › 消息 › EML 中的消息行为(实体操作语言)
本主题介绍转换消息和状态消息在 EML 中的行为方式。
转换消息
由于转换消息在语义上与当前请求相关,而不是业务对象状态,因此转换消息与相应 EML 语句的 REPORTED 结构一起返回。
例如,如果操作抛出转换消息并使用 MODIFY 语句触发操作,则转换消息与同一语句的 REPORTED 结构一起返回。转换消息绑定到请求,因此无法在稍后的时间点访问该消息,这意味着后续 READ 语句无法返回该消息。
状态消息
由于状态消息在语义上与业务对象的状态相关,因此状态消息不会与更改业务对象状态的 EML 请求的 REPORTED 结构一起返回,而是只能通过 READ 访问。MODIFY 操作期间,所有抛出的状态消息均池化,并在触发 READ 请求的业务对象实体上以 MODIFY 返回。
例如,如果 MODIFY - CREATE 在抛出状态消息的保存序列期间触发验证,则此消息不会包含在同一请求的 REPORTED 结构中,而是包含在同一实例的下一 READ 结构中的 REPORTED 结构中。
注意
如果在公开的 RAP OData 服务的上下文中触发回滚,则业务对象的状态将返回到执行请求之前的状态。由于状态消息始终反映持久化实体的当前状态,因此在初始请求之后和回滚之前触发的状态消息对于持久实体无效。因此,框架将此时间范围内触发的状态消息转换为转换消息,然后将其分配到相应
MODIFY请求的REPORTED结构。如果在非 RAP 场景中通过 EML 使用业务对象,并在
CheckBeforeSave阶段取消SAVE,则业务对象将保持其状态并保留状态消息。
示例:含草稿的被管理业务对象
以下示例说明了状态和转换消息的消息行为:
属于业务对象的验证抛出一条转换消息和一个状态消息。此示例仅用于消息行为比较 - 通常说验证宁愿抛出状态消息而不是转换消息。前两个草稿实例通过 EML CREATE 创建。然后将两个实体提交到草稿表。在草稿表中,触发检查 sample_field 值的验证。
通用验证实施遵循常规操作实施模式。验证在 Prepare 期间触发,并检查字段 sample_field 的内容是否有效:
[implementation] unmanaged|managed|abstract [in class class_name unique];
with draft;
...
define behavior for CDSEntity travel
implementation in class travel_implementation [unique]
...
{
validation sampleValidation on save { field sample_field; }
draft determine action Prepare { validation sampleValidation; }
}
在 sampleValidation 中,已实施两个消息。如果在 sample_field 中输入了不正确的值且具有严重性错误,则会触发状态消息,转换消息会确认包含的值正确且严重性为成功:
展开以下代码示例以查看方法 sampleValidation 的源代码。
示例代码
METHOD sampleValidation.
//State message is invalidated
APPEND VALUE #( %tky = k-%tky
%state_area = 'sampleValidation' ) TO reported-travel.
[...Code to check value ]
IF value_is_incorrect.
APPEND VALUE #( %tky = key-%tky ) TO failed-travel.
APPEND VALUE #( %tky = key-%tky
%state_area = 'sampleValidation'
%msg = NEW messagewrapper( textid = messagewrapper=>validation_value_incorrect
travel_id = ls_travel-travelid
severity = if_abap_behv_message=>severity-error )
%element-sample_field = if_abap_behv=>mk-on ) TO reported-travel.
ELSE.
//value is correct
APPEND VALUE #( %tky = key-%tky
%msg = new messagewrapper( textid = messagewrapper=>validation_value_correct
travel_id = ls_travel-travelid
severity = if_abap_behv_message=>severity-success )
%element-sample_field = if_abap_behv=>mk-on ) to reported-travel.
ENDIF.
ENDMETHOD.
现在,通过 EML 触发两个 CREATE 操作。在第一个 CREATE 中,为 sample_field 传递了不正确的值。在第二个 CREATE 中,提供了正确的值。两个已创建实例的后续 Prepare 操作会触发其验证。因此,只有具有正确值的实例准备才会在 中提供条目,因为相应消息已作为转换消息实施。接下来,在两个实例上执行 EML 读取。因此,由于相应消息已作为状态消息实施,因此仅具有错误值的实例的读取在 中提供条目。如果此状态消息使用 COMMIT ENTITIES 持久化,甚至可以在实例的后续会话中进行检索。 展开以下代码示例以查看源代码
示例代码
// Trigger two creates via EML
//Returns state message
MODIFY ENTITIES OF /dmo/BusinessObject
ENTITY Bo_Entity
CREATE SET FIELDS WITH
VALUE #( ( %tky = VALUE #( ID = '1234'
%is_draft = if_abap_behv=>mk-on )
%data = VALUE #(
sample_field = 'incorrectValue'
[...fill in other required fields for CREATE]
) )
FAILED DATA(create_failed)
MAPPED DATA(create_mapped)
REPORTED DATA(create_reported).
//Returns transition message in reported
MODIFY ENTITIES OF /Dmo/BusinessObject
ENTITY Bo_Entity
CREATE SET FIELDS WITH
VALUE #( ( %tky = VALUE # ( ID = '12345'
%is_draft = if_abap_behv=>mk-on )
%data = VALUE #(
sample_field = 'correctValue'
[...fill in other required fields for CREATE]
) )
FAILED DATA(create_failed_2)
MAPPED DATA(create_mapped_2)
REPORTED DATA(create_reported_2).
//Commit created instances to draft table
COMMIT ENTITIES RESPONSE OF /Dmo/BusinessObject
FAILED DATA(COMMIT_FAILED)
REPORTED DATA(COMMIT_REPORTED).
//Execute prepare to trigger state message - state message not contained in reported
MODIFY ENTITIES OF /Dmo/BusinessObject
ENTITY Bo_Entity
EXECUTE prepare from VALUE #( ( id = '1234' ) )
FAILED DATA(prepare_failed)
MAPPED DATA(prepare_mapped)
REPORTED DATA(prepare_reported).
//Execute prepare to trigger messages to trigger transition message - transition message contained in reported
MODIFY ENTITIES OF /Dmo/BusinessObject
ENTITY Bo_Entity
EXECUTE prepare from VALUE #( ( id = '12345' ) )
FAILED DATA(prepare_failed_2)
MAPPED DATA(prepare_mapped_2)
REPORTED DATA(prepare_reported_2).
// Read on draft travel entity 1234 - returns the state message for this instance
READ ENTITIES OF /Dmo/BusinessObject
ENTITY Bo_Entity
FIELDS (ID )
WITH VALUE #( ( ID = '1234'
%is_draft = if_abap_behv=>mk-on ) )
RESULT DATA(READ_RESULT)
REPORTED DATA(READ_REPORTED_STATEM)
FAILED DATA(READ_FAILED_STATEM).
//Read on draft travel entity 12345 - reported is empty
READ ENTITIES OF /Dmo/BusinessObject
ENTITY Bo_Entity
FIELDS ( ID )
WITH VALUE #( ( ID = '12345'
%is_draft = if_abap_behv=>mk-on ) )
RESULT DATA(READ_RESULT_)
REPORTED DATA(READ_REPORTED)
FAILED DATA(READ_FAILED).
//In new session - state message was persisted for draft and is returned with READ_REPORTED_STATEM
READ ENTITIES OF /Dmo/BusinessObject
ENTITY Bo_Entity
FIELDS ( ID )
WITH VALUE #( ( ID = '1234'
%is_draft = if_abap_behv=>mk-on ) )
RESULT DATA(READ_RESULT)
REPORTED DATA(READ_REPORTED_STATEM)
FAILED DATA(READ_FAILED_STATEM).
结果
按如下方式分配这两条消息:
**状态消息实例 1234:**持久状态消息在
READ_REPORTED_STATEM结构中分配。即使启动新会话,实例 1234 上的READ也会返回状态消息,直到更改值并再次触发PREPARE。当业务对象在草稿实例中一致时,业务对象实例可以保存在数据库中。转换消息实例 12345:转换消息以
prepare_reported_2结构返回。
来源:SAP Help Portal · 2025 FPS02 (Oct 2026) · 中文为 SAP 官方机器翻译
← 消息映射 · OData 中的消息 →