[官方連結](https://developers.sap.com/tutorials/s4sdkjs-prerequisites.html)

要建立已包含使用 SAP Cloud SDK for JavaScript 所需的所有檔案和配置的應用程式，您可以使用 SDK 的命令列介面 (CLI)。 要獲取 CLI，請執行以下命令：

> npm install -g @sap-cloud-sdk/cli

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

這將在你的機器上全域性安裝 CLI，允許你在任何地方使用它。 現在你可以透過執行 CLI 的 init 命令來建立一個新專案：

> sap-cloud-sdk init my-sdk-project

安裝完畢：
![](https://img-blog.csdnimg.cn/img_convert/a3678bb0dfe92872f58061c537821703.png)

生成的專案裡，package.json 定義的依賴如下：

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

執行命令，啟動初始化好的專案，能看到應用成功啟動的訊息：

> npm run start:dev

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

![](https://img-blog.csdnimg.cn/img_convert/d6337fcee5ca5ddd0227bab2f2089939.png)
[官網](https://developers.sap.com/tutorials/s4sdkjs-odata-service-cloud-foundry.html)

# Set up the API Server

有多種設定 API Server 的方法，您可以設定自己的 Mock Server，也可以使用 Sandbox API。

為了呼叫 OData 服務，需要有一個要呼叫的服務。您可以按照[此處](https://sap.github.io/cloud-s4-sdk-book/pages/mock-odata.html)的說明設定模擬業務合作伙伴和自定義服務的本地模擬伺服器。這個模擬伺服器並不支援實際 OData 服務的所有功能，但在本地試用它就足夠了。

一旦它啟動並執行，您應該會在 http://localhost:3000/ 看到服務列表。

或者，也可以使用 SAP API Business Hub 的沙箱測試許多 API。要使用沙箱，您需要一個 API 金鑰。轉到 https://api.sap.com 並單擊右上角的“登入”。如果您沒有帳戶，則需要先註冊。登入後，點選右上角的“hi”，然後在剛剛開啟的下拉選單中點選“首選項”。在首選項頁面上，單擊顯示 API 金鑰。

# Add a custom route

最初，該應用程式僅包含 index 和 hello-world 路由。 我們將為業務合作伙伴新增另一條路線，其中將列出所有可用的業務合作伙伴。

首先，在 src/ 目錄中建立一個新檔案 business-partner.controller.ts 併為此路由新增一個實現，如下所示：

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

@Controller() 裝飾器將我們的類標記為控制器（即處理請求的東西），@Get('business-partners') 裝飾器將 getBusinessPartners 方法標記為路徑 /business-partners 上的 GET 請求的處理程式。

為了讓控制器工作，我們還需要在我們的應用程式中註冊它。 開啟 app.module.ts，匯入剛剛建立的控制器類並將其新增到控制器宣告中。

```typescript
import { Module } from '@nestjs/common';
import { AppController } from './app.controller';
import { AppService } from './app.service';
import { BusinessPartnerController } from './business-partner.controller';

@Module({
  imports: [],
  controllers: [AppController, BusinessPartnerController],
  providers: [AppService],
})
export class AppModule {}
```

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

要使用適用於 JavaScript 的 SAP Cloud SDK 呼叫 OData 服務，請將此服務的虛擬資料模型 (VDM) 新增到您的依賴項。 在本文中，我們將 VDM 用於業務合作伙伴服務。 使用以下命令安裝它：

> npm install @sap/cloud-sdk-vdm-business-partner-service

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

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

SAP Cloud SDK for JavaScript 為 SAP S/4HANA Cloud 公開的每個 OData 服務提供包。 您可以在 SAP API 業務中心找到這些服務的列表，並在我們的[文件](https://help.sap.com/doc/9dbcab0600b346c2b359a8c8978a45ba/1.0/en-US/index.html)中找到相應包的列表。

在 business-partner.controller.ts 建立一個函式 getAllBusinessPartners 並根據您的 API 伺服器實現它：

在下面的程式碼片段中，我們假設您有一個模擬伺服器在本地執行在埠 3000 上。可以在[此處](https://sap.github.io/cloud-s4-sdk-book/pages/mock-odata.html)找到有關模擬伺服器的文件。

```typescript
function getAllBusinessPartners(): Promise<businesspartner> {
  return BusinessPartner.requestBuilder()
    .getAll()
    .execute({
      url: 'http://localhost:3000'
    });
}
```

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

* 在第 2 行中，我們正在為業務合作伙伴實體建立一個請求構建器。
* 第 3 行表明，我們要建立一個請求以獲取所有業務夥伴。
* 第 4 行負責執行並根據給定的目標 URL 向 URL 傳送請求。

由於網路請求本質上是非同步的，因此該函式的返回值是對業務夥伴列表 (Promise<businesspartner>) 的 Promise.

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

```typescript
import { Controller, Get, HttpException } from '@nestjs/common';
import { BusinessPartner } from '@sap/cloud-sdk-vdm-business-partner-service';

@Controller()
export class BusinessPartnerController {
  @Get('business-partners')
  getBusinessPartners() {
    return getAllBusinessPartners()
      .catch(error => {
        throw new HttpException(`Failed to get business partners - ${error.message}`, 500);
      });
  }
}

function getAllBusinessPartners(): Promise<businesspartner> {
  return BusinessPartner.requestBuilder()
    .getAll()
    .execute({
      url: 'https://sandbox.api.sap.com/s4hanacloud',
    });
}
```

最後的執行結果：成功從 SAP API sandbox 系統取得了 Business partners 資料：

![](https://img-blog.csdnimg.cn/img_convert/9e6f90c06e0231dc3323c13be9deec0c.png)</businesspartner></businesspartner></businesspartner>

SAP Cloud SDK for JavaScript 的搭建和使用方法介紹

相關文章