SAP CAP篇五：为CAP添加Fiori Elements程序(2)

本系列文章

SAP CAP篇一: 快速创建一个Service，基于Java的实现
SAP CAP篇二：为Service加上数据库支持
SAP CAP篇三：定义Model
SAP CAP篇四：为CAP添加Fiori Elements程序(1)
SAP CAP篇五：为CAP添加Fiori Elements程序(2)
SAP CAP篇六：为CAP添加Fiori Elements程序(3)
SAP CAP篇七：为CAP添加Fiori Launchpad入口 (Sandbox环境)
SAP CAP篇八：为CAP添加App Router并支持Fiori Launchpad (Sandbox环境)
SAP CAP篇九：升级为SAP CDS 7.0, CAP Java 2以及Spring Boot 3
SAP CAP篇十：理解Fiori UI的Annoation定义
SAP CAP篇十一：支持Media Object：图片、附件等
SAP CAP篇十二：AppRouter 深入研究

新建Fiori Elements Application

通过VS Code的Fiori Tools Extension来新建"Fiori Elements Application”。通过VS Code的"View"菜单，选择"Command Palette"，选择"Fiori: Open Application Generator"。

选择Application Type

选择Application Type为"List Report Object Page"。

Data Source

然后，选择"Data Source"为"Use a Local CAP Project"，然后选择CAP Project文件夹。然后选择OData Service。这里选择"AdminService"。

Entity Selection

第三步，从OData Source中选择对应的Entity。

Project Information

填充Project Information。

其中，module name其实是folder名字。这里，需要“Add FLP configuration”。

Launchpad Setting

这里需要定义Semantic Object和Action。

 "manage-books": {
     "semanticObject": "Books",
     "action": "manage",
     "signature": {
       "parameters": {},
       "additionalParameters": "allowed"
     },
     "resolutionResult": {
       "applicationType": "SAPUI5",
       "additionalInformation": "SAPUI5.Component=manage-books",
       "url": "/manage-books/webapp"
     }
 }

修改manage-books文件夹

子文件夹 webapp

该子文件夹中，除了i18n之外的文件夹之外，别的子文件夹都可以删除。

需要删除的子文件夹：

• annotations
• localService
• test

重命名 annotations.cds

将annotations.cds重命名为fiori-service.cds。

更新fiori-service.cds

添加一下Annotations到fiori-service.cds。

using AdminService as service from '../../srv/admin-service';

annotate AdminService.Books with @(
  UI: {
    SelectionFields: [ ID, price, currency_code ],
    LineItem: [
      {Value: title},
      {Value: price},
      {Value: currency.symbol, Label:' '},
    ]
  }
);

manifest.json

修改文件manifest.json，将dataSource的部分关于local annoation的部分删掉。

最后的dataSources如下：

"dataSources": {
   "mainService": {
     "uri": "/odata/v4/AdminService/",
     "type": "OData",
     "settings": {
       "odataVersion": "4.0"
     }
   }
},

添加services.cds到app文件夹

在app文件夹下添加services.cds：

using from './manage-books/Fiori-service';

添加xs-app.json到app文件夹

在app文件夹，添加xs-app.json：

{
	"welcomeFile": "/app/fiori.html",
	"authenticationMethod": "route",
	"routes": [
	  {
		"source": "^/app/(.*)$",
		"cacheControl": "no-cache, no-store, must-revalidate",
		"target": "$1",
		"localDir": "./"
	  },
	  {
		"source": "^/appconfig/(.*)$",
		"localDir": "./",
		"authenticationType": "xsuaa"
	  }
  ]
}

到面前为止，app文件夹已经初步准备完毕。下一篇会讲如何在SAP CAP (Java)来打开app文件夹来模拟Fiori Launchpad效果。