SAP学习笔记 - 开发46 - RAP开发 Managed App Metadata Extension 2 - Booking_M，BookSuppl_M

上一章讲了 RAP开发中，New Service Definition，Metadata Extension，在Metadata 文件中 复习了 lineItem，selectionField，Search，ObjectModel，Value Help，headerInfo 等内容。

SAP学习笔记 - 开发45 - RAP开发 Managed App New Service Definition，Metadata Extension-CSDN博客

本章继续学习RAP相关的知识，将其他两个表的Metadata 也做一下：

- Booking_M

- BookSuppl_M

目录

1，Booking_M 

1-1，New Metadata Extension - Z04_PV_Booking_M

1-2，@Metadata.allowExtensions: true - Z04_PV_Booking_M

1-3，@UI.facet - Z04_PV_Travel_M

1-4，@UI:{ lineItem / identification - Z04_PV_Booking_M

1-5，@UI.headerInfo / @UI.facet - Z04_PV_Booking_M

2，BookSuppl_M

2-1， New Metadata Extension - Z04_PV_BookSuppl_M

2-2，@UI.headerInfo / @UI.facet - Z04_PV_BookSuppl_M

3，完整的代码（Metadata）和页面截图

3-1，Travel_M_MD

3-2，Booking_M_MD

3-3，BookSuppl_M_MD

4，Travel_M_MD 其他功能

4-1，@UI.textArrangement: #TEXT_ONLY - Z04_PV_Travel_M_MD

a，@UI.textArrangement 的选项

b，使用示例

1. 在 CDS View 中定义

2. 效果对比

c，注意事项

d，常见问题

5，Booking_M_MD 其他功能

5-1，Search

5-2，@UI.textArrangement: #TEXT_ONLY - Z04_PV_Booking_M_MD

---

以下是详细内容。

1，Booking_M 

上一章做了Travel_M 的开发，本章继续做剩下两个表的开发。

- New Service Definition 

- Metadata Extension：lineItem，identification，Value Help，headerInfo 等

这一章想要干啥呢？ 

- 显示 Travel 一览

  这个上一章已经做好了

- 点任意行，显示Object Page

  在这个位置，将会显示Booking 列表，因为Travel - Booking 是1：N的关系

- 点击 上图Booking 列表里的任意一行，显示 Booking的Object Page

-  Booking的Object Page 里面，将会显示Booking的明细，以及 1：N的Booking Supplement 列表

- 点击Booking Supplement 列表的任意一行，将会显示 Object Page

- Object Page里面，将会显示 Booking Supplement详细内容

也就是把咱之前做的3个表给串起来，一层一层的都可以参考。

（Metadata的代码，后面一并附上，可以拖到后面参考）

1-1，New Metadata Extension - Z04_PV_Booking_M

输入Name，Description，Extended Entity，然后按Next

 

选模板，然后点Finish

 

里面先不加任何东西，这样就会显示为空，然后我们后面再慢慢加

 

1-2，@Metadata.allowExtensions: true - Z04_PV_Booking_M

加了这行才会允许使用Metadata文件

 

1-3，@UI.facet - Z04_PV_Travel_M

 

刷新一下，就是下面这个样子

 

1-4，@UI:{ lineItem / identification - Z04_PV_Booking_M

设定列表中的显示项目，以及Object Page显示项目

TODO: 出了个Blocker错误，说Bookings 那块儿没数据可以显示，找了半天也没看出出来为啥

No items available.
If any exist, they will be displayed here.

利用可能なアイテムがありません

存在する場合は、ここに表示されます。

 

如果单独看 Booking_M 的话，是可以查出来数据的呀

 

查了半天，我发现了确实是数据问题，好像用错表了😓。

这也是往新建的表里插入数据的方法不同导致的。

-1 我用的方法：参照下面这种，直接把数据放内表里， 然后Insert

SAP学习笔记 - 开发37 - RAP开发流程的具体步骤， 建表，Data Model View，Projection View，Service，Service Binding，Publish-CSDN博客

    DATA itab TYPE TABLE OF zt04_travel_m.itab = VALUE #(( CLIENT = '100' TRAVEL_ID = '00005172' BOOKING_ID = '0001' BOOKING_DATE = '20250703' CUSTOMER_ID = '000563' CARRIER_ID = 'LH' CONNECTION_ID = '0400' FLIGHT_DATE = '20250712' FLIGHT_PRICE = '1540.00 ' CURRENCY_CODE = 'EUR' BOOKING_STATUS = 'N'
LAST_CHANGED_AT = '20250625051010.0000000 '  )( 第二条数据 )...) ##NO_TEXT .DELETE FROM zt04_travel_m.INSERT zt04_travel_m FROM TABLE @itab.

 -2 这次因为是从/DMO 中的表，原封不动拷贝过来，数据也要拷过来，所以用下面这种较好

    DELETE FROM zt04_Travel_m.DELETE FROM zt04_booking_m.DELETE FROM zt04_bookSuppl_m.INSERT zt04_Travel_m FROM ( SELECT * FROM /dmo/travel_m ).INSERT zt04_booking_m FROM ( SELECT * FROM /dmo/booking_m ).INSERT zt04_Booksuppl_m FROM ( SELECT * FROM /dmo/booksuppl_m ).Commit work.

那么 第1种有啥问题呢？/DMO里除了 /dmo/travel_m 以外，还有/dmo/travel，那可不容易用错

而要是用SQL，那基本上不会错，而且简单：）

大念三遍【所有事情的发生都必然有其目的，并且有利于我！】，洗脑完毕，咱们继续话题啊。

这样 Bookings列表 就会显示出来。

1-5，@UI.headerInfo / @UI.facet - Z04_PV_Booking_M

这样就可以显示Booking_M 的Object Page页面，以及显示明细，和 BookSuppl_M的列表

其实 BookSuppl_M 列表应该显示不出来，我上面为了调查数据显示不出来，先把Metadata 做了

2，BookSuppl_M

2-1， New Metadata Extension - Z04_PV_BookSuppl_M

这个配合1-5，显示出了 BookSuppl_M 列表。

2-2，@UI.headerInfo / @UI.facet - Z04_PV_BookSuppl_M

这样就可以显示BookSuppl_M 的Object Page页面，以及显示明细

BookSuppl_M 的Object Page页面就显示出来了。

 

3，完整的代码（Metadata）和页面截图

3-1，Travel_M_MD

@Metadata.layer: #CORE
@Search.searchable: true
@UI.headerInfo: {typeName: 'Travel',typeNamePlural: 'Travels',title: {type: #STANDARD,label: 'Travel',value: 'TravelId'}
}
annotate view Z04_PV_Travel_M with
{@UI.facet: [{id: 'TravelDetail',purpose: #STANDARD,parentId: '',position: 10,label: 'Travel Detail',type: #IDENTIFICATION_REFERENCE},{id: 'Booking',purpose: #STANDARD,parentId: '',position: 20,label: 'Bookings',targetElement: '_Booking',type: #LINEITEM_REFERENCE}]@UI:{ lineItem:[{ position: 10 }],identification: [{ position: 10 }]}@Search.defaultSearchElement: trueTravelId;@UI:{ lineItem:[{ position: 20 }],selectionField: [{ position: 20 }],identification: [{ position: 20 }]}@Search.defaultSearchElement: [e-mail]: [{ entity: {name: '/DMO/I_Agency',element: 'AgencyID'},label: 'Agency'}]AgencyId;//      AgencyName;@UI:{ lineItem:[{ position: 30 }],selectionField: [{ position: 30 }],identification: [{ position: 30 }]}@Search.defaultSearchElement: [e-mail]: [{entity: {name: '/DMO/I_Customer',element: 'CustomerID'},label: 'Customer'}]CustomerId;//      CustomerName;@UI:{ lineItem:[{ position: 40 }],identification: [{ position: 40 }]}BeginDate;@UI:{ lineItem:[{ position: 50 }],identification: [{ position: 50 }]}EndDate;@UI:{identification: [{ position: 55 }]}BookingFee;@UI:{ lineItem:[{ position: 60 }],identification: [{ position: 60 }]}TotalPrice;@Consumption.valueHelpDefinition: [{entity: {name: 'I_Currency',element: 'Currency'},label: 'Currency'}]CurrencyCode;@UI:{identification: [{ position: 65 }]}Description;@UI:{ lineItem:[{ position: 70 }],selectionField: [{ position: 70 }],identification: [{ position: 70 }]}@Search.defaultSearchElement: [e-mail]: [{entity: {name: '/DMO/I_Overall_Status_VH',element: 'OverallStatus'},label: 'Overall Status'}]OverallStatus;//      OverallStatusText;//      CreatedBy;//      CreatedAt;//      LastChangedBy;@UI.hidden: trueLastChangedAt;//      /* Associations *///      _Agency;//      _Booking;//      _Currency;//      _Customer;//      _Status;}

点 开始

3-2，Booking_M_MD

@Metadata.layer: #CORE
@UI.headerInfo: {typeName: 'Booking',typeNamePlural: 'Bookings',title: {type: #STANDARD,label: 'Booking',value: 'BookingId'}
}
annotate view Z04_PV_Booking_M with
{@UI.facet: [{id: 'BookingDetail',purpose: #STANDARD,parentId: '',position: 10,label: 'Booking Detail',type: #IDENTIFICATION_REFERENCE},{id: 'BookSuppl',purpose: #STANDARD,position: 20,label: 'Booking Supplment',type: #LINEITEM_REFERENCE,targetElement: '_BookingSupplement'}]//  TravelId;@UI:{ lineItem:[{ position: 20 }],identification: [{ position: 20 }]}BookingId;@UI:{ lineItem:[{ position: 30 }],identification: [{ position: 30 }]}BookingDate;@UI:{ lineItem:[{ position: 40 }],identification: [{ position: 40 }]}CustomerId;@UI:{ lineItem:[{ position: 50 }],identification: [{ position: 50 }]}CarrierId;@UI:{ lineItem:[{ position: 60 }],identification: [{ position: 60 }]}ConnectionId;@UI:{ lineItem:[{ position: 70 }],identification: [{ position: 70 }]}FlightDate;@UI:{ lineItem:[{ position: 80 }],identification: [{ position: 80 }]}FlightPrice;//  CurrencyCode;@UI:{ lineItem:[{ position: 90 }],identification: [{ position: 90 }]}BookingStatus;@UI.hidden: trueLastChangedAt;
}

 3-1 中 Travel_M 列表点任意一条，显示Travel_M的明细（Object Page）

3-3，BookSuppl_M_MD

@Metadata.layer: #CORE
@UI.headerInfo: {typeName: 'Booking Supplement',typeNamePlural: 'Booking Supplements',title: {type: #STANDARD,label: 'Booking Supplement',value: 'BookingSupplementId'}
}
annotate view Z04_PV_BookSuppl_M with
{@UI.facet: [{id: 'BookSuppl',purpose: #STANDARD,position: 10,label: 'Booking Supplment',type: #IDENTIFICATION_REFERENCE}]//  TravelId;//  BookingId;@UI:{ lineItem:[{ position: 10 }],identification: [{ position: 10 }]}BookingSupplementId;@UI:{ lineItem:[{ position: 20 }],identification: [{ position: 20 }]}SupplementId;@UI:{ lineItem:[{ position: 30 }],identification: [{ position: 30 }]}Price;//     CurrencyCode;@UI.hidden: trueLastChangedAt;//   /* Associations *///   _Booking;//   _Supplement;//   _SupplementText;//   _Travel;}

 3-2 中 Booking_M 列表点任意一条，显示Booking_M的明细（Object Page）

然后点 Booking Supplement 列表中的任意一项，会显示其 Object Page页面

上面是我们想实现的主要功能。

除此之外，还有一些功能也想加上，比如Search，ObjectModel 等等。

4，Travel_M_MD 其他功能

4-1，@UI.textArrangement: #TEXT_ONLY - Z04_PV_Travel_M_MD

这个是啥呢？

其实就是 Key - Value 值的显示方式设定。

比如OverallStatus 在Projection View里用 @ObjectModel.text.element: [ 'OverallStatusText' ]显示名称，默认是 Value(Key) 的形式。

多数情况下客户也喜欢这种方式，但是也不总是如此，比如这里的Status，就不想显示Key，只要Value，那该怎么办呢？

就是用这个@UI.textArrangement: #TEXT_ONLY。

深入看一下各个选项：

在 SAP RAP (ABAP RESTful Application Programming) 和 Fiori Elements 中，@UI.textArrangement 注解用于控制字段文本的显示方式，特别是在表格列或表单中。以下是该注解的可用选项及其含义：

---

a，@UI.textArrangement 的选项

选项值	说明	适用场景	示例
#TEXT_ONLY	仅显示文本值，不显示图标或附加信息	纯文本字段（如名称、描述）	Name: John
#TEXT_FIRST	文本在前，图标或其他元素在后	带状态图标的文本（如状态+文本）	Completed ✅
#TEXT_LAST	文本在后，图标或其他元素在前	图标优先的显示（如货币符号+金额）	$ 100.00
#TEXT_SEPARATE	文本与图标/附加信息分开显示（通常分行）	需要清晰分隔的复杂字段	Status: ✅ Approved
#ICON_ONLY	仅显示图标，隐藏文本	空间有限时（如操作栏图标）	🛑（无文本）
#ICON_FIRST	图标在前，文本在后	状态指示（如错误图标+消息）	⚠️ Warning
#ICON_LAST	图标在文本后	次要图标补充（如链接后的外部图标）	Details ↗

---

b，使用示例

1. 在 CDS View 中定义

abap

@UI: {lineItem: [{position: 10,label: 'Status',// 文本在前，状态图标在后textArrangement: #TEXT_FIRST}],identification: [{position: 20,label: 'Price',// 货币符号在前，金额在后textArrangement: #TEXT_LAST}]
}
define view Z_MyEntity {@UI.hidden: truekey id,@Consumption.valueHelpDefinition: [{ entity: { name: 'I_StatusIcon' } }]status,@Semantics.amount.currencyCode: 'CurrencyCode'price,CurrencyCode
}

2. 效果对比

• #TEXT_FIRST:
  Completed ✅

• #ICON_FIRST:
  ⚠️ Error

• #TEXT_SEPARATE:
  Status:
✅ Approved

---

c，注意事项

1. 依赖字段类型：

   • 如果字段没有关联图标（如通过 @UI.statusIcon 或值帮助定义），#ICON_* 选项可能无效。

2. Fiori Elements 兼容性：

   • 部分选项可能因 Fiori 版本不同而表现略有差异（建议测试目标版本）。

3. 组合使用：

   • 常与以下注解配合使用：

     abap

1. • @UI.statusIcon:  // 定义状态图标
     @UI.dataPoint:   // 控制数据点样式

---

d，常见问题

Q：为什么设置了 #ICON_FIRST 却不显示图标？
A：检查是否缺少图标定义（如 @UI.statusIcon 或值帮助实体未提供图标元数据）。

如果需要更具体的场景示例，可以提供您的字段类型和预期效果！

画面效果如下：

Object Page页面：

 

5，Booking_M_MD 其他功能

5-1，Search

- @Search.searchable: true：显示检索框

- @Search.defaultSearchElement: true：定义检索框对应的检索对象

  - TravelId;

  - BookingId;

  - CustomerId;

画面效果就是这个搜索框

TODO：不知为啥，这个搜索框好像不太好用

5-2，@UI.textArrangement: #TEXT_ONLY - Z04_PV_Booking_M_MD

先给几个字段加上Name/or Text - Z04_PV_Booking_M

- CustomerId ，CustomerName

- CarrierId，CarrierName

- BookingStatus，BookingStatusText

然后再到 Z04_PV_Booking_M_MD 里面，给BookingStatus 字段加上下面annotation：

- textArrangement: #TEXT_ONLY

 

运行看效果：

- 列表中 Booking Status项目只显示名称

还有些需要添加的内容，尤其是Value Help 部分，放到下一章说。

现在文章是越写越长了😓

以上就是本篇的全部内容。

更多SAP顾问业务知识请点击下面目录链接或东京老树根的博客主页

https://blog.csdn.net/shi_ly/category_12216766.html

东京老树根-CSDN博客