定义元数据驱动的 UI 的 CDS 注释
ABAP RESTful 应用程序编程模型 › 开发 › 开发 UI 特定 › 定义元数据驱动的 UI 的 CDS 注释
如何在 CDS 中使用 UI 注释解决最常见的 UI 布局任务。
前提条件
为了使用本帮助章节,您应该熟悉:
CDS 视图和 CDS DDL(数据定义语言)
设置数据定义、服务绑定和服务定义
使用 ABAP 开发工具 (ADT)
要使用示例代码,请下载 ABAP 航班参考场景。
上下文
为了使 UI 正常工作,您无需自己实施所有内容。如果在服务绑定中使用 Fiori 元素应用预览 (FEAP),RAP 将自动处理 UI 的赤字。例如,根页面将具有具有排序和过滤功能的抬头和清单报表(表)构面,即使您没有在 CDS 中实施任何 UI 注释。此外,UI 还将包括共享按钮和基本视图管理器。
备注
要在 UI 上查看数据库条目而不实施任何 UI 注释,请单击 UI 上的齿轮图标并选择至少一列。
常见问题
此常见问题会引导您找到首次使用元数据驱动的 UI 时经常出现的正确问题主题。
源代码结构
您可以在数据定义或元数据扩展文件中使用 UI 注释。
备注
我们建议您为所有 UI 注释使用元数据扩展文件,因为这将提高源代码在数据定义中的易读性,并简化 CDS 视图的开发和维护。元数据扩展还允许对多个元数据扩展进行分层,这在客户、合作伙伴和行业同时使用具有不同定制需求的业务对象时非常有用。
您的代码将包含以下部分:
抬头部分
标注/定义视图部分
构面定义
元素列表
个字段
关联
有关所有部分和正确语法的完整概览,请参阅以下代码片段。
在完整 UI 注释示例代码中查找差旅场景的元数据扩展文件。
展开以下代码示例以查看源代码
示例代码
// HEADER SECTION
@Metadata.layer: ...
@UI.headerInfo: ...
// ANNOTATE VIEW SECTION
annotate/define view ...
{
// FACET DEFINITIONS
// Header Facets (Object Page):
@UI.facet: [ { purpose: #HEADER, ... },
// Body Facets (Object Page)
{ ... } ]
// ELEMENT LIST
// FIELDS
@UI: { lineItem: [ { ... } ],
identification: [ { ... } ],
selectionField: [ { ... } ],
fieldGroup: [ { ... } ] }
element_1;
@UI: { lineItem: [ { ... } ],
identification: [ { ... } ],
selectionField: [ { ... } ],
fieldGroup: [ { ... } ] }
element_2;
...
// ASSOCIATIONS
_Association1
}