通过文本关联获取文本

ABAP RESTful 应用程序编程模型 › 开发 › 开发通用功能 › 使用文本元素 › 通过文本关联获取文本

上下文

使用 CDS 文本关联,您可以定义元素(字段)与其相应文本或描述之间的关系。文本通常与语言相关,并以最终用户的语言显示。如果使用文本关联(如下所述)注释元素,则关联文本或描述字段将作为字段添加到参考实体。在运行时,从数据库读取此字段,并按 OData 使用者的登录语言自动过滤。无需在 CDS 视图中使用会话属性或视图参数。

要通过直接使用文本关联检索文本,请执行以下操作:

过程

  1. 使用用作文本提供者的 CDS 视图创建数据定义

    在文本提供者视图的元素级别需要以下注释,以注释语言键值元素和视图元素列表的文本元素:

    注释和值

    影响

    @Semantics.language: true

    注释元素标识语言字段。

    @Semantics.text: true

    将视图元素标识为文本元素(指向文本描述的字段)

    更多相关信息:CDS 注释

  2. 创建从使用者 CDS 视图到文本提供者视图的文本关联。

    创建文本关联时,以下 CDS 注释相关:

    注释和值

    影响

    @ObjectModel.text.association: '<_AssocToTextProvider>'

    与为注释元素提供描述性文本的文本视图的关联名称。换句话说: 注释指示使用文本关联 <_AssocToTextProvider> 提供注释元素的描述。

    更多相关信息:CDS 注释

    视图 /DMO/I_BookSuppl_T 用作文本提供者视图 /DMO/I_SupplText_T 的使用者。为此,定义与文本提供者视图作为目标的关联 _SupplementText。要指示应通过关联 _SupplementText 提供文本的字段,需添加注释 @ObjectModel.text.association。请注意,OData 公开只会考虑文本提供者中的第一个文本元素 (Description),使用 @Semantics.text: true 进行注释。在 Fiori 元素应用中,补充标识将与长文本一起显示在文本提供者视图的描述中。

    文本提供者视图 /DMO/I_SupplText_T

    define view /DMO/I_SupplText_T as select from /dmo/suppl_text as SupplementText
    
    {
      key SupplementText.supplement_id as SupplementID,
          @Semantics.language: true
      key SupplementText.language_code as LanguageCode,
          @Semantics.text: true
          SupplementText.description   as Description
          @Semantics.text: true
          SupplementText.alt_Description   as AlternativeDescription
    }
    

    文本消耗视图 /DMO/I_BookSuppl_T

    define root view /DMO/I_BookSuppl_T as select from /dmo/book_suppl as BookingSupplement
      association [1..*] to /DMO/I_SupplText_T as _SupplementText on $projection.supplement_id = _SupplementText.SupplementID
    {
      key travel_id,
      key booking_id,
      key booking_supplement_id,
          @ObjectModel.text.association: '_SupplementText'
          supplement_id,
    
          /* Associations */
          _SupplementText
    }