這是 Jerry 2021 年的第 48 篇文章，也是汪子熙公眾號總共第 325 篇原創文章。
Jerry 之前的文章 SAP Fiori 應用索引大全 曾經介紹過一個網站，能夠得到 SAP 所有 Fiori 應用列表：
https://fioriappslibrary.hana.ondemand.com/
到2021年7月18日為止，SAP 總共發布了 13268 個 Fiori 應用：
其中屬於 SAP S/4HANA 且 UI 基於 Fiori Elements 開發的 Fiori 應用數字為：878.
這 878 個 Fiori 應用，Jerry 之前的很多文章都曾經提到過，其架構為前臺界面採用 Fiori Elements 提供的 List Report, Object Type 等模板，後臺由 OData 服務提供業務數據。
SAP S/4HANA 標準的 OData 服務，在 SAP API Business Hub 上能夠查詢和瀏覽其明細。
這些 OData 服務，除了用於 SAP S/4HANA 標準 Fiori 應用外，也可以被 SAP Partners 在第三方應用中調用，方便地同 SAP S/4HANA 集成。例如，Partners 可以用自己熟悉的程式語言進行二次開發，然後將應用部署到 SAP BTP 上，即所謂的 Side-by-Side 擴展方式。
OData 協議基於 HTTP，在使用 OData 服務執行業務數據的創建或者修改時，需要編程人員在 HTTP 層面操作 POST 請求的 body 內容，步驟繁瑣且容易出錯。比如下圖是 Jerry 2019 年一個項目中用 Java 調用 SAP C4C OData 服務創建銷售訂單的測試代碼片段，其中第88行變量 body，包含的就是手動拼接 HTTP Post 請求的負載內容，可讀性很差且不易維護。
為了避免以上這些缺點，提高 Partners 同 SAP S/4HANA OData 服務集成時的開發效率，SAP 發布了 SAP S/4HANA Cloud SDK. 所謂 SDK( Software Development Kit)，即一系列開發工具庫的集合，包含開箱即用的模型和 API.
藉助 SAP S/4HANA Cloud SDK，開發人員無需了解 S/4HANA OData 服務的設計明細，可以用類似自然語言的代碼風格，調用 S/4HANA OData 服務，實現數據增刪改查的需求。
目前 S/4HANA Cloud SDK 支持 Java 和 JavaScript 兩種程式語言。在 SAP API Business Hub 上，我們可以下載 Java 版本的 SDK：
本文介紹 JavaScript 版本的 S/4HANA Cloud SDK.
運行以下命令安裝 SDK：
npm install -g @sap-cloud-sdk/cli
之後使用命令行新建一個項目：
sap-cloud-sdk init my-sdk-project
自動生成的項目文件結構如下圖所示：
生成的項目裡，package.json 定義的依賴如下：
package.json 文件定義的依賴，除了 sap-cloud-sdk 本身外，還包括 nestjs, 這是一個用於構建高效且可擴展的 Node.js 伺服器端應用的開發框架。
本文我們的目的是使用 SAP S/4HANA Cloud SDK 消費 API Business Hub Sandbox 系統中 Business Partner OData 服務。如果真實的需求是消費某個 SAP S/4HANA Cloud 系統的 OData 服務，只需要將代碼裡指向 API Hub 的 url，改成指向 S/4HANA Cloud tenant 即可。
前文提到，使用 Cloud SDK，開發人員無需了解 S/4HANA OData 設計細節，因為這些細節，被 Cloud SDK 裡所謂的虛擬數據模型：Virtual Data Model，簡稱 VDM 所封裝了。每一個 SAP S/4HANA OData 服務用到的數據模型，在 Cloud SDK 裡都有對應的 npm 包進行封裝，開發人員可以按需導入。
為了消費 Business Partner OData 服務，我們在 SAP 官網上搜索其 SDK npm 包：
根據關鍵字 partner 搜索，找到這個安裝包，將其 id ：@sap/cloud-sdk-vdm-business-partner-service 抄下來。
執行下面的命令行，將其安裝到本地：
npm install @sap/cloud-sdk-vdm-business-partner-service
現在 package.json 裡多了一個指向該包的依賴：
下面是使用 Cloud SDK 查詢 API Hub Sandbox 系統上前兩條 Business Partner 數據的完整代碼，其中核心代碼也就十行左右：
第2行代碼，從下載的 Business Partner VDM 包裡，導入名為 BusinessPartner 的虛擬數據模型
第15行代碼，調用 BusinessPartner 模型的 requestBuilder 方法，構造一個 OData 數據請求。再使用鏈式調用 getAll 和 top(2), 為構造的 OData 數據請求指定具體的目標：返回前兩條數據。
不難看出，這裡的代碼沒有任何直接操作 HTTP 的部分在內，而是更接近自然語言的風格。一個沒有開發背景的業務顧問，通過閱讀也能大致猜到這段代碼的作用。
本地命令行啟動這個應用：
npm run start:dev
在瀏覽器裡測試，能夠成功取回兩條 Business Partner 數據：
OData 協議支持的操作，在 Cloud SDK VDM 裡均有對應的方法。
比如OData 協議的 select 指令，只返回指定的欄位，在 SDK 裡對應了同名的 select 方法：
執行效果：
OData 協議的 filter 指令，對應 SDK 的同名 filter 方法。
下圖代碼的含義，代表只返回 BusinessPartnerCategory 欄位值為 2 的前20條 BusinessPartner 數據：
希望本文能讓大家對 SAP S/4HANA Cloud SDK 有一個最基本的認識。如果需要使用 SAP Cloud SDK 同 SAP S/4HANA Cloud 集成，建議大家從 SAP 官網開始，按部就班地學習。
感謝閱讀。
https://sap.github.io/cloud-sdk/docs/js/overview-cloud-sdk-for-javascript
更多閱讀