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

相关推荐
wangqiaowq1 小时前
Ontology 学习
学习
choumou_M3 小时前
算法_1:由浅入深学习快速排序QuickSort
学习·算法·排序算法
一壶浊酒伴余生5 小时前
新概念英语第一册 · 句法笔记
笔记·英语学习·英语语法·新概念英语
蒸蒸yyyyzwd8 小时前
后端学习笔记 day111
笔记·学习
叼烟扛炮8 小时前
[LangChain] 学习笔记（08）：工具调用底层闭环与第三方搜索（Tavily）实战
人工智能·笔记·学习·langchain
Century_Dragon9 小时前
让新能源故障诊断实训“触手可及“——仿真教学软件（VR）介绍
学习
江屿风9 小时前
【Git-组件】【Git入门：从文档灾难到版本掌控】流食般投喂
运维·笔记·git·组件·版本控制
楚山之石10 小时前
【Radiology】影像组学的标准化与可重复性：IBSI 卷积滤波器共识及其未能覆盖的环节
人工智能·学习·机器学习·mri
小李不想当小白11 小时前
HAL库之UART（STM32 HAL库学习笔记）
笔记·stm32·单片机·嵌入式硬件·学习·嵌入式
旖旎夜光12 小时前
【C++ 基础入门】C++ 多态（中）：虚函数表、多态原理与动静绑定
开发语言·c++·笔记·学习
热门推荐
01国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）02历年考研数学一、数学二、数学三真题试卷及答案PDF03如何新建文件夹？ 电脑新建文件夹的4种方法04几个好用的ip纯净度检测网站05GitHub 镜像站点06微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新07昇腾910B系列芯片完全指南：四款型号对比、服务器选型与大模型部署实战08苹果iPA游戏软件资源下载网站09蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接10【SQL Server 2022】保姆级SQL Server 详细图文下载安装教程