添加 UI 使用的 UI 元数据

ABAP RESTful 应用程序编程模型 › 开发 › 开发应用程序 › 使用多行编辑功能开发事务应用 › 预测 UI 敞口的业务对象 › 投影业务对象数据模型 › 添加 UI 使用的 UI 元数据

对于多行编辑场景,在业务对象实体的元数据扩展中定义 UI 注释。

上下文

Fiori 元素 UI 的布局主要可以在具有 @UI 注释的 RAP BO 中定义。然后,这些 UI 注释将与 UI 服务的元数据一起公开,并应用于定义 UI。最佳实践是在元数据扩展中维护 UI 相关注释。

过程

为载体业务对象中的每个映射视图创建元数据扩展。在 ADT 中,右键单击数据定义以打开元数据扩展的创建向导。

元数据扩展 /DMO/C_CARRIERSLOCKSINGLETON_S

将元数据扩展定义为 CDS 映射视图 /DMO/C_CARRIERSLOCKSINGLETON_S 的扩展。

定义层 #CORE。

由于承运方业务对象的根视图只有一个实例,因此 Fiori 元素的清单报表页面的 UI 布局只有有限的布局要求。

要指定 Fiori UI 的抬头文本,请在实体级别使用注释 @UI.headerInfo。它指定列表标题以及对象页面的标题。

UI 的主要构件块指定为 UI 构面。使用 @UI.facet 注释为根视图定义构面,并通过定义目标元素定义到对象页面的导航。

有关 UI 布局配置的详细信息,请参阅定义元数据驱动的 UI 的 CDS 注释。

展开以下代码示例以查看元数据扩展的源代码 /DMO/C_CarriersLockSingleton_S。

示例代码

@Metadata.layer: #CORE

@UI: { headerInfo: { typeName: 'Manage Carriers',
                     typeNamePlural: 'Carrier Singleton',
                     title: { type: #STANDARD, value: 'CarrierSingletonID' } } }

annotate entity /DMO/C_CarriersLockSingleton_S
  with
{
  @UI.facet: [

  {
    purpose:  #STANDARD,
    type:     #LINEITEM_REFERENCE,
    label:    'Carrier Multi Inline Edit',
    position: 10,
    targetElement: '_Airline'
  }
  ]

  @UI.lineItem: [{ position: 10 }]
  CarrierSingletonID;
}

元数据扩展 /DMO/C_CARRIER_S

将元数据扩展定义为 CDS 映射视图 /DMO/C_CARRIER_S 的扩展。

定义层 #CORE。

与在根视图的元数据扩展中一样,将抬头信息、指示对象页面上列表的构面指定为 identification_reference,并将元素的位置指定为行项目和标识。

有关 UI 布局配置的详细信息,请参阅定义元数据驱动的 UI 的 CDS 注释。

展开以下代码示例以查看元数据扩展的源代码 /DMO/C_Carrier_S。

示例代码

@Metadata.layer: #CORE

@UI: { headerInfo: { typeName:       'Carrier',
                     typeNamePlural: 'Carriers',
                     title:          { type: #STANDARD,
                                       label: 'Airline',
                                       value: 'AirlineID' } } }
annotate entity /DMO/C_Carrier_S
  with
{
  @UI.facet: [{ type: #IDENTIFICATION_REFERENCE }]

  @UI.lineItem: [{ position: 10 }]
  @UI.identification: [{ position: 10 }]
  AirlineID;

  @UI.lineItem: [{ position: 20 }]
  @UI.identification: [{ position: 20 }]
  Name;

  @UI.lineItem: [{ position: 30 }]
  @UI.identification: [{ position: 30 }]
  CurrencyCode;
}

来源:SAP Help Portal · 2025 FPS02 (Oct 2026) · 中文为 SAP 官方机器翻译

← 投影业务对象数据模型 · 预测业务对象行为 →