为选择字段提供值帮助

ABAP RESTful 应用程序编程模型 › 开发 › 开发应用程序 › 开发只读列表报表应用 › 改善用户体验 › 为选择字段提供值帮助

使用值帮助可以更轻松地在 UI 上找到选择字段的正确值。

您已为 UI 创建一些选择字段,使用户能够在航班应用中找到合适的航班。抬头的选择字段使用 UI.selectionField 进行定义,例如 AirlineID。

困难是知道正确的三个字母的机场代码,以确定航班的正确出发或目的地机场。您可以启用值帮助选项以帮助用户查找正确的值。然后,用户可以直接访问值帮助对话框,他们可以在其中输入值,例如城市名称或国家/地区代码,以查找合适的机场代码。

UI 为最终用户提供值帮助对话框,其中多个值帮助字段可帮助最终用户找到输入字段的正确值。

为值帮助添加注释

前提条件

值帮助提供者视图已存在。在我们的案例中,CDS 视图 /DMO/I_Airport 包含相关字段 Name、City 和 CountryCode 以帮助查找机场代码。

上下文

要为 CDS 视图 /DMO/C_Connection_R 中元素 Departure Airport Code 和 Destination Airport Code 的选择字段提供值帮助,请使用注释 @Consumption.valueHelpDefinition。

过程

  1. 打开 CDS 视图 /DMO/C_Connection_R。

  2. 对元素 Departure Airport Code 和 Destination Airport Code 进行注释。您想要为这些元素提供带有注释的值帮助对话框 @Consumption.valueHelpDefinition: [{ entity: { name: '<target_view>' , element: '<target_element>' }}]. 在我们的案例中,目标视图是/DMO/I_Airport_StdVH 目标元素 AirportID,其用作源视图中两个元素的绑定条件。附加项 useForValidation: true 标记用于验证用户输入的值帮助。根据值帮助中包含的值自动检查用户输入。

    {...
          @Consumption.valueHelpDefinition: [{ entity: {name: '/DMO/I_Airport_StdVH', element: 'AirportID' }, useForValidation: true }]
          ...
          DepartureAirport,
          _AirportFrom.Name                                              as DepartureAirportName,
    
          ...
          @Consumption.valueHelpDefinition: [{ entity: {name: '/DMO/I_Airport_StdVH', element: 'AirportID' }, useForValidation: true }]
          DestinationAirport,
          _AirportTo.Name                                                as DestinationAirportName,
    …}
    
  3. 激活 CDS 视图。

结果

您已为参考机场代码元素的 选择字段 实施值帮助。现在,您可以使用带有选项的值帮助对话框来使用值帮助提供者视图 /DMO/I_Airport_StdVH 的所有元素来查找正确的三个字母的机场代码。此外,选择字段现在配有值完成选项。这意味着,开始在选择字段中输入后,将显示可能的值。

Related Information

CDS 注释

添加值帮助

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

← 显示不可读元素的文本 · 添加搜索功能 →