隐藏对象页面上的字段

ABAP RESTful 应用程序编程模型 › 开发 › 开发 UI 特定 › 定义元数据驱动的 UI 的 CDS 注释 › 对象页面 › 隐藏对象页面上的字段

如何使用 CDS 中的 UI 注释在 UI 中隐藏字段而不将其删除。

快捷信息

注释语法

@UI.hidden: true

描述

隐藏对象页面中的字段,但不将其删除。

使用

置于代码的元素列表部分,在相应元素之前。

相关主题

UI 上的字段 CDS 注释

上下文和使用

通常,OData 服务公开的所有字段均可用于客户端,无论这些字段是否使用 UI 注释显式公开。要启用最终用户个性化设置,客户端可能提供添加隐藏以供 UI 使用的字段的可能性,例如在对象页面上的构面中。使用注释 @UI.hidden 防止字段显示在 UI 和个性化对话框中,但使字段可用于 WebAPI 客户端。

例如,如果 CDS 视图包含必须向 OData 服务公开才能使用的技术键值(例如 GUID),也可以使用此注释。通常不应在 UI 上显示这些键值。@UI.hidden: true 在计算中需要字段但不应该显示在 UI 上时也很有用。如果要动态隐藏字段,例如,如果您希望仅在字段具有正值时显示字段,则隐藏字段尤其有用。

请注意,您也可以使用 @UI.hidden: true 标注清单报表的字段。但是,这只会取消选择注释字段作为列,而不会将其完全隐藏。这实际上与最初没有用 @UI.lineItem 注释 元素相同。

将注释放在 CDS 数据定义或元数据扩展的元素列表部分中,紧邻相应元素的前面。

有关详细信息,请参阅 CDS 注释。

代码片段

在此示例中,预订费不应显示给用户,但可能需要用于计算总价。

在完整 UI 注释示例代码中查找差旅场景的元数据扩展文件。

annotate view ...

{
...
// ELEMENT LIST
...
  @UI: { hidden: true }
  BookingFee;

  @UI: { identification: [ { position: 43 } ] ,
         fieldGroup:     [ { qualifier: 'Fieldgroup2',
                             position: 10 } ] }
  TotalPrice;
...
}

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

← 使用构面更改对象页面布局 · 在对象页面上动态隐藏字段 →