UI 上的状态消息
ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › 消息 › 通用消息实施 › 状态消息 › UI 上的状态消息
本主题显示状态消息与 UI5 一起显示。
UI 上的状态消息
消息的表示取决于 UI 技术,以下屏幕截图特定于 UI5,在其他情况下,消息表示可能会有所不同。
状态消息显示在消息弹出窗口中,并在业务对象状态发生更改之前一直保留。如果将消息分配到 %ELEMENT 中的字段 ,则以严重性颜色对相应字段进行框架化,以说明字段值和消息之间的链接,以改善用户体验。
以下示例从被管理场景的 validateDates 方法的实施中提取。此验证检查开始日期是否早于结束日期。由于验证是指业务对象的状态,因此使用 %state_area 填充 'VALIDATE_DATES' 组件。如果在同一实施中实施多个状态消息,则建议对所有 %state_area 定义使用相同的值。
对于此验证,定义了两个目标元素 %element-BeginDate 和 %element-EndDate,因为这些字段值在验证中进行检查。在这种情况下,类 /dmo/cm_flight_home 用作消息包装类。消息文本所需的特定消息标识和相应变量包含在 end_date_before_begin_date 常量中。对于此消息,begin_date(类型 DATS)。end_date(类型 DATS)和 travel_id(字符串类型)作为消息变量传递。消息严重性定义为错误,指示用户必须针对不正确的值更改日期。消息分配到差旅实体的报告结构:
APPEND VALUE #( %tky = ls_travel_result-%tky
%state_area = 'VALIDATE_DATES'
%msg = NEW /dmo/cm_flight_home( textid = /dmo/cm_flight_home=>end_date_before_begin_date
begin_date = ls_travel_result-begindate
end_date = ls_travel_result-enddate
travel_id = ls_travel_result-travelid
severity = if_abap_behv_message=>severity-error )
%element-begindate = if_abap_behv=>mk-on
%element-enddate = if_abap_behv=>mk-on ) TO reported-travel.
如果日期不正确,则在用户尝试保存差旅实例后,状态消息将呈现如下:
定义的目标元素以红色框住,以指示消息和相应字段之间的链接。验证结果作为状态消息显示在左下方的消息框中。定义的消息长度超过短文本的最大长度,并自动显示在长文本视图中,以便完整文本可供用户读取。消息分配到具有标签已管理 - 使用语义键值的行程的差旅实体 - 消息的标题始终派生自消息分配到其报告结构的业务对象标签。此外,状态消息使用户可以在消息和受影响字段之间进行导航。相应消息随即显示在受影响字段的底部: