消息

ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › 消息

本主题介绍了与 ABAP RESTful Application Programming Model 相关的基本消息概念。

关于消息

消息提供了一种重要的方法来指导和验证消费者和用户操作,并帮助避免和解决问题。因此,消息对于向消费者或用户传达问题很重要。设计良好的消息有助于识别、诊断和解决问题。因此,务必始终一致地使用消息并优化整体交互。因此,需要采取行动的错误和警告应明确说明并加以描述,以帮助快速有效地解决问题。建议为失败结构中的每个条目提供消息,以提供附加信息。

根据消息是参考业务对象实例的状态还是仅参考当前请求,存在不同类型的消息。状态消息参考业务对象实例,转换消息参考请求。状态消息必须始终绑定到业务对象实例(绑定),而转换消息可以绑定或取消绑定(与业务对象实例无关)。

备注

运行时因错误而终止必须始终根据失败结构中的条目实施,以指示失败原因。作为报告结构一部分的消息,仅提供相应情况的附加信息,但不是运行时终止的可靠指示。对于程序设计,始终建议考虑失败结构中的失败原因。

EML 中的消息

执行修改请求时,将在 failed 结构中返回失败实例的键值。相关失败实例的消息将以 reported 结构返回,其组件在运行时由编译器根据返回值派生。reported 结构的以下组件与消息处理相关:

  • REPORTED

    • %CID:相关实例的标识

    • %MSG:已填充消息包装器类的实例

    • %ELEMENT:列出与消息相关的实体的所有字段或关联。

    • %STATE_AREA:如果填充类型为 String 的此组件,则框架会将消息解释为状态消息。

    • %OP:此组件指示与消息相关的已执行操作。此组件仅与转换消息相关。

    • %OTHER:报告的结构包含定义的每个实体的表,此外 %OTHER 包含与实体无关的所有消息的表。当消息与业务对象实体无关时,使用消息包装器类的实例填充 %OTHER 组件(未绑定消息)

    • %path(仅与子实体相关):路径组件将子实体映射到其父项。如果存在具有多个子实体的业务对象,则会扩展 %PATH 组件以将子实体映射到其父实体和业务对象根。

使用 %ELEMENT 组件,可以将消息分配到一个或多个目标字段。这些目标由客户端解释并改善用户体验,因为目标在消息和目标字段之间建立可见链接,如果有许多错误消息,也会启用导航。%STATE_AREA 组件确定是否将消息解释为状态消息。如果将此组件留空,则将消息解释为转换消息。如果填充组件,则将消息解释为状态消息。在为同一实例请求多个操作或操作时,组件 %OP 对于区分消息与哪个操作相关的操作非常重要。

有关 reported 和 failed 结构的更多常规信息,请参阅:

有关消息在 EML 中的行为方式的详细信息,请参阅 EML(实体操作语言)中的消息行为。