将 CDS 视图作为数据模型实施

ABAP RESTful 应用程序编程模型 › 启动 › 为简单列表报告开发 OData 服务 › 使用 CDS 定义数据模型 › 将 CDS 视图作为数据模型实施

使用预定义的数据库表作为 CDS 视图的数据源。

前提条件

  • 您已在 ABAP 开发工具中创建数据定义部件。

  • 数据库表 /dmo/connection 可供您使用。

上下文

在此步骤中,使用预定义的数据源将接口视图作为新的数据模型实施。

过程

  1. 如果尚未执行此操作,请在编辑器中打开新数据定义。

  2. 指定 CDS 视图的名称: /DMO/I_Connection_R 。数据定义编辑器已使用您在创建向导中为数据定义指定的名称,为名称提供建议。但是,这些名称不必相同。可以在 define 语句中将其覆盖。

  3. 在 SELECT 语句中,输入预定义的数据库表 /dmo/connection 作为数据源,并为数据源定义可选别名。

    在使用多个数据源或数据源名称没有描述性或过长时,别名尤其有用。

    ... select from /dmo/connection as Connection{

  4. 将 /dmo/connection 的字段添加到 SELECT 列表,并为每个项目字段分配别名,如下所示:

    {
      Connection.carrier_id      as AirlineID,
      Connection.connection_id   as ConnectionID,
      Connection.airport_from_id as DepartureAirport,
      Connection.airport_to_id   as DestinationAirport,
      Connection.departure_time  as DepartureTime,
      Connection.arrival_time    as ArrivalTime,
      Connection.distance        as Distance,
      Connection.distance_unit   as DistanceUnit
    }
    

    提示

    无论何时在 SELECT 列表中插入表字段或视图元素,都可以在数据定义编辑器中使用内容辅助功能 (CTRL + SPACE)。

    使用语义自动完成插入字段

  5. 要记录新数据模型的关键语义,请在当前 CDS 视图中将 AirlineID 和 ConnectionID 元素定义为 KEY 元素:

      key connection.carrier_id     as AirlineID,
      key connection.connection_id  as ConnectionID,
    
  6. 将权限检查更改为 "NOT_REQUIRED"。

  7. 单击激活按钮 或使用快捷方式 Ctrl + F3 激活数据定义。

    要在激活前检查语法,请单击 或使用快捷方式 Ctrl + F2。

结果

CDS 视图生成的源代码如下:

@AccessControl.authorizationCheck: #NOT_REQUIRED
@EndUserText.label: 'Read-Only E2E: Data Model Connection'
define view entity /DMO/I_Connection_R
  as select from /dmo/connection as Connection
{
  key Connection.carrier_id      as AirlineID,
  key Connection.connection_id   as ConnectionID,
      Connection.airport_from_id as DepartureAirport,
      Connection.airport_to_id   as DestinationAirport,
      Connection.departure_time  as DepartureTime,
      Connection.arrival_time    as ArrivalTime,
      Connection.distance        as Distance,
      Connection.distance_unit   as DistanceUnit
}

上述源代码用于定义名为 /DMO/I_Connection_R 的相当简单的 CDS 视图。此视图使用执行 SELECT 语句的查询实施,其中数据库表 /dmo/connection 用作数据源。选择列表包括一组与场景相关的字段。选择列表中的 KEY 元素用于定义 CDS 视图的关键字段语义。

激活数据定义源后,将在 ABAP 字典中创建 CDS 视图 /DMO/I_Connection_R 的实体。

后续步骤

将元素 Distance 标记为语义上与元素 DistanceUnit 相关。

与语义相关的元素相关

使用 @Semantics 注释将数量元素与其计量单位元素相关联。

上下文

您创建的 CDS 视图 /DMO/I_Connection_R 包含在语义上高度依赖于彼此的元素,即 Distance 和 DistanceUnit。在 CDS 中,您可以使用语义注释来标准化对这些元素的使用者端有影响的语义。通常,需要标记为具有语义内容的元素可确保正确处理它们是包含以下内容的元素:

  • 货币金额

    这些元素需要参考与此元素相关的货币。

  • 度量金额

    这些元素需要参考与此元素相关的计量单位。

如果您创建的注释定义了指向量值单位的链接,则金额及其单位始终作为 OData 服务中的相互依赖进行处理。特别是,在 UI 上,金额显示时带有与其单位相关的正确小数。

因此,在 CDS 视图 /DMO/I_Connection_R 中,您需要按照以下所述进行操作,以始终将距离与距离单位一起显示。

过程

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

  2. 在 Distance 上使用注释 @Semantics.quantity.unitOfMeasure: '<ElementRef> 定义金额和计量单位之间的关系,并引用元素 DistanceUnit。

          @Semantics.quantity.unitOfMeasure: 'DistanceUnit'
          Connection.distance        as Distance,
    
          Connection.distance_unit   as DistanceUnit
    
  3. 激活 CDS 视图。

结果

如果将 CDS 视图公开到 OData 服务,则元素始终在语义上彼此相关时处理。这意味着它们在 OData 元数据文档中获得 OData 注释 sap:unit 和 sap:semantics。特别是,在 UI 上,元素始终显示为彼此附加。