CDS 映射视图
ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › RAP 业务对象最佳实践 › 业务对象建模 › 业务服务 › 业务对象映射 › CDS 映射视图
映射视图提供特定服务中的方法,以定义服务特定的映射,包括基础数据模型的非规范化。不属于常规数据模型层的业务方案微调在映射视图中定义。例如,UI 注释、值帮助、计算或缺省设置。
CDS 映射视图在数据定义开发对象中定义。数据定义向导提供映射视图的模板。
对于 CDS 视图投影,将在投影视图中投影 CDS 元素的子集。这些元素可以使用别名,而映射会自动完成。这意味着,可以重命名元素以匹配相应投影的业务服务上下文。无法在映射视图中添加新的持久数据元素。只有基础数据模型中定义的元素,才能在投影中重用。但是,可以将虚拟元素添加到映射视图。这些元素必须通过 ABAP 逻辑计算。
您可以在投影视图中添加新的只读关联。这可能与在 UI 上显示附加信息(如图表等)相关。但是,无法在映射视图中非规范化新关联实体中的字段。无法通过事务访问新的关联实体。投影 CDS 视图中定义的关联(包括构成)可用于投影 CDS 视图。但是,如果同时投影目标 CDS 视图,关联或成分可能会更改其目标。这尤其与成分相关,因为预计了完整的数据模型,因此成分目标发生更改。对于更改的目标,必须将关联或组合重定向到新目标。投影视图附带新的语法元素,用于表示目标更改。
有关映射视图语法的详细信息,请参阅将视图实体定义为映射(ABAP 关键字文档)。
到投影视图的注释传播
在元素级别的投影实体中定义的注释,将完全传播到投影视图。这意味着,注释值在投影视图中保持不变。在投影视图中的相同元素上使用同一注释后,值将被覆盖,并且只有新值对相应元素有效。
如果在投影实体中使用带有元素引用的注释,并且引用元素在投影实体中具有别名,则由于名称更改,参考不会绘制到投影视图中的元素。在这种情况下,您必须在投影视图中重新定义注释,并在注释值中使用元素的别名。
示例
使用 @Semantics 注释在基础 CDS 视图中注释金额和货币元素,以支持元素的语义关系。
define root view /DMO/I_Travel
...
{
key travel_id,
...
@Semantics.amount.currencyCode: 'currency_code'
total_price,
@Semantics.currencyCode: true
currency_code,
...}
两个 @Semantics 注释都传播到投影视图。但是,元素 currency_code 在投影视图中具有别名,因此未建立对正确元素的引用。因此,关系已中断,并且可能的 OData 服务的元数据不会与此语义关系类似。
为避免这种情况,您必须参考别名元素重新注释金额元素。
define root view entity /DMO/C_Travel as projection on /DMO/I_Travel
...
{
key travel_id,
...
@Semantics.amount.currencyCode: 'CurrencyCode'
total_price as TotalPrice,
currency_code as CurrencyCode,
...}
在投影视图中定义 UI 细节
从设计时角度来看,投影层是第一个服务特定层。如果生成的 OData 服务是 UI 服务,则必须通过 CDS 注释在 CDS 投影视图中定义所有 UI 规范或其他服务特定注释。以下 UI 细节与映射业务对象层相关:
定义 UI 元素的位置、标签和构面的 UI 注释
搜索启用
文本元素(语言相关且独立)
值帮助
限制
在 ABAP RESTful 编程模型的当前版本中,CDS 映射视图只能用于项目 CDS 视图实体。不支持其他实体,例如自定义实体。