OData V2

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

本主题介绍如何在 OData V2 中对消息进行建模。

OData V2 中的消息

OData V2 中的消息未建模为实体,而是与业务数据一起返回。

请求成功(http 响应 2xx)

如果请求成功(http 响应 2xx),则消息包含在自定义响应标头 sap-message 中,结构如下:

  • 消息代码:机器可读代码

  • 消息文本:在 T100 消息类中定义的消息文本。

  • 消息目标:使用 %element 组件定义消息目标。消息可以有一个或多个目标。如果定义了多个目标,则会将其建模为 additionalTargets 数组。在这种情况下,此数组中的每个项目都是与目标具有相同语法的字符串。

  • 严重性:严重性反映使用语句 SEVERITY = IF_ABAP_BEHV_MESSAGE=>SEVERITY-SEVERITY 在 %msg 组件中定义的严重性。

  • 转换标识:可选转换标识 - 在从一个后端状态转换到另一个后端状态(例如,在执行操作期间)期间转换消息。转换消息标记为 transition:true,状态消息标记为 transition:false。

  • *详细消息:*零个或更多详细信息,每个都带有代码、消息、严重性、目标和可选 additionalTargets 数组和转换标识。

SAP 消息标头的内容使用与响应正文相同的格式(Atom/XML 或 JSON)。

sap-message 标头的结构如下:

sap-message: {
  "code": "DMO_BUSINESSOBJECT_MESSAGES/002",
  "message": "Message text as defined in T100 message class",
  "severity": "info",
  "transition": true,
  "target": "to_Target"
  "details": [

  ]
}

代码由消息源自的 T100 消息类和消息标识符组成。此消息示例具有严重性信息,并定义为具有目标 _Target 的转换消息。

不成功(Http 响应代码 4xx [客户端错误]/ 5xx [服务器错误])

如果请求不成功,则返回包含 http 正文的消息。如果响应包含多个消息,则会按层次结构排列在第一个返回消息下方。使用以下属性描述第一条消息:

  • 语言:服务器返回消息所使用的语言(响应语言派生自请求语言)。

  • 消息:在相应 T100 消息类中定义的消息文本。

响应中的属性结构如下:

"error": {
  "code": "DMO_BUSINESSOBJECT_MESSAGES/001",
  "message": {
    "lang": "en",
    "value": "Message Text as defined in T100 message class."
  }

有关所有消息的详细信息均包含在错误详细信息块中:

      "errordetails": [
        {
          "code": "DMO_BUSINESSOBJECT_MESSAGES/001",
          "message": "Message text as defined in T100 message class.",
          "propertyref": "",
          "severity": "error",
          "transition": true,
          "target": ""
        },
        {
          "code": "DMO_BUSINESSOBJECT_MESSAGES/002",
          "message": "Second text as defined in T100 message class.",
          "propertyref": "",
          "severity": "success",
          "transition": true,
          "target": "to_Target"
        },
      ]

在此示例中,两个消息都具有属性 transition:true,表示它们被定义为转换消息(未在实施中定义 %state_area)。code 指示创建消息的消息类,数值反映在 T100 消息类中定义的消息标识符。第一个示例未绑定到目标 ,因为未定义属性 。第二条消息已分配给具有 _Target 组件的目标 %element。

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

← OData 中的消息 · OData V4 →