RAP + Fiori 实战 3:用注解完善 List Report

来源:SAP Tutorials《Refine the List Report with Annotations》 目标:通过 CDS 注解给 List Report 加列、筛选字段、排序、值帮助和状态颜色。 预计:30 分钟 | 难度:入门

前置条件

Step 1:创建 Metadata Extension

  1. 在 ADT 里右键投影视图 ZC_FE_TRAVEL_###### → New Metadata Extension。

  2. 文件名同样用 ZC_FE_TRAVEL_######,填描述,点 Next → Finish。

  3. 打开新文件,加入第一列 TravelID 的注解:

@Metadata.layer: #CORE
annotate view ZC_FE_TRAVEL_###### with
{
    @UI.lineItem: [{ position: 10 }]
    TravelID;
}
  1. 保存并 Activate;刷新应用预览,点 Go,应出现 Travel ID 列。

创建 metadata extension

Step 2:加更多列和筛选字段

在 metadata extension 里继续加列,position 控制顺序:

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

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

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

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

@UI.lineItem: [{ position: 60 }]
BookingFee;

@UI.lineItem: [{ position: 70 }]
TotalPrice;

@UI.lineItem: [{ position: 80 }]
OverallStatus;

@UI.lineItem: [{ position: 90 }]
LocalLastChangedAt;

再给三个字段加筛选栏:

@UI.lineItem: [{ position: 20 }]
@UI.selectionField: [{ position: 10 }]
AgencyID;

@UI.lineItem: [{ position: 30 }]
@UI.selectionField: [{ position: 20 }]
CustomerID;

@UI.lineItem: [{ position: 80 }]
@UI.selectionField: [{ position: 30 }]
OverallStatus;

保存、激活、刷新。列表应出现多列,筛选栏出现 Agency / Customer / Status。

加列和筛选字段

Step 3:加表头信息和默认排序

在 annotate view 上方加:

@Metadata.layer: #CORE

@UI: {
    headerInfo: {
        typeName: 'Travel',
        typeNamePlural: 'Travels'
    },
    presentationVariant: [{
        sortOrder: [{
            by: 'LocalLastChangedAt',
            direction: #DESC
        }],
        visualizations: [{
            type: #AS_LINEITEM
        }]
    }]
}

headerInfo 让表头显示 Travel/Travels 和记录数;presentationVariant 按最后修改时间倒序。保存激活后刷新,表头应显示 Travels 和记录数。

表头信息

Step 4:把 ID 显示成描述

打开投影视图 ZC_FE_TRAVEL_######(Core Data Services → Data Definitions),给字段加文本关联:

@EndUserText.label: 'Travel'
@ObjectModel.text.element: ['Description']
TravelID,

@EndUserText.label: 'Agency'
@ObjectModel.text.element: ['AgencyName']
AgencyID,
_Agency.Name as AgencyName,

@EndUserText.label: 'Customer'
@ObjectModel.text.element: ['LastName']
CustomerID,
_Customer.LastName as LastName,

@EndUserText.label: 'Status'
OverallStatus,

@EndUserText.label: 'Last Changed At'
LocalLastChangedAt,

保存激活,刷新应用:ID 列现在显示描述/名称,列标题也更友好。

ID 显示描述

Step 5:给 Status 加值帮助和颜色

  1. 给 OverallStatus 加值帮助(下拉选择),按原文的 @Consumption.valueHelpDefinition 注解。

  2. 加 criticality 注解,让状态按值显示红/黄/绿:

@UI: {
  lineItem: [{ position: 80, criticality: 'StatusCriticality' }],
  selectionField: [{ position: 30 }]
}
OverallStatus;
  1. 在视图里提供 StatusCriticality 计算字段(原文有完整 case 语句),保存激活。

  2. 刷新后检查:Status 有下拉帮助,列表中的状态有颜色。

状态颜色

下一步