原文連結

TypeScript 和 JavaScript 開發人員，這是為您準備的：SAP Cloud SDK (fka SAP S/4HANA Cloud SDK) 現在可用於 JavaScript。 今天，我們很自豪地釋出了適用於 JavaScript 的 SAP Cloud SDK 1.0.0 版。 這是繼去年 10 月開始的測試版之後，第一個通用的、高效的 JavaScript 庫版本。

與適用於 Java 的 SDK 類似，適用於 JavaScript 的 SAP Cloud SDK 使在 SAP Cloud Platform 上將 SAP S/4HANA 的擴充套件開發為應用程式變得輕鬆愉快。 適用於 JavaScript 的 SAP Cloud SDK 可幫助您將 SAP S/4HANA 整合到使用 TypeScript 或 JavaScript 編寫並在 Node.js 中執行的雲原生應用程式中。 您可以在本地執行這些應用程式，也可以將它們部署到 SAP Cloud Platform、Cloud Foundry。

Easy access to SAP S/4HANA Cloud APIs

訪問 SAP S/4HANA Cloud 可以像下面一樣簡單——沒有樣板、低階程式碼，只有業務邏輯：

import { BusinessPartner } from '@sap/cloud-sdk-vdm-business-partner-service';

BusinessPartner.requestBuilder()
    .getAll()
    .select(BusinessPartner.LAST_NAME)
    .filter(BusinessPartner.FIRST_NAME.equals("John"))
    .execute({destinationName: "S4HANACloud"})
    .then(businessPartners => {
        // process result of type BusinessPartner[]
    }).catch(reason => {
        // handle error
    });
 

這是通過 OData 虛擬資料模型（VDM，也稱為 Java SDK）實現的。 適用於 JavaScript 的 SDK 的 OData VDM 提供 SAP S/4HANA Cloud 的 OData API 的 TypeScript/JavaScript 表示，包括 SAP API Business Hub 上列出的所有服務、操作和實體型別。 與上面的程式碼片段類似，您不僅可以訪問讀取操作，還可以訪問寫入操作（尚不支援 function import）。

Straightforward integration of SAP Cloud Platform

上面的程式碼片段還說明了與 SAP Cloud Platform 上的 destination service 的開箱即用整合，用於管理目標系統或目標和身份驗證憑據。 如果您第一眼看不到它，請不要擔心 - 由於直接整合，很容易錯過：在 OData VDM 請求上呼叫 execute 時，您傳遞目標的名稱，在本例中為 S4HANACloud。 就是這樣，SDK 將負責解析 SAP Cloud Platform 上目標服務中定義的目標並執行所需的身份驗證。

如果您願意，也可以手動定義目的地。 此外，在本地執行或測試期間，可以很容易地用簡單的環境變數替換目標服務。

TypeScript or JavaScript?

上面的示例使用 TypeScript，這是 JavaScript 的型別化超集。 但是，如果您只熟悉 JavaScript，您甚至可能沒有注意到。事實上，上面的程式碼也是完全有效的 JavaScript。 SAP Cloud SDK for JavaScript 已在 TypeScript 中實現，並且可以在 JavaScript 和 TypeScript 專案中使用。JavaScript 和 TypeScript 開發人員都可以使用相同的庫並獲得相同的功能，並且在提供相應支援的編輯器的情況下，兩者都將受益於 TypeScript 啟用的程式碼完成功能。 TypeScript 專案當然會受益於額外的型別安全。

我們只能鼓勵每個人檢查 TypeScript 是否適合他的需求。如果你不想使用 TypeScript，堅持使用純 JavaScript 並在 JavaScript 中使用 SDK 仍然是完全可以的。

Continuous delivery pipeline

持續交付工具包是 SAP Cloud SDK 的核心元件，因為它使專案能夠持續交付其應用程式，而無需額外的工作來設定持續交付管道。 我們很高興從一開始就能夠為 JavaScript 專案提供這種開箱即用的持續交付管道。

為此，我們提供了兩個專案腳手架，一個用於 TypeScript，一個用於 JavaScript 專案。 它們開箱即用，包括在 Jenkins 伺服器上執行持續交付管道所需的一切。 您不必編寫一行管道程式碼即可從管道中編纂的最佳實踐中受益，只需將其配置到您的專案環境中即可。 有關受支援內容的更多詳細資訊，請檢視持續交付工具包 v17 版本的釋出公告。

How to Access the JavaScript Libraries

SAP Cloud SDK 的 JavaScript 庫可從 SAP 的 npm 登錄檔免費訪問。 SAP 登錄檔的工作方式類似於用於解析 JavaScript 模組的標準 npmjs 登錄檔。 它託管範圍為@sap 的包。 為了能夠檢索 SDK 模組（所有這些模組都隨作用域 @sap 提供），您只需執行以下命令：

npm config set "@sap:registry" "https://npm.sap.com"

然後，選擇文件中模組概述中列出的 SDK 的任何模組，並將其作為依賴項安裝到您的 Node.js 專案中，例如：

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