原文链接

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