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 中的消息 →