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

原创 于 2025-07-16 15:12:58 发布 · 957 阅读 · 11 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#学习 #笔记

上一章讲了 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: true
  TravelId;
  @UI:{ lineItem:[{ position: 20 }],
        selectionField: [{ position: 20 }],
        identification: [{ position: 20 }]
      }
  @Search.defaultSearchElement: true
  @Consumption.valueHelpDefinition: [{ entity: {
              name: '/DMO/I_Agency',
              element: 'AgencyID'
          },
          label: 'Agency'
  }]
  AgencyId;
  //      AgencyName;
  @UI:{ lineItem:[{ position: 30 }],
        selectionField: [{ position: 30 }],
        identification: [{ position: 30 }]
      }
  @Search.defaultSearchElement: true
  @Consumption.valueHelpDefinition: [{
          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: true
  @Consumption.valueHelpDefinition: [{
      entity: {
          name: '/DMO/I_Overall_Status_VH',
          element: 'OverallStatus'
      },
      label: 'Overall Status'
  }]
  OverallStatus;
  //      OverallStatusText;
  //      CreatedBy;
  //      CreatedAt;
  //      LastChangedBy;
  @UI.hidden: true
  LastChangedAt;
  //      /* 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: true
  LastChangedAt;
}

 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: true
  LastChangedAt;
  //   /* 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: true
  key 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

    • @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博客

评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值