SAP学习笔记 - 开发45 - RAP开发 Managed App New Service Definition,Metadata Extension
上一章讲了在 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-1,Z04_PV_Travel_M 修改
a),追加字段
b),@Metadata.allowExtensions: true - 允许Metadata放到单独文件
1-2,New Metadata Extension - Z04_PV_Travel_M_MD
1-3,New Service Definition - Z04_SD_Travel_M
1-4,New Service Binding - Z04_UI_Travel_M_V4
1-5,实验一下
2,Metadata Extension - Z04_PV_Travel_M_MD
2-1,加 lineItem,selectionField - 列对象,检索条件对象
2-2,加 @Search.searchable: true - 搜索框
2-3,@ObjectModel.text - 显示Code对应的Name/Text值
2-4,@Consumption.valueHelpDefinition - Value Help
2-6,@UI.identification / @UI.facet - 显示详细页面(Object Page)
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 文件的内容:
@Metadata.layer: #CORE
@Search.searchable: true
annotate view Z04_PV_Travel_M with
{@UI.lineItem: [{ position: 10 }]@Search.defaultSearchElement: trueTravelId;@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:这是详细页面的字段
@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: trueTravelId;@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: trueLastChangedAt;// /* Associations */// _Agency;// _Booking;// _Currency;// _Customer;// _Status;}
看一下效果:
List Report 页面,任意点一条
Object Page 显示的没啥问题,title 好像默认显示了 Travel ID了哈
2-7,@UI.headerInfo - Header
到目前为止的代码:
@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: trueTravelId;@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: trueLastChangedAt;// /* Associations */// _Agency;// _Booking;// _Currency;// _Customer;// _Status;}
这样就显示了 Header
以上就是本篇的全部内容。
更多SAP顾问业务知识请点击下面目录链接或东京老树根的博客主页
https://blog.csdn.net/shi_ly/category_12216766.html
东京老树根-CSDN博客