SAP CAP 项目 cds watch 生成的 index.h

使用 cds init 初始化一个 CAP 应用，然后 npm install, cds watch 启动服务器。

创建一个 schema 文件，内容如下：

namespace sap.ui.riskmanagement;
using { managed } from '@sap/cds/common';
  entity Risks : managed {
    key ID      : UUID  @(Core.Computed : true);
    title       : String(100);
  }
  entity Mitigations : managed {
    key ID       : UUID  @(Core.Computed : true);
    risks        : Association to many Risks on risks.miti = $self;
  }

注意，schema 文件可以定义 namespace.

这两个模型的 key 由 CAP 服务器自动填充，该服务器使用注释 @(Core.Computed : true) 向服务用户公开。

只有 entity 还无法被 end user 消费，需要通过 service 暴露给外部。

在 srv 文件夹里新建一个文件 risk-service.cds，注意这个文件和 entity schema 文件在不同的文件夹(前者在 db):

using { sap.ui.riskmanagement as my } from '../db/schema';
@path: 'service/risk'
service RiskService {
  entity Risks as projection on my.Risks;
    annotate Risks with @odata.draft.enabled;
  entity Mitigations as projection on my.Mitigations;
    annotate Mitigations with @odata.draft.enabled;
}

使用 cds watch 看到的自动生成的页面：

这个 index.html 的模板文件位置：

node_modules@sap\cds-dk\node_modules@sap\cds\app\index.html

在应用程序安全文件 (xs-security.json) 中，role templates 属性使您能够定义一个数组，其中列出了访问特定应用程序模块所需的一个或多个 roles（具有相应的范围和任何必需的属性）。可以定义多个角色模板，每个模板都有自己的范围和属性。

一个例子：

"role-templates": [ 
     { 
      "name"                : "Editor", 
      "description"         : "View, edit, delete books", 
      "scope-references"    : [ 
                              "$XSAPPNAME.Edit", "$XSAPPNAME.Delete"  
                              ], 
      "attribute-references": [ 
                              "Country", "CostCenter" 
                              ]  
     },
]

必须实例化角色模板。 对于角色模板中定义的任何属性和具体的属性值尤其如此，这些属性需要定制，因此无法自动提供。 只包含“本地”范围的角色模板可以在没有用户交互的情况下被实例化。 对于 foreign scope 也是如此，其中范围所有者已在某种白名单中声明同意（例如，供“公共”使用或已知“朋友”使用）。