转换消息

ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › 消息 › 通用消息实施 › 转换消息

转换消息参考触发的请求。

转换消息

转换消息参考触发的请求,并且仅在请求运行时有效。与状态消息相反,它们与业务对象本身的状态没有任何关系,而是与状态之间的转换无关。转换消息的典型示例为:“业务对象已由用户 &1 锁定”。由于示例指的是与特定实体相关的请求,因此将其分类为绑定转换消息。

或者,可以通过添加 %tky 来标识实例并将转换消息添加到业务对象实体的 REPORTED 结构,将转换消息绑定到业务对象实体。

子实体的 %path 组件

必须为根实体的所有子实体填充 %path 组件,以将子实体显式映射到父项。对于根的直接子项,%path 组件使用主键和草稿标识将子实体映射到特定父实例。在以下示例中,草稿 parent (%is_braft) 通过实例键值映射到 child 草稿:

%path = VALUE #( <root>-%is_draft = <child>-%is_draft
                 <root>-<key>     = <child-<parent_key_in_child_entity> ))

对于由三个实体组成的业务对象,第二个子实体将映射到直接父实体以及业务对象的根。%path 组件允许在运行时在实体之间进行有效映射。

%path = VALUE #( <root>-%is_draft   = <child_2>-%is_draft
                 <root>-<key>       = <child_2>-<root_key_in_child2_entity>
                 <parent>-%is_draft = <child_2>-%is_draft
                 <parent>-<key>     = <child_2>-<parent_key_in_child2_entity> )

有关特定实施示例,请参阅示例实施:validateBookingDate(预订)。

%tky 组件

%tky 定义转换消息是否参考特定业务对象实例。您可以定义属于业务对象实体的实体绑定转换消息,而无需使用以下语法参考特定实例:

APPEND VALUE #(  %msg = NEW messagewrapper(
                          textid = message_exception=>message_exception_constant
                          severity = if_abap_behv_message=>severity-severity
                          message_variable = read_result-field ) ) TO reported-business_object_entity.

如果未指定 %tky,则转换消息不会引用业务对象的实例,但消息在语义上仍与 REPORTED 结构所属的相应实体相关。例如,如果要在全局权限或全局功能控制的上下文中返回转换消息,则需要此语法。在全局方法中,不存在业务对象实例,但消息与业务对象的特定实体相关。请注意,在此上下文中会忽略依赖 %tky 解析分配(如 %element)的组件。没有实例参考的转换消息被解释为 OData 元数据中的未绑定转换消息,但无法在全局权限的上下文中定义未绑定的转换消息。请注意,全局标志由框架自动设置,无法手动设置。

通用消息实施:绑定转换消息

如果在实施中未填充 %STATE_AREA,则将消息解释为转换消息。以下通用实施是具有一个消息变量的实例绑定转换消息(添加到业务对象实体的报告结构并引用具有 %tky 组件的业务对象实例)的示例。如果转换消息与特定字段值相关,建议为 (%ELEMENT-FIELDNAME) 组件分配目标字段。这不会影响 UI,但目标作为 OData 元数据的一部分传输。

实例绑定转换消息需要 %tky 作为实例参考来解析 %element 组件的分配。如果未指定 %tky,则在运行时将忽略这些分配。实例绑定消息从实例方法实施(如实例功能控制或实例权限)返回。通常按如下方式实现 %tky 作为 实例的实例绑定转换消息:

    APPEND VALUE #(
        %tky = instance-%tky
        %msg = NEW message_exception(
                textid           = message_exception=>message_exception_constant
                severity         = if_abap_behv_message=>severity-severity
                message_variable = instance-field ) ) TO reported-business_object_entity.

由于此示例消息附加到业务对象实体,因此假设消息内容与特定实体的请求相关。如果不是这种情况,并且转换消息没有任何业务对象实体的链接,则可以将转换消息绑定到 %OTHER 组件。

有关特定实施示例,请参阅示例实施:setToBooked (Travel) 。

实体绑定转换消息在语义上仅与实体相关,与特定实例无关。因此,实体绑定转换消息在没有实例参考的情况下实施,并从全局方法实施(如全局功能控制或全局权限)返回。实体绑定转换消息通常按如下方式实施:

    APPEND VALUE #(  %msg = NEW messagewrapper(
                             textid = message_exception=message_exception_constant
                             severity = if_abap_behv_message=>severity-severity
                             message_variable = read_result-field ) ) TO reported-business_object_entity.

由于在创建特定业务对象实例之前调用全局出口,因此无需参考 %tky 即可实施此示例。%msg 组件的填充方式与实例绑定转换消息完全相同。在这种情况下,如果定义 %element,则在运行时期间将忽略分配。有关详细信息,请参阅 %tky 组件部分。

通用消息实施:未绑定转换消息

将未绑定转换消息分配给 %OTHER 组件。此通用实施表示一条转换消息,该消息将一个消息变量传递到消息包装器类并分配给 %OTHER 组件。

    reported-%other = VALUE #( ( NEW message_exception(
                                  textid           = message_exception=>message_exception_constant
                                  severity         = if_abap_behv_message=>severity-severity
                                  message_variable = instance-field ) ) ).

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

← 通用消息实施 · UI 上的未绑定和绑定转换消息 →