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

东京老树根2025-07-16 10:09

上一章讲了在 Data Model View ( CDS View for BO Structure )基础上创建 Projection View ( CDS View for BO Projection )。

SAP学习笔记 - 开发44 - RAP开发 Managed App 建 Projection View，Provider Contract，用 redirected to 设定父子关系-CSDN博客

本章继续学习RAP相关的知识 - New Service Definition，Metadata Extension。

  • New Service Definition，Metadata Extension 里面的内容

  • 基本上之前讲的，lineItem，selectionField，Search，ObjectModel，Value Help，headerInfo 等等，这些内容都重新复习了一遍。

  • 代码的写法上也有更为灵活的方案

目录

[1，New Service Definition](#1，New Service Definition)

[1-1，Z04_PV_Travel_M 修改](#1-1，Z04_PV_Travel_M 修改)

a），追加字段

[b），@Metadata.allowExtensions: true - 允许Metadata放到单独文件](#b），@Metadata.allowExtensions: true - 允许Metadata放到单独文件)

[1-2，New Metadata Extension - Z04_PV_Travel_M_MD](#1-2，New Metadata Extension - Z04_PV_Travel_M_MD)

[1-3，New Service Definition - Z04_SD_Travel_M](#1-3，New Service Definition - Z04_SD_Travel_M)

[1-4，New Service Binding - Z04_UI_Travel_M_V4](#1-4，New Service Binding - Z04_UI_Travel_M_V4)

1-5，实验一下

[2，Metadata Extension - Z04_PV_Travel_M_MD](#2，Metadata Extension - Z04_PV_Travel_M_MD)

[2-1，加 lineItem，selectionField - 列对象，检索条件对象](#2-1，加 lineItem，selectionField - 列对象，检索条件对象)

[2-2，加 @Search.searchable: true - 搜索框](#2-2，加 @Search.searchable: true - 搜索框)

[2-3，@ObjectModel.text - 显示Code对应的Name/Text值](#2-3，@ObjectModel.text - 显示Code对应的Name/Text值)

[2-4，@Consumption.valueHelpDefinition - Value Help](#2-4，@Consumption.valueHelpDefinition - Value Help)

[2-5，@UI.hidden: true](#2-5，@UI.hidden: true)

[2-6，@UI.identification / @UI.facet - 显示详细页面（Object Page）](#2-6，@UI.identification / @UI.facet - 显示详细页面（Object Page）)

[2-7，@UI.headerInfo - Header](#2-7，@UI.headerInfo - Header)

下面是详细内容。

1，New Service Definition

Projection View建好了，下面该做 Service Definition了。

1-1，Z04_PV_Travel_M 修改

a），追加字段

  • _Agency.Name as AgencyName, =》显示代理店名称

  • _Customer.LastName as CustomerName, =》显示客户名称

  • _Status._Text.Text as OverallStatusText :localized, =》显示总体状态名称，localized：本地化

b），@Metadata.allowExtensions: true - 允许Metadata放到单独文件

因为咱们想要将Metadata单独到一个文件当中，需要设置该annotation 为True

1-2，New Metadata Extension - Z04_PV_Travel_M_MD

输入Name，Description，Extended Entity，点Next

选模板，annotateView，然后点Finish

Ctrl + Space，然后选 Insert All，这样就不用挨个输入了哈👍

本来想先不加，然后再慢慢挨个加，结果直接报个错，说至少得有一个😓，好吧

>No annotations defined. At least one annotation must be defined for 'Z04_PV_Travel_M'

先搞成这样，Ctrl+F3，激活

1-3，New Service Definition - Z04_SD_Travel_M

输入Name，Description，点Next

选模板，只有一个：），点Finish

咱们把 Z04_PV_Booking_M，Z04_PV_BookSuppl_M 都给加上，然后激活

1-4，New Service Binding - Z04_UI_Travel_M_V4

输入Name，Description，Binding Type，点 Next

点Finish

Ctrl + F3，激活，然后点 Publish

1-5，实验一下

就是这样的哈

其实也可以查询，点Settings，然后把想看的字段给调出来，就可以看啦，参照如下文章

SAP学习笔记 - 开发40 - RAP开发 Annotation的作用 @UI.headerInfo /@UI.lineItem/ @UI.selectionField/ @UI.facet等-CSDN博客

就像这样，数据是可以检索出来的。

但是这样毕竟不方便嘛，下面咱们就让画面默认显示这些字段

2，Metadata Extension - Z04_PV_Travel_M_MD

2-1，加 lineItem，selectionField - 列对象，检索条件对象

都是以前讲过的，其中UI 有多个annotation的话，写法上可以合并成下面这样：

  • @UI:{ lineItem:[{ position: 70 }],

selectionField: [{ position: 70 }]

}

刷新页面，默认就显示成这样了

2-2，加 @Search.searchable: true - 搜索框

  • @Search.searchable: true

  • @Search.defaultSearchElement: true

TODO：好像没好用，之前还是好用的啊，不知道差哪儿，以后再说

SAP学习笔记 - 开发42 - RAP开发 Annotation的作用3: @Search.searchable - 检索功能，@Search.fuzzinessThreshold - 模糊查询-CSDN博客

2-3，@ObjectModel.text - 显示Code对应的Name/Text值

这里面需要注意几点：

  • @ObjectModel.text 属于 ABAP Level 的association，所以不能写在 Metadata 文件中

  • 下面的写法是OK的，如果也可以简写成：@ObjectModel.text.element: [ 'AgencyName' ]

@ObjectModel.text: {

element: [ 'AgencyName' ]

}

完整的代码如下：AgencyName，CustomerName，OverallStatusText 都写上

Agency ID，Customer ID 都好用

TODO：但是 Overall Status 好像不好用哈

好像不是不好用，而是没有语言 JA 的文本吧

只有 E （English）的文本😓，好吧，代码应该没问题

把JA 的数据给加上

这样就能显示出来了

2-4，@Consumption.valueHelpDefinition - Value Help

对以下几个字段添加 Value Help：

  • AgencyId - Table：/DMO/I_Agency Field：AgencyID

  • CustomerId - Table：/DMO/I_Customer Field：CustomerID

  • CurrencyCode - Table：I_Currency Field：Currency

  • OverallStatus - Table：/DMO/I_Overall_Status_VH Field：OverallStatus

到目前这一步的 Metadata 文件的内容：

sql 复制代码 
@Metadata.layer: #CORE
@Search.searchable: true
annotate view Z04_PV_Travel_M with
{
  @UI.lineItem: [{ position: 10 }]
  @Search.defaultSearchElement: true
  TravelId;
  @UI:{ lineItem:[{ position: 20 }],
        selectionField: [{ 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 }]
      }
  @Search.defaultSearchElement: true
  @Consumption.valueHelpDefinition: [{
          entity: {
              name: '/DMO/I_Customer',
              element: 'CustomerID'
          },
          label: 'Customer'
  }]
  CustomerId;
  //      CustomerName;
  @UI.lineItem: [{ position: 40 }]
  BeginDate;
  @UI.lineItem: [{ position: 50 }]
  EndDate;
  //      BookingFee;
  @UI.lineItem: [{ position: 60 }]
  TotalPrice;
  @Consumption.valueHelpDefinition: [{
      entity: {
          name: 'I_Currency',
          element: 'Currency'
      },
      label: 'Currency'
  }]
  CurrencyCode;
  //      Description;
  @UI:{ lineItem:[{ position: 70 }],
        selectionField: [{ position: 70 }]
      }
  @Search.defaultSearchElement: true
  @Consumption.valueHelpDefinition: [{
      entity: {
          name: '/DMO/I_Overall_Status_VH',
          element: 'OverallStatus'
      },
      label: 'Overall Status'
  }]
  OverallStatus;
  //      OverallStatusText;
  //      CreatedBy;
  //      CreatedAt;
  //      LastChangedBy;
  //      LastChangedAt;
  //      /* Associations */
  //      _Agency;
  //      _Booking;
  //      _Currency;
  //      _Customer;
  //      _Status;

}

刷新看效果：

  • Agency ID：
  • Customer ID：
  • Overall Status：

2-5，@UI.hidden: true

虽然在画面端存在，但是不显示，设为 hidden：true

2-6，@UI.identification / @UI.facet - 显示详细页面（Object Page）

  • @UI.facet：在 Metadata里面添加，这个是详细页面的块（字段显示在其中）

  • @UI.identification：这是详细页面的字段

sql 复制代码 
@Metadata.layer: #CORE
@Search.searchable: true
annotate view Z04_PV_Travel_M with
{
  @UI.facet: [{
      id: 'TravelDetail',
      purpose: #STANDARD,
      parentId: '',
      position: 10,
      label: 'Travel Detail',
      type: #IDENTIFICATION_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;

}

看一下效果：

List Report 页面，任意点一条

Object Page 显示的没啥问题，title 好像默认显示了 Travel ID了哈

2-7，@UI.headerInfo - Header

到目前为止的代码：

sql 复制代码 
@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
  }]
  @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;

}

这样就显示了 Header

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

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

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

东京老树根-CSDN博客

相关推荐
Chef_Chen1 小时前
从0开始学习R语言--Day47--Nomogram
学习
Pi_Qiu_1 小时前
Python初学者笔记第十三期 -- （常用内置函数）
java·笔记·python
毕设源码柳学姐2 小时前
计算机毕业设计Java医学生在线学习平台系统 基于 Java 的医学生在线学习平台设计与开发 Java 医学在线教育学习系统的设计与实现
java·学习·课程设计
不过普通话一乙不改名3 小时前
扩展：操作系统之高性能网络计算
网络·笔记
不会敲代码的XW3 小时前
LVS（Linux Virtual Server）详细笔记（理论篇）
linux·笔记·lvs
永日456703 小时前
学习日记-spring-day46-7.11
java·学习·spring
Yhame.3 小时前
【 Cache 写策略学习笔记】
笔记·学习
Blossom.1184 小时前
从“炼丹”到“流水线”——如何用Prompt Engineering把LLM微调成本打下来？
人工智能·python·深度学习·神经网络·学习·机器学习·prompt
HuashuiMu花水木4 小时前
PyTorch笔记7----------计算机视觉基础
人工智能·pytorch·笔记
86Eric4 小时前
C# 入门教程（三）：详解字段、属性、索引器及各类参数与扩展方法
学习·c#·传参·扩展方法·属性，字段·输出参数
热门推荐
01全球最强模型Grok4，国内已可免费使用！（附教程）02KGG转MP3工具|非KGM文件|解密音频03Coze扣子平台完整体验和实践（附国内和国际版对比）04《深入设计模式》模式结构汇总05使用Ruby接入实时行情API教程06扣子（coze）实战|我用扣子搭建了一个自动分析小红薯笔记内容的AI应用|详细步骤拆解07基于odoo17的设计模式详解---单例模式08集群聊天服务器---MySQL数据库的建立09DeepSeek各版本说明与优缺点分析10LOT: 通过逻辑增强大型语言模型的零样本Chain-of-Thought推理能力