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 →