显示不可读元素的文本

ABAP RESTful 应用程序编程模型 › 开发 › 开发应用程序 › 开发只读列表报表应用 › 改善用户体验 › 显示不可读元素的文本

使用文本关联将可读文本添加到短表单或标识符。

存储在数据库中的数据会尽可能短,因此,许多单词会用字符代码缩短或缩写。虽然这很方便,但从用户角度来说,UI 标签上的问题无法理解。以转机中的航空公司代码为例:名称不是人工可读的,不提供有关实际标签的任何信息。

缺省情况下,航空公司缩写为两个字母的航空公司代码。

UI 中的航空公司代码不可读

航空公司的全名包含在基于数据库 /DMO/I_Carrier 的 CDS 视图 /DMO/carrier 中。使用文本关联,您可以建立从连接 CDS 视图到运输公司 CDS 视图的链接,并采用航空公司的名称作为 UI 中航空公司代码的补充。

您需要使用 @semantics 和 @ObjectModel 域中的注释将名称标记为可读文本,并将附加文本分配到航空公司代码元素。

对于出发机场和目的地机场也是如此。全名对 用户更有用,而不是缩写。为了显示出发和目的地机场名称,文本视图 /DMO/I_Airport 用于不同的连接条件。使用 on $projection.DepartureAirport = _AirportFrom.AirportID 定义出发机场,使用 on $projection.DestinationAirport = _AirportTo.AirportID 定义目的地机场。

有关文本元素的更多详细信息,请参阅使用文本元素。

通过文本关联获取航空公司名称

前提条件

文本提供者视图已存在。在我们的案例中,CDS 视图 /DMO/I_Carrier 包含相关文本元素 Name。

上下文

航空公司的可读名称可以与两个字母代码一起显示在 UI 上。文本应显示在列表报表页面和对象页面上,以保持用户体验一致。为此,您需要为视图 /DMO/I_Connection_R 和 /DMO/I_Flight_R 实施文本关联。文本关联始终在接口视图级别定义,并由使用或映射视图隐式继承。

过程

  1. 打开 CDS 视图 /DMO/I_Carrier。使用元素 @Semantics.text: true 上的注释 Name 将注释元素标识为文本并激活视图。

    ...
    define view entity /DMO/I_Carrier
      as select from /dmo/carrier as Airline
    
    {
      key Airline.carrier_id    as AirlineID,
    
          @Semantics.text: true
          Airline.name          as Name,
    
          Airline.currency_code as CurrencyCode
    }
    

    备注

    通常,您可以将多个视图字段注释为文本字段。但是,在 OData 公开的文本使用者视图中仅考虑第一个注释字段。

    /DMO/I_Airport 的注释方式与 @Semantics.text:true 相同:

    @AccessControl.authorizationCheck: #NOT_REQUIRED
    @EndUserText.label: 'Airport View - CDS Data Model'
    
    @Search.searchable: true
    
    define view entity /DMO/I_Airport
      as select from /dmo/airport as Airport
    
    ...
    {
          ...
    
          @Semantics.text: true
          @Search.defaultSearchElement: true
          @Search.fuzzinessThreshold: 0.8
          Airport.name       as Name,
    
          ...
    }
    
  2. 打开要使用 /DMO/I_Connection_R 的 CDS 视图 Name。使用 AirlineID 上的连接条件实施与 CDS 视图 /DMO/I_Carrier 的关联。

  3. 在元素 @ObjectModel.text.association: '<_AssocToTextProvider>' 上使用注释 AirlineID 并引用关联 _Airline 作为文本关联。然后激活 CDS 视图。

    ...
    define view entity /DMO/I_Connection_R
      as select from /dmo/connection as Connection
    
      ...
      association [1]    to /DMO/I_Carrier  as _Airline     on  $projection.AirlineID = _Airline.AirlineID
    {
            @ObjectModel.text.association: '_Airline'
      key   Connection.carrier_id      as AirlineID,
      key   Connection.connection_id   as ConnectionID,
    
            /* Associations */
            _Flight,
            _Airline,
    }
    
  4. 还针对 /DMO/I_Airport 实施关联以获取出发和到达机场名称。使用 @ObjectModel.text.association 对 Connection.airport_from_id as DepartureAirport 字段和 Connection.airport_to_id as DestinationAirport 字段进行标注。

    源代码

      ...
    define view entity /DMO/I_Connection_R
      as select from /dmo/connection as Connection
    
      ...
    
      association [1]    to /DMO/I_Carrier  as _Airline     on  $projection.AirlineID = _Airline.AirlineID
      association [1]    to /DMO/I_Airport  as _AirportFrom on  $projection.DepartureAirport = _AirportFrom.AirportID
      association [1]    to /DMO/I_Airport  as _AirportTo   on  $projection.DestinationAirport = _AirportTo.AirportID
    
    {
            @ObjectModel.text.association: '_Airline'
      key   Connection.carrier_id      as AirlineID,
      key   Connection.connection_id   as ConnectionID,
    
            @ObjectModel.text.association: '_AirportFrom'
            Connection.airport_from_id as DepartureAirport,
    
            @ObjectModel.text.association: '_AirportTo'
            Connection.airport_to_id   as DestinationAirport,
    
            Connection.departure_time  as DepartureTime,
            Connection.arrival_time    as ArrivalTime,
    
            ...
    
            /* Associations */
            _Flight,
            _Airline,
            _AirportFrom,
            _AirportTo
    }
    
  5. 打开您还想要显示其文本的 CDS 视图 /DMO/I_Flight_R。在元素 @ObjectModel.text.association: '<_AssocToTextProvider>' 上使用注释 AirlineID 并引用关联 _Airline 作为文本关联。然后激活 CDS 视图。

    ...
    define view entity /DMO/I_Flight_R
      as select from /dmo/flight as Flight
    
      association [1]    to /DMO/I_Carrier_R as _Airline on  $projection.AirlineID = _Airline.AirlineID
    {
    ...
          @ObjectModel.text.association: '_Airline'
      key Flight.carrier_id       as AirlineID,
    ...
    /*Association*/
          _Airline
    }
    

结果

您已从两个 CDS 视图建立文本关联,其中包含两个字母的航空公司代码以及出发和到达机场名称。文本来自文本提供者视图,并显示在用户界面中,以及两个字母的代码和机场缩写。现在,航空公司可通过其全名明确识别。

Related Information

使用文本元素

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

← 更改 UI 字段标签和描述 · 为选择字段提供值帮助 →