显示不可读元素的文本
ABAP RESTful 应用程序编程模型 › 开发 › 开发应用程序 › 开发只读列表报表应用 › 改善用户体验 › 显示不可读元素的文本
使用文本关联将可读文本添加到短表单或标识符。
存储在数据库中的数据会尽可能短,因此,许多单词会用字符代码缩短或缩写。虽然这很方便,但从用户角度来说,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 实施文本关联。文本关联始终在接口视图级别定义,并由使用或映射视图隐式继承。
过程
打开 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, ... }
打开要使用
/DMO/I_Connection_R的 CDS 视图Name。使用AirlineID上的连接条件实施与 CDS 视图/DMO/I_Carrier的关联。在元素
@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, }
还针对
/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 }
打开您还想要显示其文本的 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 字段标签和描述 · 为选择字段提供值帮助 →