定位字段

ABAP RESTful 应用程序编程模型 › 开发 › 开发 UI 特定 › 定义元数据驱动的 UI 的 CDS 注释 › UI 上的字段 › 定位字段

如何使用 CDS 中的 UI 注释重新排列字段。

快捷信息

注释语法

@UI.identification: [{position: <value>}]

描述

按照 position 值的顺序对字段进行排序。

使用

置于代码的元素列表部分,在每个相应元素之前。

相关主题

UI 上的字段 CDS 注释

注释语法

@UI.lineItem: [ { position: <value> } ]

描述

按 'position' 值的顺序对字段(即表列)进行排序。

使用

置于代码的元素列表部分,在每个相应元素之前。

相关主题

UI 上的字段 CDS 注释

Fiori UI 上的预览

UI 标识字段按对象页面上的头寸值顺序排序

UI 行项目字段按清单报表中的头寸值顺序排序

上下文和使用

将注释放在 CDS 数据定义或元数据扩展的元素列表部分中,紧邻相应元素的前面。position 的值是相对的,这意味着 UI 上元素的顺序由每个元素的 position 的值的相对顺序定义。

我们建议您在 position 的相应值之间留有间隔。这将使在其他两个元素之间回溯添加元素更加容易,因为您无需更改所有其他元素的 position 值。

子注释 position 可以与以下注释以类似的方式使用:

UI.facet UI.fieldGroup UI.identification UI.lineItem UI.selectionField UI.statusInfo

您可以在 CDS 注释中找到有关此内容的更多详细信息。

代码片段

在此示例中,我们使用 @UI.identification.position 在对象页面上使用类型 #IDENTIFICATION_REFERENCE 定义构面中标识字段的顺序。同样,我们使用注释 @UI.lineItem.position 定义列表报表的字段(即列)的顺序。

您可以在完整 UI 注释示例代码中找到差旅场景的元数据扩展文件。

展开以下代码示例以查看视图 Z_C_TRAVEL_R 注释的源代码。

...
annotate view Z_C_TRAVEL_R with

{
  ...
  // Body Facets (Object Page)
  ...
       // Facet 3

             { id:              'Facet3-ID',
               purpose:         #STANDARD,
               type:            #IDENTIFICATION_REFERENCE, // Refers to elements annotated with '@UI.identification' in the element list below
               label:           'Facet 3 - Overview and Comments',
               position:        30 }
             ]

  // ELEMENT LIST

  @UI: { lineItem:       [ { position: 10 } ],
         identification: [ { position: 10 } ]
       }
  TravelID;

  @UI: { lineItem:       [ { position: 20 } ],
         identification: [ { position: 20 } ]
       }
  AgencyID;

  @UI: { lineItem:       [ { position: 30 } ],
         identification: [ { position: 30 } ]
       }
  CustomerID;

  @UI: { lineItem:       [ { position: 40 } ],
         identification: [ { position: 40 } ]
       }
  BeginDate;

  @UI: { lineItem:       [ { position: 50 } ],
         identification: [ { position: 50 } ]
       }
  EndDate;

  @UI: { hidden: true,
         identification: [ { position: 80 } ] }
  BookingFee;

  @UI: { identification: [ { position: 60 } ] }
  TotalPrice;

  @UI: { identification: [ { position: 70,
                             label: 'Comment' } ]
       }
  Memo;

  @UI: { lineItem:      [ { position: 60,
                            label: 'Set to Booked' } ]
  Status;
}

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

← 覆盖默认字段标签 · 分组字段 →