转换消息
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 上的未绑定和绑定转换消息 →