更改 UI 字段标签和描述

ABAP RESTful 应用程序编程模型 › 开发 › 开发应用程序 › 开发只读列表报表应用 › 改善用户体验 › 更改 UI 字段标签和描述

字段标签和描述有助于定制应用的 UI。

对显示在用户界面上的元素进行有意义的描述,是使用应用和改善用户体验的关键概念。UI 上的所有项目对于用户都是可读和可理解的,这一点至关重要。尽管 ABAP 字典中的每个数据元素都标有在 UI 上显示的描述,但有时您想要修改特定用例的描述,并为其提供持久数据库层上预定义的名称以外的名称。在 CDS 层中,可以使用注释 @EndUserText.label: '<text>' 和 @EndUserText.quickInfo: '<text>' 重新定义数据库描述标签并提供更多信息。

在 CDS 层中分配的标签将覆盖数据库字段描述,并向 OData 服务公开。如果不存在覆盖 CDS EndUserText 注释的贴标签注释 UI 则这些标签也会传播到 UI 并在用户界面上显示。

备注

UI 标记注释(如 @UI.lineItem: [ { label: '' } ])会覆盖 UI 上的任何 @EndUserText 标记注释。但是,它们不会显示在 OData 服务元数据中。

工具提示可以为元素提供附加或更全面的信息。工具提示以鼠标悬停在文本上显示在 UI 上。如果未使用 @EndUserText 注释,则从存储在 ABAP 字典中的数据元素的详细描述中检索鼠标悬停功能的文本。

通常,SAP 翻译流程会将 EndUserText 注释中使用的每个文本以及提供给数据元素的标签翻译成每种相关语言。

有关如何在数据模型中集成用户信息的更多信息,请参阅添加字段标签和描述以及覆盖默认字段标签。

集成鼠标悬停功能

如果需要有关元素的附加且更长的信息,可以使用注释 @EndUserText.quickInfo: <text> 在将鼠标悬停在元素上时显示文本。

备注

如果未在 CDS 中定义工具提示,则将鼠标悬停在文本上将显示 ABAP 字典中数据元素的简短描述。

要将鼠标的文本更改为上方,请使用工具提示。

示例

      @UI: {
      lineItem: [ { position: 10, label: 'Airline' } ],
      identification:[ { position: 10, label: 'Airline' } ] }
      @EndUserText.quickInfo: 'Airline that operates the flight.'
  key Connection.carrier_id       as AirlineID,

将鼠标悬停在显示的 CDS 注释工具提示上