使用 `cds init` 初始化一個 CAP 應用，然後 `npm install`, `cds watch` 啟動伺服器。

建立一個 [schema](https://developers.sap.com/tutorials/btp-app-create-cap-application.html) 檔案，內容如下：

```sql
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`):

```sql
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` 看到的自動生成的頁面：

![](https://img-blog.csdnimg.cn/img_convert/638821d8c21a59be41396cbf97046705.png)

這個 index.html 的模板檔案位置：

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

在應用程式安全檔案 (xs-security.json) 中，role templates 屬性使您能夠定義一個陣列，其中列出了訪問特定應用程式模組所需的一個或多個 `roles`（具有相應的範圍和任何必需的屬性）。可以定義多個角色模板，每個模板都有自己的範圍和屬性。

一個例子：

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

必須例項化角色模板。 對於角色模板中定義的任何屬性和具體的屬性值尤其如此，這些屬性需要定製，因此無法自動提供。 只包含“本地”範圍的角色模板可以在沒有使用者互動的情況下被例項化。 對於 foreign scope 也是如此，其中範圍所有者已在某種白名單中宣告同意（例如，供“公共”使用或已知“朋友”使用）。

SAP CAP 專案 cds watch 生成的 index.html 的模板位置和許可權控制

相關文章